Figuras

Contenido

• Figuras simples
  • Demostración
• Figuras múltiples
  • Demostración

Para gestionar figuras en md2tex se utiliza el paquete grapichx (aunque existen otros paquetes) para las figuras simples; para las figuras múltiples se utiliza el paquete subfigure, esto para poner diferentes figuras en un mismo entorno. Para que md2tex mantenga reciprocidad con LaTeX se define una sintaxis para figuras simples y también se define otra sintaxis para figuras múltiples. Se utiliza el entorno figure para presentar tanto figuras simples como múltiples.

Figuras simples

La sintaxis que md2tex define para las figuras simples es la siguiente:

![<caption>, <options...>, <position>](<figure name>)

El código generado por md2tex tendrá la siguiente sintaxis:

\begin{figure}[<position>]
    \centering
    \includegraphics[<options...>]{<figure name>}
    \caption{<caption>}
\end{figure}

A continuación se brinda una explicación acerca de la sintaxis que md2tex exige para las figuras:

• caption: Siempre deberá ír como primer parámetro y es un parámetro obligatorio. En caption usted puede poner una breve descripción de la figura que está mostrando.
• options: Son parámetros opcionales; si usted no los define md2tex tomará valores por defecto para estos parámetros. Puede poner un máximo de 4 opciones, separadas por ,. Las opciones son:

  md2tex	LaTeX	Funcionalidad
  w	width	Ajusta la anchura de la figura.
  h	height	Ajusta la altura de la figura.
  s	scale	Escala las dimensiones de la figura.
  a	angle	Gira la figura según los grados que el usuario le indica.

  La sintaxis para las opciones es la siguiente: <option> = <value>.

• position: La necesidad de este parámetro surge debido a la manera en que LaTeX trata las figuras (LaTeX les llama objetos flotantes). Durante la compilación, LaTeX buscará un lugar en la página adecuado a las dimensiones de la figura (para esto, LaTeX se basa en reglas internas de posicionamiento) y muchas veces ese no es el lugar que el usuario desea mostrar la figura. Por eso que es necesario en la mayoría de los casos, que el usuario indique el lugar donde quiere poner la figura. En md2tex este es un parámetro opcional; por defecto md2tex utiliza !h que en palabras sería: ignore las reglas internas de posicionamiento y ponga la figura mas o menos aquí. La posición de una figura se puede definir de acuerdo a la siguiente tabla:

  md2tex	LaTeX	Posición	Funcionalidad
  h	h	here	Colocar la figura en un espacio que cumpla con las dimensiones de la misma, preferiblemente después del último párrafo.
  t	t	top	Colocar la figura preferiblemente en la parte superior de la página.
  b	b	bottom	Colocar la figura preferiblemente en la parte inferior de la página.
  p	p	page	Colocar la figura preferiblemente en una página aparte (probablemente juntará la figura con otros objetos flotantes, como ser: tablas y ecuaciones).
  o	!	override	Ignore las reglas internas de posicionamiento.

  Puede combinar el parámetro de posicionamiento override con cualquiera de los otros parámetros de posicionamiento.

• figure path: En md2tex se define una carpeta en la cual pdflatex buscará las figuras. Esta carpeta deberá estar dentro de la carpeta latex de su proyecto, por ejemplo: your-project/latex; la carpeta deberá llamarse images. El árbol de directorios de su proyecto deberá ser similar al siguiente:

  your-project/
  ├── test.md
  └── latex/
      ├── images/
      |   └── your-image.png
      └── tex/
          └── test.tex
  

  LaTeX soporta las siguientes extensiones de imagenes: .png, .jpg, .jpeg.
  Al ejecutar md2tex por primera vez, se creará la carpeta images en caso de no estar creada.

  Dentro de la carpeta images puede crear subcarpetas, aunque deberá indicar la ruta exacta (a partir de images) de la figura que quiere mostrar.

Demostración

En esta demostración se incluye texto e imagenes asociadas a ese texto. Para fines de esta demostración, en la carpeta de su proyecto puede crear un archivo con el nombre: test.md.

!--
    cover: default {
        title: Arquitectura Colonial
        author: Anonimo
        date: today
    }
