RPC bug: using built-in debug mode instead of my own debug functions
[ikiwiki] / doc / bugs / linkmap_displays_underscore_escapes.mdwn
1 [[!template id=gitbranch branch=chrysn/linkmapenhancement author="[[chrysn]]"]]
2
3 [[ikiwiki/directive/linkmap]]s display the file name instead of the pagetitle, showing unsightly underscore escapes and underscores instead of blanks to users.
4
5 the attached [[!taglink patch]] fixes this; from its commit message:
6
7     display the pagetitle() in linkmaps
8     
9     without this patch, linkmaps display underscores and underscore escape
10     sequences in the rendered output.
11     
12     this introduces a pageescape function, which invoces pagetitle() to get
13     rid of underscore escapes and wraps the resulting utf8 string
14     appropriately for inclusion in a dot file (using dot's html encoding
15     because it can represent the '\"' dyad properly, and because it doesn't
16     need special-casing of newlines).
17
18 the output will look much better (at least in my wikis) with the "[[bugs/pagetitle function does not respect meta titles]]" issue fixed.
19
20 > [[Looks good to me|users/smcv/ready]].
21 >
22 > I don't think it's correct for `pagetitle()` to output `\[[!meta title]]`
23 > though, as discussed on the linked bug: it appears in an assortment of
24 > contexts where the full formal title of the page seems inappropriate.
25 > If you want linkmap to use `\[[!meta title]]`, I think it would be
26 > better to give it a `show` parameter, like `\[[!map]]` has?
27 > --[[smcv]]
28
29 >> sounds good; i'll have a look at it the next time i touch the linkmap
30 >> plugin. the patch at hand would be a starting point for that. --[[chrysn]]
31
32 the patch is stored in [[the patch.pl]] as created by git-format-patch, and can
33 be pulled from the abovementioned branch.
34
35 > update 2014-06-29: branch still merges cleanly and works. --[[chrysn]]
36
37 >> [[merged|done]] --[[smcv]]