Return-Path: 
 <dev-return-15492-apmail-forrest-dev-archive=forrest.apache.org@forrest.apache.org>
Delivered-To: apmail-forrest-dev-archive@www.apache.org
Received: (qmail 42907 invoked from network); 1 Apr 2005 00:11:14 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 1 Apr 2005 00:11:14 -0000
Received: (qmail 33530 invoked by uid 500); 1 Apr 2005 00:11:14 -0000
Delivered-To: apmail-forrest-dev-archive@forrest.apache.org
Received: (qmail 33498 invoked by uid 500); 1 Apr 2005 00:11:13 -0000
Mailing-List: contact dev-help@forrest.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:dev-help@forrest.apache.org>
list-unsubscribe: <mailto:dev-unsubscribe@forrest.apache.org>
List-Post: <mailto:dev@forrest.apache.org>
Reply-To: dev@forrest.apache.org
Delivered-To: mailing list dev@forrest.apache.org
Received: (qmail 33485 invoked by uid 99); 1 Apr 2005 00:11:13 -0000
X-ASF-Spam-Status: No, hits=0.0 required=10.0
	tests=HTML_MESSAGE
X-Spam-Check-By: apache.org
Received-SPF: neutral (hermes.apache.org: local policy)
Received: from web81603.mail.yahoo.com (HELO web81603.mail.yahoo.com)
 (206.190.37.120)
  by apache.org (qpsmtpd/0.28) with SMTP; Thu, 31 Mar 2005 16:11:12 -0800
Message-ID: <20050401001109.26823.qmail@web81603.mail.yahoo.com>
Received: from [63.202.83.131] by web81603.mail.yahoo.com via HTTP;
 Thu, 31 Mar 2005 16:11:09 PST
Date: Thu, 31 Mar 2005 16:11:09 -0800 (PST)
From: Jeff Levitt <derby@mylevita.com>
Subject: Re: DITA plugin
To: dev@forrest.apache.org
In-Reply-To: <424C7886.3030100@apache.org>
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="0-485008240-1112314269=:26588"
X-Virus-Checked: Checked
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

--0-485008240-1112314269=:26588
Content-Type: text/plain; charset=us-ascii
Content-Id: 
Content-Disposition: inline

--- Ross Gardler <rgardler@apache.org> wrote:

> OK, I've had a look at the build files. The
> preprocessing stage is 
> actually optional. There are some things that don't
> work if you don't do 
> it (like conrefs whatever they are).
> 

Conrefs are strings pulled in from other files.  So
for example, instead of calling our product "Derby
Version 10" everywhere, we can put the version number
in a conref file, and call it whenever we want it in
the dita files.  That way we only change the version
number in one place when he have a new release.  You
might call a conref an entity depending on what tools
you use, but for DITA, we use a conref file.

I suppose we can skip that step for now.

> So, I propose that for this first instance we ignore
> the preprocessing 
> step and just focus on getting the files into a
> forrest site.
> 
> I'm done for the night now so here's where I am up
> to. I should get time 
> to look at this again in a few days time. In the
> meantime if you want to 
> have a go at getting started, I (and others) will be
> glad to answer 
> questions.
> 
> ----
> 
> It seems that this will not be just one plugin, it
> will be two. One (an 
> internal plugin) to generate the site.xml (or
> book.xml) files and one 
> (and input plugin) to generate the XDocs.
> 
> 
> The Dita Toolkit provides a set of XSL sheet sfor
> building HTML or PDF 
> from DITA files. Since we do our own PDF generation
> we'll focus on the HTML.
> 
> Ignoring the preprocess stage for now, there are two
> important targets:
> 
> dita.map.xhtml Target
> ---------------------
> 
> This target is in ditatargets.xml
> 
> This appears to be the target that creates the table
> of contents:
> 
> <xslt processor="trax"
> 		basedir="${dita.temp.dir}"
> 		destdir="${output.dir}"
> 		includes="${dita.input}"
> 	
>
style="${dita.script.dir}${file.separator}map2htmtoc.xsl">
>    <param name="DITAEXT"
> expression="${dita.extname}" if="dita.extname"/>
>    <mapper type="glob"
> from="*${dita.input.filename}" 
> to="*${args.xhtml.toc}.html"/>
> </xslt>
> 
> 
> Since ths is the table of contents, it will create
> our site.xml and will 
> belong in an internal plugin.
> 
> Expressed as the beginnings of a Forrest pipeline
> this is:
> 
> <map:match pattern="site.xml".>
>    <map:generate src="?????"/>
>    <map:transform
> src="resources/stylesheets/map2htmtoc.xsl"/>
>      <map:parameter name="DITAEXT" value="?????"/>
>    </map:transform>
>    <map:seriliaze type="xml"/>
> </map:match>
> 
> FIXME: What file are we generating from here? i.e.
> what is the DITA 
> equivalent to our site.xml
> 
> FIXME: What is the parameter DITAEXT for?
> 

The ditaext value should be ".dita"

The toc that gets generated is a simple html file. 
Here's a simplified version of the Derby Admin Guide
toc file that gets generated:

<html>
<head><META http-equiv="Content-Type"
content="text/html; charset=UTF-8">
<base target="contentwin"><title>Server and
Administration Guide</title>
</head>
<body>
<UL>
<LI><a href="radmincopyright.html">Copyright</a></LI>
<LI><a href="cadminpreface30074.html">About this
guide</a>
<UL>
<LI><a href="cadminpreface11181.html">Purpose of this
guide</a></LI>
<LI><a
href="cadminpreface22460.html">Audience</a></LI>
<LI><a href="cadminpreface23947.html">How This
Document Is Organized</a></LI>
</UL>
</LI>
</UL>
</body>
</html>

