This is both and announcement of a fiddly thing that i finally got working, 
and an invitation to participate.

So, in sphinx-contrib, the feed extension has offered an RSS feed ordered 
using the standard docutils date metadata for a good many months now.

:Date: 2001-08-11 13:00:00


 However, this last-updated has not been visible in the human-readable 
generated markup.

Latest versions include a directive to generated an index of pages sorted 
by date and decorated with last-date time. Markup looks like 
this<https://bitbucket.org/birkenfeld/sphinx-contrib/src/b7d7d42524a3/feed/tests/root/index.rst>
:


.. toctree::
    :maxdepth: 2
    :glob:
    :hidden:
    
    *

.. latest::
    :maxdepth: 2
    :glob:

    *

i.e. you create a table of contents as usual to ensure all documents get a 
real ToC entry, but set that to hidden and generate a parallel date-based 
"latest" list, that uses the same lookup logic under the hood. It's not 
designed to be a "blog roll engine" with a waterfall of articles with brief 
snippets etc- we have the serialized HTML builder for that, after all. 
However, it *is *supposed to make it easy to create nice, bloxsom-like 
date-based overviews, such as the excellent Cosma Shalizi 
Notebooks<http://cscs.umich.edu/~crshalizi/notabene/>
.

It works at the moment, though it's definitely the minimum shippable 
product. If anyone knows a more elegant way to do what i've done, as an 
extension-API n00b, feedback/patches/improved tests etc welcome. (And if 
anyone did want to implement a whole blog engine using what I've done - 
well, please let me know how you go.)

Otherwise, enjoy. ;)

Dan

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To view this discussion on the web visit 
https://groups.google.com/d/msg/sphinx-dev/-/I9mZk3Uxw-MJ.
To post to this group, send email to sphinx-dev@googlegroups.com.
To unsubscribe from this group, send email to 
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at 
http://groups.google.com/group/sphinx-dev?hl=en.

Reply via email to