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