doc/plugins/headinganchors/discussion.mdwn

   1 Isn't this functionality a part of what [[plugins/toc]] needs and does? Then probably the [[plugins/toc]] plugin's code could be split into the part that implements the [[plugins/headinganchors]]'s functionality and the TOC generation itself. That will bring more order into the code and the set of available plugins. --Ivan Z.
   2
   3 > Indeed it is. Except [[plugins/toc]] generates headings differently - and independently of this. *Even* if [[toc]]'s functionality would be split, you'd probably want to retain backwards compatibility there, so it's unlikely that this will happen... Also see [[todo/toc-with-human-readable-anchors]]. --[[anarcat]]
   4
   5 ---
   6
   7 A patch to make it more like MediaWiki:
   8
   9 <pre>--- headinganchors.pm
  10 +++ headinganchors.pm
  11 @@ -5,6 +5,7 @@
  12  use warnings;
  13  use strict;
  14  use IkiWiki 2.00;
  15 +use URI::Escape;
  16
  17  sub import {
  18          hook(type => "sanitize", id => "headinganchors", call => \&headinganchors);
  19 @@ -14,9 +15,11 @@
  20          my $str = shift;
  21          $str =~ s/^\s+//;
  22          $str =~ s/\s+$//;
  23 -        $str = lc($str);
  24 -        $str =~ s/[&\?"\'\.,\(\)!]//mig;
  25 -        $str =~ s/[^a-z]/_/mig;
  26 +        $str =~ s/\s/_/g;
  27 +        $str =~ s/"//g;
  28 +        $str =~ s/^[^a-zA-Z]/z-/; # must start with an alphabetical character
  29 +        $str = uri_escape_utf8($str);
  30 +        $str =~ s/%/./g;
  31          return $str;
  32  }
  33  </pre>
  34
  35 --Changaco
  36
  37 ----
  38
  39 I think using this below would let the source html clear for the browser
  40 without changing the render:
  41
  42         #use URI::Escape
  43         .
  44         .
  45
  46         #$str = uri_escape_utf8($str);
  47         $str = Encode::decode_utf8($str);
  48         #$str =~ s/%/./g;
  49
  50 Don't you think ?
  51 [[mathdesc]]