Difference between revisions of "Instrucciones de redacción"

From OSGeo
Jump to navigation Jump to search
m (removed category)
Line 1: Line 1:
[[Libro SIG|Volver al índice]]
+
[[Libro SIG|Volver al índice]]  
  
Este artículo se ha traído del repositorio del libro: https://svn.osgeo.org/osgeo/book/es/libro_sig/LaTeX/Instrucciones.txt
+
Aquí encontraras sugerencias y algunas convenciones utilizadas en el libro.  
===Conexiones entre palabras===
 
  
Usa el signo "~" para mantener conectadas las unidades y los valores
+
=== Conexiones entre palabras ===
 +
 
 +
Usa el signo "~" para mantener conectadas las unidades y los valores  
  
 
  "La elevación tiene un rango entre 0~m y 8000~m, como se observa en la figura ~\ref{Fig:ch01:esquema}."
 
  "La elevación tiene un rango entre 0~m y 8000~m, como se observa en la figura ~\ref{Fig:ch01:esquema}."
  
===Etiquetado de elementos===
+
=== Etiquetado de elementos ===
  
Usa las siguientes convenciones para etiquetar elementos:
+
Usa las siguientes convenciones para etiquetar elementos:  
  
{| {{Prettytable}} cellpadding="5"
+
{| cellpadding="5"
!Tipo
 
!Formato
 
!Ejemplo
 
 
|-
 
|-
|Referencia
+
! Tipo
|AutorAñoPublicacion
+
! Formato
|Hengl2004Geoderma
+
! Ejemplo
 
|-
 
|-
|Sección
+
| Referencia
|Etiqueta
+
| AutorAñoPublicacion
|Introduccion
+
| Hengl2004Geoderma
 
|-
 
|-
|Figura
+
| Sección
|Fig:Codigocapitulo
+
| Etiqueta
|Fig:esquema
+
| Introduccion
 
|-
 
|-
|Tabla
+
| Figura
|Tabla:Etiqueta
+
| Fig:Codigocapitulo
|Tabla:resumen
+
| Fig:esquema
 
|-
 
|-
|Ecuación
+
| Tabla
|Eq:Etiqueta
+
| Tabla:Etiqueta
|Eq:pendiente
+
| Tabla:resumen
 +
|-
 +
| Ecuación  
 +
| Eq:Etiqueta  
 +
| Eq:pendiente
 
|}
 
|}
  
No utilices acentos ni eñes en las etiquetas. Sustituye ñ por n o ny.
+
No utilices acentos ni eñes en las etiquetas. Sustituye ñ por n o ny.  
 
 
===Figuras===
 
 
 
Las figuras pueden ser en color o blanco y negro. Intenta siempre que sea
 
posible crearlas con un programa vectorial como CorelDraw o Inkscape, y
 
añadirlas después como PostScript o pdf. Si insertas imágenes raster en blanco
 
y negro o en escalas de gris, disminuye la profundidad de color en consonancia
 
para disminuir su tamaño en disco. Utiliza formatos de compresión sin pérdidas.
 
  
Si debes añadir texto, procura hacerlo con letra de tipo Arial o similar.
+
=== Figuras ===
  
Cuando agrupes varias imágenes en una sola, etiquetalas como a) b), etc, y haz
+
Las figuras pueden ser en color o blanco y negro. Intenta siempre que sea posible crearlas con un programa vectorial como CorelDraw o Inkscape, y añadirlas después como PostScript o pdf. Si insertas imágenes raster en blanco y negro o en escala de grises, disminuye la profundidad de color en consonancia para disminuir su tamaño en disco. Utiliza formatos de compresión sin pérdidas.  
referencia a esta notación en el pie de la figura.
 
  
Para poder cambiar la maquetación del libro con facilidad, no pongas tamaños
+
Si debes añadir texto, usa letra de tipo Arial.  
absolutos a la imagen, sino relativos. Utiliza los comandos \columnwidth para
 
imágenes en una columna (introducidas con \begin{figure}) o \textwidth para
 
imágenes en dos columnas (introducidas con \begin{figure*})
 
  
===Referencias===
+
Cuando agrupes varias imágenes en una sola, etiquetalas como a) b), etc, y haz referencia a esta notación en el pie de la figura.
  
