docca
docca copied to clipboard
boostorg
Boost.Book XSLT C++ documentation system
This is part of the effort to make the Boost libraries "modular" for build and consumption. See https://lists.boost.org/Archives/boost/2024/01/255704.php and https://github.com/grafikrobot/boost-b2-modular/blob/b2-modular/README.adoc for more information. This PR depends on the following other...
Example: https://www.boost.org/doc/libs/master/libs/mysql/doc/html/mysql/ref/boost__mysql__metadata_collection_view.html `metadata_collection_view` is defined as a type alias for `boost::span`, where `metadata` is an object defined by MySQL. I'd expect the reference page to only show the type alias,...
In this branch: https://github.com/vinniefalco/url/tree/docca Some very weird things are happening. For example here is the member declaration for `userinfo()`: https://github.com/vinniefalco/url/blob/4a8df7369af8946a56ee8ff88b599b4cc5b3c544/include/boost/url/url_view_base.hpp#L633 And yet it is being rendered as a static member:...
Would it be possible to have an "edit this page" link on every generated doc page and in each page of the exposition? I guess it should link to the...
Inexplicably, some section headers get hyperlinked. I have no idea why. This could be a Quickbook / Boostbook issue. Example: 
For example here ``` template detail::pct_encoded_bnf pct_encoded_bnf( CharSet const& cs, pct_encoded_str& t) noexcept; ``` Currently the workaround is to write ``` template #ifdef BOOST_URL_DOCS __implementation_defined__ #else detail::pct_encoded_bnf #endif pct_encoded_bnf( CharSet...
I am hoping to eventually get a visualization debug option working on the docca build using [xslt-visualizer](https://github.com/evanlenz/xslt-visualizer) (which itself has some pending optimizations that will affect the output, so it's...
There are probably some other commands that can be similarly supported. Like `@bugs`.