Clarify FAQ entry re: need to install Markdown

Folks keep running into this error, which probably signals a need to
change this behavior. After all, it wouldn't be hard for us to detect
what's going on and provide a better error message, such as: "It looks
like you're trying to process Markdown, but the Markdown library is not
currently installed. Please install the Python-Markdown library via 'pip
install markdown'."

Until we implement something akin to the above, this should serve as a
slightly-improved FAQ entry in the interim.
This commit is contained in:
Justin Mayer 2013-10-19 17:20:13 +02:00
commit ae2afa27fc

View file

@ -65,12 +65,13 @@ How do I create my own theme?
Please refer to :ref:`theming-pelican`.
I want to use Markdown, but I got an error.
===========================================
I'm using Markdown and getting ``No valid files found in content`` errors.
==========================================================================
Markdown is not a hard dependency for Pelican, so you will need to explicitly
install it. You can do so by typing the following command, prepending ``sudo``
if permissions require it::
Markdown is not a hard dependency for Pelican, so if you have content in
Markdown format, you will need to explicitly install the Markdown library.
You can do so by typing the following command, prepending ``sudo`` if
permissions require it::
pip install markdown