Add a permalink functionality to section and diective-section in the generated doc.

This is convenient and consistent with httpd.a.o

Getting a link to a section or a directive is already possible from the TOC, but having it available directly in-place is, IMHO, much more useful.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1828588 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/style/lang/da.xml b/docs/manual/style/lang/da.xml
index c7be52ae55ec54bdd369d0f4eb662ef3e4283666..bca1670ece642db61dee8ffbce98f8aab0c81965 100644 (file)
--- a/docs/manual/style/lang/da.xml
+++ b/docs/manual/style/lang/da.xml
@@ -76,6 +76,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Syntaks</message>

diff --git a/docs/manual/style/lang/de.xml b/docs/manual/style/lang/de.xml
index 653f3db0dc8a0588b72902c00203c7e29cfcc542..f39113a34b14699541967a00eee79d442a7a79e7 100644 (file)
--- a/docs/manual/style/lang/de.xml
+++ b/docs/manual/style/lang/de.xml
@@ -71,6 +71,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Syntax</message>

diff --git a/docs/manual/style/lang/en.xml b/docs/manual/style/lang/en.xml
index 4e97a89091fb9f39ab8c3d98795887295fd78312..5c1599e063131f37dbaf78048a7d4d6b79f0e9d7 100644 (file)
--- a/docs/manual/style/lang/en.xml
+++ b/docs/manual/style/lang/en.xml
@@ -75,6 +75,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Syntax</message>

diff --git a/docs/manual/style/lang/es.xml b/docs/manual/style/lang/es.xml
index e143f5031c58c1fe1d4c68a3c2bee451b2ae70ae..213cf2d37fae06ec3cec805c1f5d5c7c6ffbea9b 100644 (file)
--- a/docs/manual/style/lang/es.xml
+++ b/docs/manual/style/lang/es.xml
@@ -79,6 +79,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Sintaxis</message>

diff --git a/docs/manual/style/lang/fr.xml b/docs/manual/style/lang/fr.xml
index 52d6aadc2394f675a189f254cf29c03b4b3c0d6d..af325294f8881290e00fe4192861cd9036e9fdab 100644 (file)
--- a/docs/manual/style/lang/fr.xml
+++ b/docs/manual/style/lang/fr.xml
@@ -75,6 +75,7 @@
         <message id="httpdchangelog">Journal des modifications de httpd</message>
         <message id="httpdknownissues">Probl&#232;mes connus</message>
         <message id="httpdreportabug">Signaler un bug</message>
+        <message id="permalink">Lien permanent</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Syntaxe</message>

diff --git a/docs/manual/style/lang/ja.xml b/docs/manual/style/lang/ja.xml
index 060bf2d5a24254fafabfc4c823afa583db435ada..ebe75459ce7d68cabbd9120a895587ac1e4b622a 100644 (file)
--- a/docs/manual/style/lang/ja.xml
+++ b/docs/manual/style/lang/ja.xml
@@ -70,6 +70,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">構文</message>

diff --git a/docs/manual/style/lang/ko.xml b/docs/manual/style/lang/ko.xml
index b219246ffb7fda5f579e6aa03d612a4ce6ddaae1..a2227757d8d30d2f519a850bd7560344b6c43080 100644 (file)
--- a/docs/manual/style/lang/ko.xml
+++ b/docs/manual/style/lang/ko.xml
@@ -76,6 +76,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">¹®¹ý</message>

diff --git a/docs/manual/style/lang/pt-br.xml b/docs/manual/style/lang/pt-br.xml
index d2e4ad54862acc488826ae0b82bd2becfaef79ed..b58e6c225695ba7713c7b8dfef9abae637f4f05c 100644 (file)
--- a/docs/manual/style/lang/pt-br.xml
+++ b/docs/manual/style/lang/pt-br.xml
@@ -74,6 +74,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Sintaxe</message>

diff --git a/docs/manual/style/lang/ru.xml b/docs/manual/style/lang/ru.xml
index 0a7d3df89cd5a843556bd476fab73de5a124d329..37d5e62a913fe5081a8121470cbf3201660ac499 100644 (file)
--- a/docs/manual/style/lang/ru.xml
+++ b/docs/manual/style/lang/ru.xml
@@ -74,6 +74,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">óÉÎÔÁËÓÉÓ</message>

