Skip to main content


Project description

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


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


Use easy_install:

easy_install sphinxcontrib-recentpages

Then add the following line into source/

extensions += ['sphinxcontrib.recentpages']

Recentpages on sidebar

Recentpages can be displayed on sidebar.

First, please enable recentpages_sidebar in source/

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/ 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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for sphinxcontrib-recentpages, version 0.7.1
Filename, size File type Python version Upload date Hashes
Filename, size sphinxcontrib_recentpages-0.7.1-py2.7.egg (19.1 kB) File type Egg Python version 2.7 Upload date Hashes View
Filename, size sphinxcontrib-recentpages-0.7.1.tar.gz (8.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page