Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Minor fixes to indexes docs [ci skip]
hat tip @felixfontein

Signed-off-by: Chris Warrick <kwpolska@gmail.com>
  • Loading branch information
Kwpolska committed Jun 21, 2015
1 parent cba97c8 commit 287b306
Showing 1 changed file with 12 additions and 11 deletions.
23 changes: 12 additions & 11 deletions docs/manual.txt
Expand Up @@ -905,19 +905,20 @@ Static indexes
``````````````

Nikola uses *static indexes* by default. This means that ``index-1.html`` has
the latest posts, and the newest posts are in ``index-N.html``, where ``N`` is
the highest number. Only the page with the highest number and the main page
(``index-N.html`` and ``index.html``) are rebuilt (the others remain
unchanged). The page that appears when you click *Older posts* on the index
page, ``index-N.html``, might contain **less than 10 posts** if there are not
enough posts to fill up all pages.
the oldest posts, and the newest posts past the first 10 are in
``index-N.html``, where ``N`` is the highest number. Only the page with the
highest number and the main page (``index-N.html`` and ``index.html``) are
rebuilt (the others remain unchanged). The page that appears when you click
*Older posts* on the index page, ``index-N.html``, might contain **less than 10
posts** if there are not enough posts to fill up all pages.

This can be disabled by setting ``INDEXES_STATIC`` to ``False``. In that mode,
``index-1.html`` contains all the newest posts and will always contain 10 posts
(unless you have less than 20). The last page, ``index-N.html``, contains the
oldest posts, and might contain less than 10 posts. This is how many blog
engines and CMSes behave. Note that this will lead to rebuilding all index
pages, which might be a problem for larger blogs (with a lot of index pages).
``index-1.html`` contains all the newest posts past the first 10 and will
always contain 10 posts (unless you have less than 20). The last page,
``index-N.html``, contains the oldest posts, and might contain less than 10
posts. This is how many blog engines and CMSes behave. Note that this will
lead to rebuilding all index pages, which might be a problem for larger blogs
(with a lot of index pages).

Creating a Page
---------------
Expand Down

0 comments on commit 287b306

Please sign in to comment.