Bug 32037 - Unify section IDs
Unify section IDs
Status: REOPENED
Product: UCS manual
Classification: Unclassified
Component: General
unspecified
Other Linux
: P5 normal (vote)
: ---
Assigned To: Docu maintainers
:
: 37850 (view as bug list)
Depends on:
Blocks: 38589 30811
  Show dependency treegraph
 
Reported: 2013-07-22 18:48 CEST by Alexander Kläser
Modified: 2018-10-19 08:22 CEST (History)
3 users (show)

See Also:
What kind of report is it?: ---
What type of bug is this?: ---
Who will be affected by this bug?: ---
How will those affected feel about the bug?: ---
User Pain:
Enterprise Customer affected?:
School Customer affected?:
ISV affected?:
Waiting Support:
Ticket number:
Bug group (optional):
Max CVSS v3 score:


Attachments
Diff XML chapter and section IDs (478 bytes, text/plain)
2013-07-23 14:57 CEST, Philipp Hahn
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Alexander Kläser univentionstaff 2013-07-22 18:48:46 CEST
Currently, the URL of the manual (in English and German) is dynamic and changes with each UCS version. In order reference the manual from within UMC, we need a stable, version independent link, e.g.:

  http://docs.univention.de/de/manual
  http://docs.univention.de/en/manual

What about old manual versions? Why can they not be accessed?
Comment 1 Moritz Muehlenhoff univentionstaff 2013-07-23 08:11:41 CEST
Already exists, e.g. http://docs.univention.de/handbuch.html links to the most currentl manual in German.

> What about old manual versions? Why can they not be accessed?

We didn't use Docbook prior to 3.1, so we can't generate a HTMLified version.

The documentation for older releases and related products can be found here:
http://www.univention.de/download-und-support/dokumentation/standarddokumentation/
Comment 2 Alexander Kläser univentionstaff 2013-07-23 11:37:13 CEST
Ok, thanks.
Comment 3 Philipp Hahn univentionstaff 2013-07-23 12:09:24 CEST
There's still an issue with the section id: They are not identical between the German and English version, so for example:
 <http://docs.univention.de/manual-3.1-1.html#introduction:Introduction>
 <http://docs.univention.de/handbuch-3.1-1.html#introduction:Einfuehrung>

It would help to use the English IDs also for the German manual, since than only one set of IDs must be stored.


FYI: This would also help with the olink-database, since it would allow an automatic switchover from German to English when no German manual exists. <http://www.sagehill.net/docbookxsl/OlinkResolving.html#OlinkLanguageFallback>
Comment 4 Philipp Hahn univentionstaff 2013-07-23 14:57:37 CEST
Created attachment 5336 [details]
Diff XML chapter and section IDs

export XML_CATALOG_FILES="../../../doc-common/docbook/catalog.xml"
diff \
  <(xsltproc --xinclude id-check.xsl manual-3.1.xml) \
  <(xsltproc --xinclude id-check.xsl handbuch-3.1.xml)
Comment 5 Philipp Hahn univentionstaff 2015-02-20 09:43:55 CET
*** Bug 37850 has been marked as a duplicate of this bug. ***