[ docbook-Feature Requests-413984 ] More useful Q&A anchors

[<no...@so...>]

Feature Requests item #413984, was updated on 2001-04-05 05:53
You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=373750&aid=413984&group_id=21935

Category: DocBook DSSSL
Group: Next Release (example)
>Status: Closed
Priority: 5
Submitted By: Nobody/Anonymous (nobody)
Assigned to: Norman Walsh (nwalsh)
Summary: More useful Q&A anchors

Initial Comment:
Submitted by: Nik Clayton <ni...@fr...>

I submitted the man CGI link stuff as well.

Anyway.  The default way to create anchors in the HTML
output is to use the all-element-number function.  This
is OK, but suboptimal.  As elements are added or
removed the question IDs will change.

This replacement for generate-anchor special cases
questions, and uses the question-answer-label function
to generate the anchor.  The generated anchor is easy
to understand, and is more stable (assume questions are
only added to the end of any existing questions).

It will probably fail if the document resets question
numbering part way through the document.  Perhaps this
functionality should be hidden behind a flag?

(define (generate-anchor #!optional (nd
(current-node)))
  (cond
    ((equal? (gi nd) (normalize "question"))
      (string-append "Q" (question-answer-label)))
    (else
      (string-append "AEN" (number->string
(all-element-number nd))))))


----------------------------------------------------------------------

>Comment By: Norman Walsh (nwalsh)
Date: 2001-04-24 04:43

Message:
Logged In: YES 
user_id=81663

The right way to improve the anchors is to put IDs on the
qandaentrys.

This approach is nearly as fragile as the current approach,
since adding a new question would interrupt the numbering
and it has the additional disadvantage that it relies on
question labels being unique and they are by no means
gauranteed to be so.

I think this makes sense as a local customization for
documents that are known to have unique question numbers.


----------------------------------------------------------------------

You can respond by visiting: 
http://sourceforge.net/tracker/?func=detail&atid=373750&aid=413984&group_id=21935