I just removed a lot of bullets from that toc for
simplicity...
I dont know if thats what you can use, since it sounds
like you would need an xml nav tree instead of an html
one.  In that case, maybe we should use the eclipse
transform instead (also in ditatargets.xml).  The
eclipse transform is designed to create xhtml content
with an xml nav tree (toc, in case you dont use the
term, stands for table of contents, basically a nav
tree).  These files are usually thrown in an eclipse
plugin that allows you to create an infocenter based
on eclipse.  But I think we can use them with Forrest
instead.  I'm attaching the file I attached earlier,
but the xhtml version (is it the same?).  Here is a
simplified version of the xml toc that gets generated
from the eclipse transform of the toolkit:


<?xml version="1.0" encoding="UTF-8"?>
<?NLS TYPE="org.eclipse.help.toc"?>

<toc label="Server and Administration Guide"
topic="radmincopyright.html">
<topic label="Copyright" href="radmincopyright.html"/>
<topic label="About this guide"
href="cadminpreface30074.html">
<topic label="Purpose of this guide"
href="cadminpreface11181.html"/>
<topic label="Audience"
href="cadminpreface22460.html"/>
<topic label="How This Document Is Organized"
href="cadminpreface23947.html"/>
</topic>
</toc>

(many bullets removed for simplicity)


> dita.topics.xhtml
> -----------------
> 
> This target is in ditatargets.xml
> 
> This target is the "meat" of the transformation. It
> provides the main 
> XSLT transformation:
> 
> <xslt processor="trax"
> 		basedir="${dita.temp.dir}"
> 		destdir="${output.dir}"
> 		includes="${fullditatopc.list}"
> 		extension=".html"
> 	
>
style="${dita.script.dir}${file.separator}dita2xhtml.xsl">
>          <param name="DITAEXT"
> expression="${dita.extname}" 
> if="dita.extname"/>
>          <param name="FILTERFILE"
> expression="${dita.input.valfile}" 
> if="dita.input.valfile"/>
>          <param name="CSS" expression="${args.css}"
> if="args.css"/>
>          <param name="CSSPATH"
> expression="${args.csspath}" 
> if="args.csspath"/>
>          <param name="HDF" expression="${args.hdf}"
> if="args.hdf"/>
>          <param name="HDR" expression="${args.hdr}"
> if="args.hdr"/>
>          <param name="FTR" expression="${args.ftr}"
> if="args.ftr"/>
>          <param name="DRAFT"
> expression="${args.draft}" if="args.draft"/>
>          <param name="ARTLBL"
> expression="${args.artlbl}" if="args.artlbl"/>
> </xslt>
> 
> This is what will provide our internal formats and
> so this belongs in an 
> input plugin.
> 
> Expressed as the beginnings of a Forrest pipeline
> this is:
> 
> <map:match pattern="**.xml".>
>    <map:generate src="{1}.xml/>
>    <map:transform
> src="resources/stylesheets/dita2xhtml.xsl"/>
>          <map:parameter name="DITAEXT"
> expression="?????"/>
>          <map:parameter name="FILTERFILE"
> expression="?????"/>
>          <map:parameter name="CSS"
> expression="?????"/>
>          <map:parameter name="CSSPATH"
> expression="?????"/>
>          <map:parameter name="HDF"
> expression="?????"/>
>          <map:parameter name="HDR"
> expression="?????"/>
>          <map:parameter name="FTR"
> expression="?????"/>
>          <map:parameter name="DRAFT"
> expression="?????"/>
>          <map:parameter name="ARTLBL"
> expression="?????"/>
>    </map:transform>
>    <map:transform
> src="{forrest:stylesheets}html2document.xml"/>
>    <map:serialize type="xml"/>
> </map:match>
> 

These ????? are just parameters.  We dont use a css
file for our project, for example.  We dont enter any
of these parameters at all for the Derby builds...
--0-485008240-1112314269=:26588
Content-Type: text/html; name="cadminhubbkup21105.html"
Content-Description: cadminhubbkup21105.html
Content-Disposition: inline; filename="cadminhubbkup21105.html"

<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="copyright" content="(C) Copyright 2005" />
<meta name="DC.rights.owner" content="(C) Copyright 2005" />
<meta content="public" name="security" />
<meta content="index,follow" name="Robots" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta content="concept" name="DC.Type" />
<meta name="DC.Title" content="Backing up encrypted databases" />
<meta content="Encrypted databases, backing up, Backup, of encrypted databases" name="DC.subject" />
<meta content="Encrypted databases, backing up, Backup, of encrypted databases" name="keywords" />
<meta content="XHTML" name="DC.Format" />
<meta content="cadminhubbkup21105" name="DC.Identifier" />
<meta content="en-us" name="DC.Language" />
<link href="commonltr.css" type="text/css" rel="stylesheet" />
<title>Backing up encrypted databases</title>
</head>
<body id="cadminhubbkup21105"><a name="cadminhubbkup21105"><!-- --></a>


<h1 class="topictitle1">Backing up encrypted databases</h1>


<div>
<p>When you back up an encrypted database, both the backup and the log files
remain encrypted. To restore an encrypted database, you must know the boot
password.</p>

</div>

</body>
</html>
--0-485008240-1112314269=:26588--