Author: mvidner
Date: Tue Jul 29 09:10:38 2008
New Revision: 49471
URL: http://svn.opensuse.org/viewcvs/yast?rev=49471&view=rev
Log:
Changes to assist a straightforward mapping between source code
usage and reference docs URLs: list::reduce should be
.../ycp/list/reduce.html, not .../YCPListBuiltins_reduce.html
- Added a disambiguation chapter to provide links from add.html to
add-list.html and add-map.html
- This requires processing the entire document at once, not
chapter-wise, so adjusted for that too.
- In a @builtin @id, dot "." is used instead of quad "::" to delimit
namespaces. They are output as subdirectories.
Modified:
trunk/devtools/docbook/stylesheets/ydoc.xsl
Modified: trunk/devtools/docbook/stylesheets/ydoc.xsl
URL: http://svn.opensuse.org/viewcvs/yast/trunk/devtools/docbook/stylesheets/ydoc.xsl?rev=49471&r1=49470&r2=49471&view=diff
==============================================================================
--- trunk/devtools/docbook/stylesheets/ydoc.xsl (original)
+++ trunk/devtools/docbook/stylesheets/ydoc.xsl Tue Jul 29 09:10:38 2008
@@ -1,53 +1,93 @@
-<?xml version="1.0" encoding="ISO-8859-1"?>
+<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE xsl:stylesheet [
-<!ENTITY undocumented "[DOCS MISSING]">
+<!ENTITY undocumented "">
+<!ENTITY undocumented2 "[DOCS MISSING]">
]>
http://www.w3.org/1999/XSL/Transform">
-
+
xsl:apply-templates/
+
-
- <reference>
-
-
-
- <title>
-
- </title>
-
-
-
-
+
+ <!-- googled "xslt grouping":
+ http://www.jenitennison.com/xslt/grouping/muenchian.html -->
+
+
+
+
+
+
+
+ <reference id="{filename}">
+ <title>
+
+ </title>
+
+
+
+
</reference>
+
+
+
+
-
- <refentry>
-
-
-
- xsl:text_
-
+ <!-- dirsep must be allowed in IDs -->
+ .
+
xsl:choose
-
-
+
+
xsl:otherwise
-
+
-
-
- xsl:text_widget
-
-
+
+
+
+
+
+
+
+
+ xsl:choose
+
+
+
+ xsl:otherwise
+
+
+
+
+
+
+
+
+
+ <!-- produce file names according to yastdoc rules -->
+
+
+ xsl:textdir="
+
+ xsl:text"
+
+
+
+ xsl:textfilename="
+
+ xsl:text.html"
+
<refmeta>
<refentrytitle>
@@ -56,8 +96,21 @@
</refentrytitle>
- <manvolnum>3</manvolnum>
+ <manvolnum>
+
+ xsl:text,
+
+ </manvolnum>
</refmeta>
+
+
+
+
+ <refentry>
+
+
+
+
<refnamediv>
<refname>
@@ -378,6 +431,45 @@
+ <!-- create add.html for add-list.html and add-map.html -->
+
+ <reference id="Disambiguation">
+ <title>Disambiguation</title>
+
+ <!-- id!='' assumes all duplicates have id defined. -->
+
+
+
+ <refentry>
+
+
+ <refnamediv>
+ <refname>
+
+ </refname>
+ <refpurpose>disambiguation</refpurpose>
+ </refnamediv>
+
+ <refsect1>
+ <title>Variants</title>
+ <simplelist>
+
+
+ <member>
+ <xref linkend="{id}" />
+ </member>
+
+ </simplelist>
+ </refsect1>
+
+ </refentry>
+
+
+ </reference>
+
+
--
To unsubscribe, e-mail: yast-commit+unsubscribe@opensuse.org
For additional commands, e-mail: yast-commit+help@opensuse.org