[Laszlo-checkins] r11054 - in openlaszlo/trunk/docs/src: nav reference reference/navbuilder xsl
dda@openlaszlo.org
dda at openlaszlo.org
Wed Sep 17 13:18:47 PDT 2008
Author: dda
Date: 2008-09-17 13:18:43 -0700 (Wed, 17 Sep 2008)
New Revision: 11054
Modified:
openlaszlo/trunk/docs/src/nav/toc.xml
openlaszlo/trunk/docs/src/reference/info.xml
openlaszlo/trunk/docs/src/reference/navbuilder/navxmlbuilder.rb
openlaszlo/trunk/docs/src/reference/postprocess.rb
openlaszlo/trunk/docs/src/reference/wrappers.xml
openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
openlaszlo/trunk/docs/src/xsl/parameters.xsl
Log:
Change 20080917-dda-F by dda at lester.local on 2008-09-17 15:42:05 EDT
in /Users/dda/laszlo/src/svn/openlaszlo/trunk-doc5
for http://svn.openlaszlo.org/openlaszlo/trunk
Summary: Change output naming for refguide to match lz.xxx naming convention
New Features:
Bugs Fixed: LPP-7000 (name doc output files corresponding to new lz.xxx naming convention)
Technical Reviewer: (pending)
QA Reviewer: (pending)
Doc Reviewer: liorio (pending)
Documentation:
Release Notes:
Details:
Committed in advance for review
The general technique is to insert a <?dbhtml filename="zzzz.html" ?> processing instruction
into the stream seen by docbook. We choose the filename based on lz.tagname if there is a tagname
(AKA lzxname); if there is none, lz.Classname; if there is none, the unique @id that is currently
used. This ends up changing many of the names.
The known fallout is listed here and is fixed as part of this changeset. It's possible that this has
also introduced broken links for any links that reference a fixed page name.
- toc.xml needs many updates to use the new naming
- navxmlbuilder.tb, used to create classes.xml and tags.xml has been updated to use the new naming
- some lzxnames had spaces in them, e.g. '<splash view>'. Any spaces are converted to underscore.
- any time pluses (e.g. +as3, +debug) appears in the @id, these are preserved in the file name. That way
we can continue to have filenames that are architecture dependent or runtime version dependent.
- added a 'docfilename' tag (e.g. javadoc @docfile xxxx) to indicate the basename of the resulting
xxxx.html output file. We're using this currently only in wrappers.xml and attributes.xml to generate
'canned' pages that need to be named specially. This gives us an escape mechanism for filename
tweaks if we need them.
- fixed a couple < > issues in wrappers.xml . These need to appear in the lzxname for certain
tags (e.g. the lzxname for <a> is actually <a> -- this makes <a> appear correctly in the output
page). Not sure why these are needed or how to get rid of them, this was an expedient fix.
- pushed the original javascript name into a 'postprocessing' comment.
Not part of the fallout, but a broken reference to Debug+debug.html has been commented out of the TOC,
there doesn't seem to be a replacement page in place to describe the new debugger. This change
was needed to get the build to complete without error.
Also, needed to turn the docbook 'chunk.fast' parameter to 0 in order to get the <?dbhtml processing instruction
to work. This doesn't seem to be documented in docbook. Unfortunately this makes the doc builds
take a little longer, it seems.
Tests:
Built ref, spot checked pages and naming.
Modified: openlaszlo/trunk/docs/src/nav/toc.xml
===================================================================
--- openlaszlo/trunk/docs/src/nav/toc.xml 2008-09-17 20:17:33 UTC (rev 11053)
+++ openlaszlo/trunk/docs/src/nav/toc.xml 2008-09-17 20:18:43 UTC (rev 11054)
@@ -1,24 +1,24 @@
<toc>
<category title="Structure">
- <item title="&lt;attribute&gt;" href="tag.attribute.html" />
- <item title="&lt;handler&gt;" href="LzDelegate.html" />
- <item title="&lt;event&gt;" href="LzEvent.html" />
- <item title="&lt;canvas&gt;" href="LzCanvas.html" />
- <item title="&lt;import&gt;" href="tag.import.html" />
- <item title="&lt;include&gt;" href="tag.include.html" />
- <item title="&lt;library&gt;" href="tag.library.html" />
- <item title="&lt;splash&gt;" href="tag.splash+as2.html" />
- <item title="&lt;splash view&gt;" href="tag.splash-view.html" />
- <item title="lz.ContextMenu" href="LzContextMenu.html" />
- <item title="lz.ContextMenuItem" href="LzContextMenuItem.html" />
+ <item title="&lt;attribute&gt;" href="lz.attribute.html" />
+ <item title="&lt;handler&gt;" href="lz.handler.html" />
+ <item title="&lt;event&gt;" href="lz.event.html" />
+ <item title="&lt;canvas&gt;" href="lz.canvas.html" />
+ <item title="&lt;import&gt;" href="lz.import.html" />
+ <item title="&lt;include&gt;" href="lz.include.html" />
+ <item title="&lt;library&gt;" href="lz.library.html" />
+ <item title="&lt;splash&gt;" href="lz.splash+as2.html" />
+ <item title="&lt;splash view&gt;" href="lz.splash_view.html" />
+ <item title="lz.ContextMenu" href="lz.ContextMenu.html" />
+ <item title="lz.ContextMenuItem" href="lz.ContextMenuItem.html" />
</category>
<category title="View Basics">
<item title="&lt;drawview&gt;" href="lz.drawview.html"/>
<item title="&lt;html&gt;" href="lz.html.html"/>
- <item title="&lt;inputtext&gt;" href="LzInputText.html" />
-<!-- TODO [dda 3.29.2008] is this defined in includes/source/excanvas.js? <item title="LzCanvasGradient" href="LzCanvasGradient.html" /> -->
- <item title="&lt;text&gt;" href="LzText.html" />
- <item title="&lt;view&gt;" href="LzView.html"/>
+ <item title="&lt;inputtext&gt;" href="lz.inputtext.html" />
+<!-- TODO [dda 3.29.2008] is this defined in includes/source/excanvas.js? <item title="LzCanvasGradient" href="lz.CanvasGradient.html" /> -->
+ <item title="&lt;text&gt;" href="lz.text.html" />
+ <item title="&lt;view&gt;" href="lz.view.html"/>
</category>
<category title="Components">
<item title="&lt;alert&gt;" href="lz.alert.html" />
@@ -73,7 +73,7 @@
<category title="Layouts">
<item title="&lt;constantboundslayout&gt;" href="lz.constantboundslayout.html" />
<item title="&lt;constantlayout&gt;" href="lz.constantlayout.html" />
- <item title="&lt;layout&gt;" href="LzLayout.html" />
+ <item title="&lt;layout&gt;" href="lz.layout.html" />
<item title="&lt;resizelayout&gt;" href="lz.resizelayout.html" />
<item title="&lt;reverselayout&gt;" href="lz.reverselayout.html" />
<item title="&lt;simpleboundslayout&gt;" href="lz.simpleboundslayout.html" />
@@ -83,21 +83,21 @@
</category>
<category title="Animation">
- <item title="&lt;animator&gt;" href="LzAnimator.html" />
- <item title="&lt;animatorgroup&gt;" href="LzAnimatorGroup.html" />
+ <item title="&lt;animator&gt;" href="lz.animator.html" />
+ <item title="&lt;animatorgroup&gt;" href="lz.animatorgroup.html" />
</category>
<category title="Events">
- <item title="&lt;handler&gt;" href="LzDelegate.html" />
- <item title="&lt;event&gt;" href="LzEvent.html" />
- <item title="lz.Eventable" href="LzEventable.html" />
- <item title="lz.GlobalMouse" href="LzGlobalMouseService.html" />
- <item title="lz.Idle" href="LzIdleService.html" />
- <item title="lz.Keys" href="LzKeysService.html" />
- <item title="lz.ModeManager" href="LzModeManagerService.html" />
- <item title="lz.Timer" href="LzTimerService.html" />
- <item title="lz.Track" href="LzTrackService.html" />
- <item title="lz.History" href="LzHistoryService.html" />
+ <item title="&lt;handler&gt;" href="lz.handler.html" />
+ <item title="&lt;event&gt;" href="lz.event.html" />
+ <item title="lz.Eventable" href="lz.Eventable.html" />
+ <item title="lz.GlobalMouse" href="lz.GlobalMouseService.html" />
+ <item title="lz.Idle" href="lz.IdleService.html" />
+ <item title="lz.Keys" href="lz.KeysService.html" />
+ <item title="lz.ModeManager" href="lz.ModeManagerService.html" />
+ <item title="lz.Timer" href="lz.TimerService.html" />
+ <item title="lz.Track" href="lz.TrackService.html" />
+ <item title="lz.History" href="lz.HistoryService.html" />
</category>
@@ -116,47 +116,47 @@
<category title="Media" >
<item title="&lt;audio&gt;" href="tag-audio.html"/>
- <item title="&lt;font&gt;" href="LzFont.html" />
+ <item title="&lt;font&gt;" href="lz.Font.html" />
<item title="&lt;face&gt;" href="tag-face.html"/>
<item title="&lt;frame&gt;" href="tag-frame.html"/>
<item title="&lt;image&gt;" href="lz.image.html"/>
<item title="&lt;resource&gt;" href="tag-resource.html"/>
- <item title="lz.Audio" href="LzAudioService.html" />
+ <item title="lz.Audio" href="lz.AudioService.html" />
<!-- LzFontManager ??? -->
</category>
<category title="Data">
- <item title="&lt;datapath&gt;" href="LzDatapath.html" />
- <item title="&lt;datapointer&gt;" href="LzDatapointer.html" />
- <item title="&lt;dataprovider&gt;" href="LzDataProvider.html" />
- <item title="&lt;datarequest&gt;" href="LzDataRequest.html" />
- <item title="&lt;dataselectionmanager&gt;" href="LzDataSelectionManager.html" />
- <item title="&lt;dataset&gt;" href="LzDataset.html" />
- <item title="&lt;httpdataprovider&gt;" href="LzHTTPDataProvider.html" />
- <item title="&lt;httpdatarequest&gt;" href="LzHTTPDataRequest.html" />
- <item title="lz.Param" href="LzParam.html" />
- <item title="lz.DataElement" href="LzDataElement.html" />
- <item title="lz.DataNode" href="LzDataNode.html" />
- <item title="lz.DataNodeMixin" href="LzDataNodeMixin.html" />
- <item title="lz.DataText" href="LzDataText.html" />
- <item title="lz.LazyReplicationManager" href="LzLazyReplicationManager.html" />
- <item title="lz.ReplicationManager" href="LzReplicationManager.html" />
- <item title="lz.ResizeReplicationManager" href="LzResizeReplicationManager.html" />
+ <item title="&lt;datapath&gt;" href="lz.datapath.html" />
+ <item title="&lt;datapointer&gt;" href="lz.datapointer.html" />
+ <item title="&lt;dataprovider&gt;" href="lz.dataprovider.html" />
+ <item title="&lt;datarequest&gt;" href="lz.datarequest.html" />
+ <item title="&lt;dataselectionmanager&gt;" href="lz.dataselectionManager.html" />
+ <item title="&lt;dataset&gt;" href="lz.dataset.html" />
+ <item title="&lt;httpdataprovider&gt;" href="lz.httpdataprovider.html" />
+ <item title="&lt;httpdatarequest&gt;" href="lz.httpdatarequest.html" />
+ <item title="lz.Param" href="lz.Param.html" />
+ <item title="lz.DataElement" href="lz.DataElement.html" />
+ <item title="lz.DataNode" href="lz.DataNode.html" />
+ <item title="lz.DataNodeMixin" href="lz.DataNodeMixin.html" />
+ <item title="lz.DataText" href="lz.DataText.html" />
+ <item title="lz.LazyReplicationManager" href="lz.LazyReplicationManager.html" />
+ <item title="lz.ReplicationManager" href="lz.ReplicationManager.html" />
+ <item title="lz.ResizeReplicationManager" href="lz.ResizeReplicationManager.html" />
</category>
<category title="Scripting">
- <item title="&lt;handler&gt;" href="tag.handler.html" />
- <item title="&lt;event&gt;" href="LzEvent.html" />
- <item title="&lt;method&gt;" href="tag.method.html" />
- <item title="&lt;node&gt;" href="LzNode.html" />
- <item title="&lt;script&gt;" href="LzScript.html" />
- <item title="lz.CSSStyleSheet" href="LzCSSStyleSheet.html" />
+ <item title="&lt;handler&gt;" href="lz.handler.html" />
+ <item title="&lt;event&gt;" href="lz.Event.html" />
+ <item title="&lt;method&gt;" href="lz.method.html" />
+ <item title="&lt;node&gt;" href="lz.node.html" />
+ <item title="&lt;script&gt;" href="lz.script.html" />
+ <item title="lz.CSSStyleSheet" href="lz.CSSStyleSheet.html" />
</category>
<category title="States">
<item title="&lt;dragstate&gt;" href="lz.dragstate.html" />
<item title="&lt;resizestate&gt;" href="lz.resizestate.html" />
<item title="&lt;resizestatemin&gt;" href="lz.resizestatemin.html" />
- <item title="&lt;state&gt;" href="LzState.html" />
+ <item title="&lt;state&gt;" href="lz.State.html" />
</category>
<category title="Base Classes">
@@ -204,8 +204,8 @@
</category>
<category title="Menus and Commands">
- <item title="&lt;command&gt;" href="LzCommand.html" />
- <item title="&lt;selectionmanager&gt;" href="LzSelectionManager.html" />
+ <item title="&lt;command&gt;" href="lz.Command.html" />
+ <item title="&lt;selectionmanager&gt;" href="lz.SelectionManager.html" />
</category>
<category title="RPC">
<item title="&lt;javarpc&gt;" href="lz.javarpc.html" />
@@ -213,7 +213,7 @@
<item title="&lt;rpc&gt;" href="lz.rpc.html" />
<item title="&lt;remotecall&gt;" href="lz.remotecall.html" />
<item title="&lt;soap&gt;" href="lz.soap.html" />
- <item title="&lt;security&gt;" href="tag.security.html" />
+ <item title="&lt;security&gt;" href="lz.security.html" />
<item title="&lt;sessionrpc&gt;" href="lz.sessionrpc.html" />
<item title="&lt;webapprpc&gt;" href="lz.webapprpc.html" />
<item title="&lt;xmlrpc&gt;" href="lz.xmlrpc.html" />
@@ -221,11 +221,11 @@
</category>
<category title="Services">
- <item title="lz.Browser" href="LzBrowserService.html" />
- <item title="lz.Cursor" href="LzCursorService.html" />
- <item title="lz.Focus" href="LzFocusService.html" />
- <item title="lz.Track" href="LzTrackService.html" />
- <item title="lz.URL" href="LzURL.html" />
+ <item title="lz.Browser" href="lz.BrowserService.html" />
+ <item title="lz.Cursor" href="lz.CursorService.html" />
+ <item title="lz.Focus" href="lz.FocusService.html" />
+ <item title="lz.Track" href="lz.TrackService.html" />
+ <item title="lz.URL" href="lz.URL.html" />
</category>
<category title="Charts and Graphs">
@@ -278,7 +278,7 @@
</category>
<category title="Development">
- <item title="Debug" href="Debug+debug.html"/>
+ <!-- TODO: need something for debugging... <item title="Debug" href="Debug+debug.html"/> -->
<item title="&lt;SyncTester&gt;" href="lz.SyncTester.html" />
<item title="&lt;Test&gt;" href="lz.Test.html" />
<item title="&lt;TestCase&gt;" href="lz.TestCase.html" />
Modified: openlaszlo/trunk/docs/src/reference/info.xml
===================================================================
--- openlaszlo/trunk/docs/src/reference/info.xml 2008-09-17 20:17:33 UTC (rev 11053)
+++ openlaszlo/trunk/docs/src/reference/info.xml 2008-09-17 20:18:43 UTC (rev 11054)
@@ -13,6 +13,7 @@
<property id="info-attributes" topic="LZX" subtopic="General Information" access="public">
<doc>
<tag name="lzxname"><text>An introduction to Attributes</text></tag>
+<tag name="docfilename"><text>info-attributes</text></tag>
<text>
<p>Attributes can be an element of a tag or a property of a JavaScript
class. Attributes are declared and set in tags, but they can also
Modified: openlaszlo/trunk/docs/src/reference/navbuilder/navxmlbuilder.rb
===================================================================
--- openlaszlo/trunk/docs/src/reference/navbuilder/navxmlbuilder.rb 2008-09-17 20:17:33 UTC (rev 11053)
+++ openlaszlo/trunk/docs/src/reference/navbuilder/navxmlbuilder.rb 2008-09-17 20:18:43 UTC (rev 11054)
@@ -90,6 +90,25 @@
tag
end
+def javascriptname_for(filename)
+ js = nil;
+ open(filename) {|f|
+ f.each_line { |line|
+ line.chomp!
+ if (line =~ /postprocess/) then
+ end
+ if (line =~ /@@.*original javascript name.*@@/) then
+ js = line.sub(/.*@@.*= */, '').sub(/ *@@/, '')
+ break
+ elsif (line =~ /<p class="postprocess-info-jsname">/) then
+ js = line.sub(/.*postprocess-info-jsname">/, '').sub(/<.*/, '')
+ break
+ end
+ }
+ }
+ js
+end
+
# If the title of this document does not have a tag name, return it.
def nontagname_for(filename)
name = nil;
@@ -145,16 +164,15 @@
name
}
-generate_index("{Lz*,Debug*}.html", $outdir + "/classes.xml", "index") { | file,fullname |
- name = tagname_for(fullname);
- if (name) then
- name = 'lz.' + name;
- else
- name = nontagname_for(fullname);
+generate_index("{lz.*,Lz*,Debug*}.html", $outdir + "/classes.xml", "index") { | file,fullname |
+ name = nil
+ jsname = javascriptname_for(fullname);
+ if (jsname && jsname != "") then
+ name = tagname_for(fullname);
if (name) then
- name = name.sub(/\$lzc\$class_/, 'lz.');
+ name = 'lz.' + name;
else
- name = file.sub(/\.html/, '').sub(/([^+]*)\+(.*)/, '\1 (\2)').gsub(/\+/, ' ');
+ name = jsname.sub(/\$lzc\$class_/, 'lz.').sub(/^Lz/, 'lz.');
end
end
name
Modified: openlaszlo/trunk/docs/src/reference/postprocess.rb
===================================================================
--- openlaszlo/trunk/docs/src/reference/postprocess.rb 2008-09-17 20:17:33 UTC (rev 11053)
+++ openlaszlo/trunk/docs/src/reference/postprocess.rb 2008-09-17 20:18:43 UTC (rev 11054)
@@ -81,6 +81,10 @@
outf.write('<hr/>')
line.gsub!(/<p class="postprocess-method-end([^>]*)>/, '')
line.gsub!(/<\/p>/, '')
+ elsif (pptagname =~ /^info-$/)
+ outf.write('<!-- @@ info ')
+ line.gsub!(/<p class="postprocess-info-/, '')
+ line.gsub!(/<\/p>/, ' @@ -->')
elsif (pptagname =~ /^xlink-/)
# Create an external link to an anchor
line.gsub!(/<p class="postprocess-xlink-/, '<a href="')
Modified: openlaszlo/trunk/docs/src/reference/wrappers.xml
===================================================================
--- openlaszlo/trunk/docs/src/reference/wrappers.xml 2008-09-17 20:17:33 UTC (rev 11053)
+++ openlaszlo/trunk/docs/src/reference/wrappers.xml 2008-09-17 20:18:43 UTC (rev 11054)
@@ -13,6 +13,7 @@
<doc>
<tag name="lzxname"><text>a</text></tag>
<tag name="shortdesc"><text>HTML hypertext link.</text></tag>
+<tag name="docfilename"><text>tag-a</text></tag>
<text>
<p/>
<p>HTML hypertext link. This tag can only occur inside XHTML
@@ -101,6 +102,7 @@
<doc>
<tag name="shortdesc"><text>Bold Text.</text></tag>
<tag name="lzxname"><text><b></text></tag>
+<tag name="docfilename"><text>tag-b</text></tag>
<text>
<p>HTML bold character markup. This tag can only occur inside XHTML
text containers such as <sgmltag class="element" role="LzText"><text></sgmltag> and
@@ -122,6 +124,7 @@
<doc>
<tag name="shortdesc"><text>Line break.</text></tag>
<tag name="lzxname"><text><br></text></tag>
+<tag name="docfilename"><text>tag-br</text></tag>
<text>
<p>HTML line break. This tag can only occur inside XHTML
text containers such as <tagname>text</tagname>.</p>
@@ -145,6 +148,7 @@
<doc>
<tag name="shortdesc"><text>Inline font markup.</text></tag>
<tag name="lzxname"><text>font</text></tag>
+<tag name="docfilename"><text>tag-font</text></tag>
<text>
<para>A <sgmltag class="element"><font></sgmltag> tag controls the font face, size, and color for its textual content.</para>
<note>The XHMTL <sgmltag class="element"><font></sgmltag> tag, which controls the appearance of its content, is different
@@ -183,7 +187,8 @@
<property id="tag-i" topic="LZX" subtopic="HTML Markup" access="public">
<doc>
<tag name="shortdesc"><text>Italic text.</text></tag>
-<tag name="lzxname"><text>i</text></tag>
+<tag name="lzxname"><text><i></text></tag>
+<tag name="docfilename"><text>tag-i</text></tag>
<p/>
<text>
<p>HTML italic character markup. This tag can only occur inside
@@ -204,6 +209,7 @@
<doc>
<tag name="shortdesc"><text>A way to import images into html</text></tag>
<tag name="lzxname"><text>img</text></tag>
+<tag name="docfilename"><text>tag-img</text></tag>
<text>
<p>
The compiler supports the <img> tag in HTML text content, for
@@ -262,6 +268,7 @@
<doc>
<tag name="shortdesc"><text>Paragraph.</text></tag>
<tag name="lzxname"><text><p></text></tag>
+<tag name="docfilename"><text>tag-p</text></tag>
<text>
<p>An HTML paragraph. This tag only occurs inside XHTML text such as
@@ -284,6 +291,7 @@
<doc>
<tag name="shortdesc"><text>Preformatted text.</text></tag>
<tag name="lzxname"><text><pre></text></tag>
+<tag name="docfilename"><text>tag-pre</text></tag>
<text>
<p>An HTML preformatted text region. Whitespace and line breaks within
this element are preserved.</p>
@@ -312,6 +320,7 @@
<doc>
<tag name="shortdesc"><text>Underlined text.</text></tag>
<tag name="lzxname"><text><u></text></tag>
+<tag name="docfilename"><text>tag-u</text></tag>
<text>
<p>HTML underlined character markup. This tag can only occur inside
XHTML text containers such as <sgmltag class="element" role="LzText"><text></sgmltag> and
@@ -333,6 +342,7 @@
<doc>
<tag name="shortdesc"><text>Imports an audio file.</text></tag>
<tag name="lzxname"><text><audio></text></tag>
+<tag name="docfilename"><text>tag-audio</text></tag>
<text>
<warning>This tag is obsolete. Its functionality has been replaced by
the <tagname>resource</tagname> tag.</warning>
@@ -376,6 +386,7 @@
<doc>
<tag name="shortdesc"><text></text></tag>
<tag name="lzxname"><text>face</text></tag>
+<tag name="docfilename"><text>tag-face</text></tag>
<text>
<p>Defines a font face or style within the font family that the
outer element defines.</p>
@@ -409,6 +420,7 @@
<doc>
<tag name="shortdesc"><text>A tag that defines a media object that can be associated with a view.</text></tag>
<tag name="lzxname"><text>resource</text></tag>
+<tag name="docfilename"><text>tag-resource</text></tag>
<text>
<p>This tag defines a media object, that can be presented within a
@@ -470,6 +482,7 @@
<doc>
<tag name="shortdesc"><text>A frame of a multi-frame resource.</text></tag>
<tag name="lzxname"><text>frame</text></tag>
+<tag name="docfilename"><text>tag-frame</text></tag>
<text>
<p>The <tagname>frame</tagname> tag is used to define a single frame
of a multi-frame <sgmltag class="element" role="tag-resource"><resource></sgmltag>. A multi-frame resource
Modified: openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl 2008-09-17 20:17:33 UTC (rev 11053)
+++ openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl 2008-09-17 20:18:43 UTC (rev 11054)
@@ -22,6 +22,7 @@
<!ENTITY raquo "»">
<!ENTITY tagname '(doc/tag[@name="lzxname"]/text)'>
+<!ENTITY docfilename '(doc/tag[@name="docfilename"]/text)'>
<!ENTITY shortdesc '(doc/tag[@name="shortdesc"]/text)'>
<!ENTITY lzxtype '(doc/tag[@name="lzxtype"]/text)'>
<!ENTITY lzxdefault '(doc/tag[@name="lzxdefault"]/text)'>
@@ -136,6 +137,7 @@
<xsl:variable name="jsname" select="@name"/>
<xsl:variable name="lzxname" select="&tagname;"/>
+ <xsl:variable name="docfilename" select="&docfilename;"/>
<xsl:variable name="desc">
<xsl:apply-templates select="." mode="desc"/>
</xsl:variable>
@@ -153,9 +155,49 @@
</xsl:variable>
+ <!-- collect the +debug part.... -->
+ <!-- filename generation, part 1.
+ override 'id as filename' behavior, we want: lz.tagname.html -->
+ <xsl:variable name="tmp-filebase-for-output">
+ <xsl:choose>
+ <xsl:when test="$docfilename">
+ <xsl:value-of select="$docfilename"/>
+ </xsl:when>
+ <xsl:when test="$lzxname">
+ <xsl:value-of select="concat('lz.', $lzxname)"/>
+ </xsl:when>
+ <xsl:when test="starts-with($jsname, 'Lz')">
+ <xsl:value-of select="concat('lz.', substring-after($jsname, 'Lz'))"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="@id"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+
+ <!-- filename generation, part 2.
+ restore any '+' in the id (e.g. tag.splash+as2.html)
+ and remove spaces from final filename -->
+ <xsl:variable name="filebase-for-output">
+ <xsl:choose>
+ <xsl:when test="contains(@id,'+') and not(contains($tmp-filebase-for-output,'+'))">
+ <xsl:value-of select="concat(translate($tmp-filebase-for-output,' ','_'), '+', substring-after(@id,'+'))"/>
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:value-of select="translate($tmp-filebase-for-output,' ','_')"/>
+ </xsl:otherwise>
+ </xsl:choose>
+ </xsl:variable>
+
<refentry id="{$id-for-output}" xreflabel="{$desc}">
+ <para role="postprocess-info-jsname">
+ <xsl:value-of select="$jsname"/>
+ </para>
<xsl:if test="$lzxname"><anchor id="{concat('tag.',$lzxname)}"/></xsl:if>
+ <xsl:processing-instruction name="dbhtml">
+ <xsl:text>filename="</xsl:text><xsl:value-of select="$filebase-for-output"/><xsl:text>.html"</xsl:text>
+ </xsl:processing-instruction>
<refmeta>
<refentrytitle><xsl:value-of select="$desc"/></refentrytitle>
</refmeta>
Modified: openlaszlo/trunk/docs/src/xsl/parameters.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/parameters.xsl 2008-09-17 20:17:33 UTC (rev 11053)
+++ openlaszlo/trunk/docs/src/xsl/parameters.xsl 2008-09-17 20:18:43 UTC (rev 11054)
@@ -48,7 +48,7 @@
<!-- This is too verbose, we use a style sheet instead -->
<xsl:param name="table.borders.with.css" select="0"/>
<!-- Chunking -->
- <xsl:param name="chunk.fast" select="1"/>
+ <xsl:param name="chunk.fast" select="0"/>
<xsl:param name="chunk.section.depth" select="0"/>
<xsl:param name="chunker.output.indent" select="'yes'"/>
<xsl:param name="html.extra.head.links" select="0"/>
More information about the Laszlo-checkins
mailing list