After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 352700 - Provide variable chunking depth
Provide variable chunking depth
Status: RESOLVED WONTFIX
Product: yelp-xsl
Classification: Core
Component: DocBook
2.31.x
Other Linux
: Normal normal
: ---
Assigned To: Yelp maintainers
Yelp maintainers
Depends on:
Blocks:
 
 
Reported: 2006-08-24 17:06 UTC by Joachim Noreiko
Modified: 2012-01-19 14:36 UTC
See Also:
GNOME target: ---
GNOME version: ---


Description Joachim Noreiko 2006-08-24 17:06:22 UTC 
Chunk depth can be specified for a whole document with <?yelp:chunk-depth 4?>.

However, user manuals are not homogenous. For example, this is the structure of the gedit manual at time of reporting:

# 1. Introduction
# 2. Getting Started
# 3. Working with Files
# 4. Working with Text
# 5. Finding and Replacing
# 6. Printing
# 7. Programming Features
# 8. Preferences
# 9. Plugins

Most of these top-level sections should remain as one chunk, eg Getting Started.
But some should definitely be split. The section 'Plugins' in particular should be subdivided.

Ideally, the chunk-depth instruction could be specified for individual sections.
Comment 1 Matthew East 2007-01-22 22:55:45 UTC 
This is a Big Deal, please implement it if you can!
Comment 2 Shaun McCance 2012-01-19 14:36:37 UTC 
Way too much work. It would require major rewrites in at least three separate XSLT files. If you care about how your documents are paged, use a paged source format.