Author: ben
Date: 2007-12-30 14:25:07 -0800 (Sun, 30 Dec 2007)
New Revision: 7687
Added:
openlaszlo/trunk/docs/src/developers/doc-backwards-xform.dbk
openlaszlo/trunk/docs/src/developers/images/reference-attributes-explanation.png
openlaszlo/trunk/docs/src/developers/images/reference-attributes-table.png
openlaszlo/trunk/docs/src/developers/images/reference-attributes.png
openlaszlo/trunk/docs/src/developers/images/reference-events.png
openlaszlo/trunk/docs/src/developers/images/reference-example-explanation.png
openlaszlo/trunk/docs/src/developers/images/reference-header-explanation.graffle/
openlaszlo/trunk/docs/src/developers/images/reference-header-explanation.graffle/data.plist
openlaszlo/trunk/docs/src/developers/images/reference-header-explanation.png
openlaszlo/trunk/docs/src/developers/images/reference-methods-explanation.graffle/
openlaszlo/trunk/docs/src/developers/images/reference-methods-explanation.graffle/data.plist
openlaszlo/trunk/docs/src/developers/images/reference-overview-explanation.graffle/
openlaszlo/trunk/docs/src/developers/images/reference-overview-explanation.graffle/data.plist
Modified:
openlaszlo/trunk/docs/src/build.xml
openlaszlo/trunk/docs/src/developers/doc-toolchain.dbk
openlaszlo/trunk/docs/src/developers/index.dbk
openlaszlo/trunk/docs/src/xsl/common-html.xsl
openlaszlo/trunk/docs/src/xsl/parameters.xsl
Log:
Change 20071230-ben-C by [EMAIL PROTECTED] on 2007-12-30 14:06:08 PST
in /Users/ben/src/svn/openlaszlo/trunk
for http://svn.openlaszlo.org/openlaszlo/trunk
Summary: Much doctools work and work on the documentation of the doctools
New Features: Chapter for the backwards transformation, from output to source
Documentation:
This change adds a new chapter describing the "backwards transformation,"
looking at visual elements of the output reference pages, and showing
how those elements came from docbook, and how those elements came from
js2doc, and how those elements came from source.
The purpose of this chapter is to give a starting point for a developer
who wants to change a particular thing, without having to snarf the
entire doctools structure.
Release Notes:
Details:
docs/src/developers/doc-toolchain.dbk
moved backwards transformation into its own chapter
docs/src/developers/doc-backwards-xform.dbk
new chapter to describe backwards transformation
docs/src/developers/index.dbk
added new chapter to the developer's guide
docs/src/build.xml
turned off draft mode
docs/src/xsl/common-html.xsl
took out debugging messages (just diagnostic, they didn't indicate a
problem)
docs/src/developers/images/reference*
added new images with captures of a reference page and sections called out
Tests:
Modified: openlaszlo/trunk/docs/src/build.xml
===================================================================
--- openlaszlo/trunk/docs/src/build.xml 2007-12-30 22:14:01 UTC (rev 7686)
+++ openlaszlo/trunk/docs/src/build.xml 2007-12-30 22:25:07 UTC (rev 7687)
@@ -54,7 +54,7 @@
<property name="show.fixmes" value="0"/>
</then>
<else>
- <property name="draft.mode" value="yes"/>
+ <property name="draft.mode" value="no"/> <!-- [bshine 12.30.2007] turn
off draft bg because it bothers me ] -->
<property name="show.comments" value="1"/>
<if><equals arg1="${release}" arg2="Internal" casesensitive="true"
trim="true"/>
<then>
Added: openlaszlo/trunk/docs/src/developers/doc-backwards-xform.dbk
Property changes on:
openlaszlo/trunk/docs/src/developers/doc-backwards-xform.dbk
___________________________________________________________________
Name: svn:mime-type
+ text/plain
Name: svn:eol-style
+ native
Modified: openlaszlo/trunk/docs/src/developers/doc-toolchain.dbk
===================================================================
--- openlaszlo/trunk/docs/src/developers/doc-toolchain.dbk 2007-12-30
22:14:01 UTC (rev 7686)
+++ openlaszlo/trunk/docs/src/developers/doc-toolchain.dbk 2007-12-30
22:25:07 UTC (rev 7687)
@@ -529,13 +529,6 @@
</section>
- <section id="backwards-transformation">
- <title>The Backwards Transformation: From Reference Page to Source</title>
- <para>In this section, we will show where several elements on the end
product reference page
- can be traced back to their origins in the sources.</para>
- <para>screengrab of a reference page with area highlighted, identified by
A/B/C etc</para>
- <para>for each highlighted area, show the xsl files in which it is created
and the important templates </para>
- </section>
<section id="workflow-details">
Added:
openlaszlo/trunk/docs/src/developers/images/reference-attributes-explanation.png
Property changes on:
openlaszlo/trunk/docs/src/developers/images/reference-attributes-explanation.png
___________________________________________________________________
Name: svn:mime-type
+ image/png
Added:
openlaszlo/trunk/docs/src/developers/images/reference-attributes-table.png
Property changes on:
openlaszlo/trunk/docs/src/developers/images/reference-attributes-table.png
___________________________________________________________________
Name: svn:mime-type
+ image/png
Added: openlaszlo/trunk/docs/src/developers/images/reference-attributes.png
Property changes on:
openlaszlo/trunk/docs/src/developers/images/reference-attributes.png
___________________________________________________________________
Name: svn:mime-type
+ image/png
Added: openlaszlo/trunk/docs/src/developers/images/reference-events.png
Property changes on:
openlaszlo/trunk/docs/src/developers/images/reference-events.png
___________________________________________________________________
Name: svn:mime-type
+ image/png
Added:
openlaszlo/trunk/docs/src/developers/images/reference-example-explanation.png
Property changes on:
openlaszlo/trunk/docs/src/developers/images/reference-example-explanation.png
___________________________________________________________________
Name: svn:mime-type
+ image/png
Added:
openlaszlo/trunk/docs/src/developers/images/reference-header-explanation.graffle/data.plist
Property changes on:
openlaszlo/trunk/docs/src/developers/images/reference-header-explanation.graffle/data.plist
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
openlaszlo/trunk/docs/src/developers/images/reference-header-explanation.png
Property changes on:
openlaszlo/trunk/docs/src/developers/images/reference-header-explanation.png
___________________________________________________________________
Name: svn:mime-type
+ image/png
Added:
openlaszlo/trunk/docs/src/developers/images/reference-methods-explanation.graffle/data.plist
Property changes on:
openlaszlo/trunk/docs/src/developers/images/reference-methods-explanation.graffle/data.plist
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Added:
openlaszlo/trunk/docs/src/developers/images/reference-overview-explanation.graffle/data.plist
Property changes on:
openlaszlo/trunk/docs/src/developers/images/reference-overview-explanation.graffle/data.plist
___________________________________________________________________
Name: svn:mime-type
+ application/octet-stream
Modified: openlaszlo/trunk/docs/src/developers/index.dbk
===================================================================
--- openlaszlo/trunk/docs/src/developers/index.dbk 2007-12-30 22:14:01 UTC
(rev 7686)
+++ openlaszlo/trunk/docs/src/developers/index.dbk 2007-12-30 22:25:07 UTC
(rev 7687)
@@ -155,7 +155,12 @@
<xi:include href="doc-toolchain.dbk">
<xi:fallback><para>Missing: Doc Tool Chain</para></xi:fallback>
</xi:include>
+
+ <xi:include href="doc-backwards-xform.dbk">
+ <xi:fallback><para>Missing: Doc Backwards
Transformation</para></xi:fallback>
+ </xi:include>
+
<xi:include href="docbook-local.dbk">
<xi:fallback><para>Missing: Docbook Local Style
Guide</para></xi:fallback>
</xi:include>
Modified: openlaszlo/trunk/docs/src/xsl/common-html.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/common-html.xsl 2007-12-30 22:14:01 UTC
(rev 7686)
+++ openlaszlo/trunk/docs/src/xsl/common-html.xsl 2007-12-30 22:25:07 UTC
(rev 7687)
@@ -357,8 +357,7 @@
<xsl:template match="[EMAIL PROTECTED]'lzx-embednew']">
<xsl:variable name="fname" select="filename/text()"/>
<xsl:variable name="query-parameters" select="parameter/text()"/>
- <xsl:variable name="text" select="code/text()"/>
- <xsl:message>Aha! Using role='lzx-embednew' on file <xsl:value-of
select="$fname"/> and parameters <xsl:value-of
select="$query-parameters"/></xsl:message>
+ <xsl:variable name="text" select="code/text()"/>
<xsl:variable name="query-param">
<xsl:if test="$query-parameters">&<xsl:value-of
select="$query-parameters"></xsl:value-of></xsl:if>
</xsl:variable>
@@ -376,7 +375,6 @@
<xsl:with-param name="default" select="'400'"/>
</xsl:call-template>
</xsl:variable>
- <xsl:message>Got canvas-width of <xsl:value-of select="$canvas-width"/>
and canvas-height of <xsl:value-of select="$canvas-height"/></xsl:message>
<xsl:variable name="canvas-id" select="generate-id(.)"/>
<xsl:variable name="swf-embed-params">{url: '<xsl:value-of
select="concat($lzxdir, $fname, '?lzt=swf', $query-param)"/>', id:
'<xsl:value-of select="concat($canvas-id,'SWF')"/>', width: '<xsl:copy-of
select="$canvas-width"/>', height: '<xsl:copy-of select="$canvas-height"/>',
history: false}</xsl:variable>
<xsl:variable name="dhtml-embed-params">{url: '<xsl:value-of
select="concat($lzxdir, $fname, '?lzt=html&lzr=dhtml', $query-param)"/>',
id: '<xsl:value-of select="concat($canvas-id,'DHTML')"/>', width: '<xsl:copy-of
select="$canvas-width"/>', height: '<xsl:copy-of
select="$canvas-height"/>'}</xsl:variable>
Modified: openlaszlo/trunk/docs/src/xsl/parameters.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/parameters.xsl 2007-12-30 22:14:01 UTC
(rev 7686)
+++ openlaszlo/trunk/docs/src/xsl/parameters.xsl 2007-12-30 22:25:07 UTC
(rev 7687)
@@ -34,7 +34,7 @@
<xsl:param name="index.number.separator" select="', '"/>
<xsl:param name="index.range.separator" select="'-'"/>
<!-- HTML -->
- <xsl:param name="draft.mode" select="'yes'"/>
+ <xsl:param name="draft.mode" select="'no'"/> <!-- Set to 'yes' if you want a
watermark -->
<xsl:param name="draft.watermark.image" select="'./images/draft.png'"/>
<xsl:param name="use.id.as.filename" select="1"/>
<!-- Meta/*.info -->
_______________________________________________
Laszlo-checkins mailing list
[email protected]
http://www.openlaszlo.org/mailman/listinfo/laszlo-checkins
