doc/bugs/linkmap_displays_underscore_escapes.mdwn

   1 [[ikiwiki/directive/linkmap]]s display the file name instead of the pagetitle, showing unsightly underscore escapes and underscores instead of blanks to users.
   2
   3 the attached [[!taglink patch]] fixes this; from its commit message:
   4
   5     display the pagetitle() in linkmaps
   6
   7     without this patch, linkmaps display underscores and underscore escape
   8     sequences in the rendered output.
   9
  10     this introduces a pageescape function, which invoces pagetitle() to get
  11     rid of underscore escapes and wraps the resulting utf8 string
  12     appropriately for inclusion in a dot file (using dot's html encoding
  13     because it can represent the '\"' dyad properly, and because it doesn't
  14     need special-casing of newlines).
  15
  16 the output will look much better (at least in my wikis) with the "[[bugs/pagetitle function does not respect meta titles]]" issue fixed.
  17
  18 the patch is stored in [[the patch.pl]] as created by git-format-patch. (btw, what's the preferred way to send patches, apart from creating a git branch somewhere?)