Documentation build is broken

Willem Ferguson willemferguson at
Tue Dec 10 05:25:09 UTC 2013

I am not sure where the line 11 of user-manual.txt comes from because 
there is NO info about the style sheet in the .txt file.
What I see from here is that the build is ok (in V8.6.7), but that the 
link from the help menu item in the Subsurface main menu does not work. 
A good test is to see whether the font is serif or sans serif. If its 
serif, then it did NOT find the css style sheet. All text should be sans 

If one looks at
there is possibly a discrepancy between the way that pre-v8.6.6 works 
and those AFTER 8.6.5. I suspect that the instruction for locating the 
stylesheet also differs between these versions, since they are kept in 
different folders in the two systems. If these interpretations are 
indeed correct, it looks like some adaptation of the makefile may be 
warranted, starting with asciidoc --version. But then a working 
formulation for 8.6.5 needs to be found first.
For general info see: 
, about a third of the way down that web page.

By default the css is included in the xhtml that is generated. This is 
the safe position if someone wishes to download a manual from the web. 
The name of the style sheet used is about the 8th line from the top of 
the html code generated and should say compact.css (I will edit this a 
bit for a patch on Friday to clearly indicate the provenance and use of 
this particular css file)

Kind regards,

On 10/12/2013 14:17, Sergey Starosek wrote:
> On Tue, Dec 10, 2013 at 1:50 PM, Dirk Hohndel <dirk at 
> <mailto:dirk at>> wrote:
>     I'm on my phone and can't see the attachment.
>     I built before pushing earlier, but haven't had a chance to apply
>     Willem's latest patch from an hour ago.
>     Is that what you are referring to or are you talking about what's
>     in git?
> It's against current  master 9545745c90874390e1d9ba740061fca9cb20fcdb
>     /D
>     On December 10, 2013 12:47:39 PM Sergey Starosek wrote:
>>     On Mon, Dec 9, 2013 at 5:14 PM, Dirk Hohndel <dirk at
>>     <mailto:dirk at>> wrote:
>>         To heck with this. The -a theme='theme' version works on my
>>         version as
>>         well, so I just pushed a commit that uses that instead. Can
>>         you verify
>>         that this works for you, Sergey?
>>      asciidoc: WARNING: user-manual.txt: line 11: include file not
>>     found: /usr/share/asciidoc/stylesheets/compact_subsurface.css
>>     And font is serif. Need to specify "stylesdir" attribute to make
>>     both default "asciidoc.js" and custom CSS be embedded into HTML.
>>     See attached patch (tested against asciidoc 8.6.5)
>>     Sergey
> _______________________________________________
> subsurface mailing list
> subsurface at

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <>

More information about the subsurface mailing list