Documentation build is broken
willemferguson at zoology.up.ac.za
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)
On 10/12/2013 14:17, Sergey Starosek wrote:
> On Tue, Dec 10, 2013 at 1:50 PM, Dirk Hohndel <dirk at hohndel.org
> <mailto:dirk at hohndel.org>> 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
> On December 10, 2013 12:47:39 PM Sergey Starosek wrote:
>> On Mon, Dec 9, 2013 at 5:14 PM, Dirk Hohndel <dirk at hohndel.org
>> <mailto:dirk at hohndel.org>> 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)
> subsurface mailing list
> subsurface at hohndel.org
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the subsurface