diff --git a/docs/manual/style/lang/tr.xml b/docs/manual/style/lang/tr.xml
index 68d05bec1a87ba0bc422eaa7555a486ece36da77..77a90ed62d7fcde0efa0bc5698d19ee6a516128c 100644 (file)
--- a/docs/manual/style/lang/tr.xml
+++ b/docs/manual/style/lang/tr.xml
@@ -77,6 +77,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">Sözdizimi</message>

diff --git a/docs/manual/style/lang/zh-cn.xml b/docs/manual/style/lang/zh-cn.xml
index 04b7f851d4ab1543b7190ef04220c0f10484b83a..8da870e10d6c86613866bb4d8e33e2b76a740ccc 100644 (file)
--- a/docs/manual/style/lang/zh-cn.xml
+++ b/docs/manual/style/lang/zh-cn.xml
@@ -73,6 +73,7 @@
         <message id="httpdchangelog">httpd changelog</message>
         <message id="httpdknownissues">Known issues</message>
         <message id="httpdreportabug">Report a bug</message>
+        <message id="permalink">Permanent link</message>
 
         <!-- Used in description box for directives -->
         <message id="syntax">语法</message>

diff --git a/docs/manual/style/xsl/common.xsl b/docs/manual/style/xsl/common.xsl
index 20701ff16c3385ce2400dba9b877b3d38a4de08c..d6905ce0d882f30e7cbb65275f33fb3f67284bc3 100644 (file)
--- a/docs/manual/style/xsl/common.xsl
+++ b/docs/manual/style/xsl/common.xsl
@@ -18,8 +18,9 @@
 -->
 
 <!DOCTYPE xsl:stylesheet [
-    <!ENTITY nbsp SYSTEM "util/nbsp.xml">
     <!ENTITY lf SYSTEM "util/lf.xml">
+    <!ENTITY nbsp SYSTEM "util/nbsp.xml">
+    <!ENTITY para SYSTEM "util/para.xml">
     <!ENTITY % HTTPD-VERSION SYSTEM "../version.ent">
     %HTTPD-VERSION;
 ]>
@@ -522,6 +523,7 @@ if (typeof(prettyPrint) !== 'undefined') {
           <a id="{@id}" name="{@id}">
               <xsl:apply-templates select="title" mode="print" />
           </a>
+          <a class="permalink" href="#{@id}" title="{$message[@id='permalink']}">&para;</a>
         </xsl:when>
 
         <xsl:otherwise>

diff --git a/docs/manual/style/xsl/synopsis.xsl b/docs/manual/style/xsl/synopsis.xsl
index 401ac5ff250c39e0d0d035df693e0b57336a6e2d..9ab0e5338ddc9cb1bd8607ce3e5a1f7d264a3214 100644 (file)
--- a/docs/manual/style/xsl/synopsis.xsl
+++ b/docs/manual/style/xsl/synopsis.xsl
@@ -19,6 +19,7 @@
 
 <!DOCTYPE xsl:stylesheet [
     <!ENTITY lf SYSTEM "util/lf.xml">
+    <!ENTITY para SYSTEM "util/para.xml">
 ]>
 <xsl:stylesheet version="1.0"
               xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
@@ -425,6 +426,7 @@
                 </a>
             </xsl:otherwise>
             </xsl:choose>
+        <a class="permalink" href="#{$lowername}" title="{$message[@id='permalink']}">&para;</a>
         </h2>&lf;
 
         <!-- Directive header -->

diff --git a/docs/manual/style/xsl/util/para.xml b/docs/manual/style/xsl/util/para.xml
new file mode 100644 (file)
index 0000000..f02d643
--- /dev/null
+++ b/docs/manual/style/xsl/util/para.xml
@@ -0,0 +1,3 @@
+<?xml version="1.0" encoding="utf-8"?>
+
+<xsl:text disable-output-escaping="yes" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">&amp;para;</xsl:text>