Yes, that would be indeed a nice thing to have. I've been dreaming of it and looking around, but didn't yet find anything similar. If I had more time, then I would probably extend my "directory" directive and write it myself: http://atelier.lino-framework.org/api/atelier.sphinxconf.dirtables.html
Luc On 24/04/14 16:38, Neil K wrote: > I have had a good hunt around looking for the ability to define per file > an 'abstract' / 'summary' that I can then have displayed in a toctree > but have come up blank. What I am looking for is something akin to the > autosummary/docstring approach but not quite. Does this exist? Have I > missed it somewhere? Maybe I will have to create my own directive but > thought I would ask first. > > To be clear about what I am looking for I have a outlined an example below. > > Lets say I have a file called white_paper_001.rst that looks like this - > they part being the abstract is defined so that it can be used: > > =============== > White Paper 001 > =============== > > *.. abstract::* > This white paper explains the relationship between X and Y. > > Body text will go here .... > > > In my index.rst I would have something like this - identifying that I > want the abstract included in the listing in much the same way as > the :titlesonly:option tells sphinx to display the titles: > > ============ > White Papers > ============ > > Contents: > > .. toctree:: > :glob: > > *:abstract:* > > > white_papers/* > > > Ideally I would then get something like the following - the key here is > that the abstract is sourced from the file itself rather than keyed in > independently on index.rst: > > *White Papers* > > > > _White Paper 001_ > > This white paper explains the relationship between X and Y. > > > > _White Paper 002_ > > This white paper explains the key concepts around ABC. > > -- > You received this message because you are subscribed to the Google > Groups "sphinx-users" group. > To unsubscribe from this group and stop receiving emails from it, send > an email to [email protected] > <mailto:[email protected]>. > To post to this group, send email to [email protected] > <mailto:[email protected]>. > Visit this group at http://groups.google.com/group/sphinx-users. > For more options, visit https://groups.google.com/d/optout. -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
