Adds more documentation for --write-selected.

I confess I tried just about every combination of generated file or `md` file before finally getting this right. An example would have helped me tremendously and so I've put an example in here. I also struggled to find this (who looks in settings for details about generation?) so I added a reference from the quickstart page so people can find it more easily in the settings.
This commit is contained in:
Michael Lissner 2014-10-09 12:23:59 -07:00
commit e43aadd545
2 changed files with 10 additions and 0 deletions

View file

@ -56,6 +56,9 @@ Your site has now been generated inside the ``output`` directory. (You may see a
warning related to feeds, but that is normal when developing locally and can be
ignored for now.)
To quickly iterate a single file while working on it, you can generate only a
single file. See: :ref:`writing_only_selected_content`.
Preview your site
-----------------

View file

@ -811,6 +811,13 @@ on the command line using the ``--write-selected`` option, which
accepts a comma-separated list of output file paths. By default this
list is empty, so all output is written.
An example of doing this might be:
pelican --write-selected output/posts/2014/10/08/in-re-nsl/index.html
You can use the output of the ``--debug`` flag to determine the correct file
names to provide to the ``--write-selected`` flag.
Example settings
================