Change 20071019-ben-b by [EMAIL PROTECTED] on 2007-10-19 21:30:38 PDT
in /Users/ben/src/svn/openlaszlo/branches/paperpie/docs
for http://svn.openlaszlo.org/openlaszlo/branches/paperpie/docs
Summary: Live examples links for developer's guide and reference
New Features:
Bugs Fixed:
LPP-4794 Editor for live code examples in dguide (Introduction to
Components chapter) isn't working
LPP-4696 Edit buttons missing from dguide code examples
LPP-4024 Clicking "edit" on doc example causes Firefox launch
inappropriate inquiry
LPP-4683 Parameterize path to source in live-editor for examples
in dev guide
Technical Reviewer: none
QA Reviewer: (pending)
Doc Reviewer: sundman (pending)
Documentation:
Live examples and links to edit live examples should all work, in
reference,
developers guide, and tutorials.
Release Notes:
Details:
docs/src/build.xml - Rearranged paths for building the reference
guide so that
the directory paths make sense. Everything goes from docs/src/
developers to
docs/build to docs/developers. I think this is how it was
*designed* to work,
but it's not quite how it *was* working.
1) The code examples go from the developers.input.dir
to the developers.build.dir in the developers.preprocess
target.
2) In the developers.examples.preprocess target, the examples
come from the
docs.build.dir and are transcluded in the developer's
guide index.dbk.
3) In developers.html.generate target, the input comes from
developers.build.dir
and is written out to docs/
Also, don't build the contributor's guide. It takes a long time,
and we're
not using it right now.
docs/src/xsl/common-html.xsl - Added templates and variables to keep
track of
where the current output is relative to $LPS_HOME. Various
things (like the link
to the editor.jsp) need to refer to $LPS_HOME, and other things
need to know
how far nested they are down from $LPS_HOME/docs. Rather than
being incredibly
clever and figuring it out by regexp analysis of the current
path, we just
check which part of the book we're building now, and map that
directly
to the relative path information we need.
Using this information, I rearranged the hrefs in the live
examples button
and link so that it works for both the developers guide, the
reference guide,
and the tutorials.
For the purposes of development, I have inserted some debugging
information
immediately after each live example. This will be removed before
we ship.
docs/src/xsl/simple-driver.xsl - Changed to test out techniques for
analyzing
local variables and directories.
Tests:
Files:
M src/build.xml
M src/xsl/simple-driver.xsl
M src/xsl/common-html.xsl
Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20071019-ben-
b.tar
