https://svn.boost.org/trac10/ticket/1159 <p> All (especially documenters), </p> <p> I seem to be rewriting much of the Boost.Graph documentation as I slowly translate it into quickbook format, and augment it with concepts from my SoC project. However, I've run into a "small-ish" missing feature in quickbook that I might need to do the job correctly: bibliography support. Boost.Graph has a (growing) bibliography of about 60 different references. </p> <p> What I would like to be able to do is something like this... </p> <p> # somewhere in graph.qbk [include bibliography.qbk] </p> <p> The bibliography should contains a set of structured records that define bibliographic entries that we can cite in then documentation proper. It would probably be worthwhile to support a number of different entry types. </p> <p> # book references [bibbook </p> <blockquote> <p> [authors [Aho, A.V.] [Hopcroft J.E.] [Ullman J.D.]] [title Data Structures and Algorithms] [year 1983] [publisher Addison-Wesley] </p> </blockquote> <p> ] </p> <p> # journal articles [bibarticle </p> <blockquote> <p> # ... [journal [title Software - Practice and Experience] [volume 25] </p> </blockquote> <p> [issue 8]] </p> <blockquote> <p> [year 1995] [date Aug] [pages 863-889] </p> </blockquote> <p> ] </p> <p> # conference proceedings [bibproceedings </p> <blockquote> <p> # ... [conference 23rd International Conference on Software Maintenance] [location Paris, France] [year 2007] [date Oct 2-5] </p> </blockquote> <p> ] </p> <p> There are probably others to support (i.e., theses and dissertations). Citations should be easy since they're basically just links. A citation might look something like: </p> <p> [bibref aho_1983_data_structures_and_algorithms] </p> <p> This could generate something like: </p> <p> [&lt;a href="...#..."&gt;Aho'1983&lt;/a&gt;] </p> <p> Although there are a number of different represent references. They could simply be numbers. </p> <p> Does this sound like something that might be useful for quickbook? I was thinking about trying to write it myself, but I'm a little busy between SoC and my narrowing down a dissertation topic. I still might give it a shot, but I don't really know anything about the back-end formatting. </p> <p> Thoughts? Comments? </p> <p> Andrew Sutton asutton@… </p> en-us /htdocs/site/boost.png https://svn.boost.org/trac10/ticket/1159 Trac 1.4.3 Marshall Clow Sun, 19 Aug 2007 15:09:28 GMT https://svn.boost.org/trac10/ticket/1159#comment:1 https://svn.boost.org/trac10/ticket/1159#comment:1 <ul> <li><strong>component</strong> <span class="trac-field-old">None</span> → <span class="trac-field-new">Building Boost</span> </li> </ul> Ticket René Rivera Sun, 19 Aug 2007 15:22:21 GMT https://svn.boost.org/trac10/ticket/1159#comment:2 https://svn.boost.org/trac10/ticket/1159#comment:2 <ul> <li><strong>component</strong> <span class="trac-field-old">Building Boost</span> → <span class="trac-field-new">quickbook</span> </li> </ul> Ticket Joel de Guzman Wed, 09 Apr 2014 01:58:13 GMT https://svn.boost.org/trac10/ticket/1159#comment:3 https://svn.boost.org/trac10/ticket/1159#comment:3 <ul> <li><strong>owner</strong> changed from <span class="trac-author">Joel de Guzman</span> to <span class="trac-author">Daniel James</span> </li> </ul> Ticket