pelican-plugins/asciidoc_reader/README.rst

AsciiDoc Reader
###############

This plugin allows you to use `AsciiDoc <http://www.methods.co.nz/asciidoc/>`_ 
to write your posts. File extension should be ``.asc``, ``.adoc``, 
or ``.asciidoc``.

Dependency
----------

If you want to use AsciiDoc you need to install it from `source
<http://www.methods.co.nz/asciidoc/INSTALL.html>`_ or use your operating
system's package manager.

**Note**: AsciiDoc does not work with Python 3, so you should be using Python 2.

Settings
--------

========================================  =======================================================
Setting name (followed by default value)  What does it do?
========================================  =======================================================
``ASCIIDOC_OPTIONS = []``                 A list of options to pass to AsciiDoc. See the `manpage
                                          <http://www.methods.co.nz/asciidoc/manpage.html>`_.
``ASCIIDOC_BACKEND = 'html5'``            Backend format for output. See the `documentation 
                                          <http://www.methods.co.nz/asciidoc/userguide.html#X5>`_
                                          for possible values.
========================================  =======================================================

Example file header
-------------------

Following the `example <https://github.com/getpelican/pelican/blob/master/docs/content.rst#file-metadata>`_ in the main pelican documentation:

.. code-block:: none

  = My super title

  :date: 2010-10-03 10:20
  :modified: 2010-10-04 18:40
  :tags: thats, awesome
  :category: yeah
  :slug: my-super-post
  :authors: Alexis Metaireau, Conan Doyle
  :summary: Short version for index and feeds

  == title level 2
    
  and so on...