There is a need for a clickable ToC for navigating in bigger DocBook
documents. The "Document structure" CSS seems to be fine for this
purpose, but it is rather problematic to use for this because of
GUI-related problems. Basically, you have to go trough this hassle for
a simple ToC-based jumping:

1. View -> Add...-> bottom (or top) set to "Document structure".
   This must be repeated once per opening the document.

2. Enlarge the height of the bottom view by dragging its border.

3. Double-click on the desired ToC line.

4. Decrease the height of the bottom view by dragging its border
   (you don't want the ToC to take any vertical space from the main
   view when you don't "navigate").

Regarding some tricks involved in this process:

- In 3. if you just click instead of double click, XXE may jumps back
  to the document start when the view is later resized in 4, hence
  spoiling what the whole thing was about.

- The view has to be in top or the bottom slot, and must be enlarged
  vertically before the dobule-clicking, because the selected title
  will be at the bottom of the normal view, while you want it to be at
  the top of it. Now if the normal view is vertically small, and then
  after the double-clicking it is enlarged (4.) then the earlier
  bottom line will become the top line (try it to see why).

So it is nor trivial nor convenient to do.

Further notes:

- Simply choosing the "Document structure" under View and then later
  restore it to "DocBook" is not good, as it is *very* slow for larger
  documents. Especially the switching back to "DocBook".

- Putting the "Document structure" view at left or right and just
  always leaving it there is not good, because that CSS wastes
  horizontal space awfully (quite needlessly BTW -- this may could be
  improved), and thus its frame had to be so wide that no horizontal
  space is left for frame of the norma view on a 1280x1024 monitor.
  Not to mention that the selected title will be at the bottom of the
  normal view, and now the earlier explained vertical resizing trick
  can't be applied.

- I know XXE can be customized and maybe this problem can be solved
  with that (I don't know), but a good *out-of-the-box* DocBook
  editing experience would be important. I'm sure most users just want
  to edit their DocBook (or DITA or XHTML) documents, not learn how to
  customize XXE.

-- 
Best regards,
 Daniel Dekany


Reply via email to