diff --git a/README.md b/README.md index bf1c6de..64a4452 100644 --- a/README.md +++ b/README.md @@ -64,6 +64,27 @@ Lo que nos permite Pandoc a la hora de documentar un proyecto es mantener la doc - Las plantillas de Pandoc (o *templates*) - Un buen editor de texto +Instalación de Pandoc +--------------------- + +Los paquetes de Pandoc están disponibles en la [página de descargas del proyecto](http://pandoc.org/installing.html). En el caso de Ubuntu se instala sin más que descargar el paquete y abrirlo con el Centro de Software. + +Instalación de plantillas de Pandoc +----------------------------------- + +Hay muchas plantillas para generar documentación con Pandoc, puestas a disposición de la comunidad. De momento nos hemos limitado a las plantillas del creador de Pandoc: + +``` {bash} +cd +mkdir .pandoc +cd .pandoc +git clone https://github.com/jgm/pandoc-templates templates +``` + +Esto dejará las plantillas en el directorio *~/.pandoc/templates* que es uno de los directorios donde Pandoc busca las plantillas. + +No hay inconveniente en dejar las plantillas en otro directorio, o incluso en el arbol de nuestro proyecto, pero habría que retocar el *makefile* para que Pandoc las encontrara sin problemas. + Chuletario de Pandoc ==================== @@ -203,7 +224,7 @@ Listas #### Listas desordenadas -Los ítems de la lista deben ir marcados con '\*', '+', or '-'. +Los items de la lista deben ir marcados con '\*', '+', or '-'. + example - example @@ -284,8 +305,8 @@ Todo el texto identado cuatro espacios En que me he basado (o copiado si lo prefieres) =============================================== -- En la [guía de usuario de Pandoc](http://pandoc.org/README.html) Importante leérsela para sacarle todo el jugo a esta herramienta +- En la [guia de usuario de Pandoc](http://pandoc.org/README.html) Importante leersela para sacarle todo el jugo a esta herramienta - En la [chuleta de Pandoc](https://github.com/dsanson/Pandoc.tmbundle/blob/master/Support/doc/cheatsheet.markdown) de [David Sanson](https://github.com/dsanson), perfecta para referencia rápida - Para hacer el makefile me he leido varios tutoriales y copiado descaradamente de varios sitios que olvidé apuntar (lo siento) -[1] Ojo por que en el makefile propuesto se especifica el lenguaje, así que la variable del bloque de título no va a tener efecto en este caso. +[1] Ojo por que en el makefile propuesto se especifica el lenguaje, asi que la variable del bloque de título no va a tener efecto en este caso. diff --git a/out/documento.docx b/out/documento.docx index 9f19caf..e33a690 100644 Binary files a/out/documento.docx and b/out/documento.docx differ diff --git a/out/documento.epub b/out/documento.epub index 4a49bff..ebbc7bd 100644 Binary files a/out/documento.epub and b/out/documento.epub differ diff --git a/out/documento.mw b/out/documento.mw index 03df282..ea5815c 100644 --- a/out/documento.mw +++ b/out/documento.mw @@ -52,6 +52,22 @@ Lo que nos permite Pandoc a la hora de documentar un proyecto es mantener la doc * Las plantillas de Pandoc (o ''templates'') * Un buen editor de texto +== Instalación de Pandoc == + +Los paquetes de Pandoc están disponibles en la [http://pandoc.org/installing.html página de descargas del proyecto]. En el caso de Ubuntu se instala sin más que descargar el paquete y abrirlo con el Centro de Software. + +== Instalación de plantillas de Pandoc == + +Hay muchas plantillas para generar documentación con Pandoc, puestas a disposición de la comunidad. De momento nos hemos limitado a las plantillas del creador de Pandoc: + +
cd +mkdir .pandoc +cd .pandoc +git clone https://github.com/jgm/pandoc-templates templates+Esto dejará las plantillas en el directorio ''~/.pandoc/templates'' que es uno de los directorios donde Pandoc busca las plantillas. + +No hay inconveniente en dejar las plantillas en otro directorio, o incluso en el arbol de nuestro proyecto, pero habría que retocar el ''makefile'' para que Pandoc las encontrara sin problemas. + = Chuletario de Pandoc = == Backslash Escapes == @@ -106,7 +122,7 @@ Subescrito con tildes simples, así: H~2~O. Los espacios en el superescrito y el subescrito tienen que ir escapados, p.ej., H~esto\ es \ un\ subescrito~. -== TeX matématico o código incrustado en linea == +== TeX matemático o código incrustado en linea ==
El TeX matemático va entre signos$: $2 + 2$. diff --git a/out/documento.pdf b/out/documento.pdf index e45838d..368c9a6 100644 Binary files a/out/documento.pdf and b/out/documento.pdf differ diff --git a/out/documento.tex b/out/documento.tex index 2b3f897..311711c 100644 --- a/out/documento.tex +++ b/out/documento.tex @@ -175,6 +175,35 @@ instalado?}\label{quuxe9-necesitas-tener-instalado} Un buen editor de texto \end{itemize} +\subsection{Instalación de Pandoc}\label{instalaciuxf3n-de-pandoc} + +Los paquetes de Pandoc están disponibles en la +\href{http://pandoc.org/installing.html}{página de descargas del +proyecto}. En el caso de Ubuntu se instala sin más que descargar el +paquete y abrirlo con el Centro de Software. + +\subsection{Instalación de plantillas de +Pandoc}\label{instalaciuxf3n-de-plantillas-de-pandoc} + +Hay muchas plantillas para generar documentación con Pandoc, puestas a +disposición de la comunidad. De momento nos hemos limitado a las +plantillas del creador de Pandoc: + +\begin{verbatim} +cd +mkdir .pandoc +cd .pandoc +git clone https://github.com/jgm/pandoc-templates templates +\end{verbatim} + +Esto dejará las plantillas en el directorio +\emph{\textasciitilde{}/.pandoc/templates} que es uno de los directorios +donde Pandoc busca las plantillas. + +No hay inconveniente en dejar las plantillas en otro directorio, o +incluso en el arbol de nuestro proyecto, pero habría que retocar el +\emph{makefile} para que Pandoc las encontrara sin problemas. + \section{Chuletario de Pandoc}\label{chuletario-de-pandoc} \subsection{Backslash Escapes}\label{backslash-escapes} @@ -264,8 +293,8 @@ Los espacios en el superescrito y el subescrito tienen que ir escapados, p.ej., H~esto\ es \ un\ subescrito~. \end{verbatim} -\subsection{TeX matématico o código incrustado en -linea}\label{tex-matuxe9matico-o-cuxf3digo-incrustado-en-linea} +\subsection{TeX matemático o código incrustado en +linea}\label{tex-matemuxe1tico-o-cuxf3digo-incrustado-en-linea} \begin{verbatim} El TeX matemático va entre signos$: $2 + 2$. diff --git a/src/documento.md b/src/documento.md index 31dfdc7..8b04c67 100644 --- a/src/documento.md +++ b/src/documento.md @@ -90,6 +90,33 @@ etc) con un simple comando. * Las plantillas de Pandoc (o *templates*) * Un buen editor de texto +## Instalación de Pandoc + +Los paquetes de Pandoc están disponibles en la +[página de descargas del proyecto](http://pandoc.org/installing.html). En +el caso de Ubuntu se instala sin más que descargar el paquete y +abrirlo con el Centro de Software. + +## Instalación de plantillas de Pandoc + +Hay muchas plantillas para generar documentación con Pandoc, puestas a +disposición de la comunidad. De momento nos hemos limitado a las +plantillas del creador de Pandoc: + +~~~~{bash} +cd +mkdir .pandoc +cd .pandoc +git clone https://github.com/jgm/pandoc-templates templates +~~~~ + +Esto dejará las plantillas en el directorio _~/.pandoc/templates_ que +es uno de los directorios donde Pandoc busca las plantillas. + +No hay inconveniente en dejar las plantillas en otro directorio, o +incluso en el arbol de nuestro proyecto, pero habría que retocar el +_makefile_ para que Pandoc las encontrara sin problemas. + # Chuletario de Pandoc @@ -164,7 +191,7 @@ dentro de los bloques HTML se procesa como Markdown Los espacios en el superescrito y el subescrito tienen que ir escapados, p.ej., H~esto\ es \ un\ subescrito~. -## TeX matématico o código incrustado en linea +## TeX matemático o código incrustado en linea El TeX matemático va entre signos$: $2 + 2$.