Habilitar el complemento
------------------------

Agrega el complemento en el archivo ``_config.yml`` de Jekyll:

.. code:: yaml

   plugins:
   - jekyll-printing-press

Configurar el complemento
-------------------------

La configuración específica se encuentra dentro de la “llave” ``pandoc``
en el archivo ``_config.yml``:

.. code:: yaml

   pandoc:
     # La configuración empieza aquí

Usar Pandoc para generar páginas web
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Para reemplazar ``kramdown`` como el procesador de Markdown por defecto
de Jekyll:

.. code:: yaml

   markdown: Pandoc

El contenido escrito en Markdown del sitio Jekyll será procesado primero
por Liquid (a menos que lo deshabilites) y luego generado como HTML5
utilizando el formato de salida de Pandoc correspondiente.

El formato de salida tiene opciones que puedes configurar más adelante.

Formatos y opciones
~~~~~~~~~~~~~~~~~~~

Las opciones de Pandoc pueden ser configuradas en formato YAML en la
configuración de Jekyll. Puedes usar *snake_case*\  [1]_ o
*kebab-case*\  [2]_ para nombrar las opciones.

Para más información sobre las opciones y sus valores posibles, puedes
consultar la `documentación de Pandoc (en
inglés) <https://pandoc.org/MANUAL.html#options>`__.

Agrega la llave ``options`` al archivo de configuración.

.. code:: yaml

   pandoc:
     options:

Luego, una llave para cada formato de salida.

.. code:: yaml

   pandoc:
     options:
       html5:
       pdf:
       epub:

Cada formato contendrá opciones y sus valores.

.. code:: yaml

   pandoc:
     options:
       html5:
         table-of-contents: true
         toc-depth: 3
       pdf:
         variable:
         - documentclass=book
         - papersize=a5
       epub: true

Si no es necesario agregar opciones a un formato, puedes activarlo
asignándole un valor ``true`` (verdadero, encendido), como en ``epub``
en el ejemplo.

Algunas opciones no necesitan un valor por lo que también pueden
activarse con un valor ``true``. Otras necesitan un valor, como
``toc-depth`` para ``html5``, o aceptan una lista de valores, como
``variable`` en ``pdf``.

La lista de opciones y valores puede ser tan corta o tan larga como la
necesites. Cualquier opción soportada por Pandoc es aceptada.

Opciones para la publicación del sitio
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Cuando activas Pandoc para generar las páginas HTML, puedes cambiar sus
opciones con el formato ``html5``.

.. code:: yaml

   pandoc:
     options:
       html5:
         # Las opciones de páginas web van aquí

Opciones comunes
^^^^^^^^^^^^^^^^

Para compartir opciones entre distintos formatos, puedes usar el formato
especial ``common``. Las opciones dentro de ``common`` están disponibles
en todos los formatos.

En este ejemplo, los tres formatos tienen un índice, pero sólo HTML5
produce uno que incluye los títulos de tercer nivel.

.. code:: yaml

   pandoc:
     options:
       common:
         table-of-contents: true
       html5:
         toc-depth: 3
       pdf:
         variable:
         - documentclass=book
         - papersize=a5
       epub: true

Deshabilitar o cambiar opciones comunes
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Si necesitas deshabilitar una opción en un formato específico, pero
mantenerla para los demás, cambia su valor a ``false`` (falso, apagado).

.. code:: yaml

   pandoc:
     options:
       common:
         table-of-contents: true
       html5:
         toc-depth: 3
       pdf:
         variable:
         - documentclass=book
         - papersize=a5
       epub:
         table-of-contents: false

Ahora solo ``html5`` y ``pdf`` tienen índices y ``epub`` no.

El mismo funcionamiento aplica para cambiar un valor:

.. code:: yaml

   pandoc:
     options:
       common:
         table-of-contents: true
         toc-depth: 3
       html5:
         toc-depth: 4
       pdf:
         variable:
         - documentclass=book
         - papersize=a5
       epub: true

Ahora todos los formatos tienen un índice con títulos de tercer nivel,
exceptuando ``html5`` que incluye los de cuarto nivel.

.. [1]
   Minúsculas y guión bajo para separar palabras.

.. [2]
   Minúsculas y guión medio para separar palabras.