Si la referencia que quieres añadir no está en el fichero de bibliografía en
+
Para poder cambiar la maquetación del libro con facilidad, no pongas tamaños absolutos a la imagen, sino relativos. Utiliza el comando \textwidth.  
formato BibTeX, añádela a éste siguiendo las convenciones del punto anterior.
 
  
Si añades una referencia web en el campo URL del elemento BibTeX, que sea una
+
=== Referencias ===
página que con cierta probabilidad vaya a existir durante un largo periodo de
 
tiempo y garantice que estará ahí para futuros lectores del libro. También es
 
necesario comprobar que el enlace ofrece el articulo o libro de forma legal y
 
libre. Los que estéis en universidad, tened en cuenta que la universidad paga
 
para acceder a las revistas, pero esos contenidos no están libres aunque podáis
 
verlos desde vuestros ordenadores...
 
  
Para añadir enlaces a una página web sin que ésta sea un artículo, la
+
Si la referencia que quieres añadir no está en el fichero de bibliografía en formato BibTeX, añádela a éste siguiendo las convenciones del punto anterior.
referencia puede añadirse dentro del texto como nota al pie, especificando la
 
URL y la información adicional correspondiente
 
  
 +
Si añades una referencia web en el campo URL del elemento BibTeX, que sea una página que con cierta probabilidad vaya a existir durante un largo periodo de tiempo y garantice que estará ahí para futuros lectores del libro. También es necesario comprobar que el enlace ofrece el articulo o libro de forma legal y libre. Añade "Disponible en \url{***}" en la sección "Note" para que aparezca la dirección en la bibliografía.
  
===Citar referencias===
+
Para añadir enlaces a una página web sin que ésta sea un artículo usa el tipo "Misc"
  
Los comandos de cita funcionan de la siguiente forma.:
+
Consulta otras entradas existentes en la bibliografía para ver cómo se usan los tipos anteriores u otros sobre los que tengas dudas.  
  
\cited{key} ==>> Jones et al. (1990)
+
JabRef es un programa libre muy adecuado para la gestión de bibliografías BibTeX
\citet*{key} ==>> Jones, Baker, and Smith (1990)
 
\citet{key} ==>> Jones et al. (1990)
 
\citep*{key} ==>> (Jones, Baker, and Smith, 1990)
 
\citep[ch.~2]{key} ==>> (Jones et al., 1990, ch. 2)
 
\citep[e.g.][]{key} ==>> (e.g. Jones et al., 1990)
 
\citep[e.g.][p.~32]{key} ==>> (e.g. Jones et al., p. 32)
 
\citeauthor{key} ==>> Jones et al.
 
\citeauthor*{key} ==>> Jones, Baker, and Smith
 
\citeyear{key} ==>> 1990
 
  
 +
<br>
  
===Comentarios===
+
=== Comentarios ===
  
Si hay partes que dejas sin escribir o que crees que son mejorables, hazlo
+
Si hay partes que dejas sin escribir o que crees que son mejorables, hazlo saber de forma explícita. Puedes añadir comentarios en el codigo LaTeX, pero también poner llamadas de atención por medio de simples asteriscos (luego es fácil localizar estos con una simple busqueda...).  
saber de forma explícita. Puedes añadir comentarios en el codigo LaTeX, pero
 
también poner llamadas de atención por medio de simples asteriscos (luego es
 
fácil localizar estos con una simple busqueda...).
 
  
Por ejemplo:
+
Por ejemplo:  
  
 
   "De lo anterior se deduce *******creo que esto se puede explicar más detalladamente******** que..."
 
   "De lo anterior se deduce *******creo que esto se puede explicar más detalladamente******** que..."
  
 +
=== Estructura ===
  
===Palabras clave===
+
Utiliza la macro "intro" al inicio del capítulo para añadir una descripción breve de éste, incluyendo información sobré qué se aprenderá tras su lectura y que conocimientos se presuponen. Antes de esto, utiliza la macro "keypoints" para añadir los puntos clave. Separa éstos mediante el comando $\bullet$  
 
 
Para mantener la coherencia, es mas conveniente hacer el índice de términos al
 
final y que esta labor la lleve a cabo una única persona. Para facilitar su
 
trabajo, añade los términos clave de tu capítulo que desees incluir en ese
 
indice, poniéndolos al final de éste en una linea comentada como la siguiente
 
 
 
% MDE, MDT, geomorfometría, pendiente, orientación, índice de convergencia...
 
 
 
 
 
===Estructura===
 
 
 
Utiliza la macro "intro" al inicio del capítulo para añadir una descripción
 
