diff --git a/README.md b/README.md index 6862584..d074431 100644 --- a/README.md +++ b/README.md @@ -48,6 +48,13 @@ Si quieres cambiar el nombre del fichero de salida (*documento*) tendrás que ed Otras líneas que puedes tocar en el makefile son las que especifican el idioma y los tipos de letra usados. +¿Qué es Pandoc? +=============== + +Como explican en \[http://pandoc.org\], Pandoc es una librería en Haskell para hacer conversión de documentos de un formato markup a otro. Y también es una herramienta de terminal de comandos que usa esa librería. + +Lo que nos permite Pandoc a la hora de documentar un proyecto es mantener la documentación en un formato abierto y sencillo (markdown) y generar salidas en distintos formatos (pdf, mediawiki, epub, html, etc) con un simple comando. + ¿Qué necesitas tener instalado? =============================== @@ -74,15 +81,15 @@ Es una forma rápida de indicar el título el autor o autores y la fecha. Tiene % autor(es) (separados por :) % fecha -Alternativamente se puede usar un bloque de título mucho más completo mediante el formato [YAML](https://en.wikipedia.org/wiki/YAML), especificando variables. No puede usarse simultáneamente con el anterior, hay que escoger entre los dos estilos. +Alternativamente se puede usar otro estilo para el bloque de título, mucho más completo, en formato [YAML](https://en.wikipedia.org/wiki/YAML), especificando variables. No puede usarse simultáneamente con el anterior, hay que escoger entre los dos estilos. Se pueden especificar todo tipo de variables [1]. --- title: Título author: - - Autor Uno - - Otro autor + - Autor Uno + - Otro autor tags: [nothing, nothingness] date: enero-2016 lang: es-ES @@ -281,4 +288,4 @@ En que me he basado (o copiado si lo prefieres) - 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 se especifica el lenguaje, asi 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 a2816dd..b7add28 100644 Binary files a/out/documento.docx and b/out/documento.docx differ diff --git a/out/documento.epub b/out/documento.epub index 118362a..ed03b1f 100644 Binary files a/out/documento.epub and b/out/documento.epub differ diff --git a/out/documento.mw b/out/documento.mw index 1d656a9..ab5cd22 100644 --- a/out/documento.mw +++ b/out/documento.mw @@ -38,6 +38,12 @@ Si quieres cambiar el nombre del fichero de salida (''documento'') tendrás que 
target  := documento
Otras líneas que puedes tocar en el makefile son las que especifican el idioma y los tipos de letra usados. += ¿Qué es Pandoc? = + +Como explican en [http://pandoc.org], Pandoc es una librería en Haskell para hacer conversión de documentos de un formato markup a otro. Y también es una herramienta de terminal de comandos que usa esa librería. + +Lo que nos permite Pandoc a la hora de documentar un proyecto es mantener la documentación en un formato abierto y sencillo (markdown) y generar salidas en distintos formatos (pdf, mediawiki, epub, html, etc) con un simple comando. + = ¿Qué necesitas tener instalado? = * Pandoc @@ -59,16 +65,16 @@ Es una forma rápida de indicar el título el autor o autores y la fecha. Tiene 
% título
 % autor(es) (separados por :)
 % fecha
-Alternativamente se puede usar un bloque de título mucho más completo mediante el formato [https://en.wikipedia.org/wiki/YAML YAML], especificando variables. No puede usarse simultáneamente con el anterior, hay que escoger entre los dos estilos. +Alternativamente se puede usar otro estilo para el bloque de título, mucho más completo, en formato [https://en.wikipedia.org/wiki/YAML YAML], especificando variables. No puede usarse simultáneamente con el anterior, hay que escoger entre los dos estilos. -Se pueden especificar todo tipo de variables Ojo por que en el makefile se especifica el lenguaje, asi que la variable del bloque de título no va a tener efecto en este caso. +Se pueden especificar todo tipo de variables 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. . 
---
 title: Título
 author:
-- Autor Uno <autor.uno@gmail.com>
-- Otro autor <otroautor@gmail.com>
+- Autor Uno <autor.uno@correo.com>
+- Otro autor <otroautor@correo.com>
 tags: [nothing, nothingness]
 date: enero-2016
 lang: es-ES
diff --git a/out/documento.pdf b/out/documento.pdf
index 883c5b2..a66e335 100644
Binary files a/out/documento.pdf and b/out/documento.pdf differ
diff --git a/out/documento.tex b/out/documento.tex
index 1890615..b969fb8 100644
--- a/out/documento.tex
+++ b/out/documento.tex
@@ -147,6 +147,18 @@ target  := documento
 Otras líneas que puedes tocar en el makefile son las que especifican el
 idioma y los tipos de letra usados.
 
+\section{¿Qué es Pandoc?}\label{quuxe9-es-pandoc}
+
+Como explican en {[}http://pandoc.org{]}, Pandoc es una librería en
+Haskell para hacer conversión de documentos de un formato markup a otro.
+Y también es una herramienta de terminal de comandos que usa esa
+librería.
+
+Lo que nos permite Pandoc a la hora de documentar un proyecto es
+mantener la documentación en un formato abierto y sencillo (markdown) y
+generar salidas en distintos formatos (pdf, mediawiki, epub, html, etc)
+con un simple comando.
+
 \section{¿Qué necesitas tener
 instalado?}\label{quuxe9-necesitas-tener-instalado}
 
@@ -184,21 +196,22 @@ Tiene que ir al principio del documento
 % fecha
 \end{verbatim}
 
-Alternativamente se puede usar un bloque de título mucho más completo
-mediante el formato \href{https://en.wikipedia.org/wiki/YAML}{YAML},
-especificando variables. No puede usarse simultáneamente con el
-anterior, hay que escoger entre los dos estilos.
+Alternativamente se puede usar otro estilo para el bloque de título,
+mucho más completo, en formato
+\href{https://en.wikipedia.org/wiki/YAML}{YAML}, especificando
+variables. No puede usarse simultáneamente con el anterior, hay que
+escoger entre los dos estilos.
 
 Se pueden especificar todo tipo de variables \footnote{Ojo por que en el
-  makefile se especifica el lenguaje, asi que la variable del bloque de
-  título no va a tener efecto en este caso.}.
+  makefile propuesto se especifica el lenguaje, asi que la variable del
+  bloque de título no va a tener efecto en este caso.}.
 
 \begin{verbatim}
 ---
 title: Título
 author:
-- Autor Uno 
-- Otro autor 
+- Autor Uno 
+- Otro autor 
 tags: [nothing, nothingness]
 date: enero-2016
 lang: es-ES
diff --git a/src/documento.md b/src/documento.md
index 66a0522..30e83e8 100644
--- a/src/documento.md
+++ b/src/documento.md
@@ -4,15 +4,13 @@ author:
 - Sergio Alvariño 
 tags: [Pandoc, Documentación, makefile, git]
 date: abril-2016
-lang: gl-ES
+lang: es-ES
 abstract: |
   Una chuleta para usar Pandoc, copiado descaradamente de varios sitios de internet.
   
   Solo para referencia rápida y personal.
 ---
 
-
-
 # ¿Cómo usar esto?
 
 ## Muy rápido
@@ -72,6 +70,18 @@ tendrás que editar el makefile y cambiar la línea:
 Otras líneas que puedes tocar en el makefile son las que especifican
 el idioma y los tipos de letra usados.
 
+# ¿Qué es Pandoc?
+
+Como explican en [http://pandoc.org], Pandoc es una librería en
+Haskell para hacer conversión de documentos de un formato markup a
+otro. Y también es una herramienta de terminal de comandos que usa esa
+librería.
+
+Lo que nos permite Pandoc a la hora de documentar un proyecto es
+mantener la documentación en un formato abierto y sencillo (markdown)
+y generar salidas en distintos formatos (pdf, mediawiki, epub, html,
+etc) con un simple comando.
+
 # ¿Qué necesitas tener instalado?
 
 * Pandoc
@@ -101,19 +111,20 @@ fecha. Tiene que ir al principio del documento
     % autor(es) (separados por :)
     % fecha
 
-Alternativamente se puede usar un bloque de título mucho más completo
-mediante el formato [YAML](https://en.wikipedia.org/wiki/YAML),
-especificando variables. No puede usarse simultáneamente con el anterior, hay que escoger
-entre los dos estilos.
+Alternativamente se puede usar otro estilo para el bloque de título,
+mucho más completo, en formato
+[YAML](https://en.wikipedia.org/wiki/YAML), especificando
+variables. No puede usarse simultáneamente con el anterior, hay que
+escoger entre los dos estilos.
 
 Se pueden especificar todo tipo de variables
-^[Ojo por que en el makefile se especifica el lenguaje, asi que la variable del bloque de título no va a tener efecto en este caso.].
+^[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.].
 
     ---
     title: Título
     author:
-    - Autor Uno 
-    - Otro autor 
+    - Autor Uno 
+    - Otro autor 
     tags: [nothing, nothingness]
     date: enero-2016
     lang: es-ES