Bug 19187 - Stichwortindex für UCS Handbuch
Stichwortindex für UCS Handbuch
Status: REOPENED
Product: UCS manual
Classification: Unclassified
Component: General
unspecified
Other Linux
: P5 enhancement (vote)
: ---
Assigned To: Docu maintainers
:
Depends on:
Blocks:
  Show dependency treegraph
 
Reported: 2010-08-02 11:20 CEST by Nico Gulden
Modified: 2015-05-28 15:53 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:
Flags outvoted (downgraded) after PO Review:
Ticket number:
Bug group (optional):
Max CVSS v3 score:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Nico Gulden univentionstaff 2010-08-02 11:20:28 CEST

    
Comment 1 Nico Gulden univentionstaff 2010-08-02 11:29:26 CEST
Ein Stichwortindex im UCS Handbuch ist aus meiner Sicht hilfreich, um konkrete Anhaltspunkte z.B. zum Thema Hook-Scripte, die im Handbuch verteilt sind, zu haben.
Comment 2 Moritz Muehlenhoff univentionstaff 2012-12-13 09:45:45 CET
Das ist nicht geplant, das Handbuch wurde zu 3.0 von der Struktur her deutlich überarbeitet und ggf. kann in der Dokumentation gesucht werden.
Comment 3 Philipp Hahn univentionstaff 2013-03-25 09:40:49 CET
Bei einer Schulung wurde angemerkt, daß <quote>es ein Unding sei, heutzutage noch ein Handbuch ohne Index herauszugeben.</quote>

Es gibt durchaus auch IT-Personen, die ein gedrucktes Handbuch vorziehen.
Und eine Volltextsuche ist auch kein Ersatz für einen vom Autorenteam ordentlich gepflegten Index.

In DocBook ist das technisch recht einfach umzusetzen, der Hauptaufwand liegt natürlich darin, die richtigen Begriffe und Stellen zu finden.

Bonus-Punkte für einen zweiten Index der UCR-Variablen.

<http://www.docbook.org/tdg/en/html/indexterm.html>
<http://www.docbook.org/tdg/en/html/index.html>

Da ich selber privat auch gerade ein Handbuch mit DB erstellt habe, hier eine kleine Anmerkung, um einen Bug im XSL zu vermeiden:
Man sollte derzeit den <indexterm> nicht nach einem <section><title/> platzieren, sondern innerhalb des <title>-Elements, also
  <section id="..."><title>...<indexterm><primary>...</primary></indexterm></title>...</section>
Ansonsten platziert das XSL nach dem <title/> ein leeres <fo:wrap/>-Element das als leerer Absatz gilt. Das macht das "keey-with-next"-Verhalten des Titels kaputt, weshalb dann gerne der Titel auf der vorherigen Seite ganz unten steht und der Absatz dazu dann erst auf der nächsten Seite oben steht.
Comment 4 Stefan Gohmann univentionstaff 2014-01-06 10:21:08 CET
Wurde erneut angemerkt: Ticket #2013112021003518. Gleicher Kunde wie bei Comment #3.

Ich denke wir sollten das zu einem der nächsten Releases umsetzen.
Comment 6 Stefan Gohmann univentionstaff 2015-05-28 15:53:16 CEST
Thanks, as discussed, we won't implement it in the next months.