--!

La **arquitectura colonial** es un estilo arquitect'onico de una madre patria que 
se ha incorporado a las construcciones de asentamientos o colonias. Los colonos 
frecuentemente constru'ian asentamientos que sintetizaban la arquitectura de sus 
pa'ises de origen con las caracter'isticas de dise~no de sus nuevas tierras, creando 
dise~nos h'ibridos.  

Durante los diversos per'iodos coloniales -a diferencia de las ciudades europeas 
de la 'epoca que eran una amalgama de estilos, paradigmas e ideales diferentes y 
muchas veces opuestos- las ciudades respondieron a preceptos homogeneizadores y 
ordenadores que expresaban c'anones y principios que pretend'ian instaurar una 
forma de vida y unos mecanismos ordenadores del espacio p'ublico y privado.  

##  Ciudades coloniales en Am'erica

![Ciudad de Cartagena de Indias, w=8cm, h=6cm, oht](cartagena_indias.jpg)
![Ciudad de San Miguel Allende, w=8cm, h=6cm, oht](san_miguel_allende.jpg)
![Ciudad de Cuzco, w=10cm, h=7cm, oht](cuzco.jpg)

Si desea descargar las imagenes, puede encontrarlas aquí.

Ejecute md2tex:

$ ./md2tex test.md

Al interpretar el archivo anterior con md2tex, se generará el siguiente código LaTeX:

\documentclass{article}

\usepackage{graphicx}