breve de éste, incluyendo información sobré qué se aprenderá tras su lectura y
 
que conocimientos se presuponen. Antes de esto, utiliza la macro "keypoints"
 
para añadir los puntos clave. Separa éstos mediante el comando $\bullet$
 
 
 
Al final del capítulo, usa las macros "keyreferences" y "internet" para añadir
 
referencias clave (3 o 4) y las direcciones de internet relevantes del
 
capítulo. Por ejemplo:
 
 
 
\begin{keyreferences}
 
\item Tomlin, C.D. (1990) Geographic information systems and cartographic modelling.
 
New Jersey, United States: Prentice Hall.
 
\item Berry, J.K. (1993) Beyond Mapping: Concepts, Algorithms, and Issues in GIS.
 
Fort Collins, CO: GIS World, Inc.
 
\end{keyreferences}
 
 
\begin{internet}
 
\item http://www.innovativegis.com/basis/\-Map\-Analysis/\-Default.htm
 
\end{internet}
 
 
 
Puedes consultar los capítulos ya escritos o la sección "Estructura de este
 
libro" para saber más.
 
  
[[Category:Libro SIG]]
+
[[Category:Libro_SIG]]

Revision as of 13:32, 14 December 2010

Volver al índice

Aquí encontraras sugerencias y algunas convenciones utilizadas en el libro.

Conexiones entre palabras

Usa el signo "~" para mantener conectadas las unidades y los valores

"La elevación tiene un rango entre 0~m y 8000~m, como se observa en la figura ~\ref{Fig:ch01:esquema}."

Etiquetado de elementos

Usa las siguientes convenciones para etiquetar elementos:

Tipo Formato Ejemplo
Referencia AutorAñoPublicacion Hengl2004Geoderma
Sección Etiqueta Introduccion
Figura Fig:Codigocapitulo Fig:esquema
Tabla Tabla:Etiqueta Tabla:resumen
Ecuación Eq:Etiqueta Eq:pendiente

No utilices acentos ni eñes en las etiquetas. Sustituye ñ por n o ny.

Figuras

Las figuras pueden ser en color o blanco y negro. Intenta siempre que sea posible crearlas con un programa vectorial como CorelDraw o Inkscape, y añadirlas después como PostScript o pdf. Si insertas imágenes raster en blanco y negro o en escala de grises, disminuye la profundidad de color en consonancia para disminuir su tamaño en disco. Utiliza formatos de compresión sin pérdidas.

Si debes añadir texto, usa letra de tipo Arial.

Cuando agrupes varias imágenes en una sola, etiquetalas como a) b), etc, y haz referencia a esta notación en el pie de la figura.

Para poder cambiar la maquetación del libro con facilidad, no pongas tamaños absolutos a la imagen, sino relativos. Utiliza el comando \textwidth.

Referencias

Si la referencia que quieres añadir no está en el fichero de bibliografía en formato BibTeX, añádela a éste siguiendo las convenciones del punto anterior.

Si añades una referencia web en el campo URL del elemento BibTeX, que sea una página que con cierta probabilidad vaya a existir durante un largo periodo de tiempo y garantice que estará ahí para futuros lectores del libro. También es necesario comprobar que el enlace ofrece el articulo o libro de forma legal y libre. Añade "Disponible en \url{***}" en la sección "Note" para que aparezca la dirección en la bibliografía.

Para añadir enlaces a una página web sin que ésta sea un artículo usa el tipo "Misc"

Consulta otras entradas existentes en la bibliografía para ver cómo se usan los tipos anteriores u otros sobre los que tengas dudas.

JabRef es un programa libre muy adecuado para la gestión de bibliografías BibTeX


Comentarios

Si hay partes que dejas sin escribir o que crees que son mejorables, hazlo saber de forma explícita. Puedes añadir comentarios en el codigo LaTeX, pero también poner llamadas de atención por medio de simples asteriscos (luego es fácil localizar estos con una simple busqueda...).

Por ejemplo:

 "De lo anterior se deduce *******creo que esto se puede explicar más detalladamente******** que..."

Estructura

Utiliza la macro "intro" al inicio del capítulo para añadir una descripción breve de éste, incluyendo información sobré qué se aprenderá tras su lectura y que conocimientos se presuponen. Antes de esto, utiliza la macro "keypoints" para añadir los puntos clave. Separa éstos mediante el comando $\bullet$