phpBB 3.0 Documentation backend

Discussion of general topics related to the new version and its place in the world. Don't discuss new features, report bugs, ask for support, et cetera. Don't use this to spam for other boards or attack those boards!
Forum rules
Discussion of general topics related to the new release and its place in the world. Don't discuss new features, report bugs, ask for support, et cetera. Don't use this to spam for other boards or attack those boards!
ElbertF
Registered User
Posts: 583
Joined: Fri Dec 03, 2004 4:35 pm
Location: tracing..
Contact:

phpBB 3.0 Documentation backend

Post by ElbertF »

Does anyone have a clue which XML editor is used for the phpBB 3.0 Documentation? By looking at the source code, I suspect it wasn't written by hand.

According to the meta tag, "DocBook XSL Stylesheets V1.70.1" is the generator. Isn't DocBook just a DTD?

edit: I found a list of validating editors.. I'll try XXE.

http://wiki.docbook.org/topic/DocBookAuthoringTools" target="_blank

User avatar
dhn
Registered User
Posts: 1518
Joined: Wed Jul 04, 2001 8:10 am
Location: Around the corner
Contact:

Re: phpBB 3.0 Documentation backend

Post by dhn »

It can be written in any text editor you want, it's XML after all. Most of us are using oXygen XML because it has a docbook environment included and is a fantastic XML editor.

ElbertF
Registered User
Posts: 583
Joined: Fri Dec 03, 2004 4:35 pm
Location: tracing..
Contact:

Re: phpBB 3.0 Documentation backend

Post by ElbertF »

XXE wasn't bad, but I'll try oXygen XML. Thanks. :)

Klors
Registered User
Posts: 95
Joined: Fri Sep 19, 2003 2:08 pm

Re: phpBB 3.0 Documentation backend

Post by Klors »

Altova's XML Spy was pretty good for features and seemed like a nice enough interface, but for some reason I didn't enjoy using it as much as Textpad and uninstalled it. I'll have to try some others.

Graham
Registered User
Posts: 1304
Joined: Tue Mar 19, 2002 7:11 pm
Location: UK

Re: phpBB 3.0 Documentation backend

Post by Graham »

The actual output you see and read is generated using nothing more fancy than xsltproc on the command line, and I know that at least part of it was written in vi :)
"So Long, and Thanks for All the Fish"

Graham
Eeek, a blog!

Uchiha Nick
Registered User
Posts: 397
Joined: Tue Jul 20, 2004 6:21 am
Location: Rotterdam, The Netherlands
Contact:

Re: phpBB 3.0 Documentation backend

Post by Uchiha Nick »

dhn wrote: It can be written in any text editor you want, it's XML after all. Most of us are using oXygen XML because it has a docbook environment included and is a fantastic XML editor.



hmm, its a paid program :( anyone know of a good free one? ( gotta save up some cash, saving for something ^^ )
Image

User avatar
dhn
Registered User
Posts: 1518
Joined: Wed Jul 04, 2001 8:10 am
Location: Around the corner
Contact:

Re: phpBB 3.0 Documentation backend

Post by dhn »

Follow the link in spambot's first post.

ybart10
Registered User
Posts: 34
Joined: Sat May 11, 2002 8:52 am
Contact:

Re: phpBB 3.0 Documentation backend

Post by ybart10 »

Something curious, docbook xslt does not seem to allow chunking into multiple directories.
However, the phpBB documentation is separated into multiples directories.

Did the phpBB documentation had to be separated into multiples directories manually ?

User avatar
dhn
Registered User
Posts: 1518
Joined: Wed Jul 04, 2001 8:10 am
Location: Around the corner
Contact:

Re: phpBB 3.0 Documentation backend

Post by dhn »

ybart10 wrote: Something curious, docbook xslt does not seem to allow chunking into multiple directories.
However, the phpBB documentation is separated into multiples directories.

Did the phpBB documentation had to be separated into multiples directories manually ?

Read up on dbhtml:

Code: Select all

 <chapter id="admin_guide">
       <?dbhtml dir="adminguide" filename="index.html" ?>
You can set this value for each section or chapter. the above means that the directory in which this chapter will be transformed to is adminguide and the filename of the start page inside this directory is index.html. If not set, the filename would be the id of the element (adminguide in this case) and the directory the root one.

This works without any further modifications.

ybart10
Registered User
Posts: 34
Joined: Sat May 11, 2002 8:52 am
Contact:

Re: phpBB 3.0 Documentation backend

Post by ybart10 »

Thanks ! :)

However, is it possible to get the xml source of the documentation ?

Post Reply