[Box Backup-dev] DocProject editing setup

[Per Thomsen]

On 8/11/06 9:57 PM, E.W. Peter Jalajas wrote:
> Thanks, Per.
>
> I already had java on my ubuntu dapper box by downloading and running
> automatix. (Debian and ubuntu don't like sun java because it is not
> free as in freedom.)
>
> I downloaded xxe from the website
> http://www.xmlmind.com/xmleditor/download.shtml
> specifically xxe-std-3_4_0.tar.gz
> and followed the simple instructions under Description on that page.
>
> Per Martin, I ran
>
> svn co http://bbdev.fluffy.co.uk/svn/box/trunk boxbackup
>
> and that downloaded the entire box backup product (revision 778; 3327
> files) in just a few seconds.
>
> In the xxe bin directory, I ran
>
> ./xxe
>
> and the java window opened.  I then tried to open the svn-downloaded
> file:
>
> boxbackup/documentation/boxbackup/adminguide.xml
>
> but I get error
>
> Cannot open boxbackup/documentation/boxbackup/adminguide.xml" 
> .../boxbackup/documentation/boxbackup/ExceptionCodes.xml (No such file
> or directory)
>
> {Gosh I wish error messages were all swipe-able for copying and
> pasting...Chris, please take note for Boxi.)
>
> Can you please help me past that error?
>   
Sure. Type 'make' in the boxbackup/documentation/boxbackup directory.
That creates the ExceptionCodes.xml file, and you can then open
adminguide.xml. This also generates the nicer looking HTML pages for
you, as well as the man-pages.

Basically, I only use XXE for editing. 'make' and the other tools are
used to generate the actual readable docs.
> Opening boxbackup/documentation/boxbackup/instguide.xml worked
> perfectly, and I'm poking around that now.  I made a junk change to
> that file in xxe and saved it.  I also ran the menu option, DocBook,
> Convert Document, and made an html file; it wasn't pretty, but quite
> useable.  
>
> How do I make a pretty html page like
> http://www.reedtz.com/boxdoc/instguide/ ?
>   
'make' is your friend... Look at the Makefile, to see what I'm doing.

Thanks,
Per

-- 
Per Reedtz Thomsen | Reedtz Consulting, LLC | F: 209 883 4119
V: 209 883 4102    |   pthomsen@reedtz.com  | C: 209 996 9561
GPG ID: 1209784F   |  Yahoo! Chat: pthomsen | AIM: pthomsen