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

Release history Release notifications

This version
History Node


History Node


History Node


History Node


Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
sphinxcontrib_recentpages-0.7.1-py2.7.egg (19.1 kB) Copy SHA256 hash SHA256 Egg 2.7 Dec 17, 2012
sphinxcontrib-recentpages-0.7.1.tar.gz (8.3 kB) Copy SHA256 hash SHA256 Source None Dec 17, 2012

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page