skip to navigation
skip to content

Not Logged In

sphinxcontrib-recentpages 0.7.1

This sphinx extension provides a new directive which displays recent updated files list.

Introduction

This sphinx extension provides a new directive which displays recent updated files list. If you want to get all page list ordered by mtime, just put recentpages directive as follows:

.. recentpages::

If you want to display recent 3 files only, add num option to the directive:

.. recentpages::
    :num: 3

Install

Use easy_install:

easy_install sphinxcontrib-recentpages

Then add the following line into source/conf.py:

extensions += ['sphinxcontrib.recentpages']

Recentpages on sidebar

Recentpages can be displayed on sidebar.

First, please enable recentpages_sidebar in source/conf.py:

recentpages_sidebar = True

After you enable this, recentpages extension will create a template file 'recentpages.html' in your template path ( '_templates' by default ).

Please make sure 'template_path' property contains at least 1 writable directory if you customize 'template_path'.

Then add 'recentpages.html' to 'html_sidebars' dictionary. For example, add the following line to source/conf.py if you want to add under the default sidebar:

html_sidebars = {'**': ['localtoc.html', 'relations.html', 'sourcelink.html', 'searchbox.html', 'recentpages.html']}

By default, 5 pages are displayed on sidebar. If you want to change the number of pages on the list, please change 'recentpages_sidbar_pages' property:

recentpages_sidebar_pages = 10
 
File Type Py Version Uploaded on Size
sphinxcontrib-recentpages-0.7.1.tar.gz (md5) Source 2012-12-17 8KB
sphinxcontrib_recentpages-0.7.1-py2.7.egg (md5) Python Egg 2.7 2012-12-17 18KB
  • Downloads (All Versions):
  • 25 downloads in the last day
  • 137 downloads in the last week
  • 654 downloads in the last month