From: Attila T. <att...@gm...> - 2011-06-22 11:44:00
|
Hello, I would like to know if it is possible make definitions in definition lists implicit hyperlink targets automatically somehow. Eg. instead of: --------------------------------------------------------------------------- _`considerWarningAsError` When set to non-zero, show error message instead of confirmation dialog. chechEntryMaximumValue Together with considerWarningAsError_ blah. --------------------------------------------------------------------------- I would like to write this --------------------------------------------------------------------------- considerWarningAsError When set to non-zero, show error message instead of confirmation dialog. chechEntryMaximumValue Together with considerWarningAsError_ blah. --------------------------------------------------------------------------- i.e. without explicit markup in the first line (definition) for "considerWarningAsError". Is this possible? If not, how should I make it possible? Thanks -- Attila |
From: Guenter M. <mi...@us...> - 2011-06-23 07:50:02
|
On 2011-06-22, Attila Tajti wrote: > Hello, > I would like to know if it is possible make definitions in definition > lists implicit hyperlink targets automatically somehow. Eg. instead of: > --------------------------------------------------------------------------- > _`considerWarningAsError` > When set to non-zero, show error message instead of confirmation > dialog. > chechEntryMaximumValue > Together with considerWarningAsError_ blah. > --------------------------------------------------------------------------- > I would like to write this > --------------------------------------------------------------------------- > considerWarningAsError > When set to non-zero, show error message instead of confirmation > dialog. > chechEntryMaximumValue > Together with considerWarningAsError_ blah. > --------------------------------------------------------------------------- > i.e. without explicit markup in the first line (definition) for > "considerWarningAsError". > Is this possible? If not, how should I make it possible? This is currently not supported. To achieve it, there are several ways, amongst them: a) write and use a pre-processor script that adds the explicit markup before passing the result to Docutils. b) write a "transform" that traverses the doctree after parsing and adds the hypertargets to the node. Method a) is the quick and dirty one - giving fast results without the need to understand all of the Docutils interna. Together with a custom "front-end", it could be used with the same ease as the standard front-ends. Method b) is "the right way", which, when done well, might even be added to Docutils. However, it requires reading and understanding the Doctutils developer documentation, looking at the source of other "transforms" and at the places where these transforms are called. Günter |