Portadas

Contenido

• Portada: default
  • Demostración
• Portada: report
  • Demostración

En md2tex se han implementado dos estilos de portada: default y report. Se puede hacer uso de estas portadas a través del parámtero cover. El propósito de las portadas se describe a continuación:

• default: Es una portada de propósito general en la cual se puede especificar parámetros como: un título para el documento, el autor o autores, la fecha de elaboración o entrega del documento; también puede poner un logo.
• report: Esta orientada a un entorno formal, en esta portada se pueden especificar parámetros como ser: logo, nombre de la institución, asignatura, el lugar de ubicación de la institución y también el título del documento, nombre del autor y fecha de redacción.

En la siguiente tabla se muestran los parámetros aceptados por cada tipo de portada:

Los parámetros de la tabla anterior son opcionales (no es necesario que se incluyan todos en la portada), pero para que la portada tenga mejor presentación es recomendable definirlos todos.

La sintaxis para una portada es la siguiente:

!--
    cover: <cover type> {
        <param 1>: <value>
        <param 2>: <value>
        <param n>: <value>
    }
--!

Donde <cover type> puede ser default o report. Los parámetros pueden ser según los sugiere la tabla anterior.

Portada: default

Para la portada default, LaTeX hace uso del comando \maketitle, este comando espera que los valores de title, date y author esten definidos. Los parámetros de author, logo y date pueden tener algunas variantes que se definen a continuación:

• author: Pueden definirse varios autores para el documento, siempre y cuando los nombres de los mismos vayan separados por el caracter &.
• logo: El logo puede ser una imagen .png o .jpg, esta imagen será buscada por el compilador pdfLaTeX en la carpeta images, si la imagen no se encuentra en esa ruta se generará un error de compilación al ejecutar pdfLaTeX.
• date: Puede utilizar la palabra today, esto hará que se muestre la fecha del sistema; sin embargo, puede indicar una fecha manualmente. Por ejemplo: 05-01-21, 05-01-2021 o 5 de enero del 2021.

Demostración

En un archivo de texto (puede ser test.md), escriba lo siguiente:

!--
    cover: default {
        logo: mylogo.png
        title: Leyes de la termodin'amica
        author: Nicolas Sadi Carnot & Rudolf Clausius & William Thompson
        date: 15 de marzo del 1860
    }
--!

Las leyes de la termodin'amica (o los principios de la termodin'amica) describen el 
comportamiento de tres cantidades f'isicas fundamentales, la temperatura, la energ'ia 
y la entrop'ia, que caracterizan a los sistemas termodin'amicos. El t'ermino 
__termodin'amica__ proviene del griego *thermos*, que significa __calor__, y _dynamos_, 
que significa **fuerza**.  

Matem'aticamente, estos principios se describen mediante un conjunto de ecuaciones que 
explican el comportamiento de los sistemas termodin'amicos, definidos como cualquier objeto 
de estudio (desde una mol'ecula o un ser humano, hasta la atm'osfera o el agua hirviendo en 
una cacerola).  

Existen cuatro leyes de la termodin'amica y son cruciales para comprender las leyes f'isicas 
del universo y la imposibilidad de ciertos fen'omenos como el del movimiento perpetuo.

Ejecute md2tex:

$ ./md2tex test.md

El código generado por md2tex es el siguiente:

\documentclass{article}

\usepackage{graphicx}

\begin{document}
	\begin{figure}[!t]
		\centering
		\includegraphics[width=0.2\textwidth]{../images/mylogo.png}
	\end{figure}
	\title{Leyes de la termodin\'amica}
	\author{Nicolas Sadi Carnot \and Rudolf Clausius \and William Thompson}
	\date{15 de marzo del 1860}
	\maketitle
	Las leyes de la termodin\'amica (o los principios de la termodin\'amica) describen el 
	comportamiento de tres cantidades f\'isicas fundamentales, la temperatura, la energ\'ia 
	y la entrop\'ia, que caracterizan a los sistemas termodin\'amicos. El t\'ermino 
	\textbf{termodin\'amica} proviene del griego \textit{thermos}, que significa \textbf{calor}, y \textit{dynamos}, 
	que significa \textbf{fuerza}.\newline
  
	Matem\'aticamente, estos principios se describen mediante un conjunto de ecuaciones que 
	explican el comportamiento de los sistemas termodin\'amicos, definidos como cualquier objeto 
	de estudio (desde una mol\'ecula o un ser humano, hasta la atm\'osfera o el agua hirviendo en 
	una cacerola).\newline
  
	Existen cuatro leyes de la termodin\'amica y son cruciales para comprender las leyes f\'isicas 
	del universo y la imposibilidad de ciertos fen\'omenos como el del movimiento perpetuo.
\end{document}

Como buena práctica de redacción de documentos en LaTeX, los comandos \title{...}, \author{...}, \date{...} y \maketitle deberían ír en el preámbulo¹ del código; sin embargo, debido a limitaciones de md2tex el código para el estilo de portada: default se genera dentro del entorno document.

Ubiquese en la carpeta latex/tex y ejecute pdfLaTeX:

$ pdflatex test.tex

El documento PDF generado es el siguiente:

La información que aparece en el PDF anterior es de caracter demostrativo.

• Ver PDF - Demostración Portada: default

Portada: report

En este tipo de portada, md2tex genera una portada personalizada en la primera página del documento. De igual manera, algunos parámetros son opcionales pero es recomendable que se definan todos. Aquí se introducen tres parámetros adicionales: institution, subject y place. LaTeX hace uso del entorno titlepage para generar una página en blanco no numerada al inicio del documento.

• institution: es el nombre de la institución u organización a la que se dirige el documento.
• subject: esta hace referencia a la materia o asunto que se trata en el documento.
• place: hace referencia al lugar en el que está ubicada la institución a la que se dirige el documento.

Demostración

En un nuevo archivo de texto (puede ser test.md), escriba lo siguiente:

!--
	cover: report {
		logo: logo_unitec.jpg
		institution: Universidad Tecnol'ogica Centroamericana
		title: Herencia y Polimorfismo
		subject: Lenguajes de Programaci'on
		author: 1st Author & 2nd Author
		date: today
		place: San Pedro Sula, Honduras
	}
--!

Desde la línea de comandos, ejecute md2tex:

$ ./md2tex test.md

La salida generada por md2tex es la siguiente:

\documentclass{article}

\usepackage{graphicx}

\begin{document}
	\begin{titlepage}
		\centering
		\includegraphics[width=0.2\textwidth]{../images/logo_unitec.jpg}\par
		\scshape\LARGE Universidad Tecnol\'ogica Centroamericana \par
		\vfill
		\Huge Herencia y Polimorfismo \par
		\vfill
		\LARGE Lenguajes de Programaci\'on \par
		\vfill
		\large Autores \par
		\Large 1st Author  \par
		\Large  2nd Author \par
		\vfill
		\Large \today \par
		\vfill
		\large San Pedro Sula, Honduras \par
		\vfill
	\end{titlepage}
\end{document}

Vaya a la carpeta latex/tex y ejecute pdfLaTeX:

$ pdflatex test.tex

El archivo PDF generado será el siguiente:

• Ver PDF - Demostración Portada: report