Skip to content

Commit b260375

Browse files
committedSep 18, 2016
Clarify 'stories' in manual and add links to theming
Signed-off-by: Chris Warrick <kwpolska@gmail.com>
1 parent 2e54807 commit b260375

File tree

1 file changed

+19
-5
lines changed

1 file changed

+19
-5
lines changed
 

‎docs/manual.txt

+19-5
Original file line numberDiff line numberDiff line change
@@ -815,8 +815,8 @@ There are multiple configuration variables dedicated to each of the three taxono
815815
* ``HIDDEN_TAGS``. ``HIDDEN_CATEGORIES`` to make some tags/categories invisible in lists
816816
* ``POSTS_SECTION_FROM_META`` to use ``.. section:`` in posts instead of inferring paths from paths
817817

818-
Creating a Page
819-
---------------
818+
Creating a Page (Story)
819+
-----------------------
820820

821821
Pages are the same as posts, except that:
822822

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

834+
In some places (including default directories and templates), pages are called
835+
*stories* for historic reasons. Both are synonyms for the same thing: pages
836+
that are not blog posts.
837+
834838
Supported input formats
835839
-----------------------
836840

@@ -1175,7 +1179,7 @@ CSS tweaking
11751179
.. _LESS: http://lesscss.org/
11761180
.. _Sass: http://sass-lang.com/
11771181

1178-
Template tweaking
1182+
Template tweaking and creating themes
11791183
If you really want to change the pages radically, you will want to do a
11801184
`custom theme <theming.html>`__.
11811185

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

1318-
Getting More Themes
1319-
-------------------
1322+
Custom Themes
1323+
-------------
1324+
1325+
If you prefer to have a custom appearance for your site, and modifying CSS
1326+
files and settings (see `Customizing Your Site`_ for details) is not enough,
1327+
you can create your own theme. See the :doc:`theming` and
1328+
:doc:`creating-a-theme` for more details. You can put them in a ``themes/``
1329+
folder and set ``THEME`` to the directory name. You can also put them in
1330+
directories listed in the ``EXTRA_THEMES_DIRS`` configuration variable.
1331+
1332+
Getting Extra Themes
1333+
--------------------
13201334

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

0 commit comments

Comments
 (0)
Please sign in to comment.