\begin{document}
	\title{Arquitectura Colonial}
	\author{Anonimo}
	\date{\today}
	\maketitle
	La \textbf{arquitectura colonial} es un estilo arquitect\'onico de una madre patria que 
	se ha incorporado a las construcciones de asentamientos o colonias. Los colonos 
	frecuentemente constru\'ian asentamientos que sintetizaban la arquitectura de sus 
	pa\'ises de origen con las caracter\'isticas de dise\~no de sus nuevas tierras, creando 
	dise\~nos h\'ibridos.\newline
  
	Durante los diversos per\'iodos coloniales -a diferencia de las ciudades europeas 
	de la \'epoca que eran una amalgama de estilos, paradigmas e ideales diferentes y 
	muchas veces opuestos- las ciudades respondieron a preceptos homogeneizadores y 
	ordenadores que expresaban c\'anones y principios que pretend\'ian instaurar una 
	forma de vida y unos mecanismos ordenadores del espacio p\'ublico y privado.\newline
  

	\subsection*{ Ciudades coloniales en Am\'erica}

	\begin{figure}[!ht]
		\centering
		\includegraphics[width=8cm, height=6cm]{../images/cartagena_indias.jpg}
		\caption{Ciudad de Cartagena de Indias}
	\end{figure}

	\begin{figure}[!ht]
		\centering
		\includegraphics[width=8cm, height=6cm]{../images/san_miguel_allende.jpg}
		\caption{Ciudad de San Miguel Allende}
	\end{figure}

	\begin{figure}[!ht]
		\centering
		\includegraphics[width=10cm, height=7cm]{../images/cuzco.jpg}
		\caption{Ciudad de Cuzco}
	\end{figure}
\end{document}

Vaya a la carpeta latex/tex y compile el código generado con pdflatex:

$ pdflatex test.tex

El archivo PDF generado debe ser similar al siguiente:

• Ver PDF - Demostración Figuras Simples

Figuras múltiples

Las figuras múltiples se implementan para mostrar diferentes figuras en un mismo entorno figure. md2tex incorpora el paquete subfigure en el código generado; LaTeX necesitará este paquete para mostrar diferentes figuras en un mismo objeto flotante.

En md2tex se ha definido la siguiente sintaxis para manejar múltiples figuras:

![{<caption>, <position>}: <subcaption>, <options...>; ...](<figure name>, ...)

La sintaxis del código generado por md2tex es la siguiente:

\begin{figure}[<position>]
	\centering
	\subfigure[<subcaption>]{
		\includegraphics[<options...>]{<figure name>}
	}
	...
	\caption{<caption>}
\end{figure}

• subcaption: Este es el único elemento nuevo introducido en esta sintaxis (los demas se han explicado en el apartado: Figuras simples); sucaption sirve para poner una descripción debajo de cada subfigura.

Demostración

En esta demostración, el árbol de directorios es similar al siguiente:

your-project/
├── test.md
└── latex/
    ├── images/
    |   └── figuras2d/
    |       ├── circulo.png
    |       ├── cuadrado.png
    |       ├── pentagono.png
    |       └── rombo.png
    └── tex/
        └── test.tex

En un nuevo archivo, por ejemplo: test.md; escriba lo siguiente:

# Figuras geom'etricas

En geometr'ia, la forma de un objeto f'isico situado en un espacio, es una descripci'on 
geom'etrica de la parte del espacio ocupado por el objeto, seg'un lo determinado por 
su l'imite exterior y sin tener en cuenta su ubicaci'on y orientaci'on en el espacio, 
el tama~no, y otras propiedades como el color, el contenido y la composici'on del 
material.  

Las formas simples se pueden describir mediante objetos b'asicos de geometr'ia tales 
como un conjunto de dos o m'as puntos, l'ineas rectas, curvas, planos, figuras planas 
_(por ejemplo, un cuadrado o un c'irculo)_, figuras s'olidas _(por ejemplo, el cubo o la esfera)_. 
La mayor'ia de las formas que se encuentran en el mundo real son complejas. Algunas formas son 
tan arbitrarias, como las estructuras de las plantas y las costas, que deben ser analizadas 
mediante la geometr'ia diferencial o los fractales.

## Figuras Planas

![{Figuras geometricas de dos dimensiones, oht}:Cuadrado, w=2.5cm, h=2.5cm; Circulo, w=2.5cm, h=2.5cm; Rombo, s=0.5; Pentagono, s=0.5, a=45](figuras2d/cuadrado.png, figuras2d/circulo.png, figuras2d/rombo.png, figuras2d/pentagono.png) 

Si desea descargar las imagenes, puede encontrarlas aquí.

Ejecute md2tex:

$ ./md2tex test.md

El código LaTeX generado por md2tex es el siguiente:

\documentclass{article}

\usepackage{graphicx}
\usepackage{subfigure}

\begin{document}

	\section*{Figuras geom\'etricas}
	En geometr\'ia, la forma de un objeto f\'isico situado en un espacio, es una descripci\'on 
	geom\'etrica de la parte del espacio ocupado por el objeto, seg\'un lo determinado por 
	su l\'imite exterior y sin tener en cuenta su ubicaci\'on y orientaci\'on en el espacio, 
	el tama\~no, y otras propiedades como el color, el contenido y la composici\'on del 
	material.\newline
  
	Las formas simples se pueden describir mediante objetos b\'asicos de geometr\'ia tales 
	como un conjunto de dos o m\'as puntos, l\'ineas rectas, curvas, planos, figuras planas 
	\textit{(por ejemplo, un cuadrado o un c\'irculo)}, figuras s\'olidas \textit{(por ejemplo, el cubo o la esfera)}. 
	La mayor\'ia de las formas que se encuentran en el mundo real son complejas. Algunas formas son 
	tan arbitrarias, como las estructuras de las plantas y las costas, que deben ser analizadas 
	mediante la geometr\'ia diferencial o los fractales.

	\subsection*{Figuras Planas}

	\begin{figure}[!ht]
		\centering
		\subfigure[Cuadrado]{
			\includegraphics[width=2.5cm, height=2.5cm]{../images/figuras2d/cuadrado.png}
		}
		\subfigure[ Circulo]{
			\includegraphics[width=2.5cm, height=2.5cm]{../images/figuras2d/circulo.png}
		}
		\subfigure[ Rombo]{
			\includegraphics[scale=0.5]{../images/figuras2d/rombo.png}
		}
		\subfigure[ Pentagono]{
			\includegraphics[scale=0.5, angle=45]{../images/figuras2d/pentagono.png}
		}
		\caption{Figuras geometricas de dos dimensiones}
	\end{figure}
\end{document}

Ejecute pdfLaTeX:

$ pdflatex test.tex

Si no hay errores, se generará un archivo PDF como el siguiente:

• Ver PDF - Demostración Figuras Múltiples