[Skiboot] [RFC] Doc: Add support to build OpenPOWER Foundation style documentation from RST

Stewart Smith stewart at linux.vnet.ibm.com
Tue Aug 22 10:51:11 AEST 2017

Jeffrey Scheel <scheel at us.ibm.com> writes:
> I've looked at this more closely and it appears that the deltas in code 
> have exposed some of the original "fragility" I found in the conversion 
> tools.  As such, I've decided to explore and alternative solution.  My 
> current thinking is either to find a way to convert the skibook.tex file 
> to docbook as a self-contained entity or generate the "singlehtml" file 
> and use it.  Either of these routes would eliminate the challenges I've 
> seen in file structure and links.
> Initial look at using pandoc to convert .tex to .xml reveals a gap in link 
> handling.  This could be a configuration problem, but I've not found a 
> solution yet.  Additionally, some of the tables were not handled well.
> A quick use of herold to convert html to docbook, seems to have generated 
> better docbook.  This is the route I will continue to explore next week.
> As such, no further work should be done on the patch.  Thanks for the 
> help,

Hrm... maybe a better approach would be to have a style for Sphinx that
produces OpenPOWER Foundation stylized documentation?

Stewart Smith
OPAL Architect, IBM.

More information about the Skiboot mailing list