From: anarcat <anarcat@web>
Date: Wed, 12 Apr 2017 20:14:13 +0000 (-0400)
Subject: add i18nheadinganchors plugin
X-Git-Tag: debian/3.20170622~86
X-Git-Url: http://git.vanrenterghem.biz/git.ikiwiki.info.git/commitdiff_plain/42b8a58565f6dd878956c9a3876291d08be000ef

add i18nheadinganchors plugin
---

diff --git a/doc/plugins/contrib/i18nheadinganchor.mdwn b/doc/plugins/contrib/i18nheadinganchor.mdwn
new file mode 100644
index 000000000..3bef82ef0
--- /dev/null
+++ b/doc/plugins/contrib/i18nheadinganchor.mdwn
@@ -0,0 +1,19 @@
+[[!template  id=gitbranch branch=anarcat/i18n-headinghanchors author="[[anarcat]]"]]
+
+This plugin is similar to [[plugins/headinganchors]] except:
+
+ 1. it overrides other attributes previously set on heading elements
+    (to override the multimarkdown-generated headings for example)
+
+ 2. deals with non-ASCII charsets better: for example, 北亰 becomes
+    "bei-jing" instead of "z-.E4.BA.B0" and "liberté" becomes
+    "liberte" instead of "libert.C3.A9"
+
+This is a separate plugin because this is a backwards-incompatible
+change, but I would be more than happy to make a patch to merge this
+in the main plugin if necessary.
+
+Also note that *all* heading attributes are overriden with the ID
+tag. If this is not desirable, we'd need to fire up a full
+HTML::Parser or do some more regex magic to preserve the attributes
+other than `id=` which we want to keep. -- [[anarcat]]