Wolfgang, On Sunday, 2016-11-13 10:42:48 +0100, Wolfgang Thämelt wrote:
> ... > In the Bitbucket Wiki HTML this looks like > > <li><a > href="#markdown-header-which-hotkeys-are-available-in-qmapshack">Which > hotkeys are available in QMapShack?</a></li> > ... > Using Rainer Woitok's make.sh HTML mechanism this looks like > > <li><a href="#which-hotkeys-are-available-in-qmapshack">Which hotkeys > are available in QMapShack?</a></li> The first variant is unique to Bitbucket. Even though Bitbucket claims to use Python Markdown plus a few standard Python Markdown extensions, no Python Markdown extension I'm aware of starts local header identif- iers with "markdown-header-". Thus when you run Python Markdown locally all local header identifiers will be created without the "markdown-head- er-" prefix and thus explicit references to these header identifiers in Markdown "(...)[...]" clauses too must be specified without this prefix in order to be resolvable locally. The good thing is that Bitbucket also correctly interprets header ident- ifiers without the "markdown-header-" prefix in Markdown sources, so we can keep the "markdown-header-" prefix out of the Markdown sources in order to satisfy both, users reading the documentation via Bitbucket and users running "make doc" and reading the documentation offline. This is done -- among other things -- by script "DocFix.sh" which is executed when you locally run "make nav" against the repository. So the bottom line is: you can use either variant of header identifiers, provided you run "make nav" afterwards (which you should do anyway). But if you can't run "make nav" yourself, just don't use the "markdown- header-" prefix at all. Sincerely, Rainer ------------------------------------------------------------------------------ Developer Access Program for Intel Xeon Phi Processors Access to Intel Xeon Phi processor-based developer platforms. With one year of Intel Parallel Studio XE. Training and support from Colfax. Order your platform today. http://sdm.link/xeonphi _______________________________________________ Qlandkartegt-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/qlandkartegt-users
