Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Clarify 'stories' in manual and add links to theming
Signed-off-by: Chris Warrick <kwpolska@gmail.com>
  • Loading branch information
Kwpolska committed Sep 18, 2016
1 parent 2e54807 commit b260375
Showing 1 changed file with 19 additions and 5 deletions.
24 changes: 19 additions & 5 deletions docs/manual.txt
Expand Up @@ -815,8 +815,8 @@ There are multiple configuration variables dedicated to each of the three taxono
* ``HIDDEN_TAGS``. ``HIDDEN_CATEGORIES`` to make some tags/categories invisible in lists
* ``POSTS_SECTION_FROM_META`` to use ``.. section:`` in posts instead of inferring paths from paths

Creating a Page
---------------
Creating a Page (Story)
-----------------------

Pages are the same as posts, except that:

Expand All @@ -831,6 +831,10 @@ You can create the page's files manually or use the ``new_post`` command
with the ``-p`` option, which will place the files in the folder that
has ``use_in_feed`` set to False.

In some places (including default directories and templates), pages are called
*stories* for historic reasons. Both are synonyms for the same thing: pages
that are not blog posts.

Supported input formats
-----------------------

Expand Down Expand Up @@ -1175,7 +1179,7 @@ CSS tweaking
.. _LESS: http://lesscss.org/
.. _Sass: http://sass-lang.com/

Template tweaking
Template tweaking and creating themes
If you really want to change the pages radically, you will want to do a
`custom theme <theming.html>`__.

Expand Down Expand Up @@ -1315,8 +1319,18 @@ change the FILES_FOLDERS option:
# FILES_FOLDERS = {'files': '' }
# Which means copy 'files' into 'output'

Getting More Themes
-------------------
Custom Themes
-------------

If you prefer to have a custom appearance for your site, and modifying CSS
files and settings (see `Customizing Your Site`_ for details) is not enough,
you can create your own theme. See the :doc:`theming` and
:doc:`creating-a-theme` for more details. You can put them in a ``themes/``
folder and set ``THEME`` to the directory name. You can also put them in
directories listed in the ``EXTRA_THEMES_DIRS`` configuration variable.

Getting Extra Themes
--------------------

There are a few themes for Nikola. They are available at
the `Themes Index <https://themes.getnikola.com/>`_.
Expand Down

0 comments on commit b260375

Please sign in to comment.