<commit_before>Frequently Asked Questions (FAQ)
################################

Here is a summary of the frequently asked questions for pelican.

Is it mandatory to have a configuration file ?
==============================================

No, it's not. Configurations files are just an easy way to configure pelican.
For the basic operations, it's possible to specify options while invoking
pelican with the command line (see `pelican --help` for more informations about
that)

I'm creating my own theme, how to use pygments ?
================================================

Pygment add some classes to the generated content, so the theming of your theme
will be done thanks to a css file. You can have a look to the one proposed by
default `on the project website <http://pygments.org/demo/15101/>`_

How do I create my own theme ?
==============================

Please refer yourself to :ref:`theming-pelican`.

How can I help ?
================

You have different options to help. First, you can use pelican, and report any
idea or problem you have on `the bugtracker
<http://github.com/ametaireau/pelican/issues>`_.

If you want to contribute, please have a look to `the git repository
<https://github.com/ametaireau/pelican/>`_, fork it, add your changes and do
a pull request, I'll review them as soon as possible.

You can also contribute by creating themes, and making the documentation
better.
<commit_msg>add information about mardown in the FAQ<commit_after>Frequently Asked Questions (FAQ)
################################

Here is a summary of the frequently asked questions for pelican.

Is it mandatory to have a configuration file ?
==============================================

No, it's not. Configurations files are just an easy way to configure pelican.
For the basic operations, it's possible to specify options while invoking
pelican with the command line (see `pelican --help` for more informations about
that)

I'm creating my own theme, how to use pygments ?
================================================

Pygment add some classes to the generated content, so the theming of your theme
will be done thanks to a css file. You can have a look to the one proposed by
default `on the project website <http://pygments.org/demo/15101/>`_

How do I create my own theme ?
==============================

Please refer yourself to :ref:`theming-pelican`.

How can I help ?
================

You have different options to help. First, you can use pelican, and report any
idea or problem you have on `the bugtracker
<http://github.com/ametaireau/pelican/issues>`_.

If you want to contribute, please have a look to `the git repository
<https://github.com/ametaireau/pelican/>`_, fork it, add your changes and do
a pull request, I'll review them as soon as possible.

You can also contribute by creating themes, and making the documentation
better.

I want to use markdown, but I got an error
==========================================

Markdown is not a hard dependency for pelican, so you will need to install it
by yourself. You can do so by typing::

    $ (sudo) pip install markdown

In case you don't have pip installed, consider installing it by doing::

    $ (sudo) easy_install pip

{'fraction_non_alphanumeric': 0.17252098228162885, 'fraction_numerical': 0.003108486167236556, 'mean_word_length': 4.808664259927798, 'pattern_counts': {'":': 0, '<': 9, '<?xml version=': 0, '>': 9, 'https://': 2, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '7266116', 'n_tokens_mistral': 837, 'n_tokens_neox': 785, 'n_words': 436}