You are not logged in.

#1 2004-07-31 16:25:38

campylobacter
Member
From: Austria
Registered: 2004-04-12
Posts: 60
Website

ArchLinux documentation with the GuideXML syntax?

Hi,

I think, that the Gentoo documentation is one of the best in the web. The use XML or Guide XML. You can find more infos at the gentoo page: http://www.gentoo.org/doc/en/xml-guide.xml

Why ArchLinux do not use the same syntax? It´s very easy to learn, and looks better than a wiki. I think so wink

I made a litlle demo, quick and dirty, with the same files from the Gentoo docu, but the ArchLinux design.
There are only one line need, to build an html site:
xsltproc --novalid /home/campylobacter/test/guide.xsl demo.xml > /home/campylobacter/test/demo.html

Look here for the result: http://hollaus-it.at/archlinux/demo.html

It can be an alternative to the wiki system. Has it a worth?

Best Regards,
campy

Offline

#2 2004-07-31 16:37:57

Dusty
Schwag Merchant
From: Medicine Hat, Alberta, Canada
Registered: 2004-01-18
Posts: 5,986
Website

Re: ArchLinux documentation with the GuideXML syntax?

Dennis and I discussed this when we set out to draw up documentation standards, but we decided it was one more markup for people to learn, and had a bit more cruft than the Arch "Keep It Simple" attitude desires.

We devised a documentation and styles guide based on XHTML. This IS the standard:

http://www.archlinux.org/docs/en/guide/ … guide.html

Although it is still open to change and suggestion, it is basically in its final form.

Dusty

Offline

#3 2004-07-31 18:11:25

campylobacter
Member
From: Austria
Registered: 2004-04-12
Posts: 60
Website

Re: ArchLinux documentation with the GuideXML syntax?

Ok, I have only read the wiki wink
It is an valid HTML 4.01 Transitional document, but XHTML is only a little bit different .

I think, that an xml file is more "Keep It Simple", and it has an independent design.

But the XHTML and css solution is also good.

Perhaps we start an german community with the XML-syntax big_smile

campy

Offline

#4 2004-07-31 19:51:40

sarah31
Member
From: Middle of Canada
Registered: 2002-08-20
Posts: 2,975
Website

Re: ArchLinux documentation with the GuideXML syntax?

Correct me if I am wrong but the gentoo guide setup is just a CMS like plone or PHPX. Only i don't see anywhere how users can contribute to it like a wiki. I like the wiki layout much more than the multiple color scheme which gentoo employs in their documentation.

The markup language itself is still very chunky so I really don't see much advantage there.


AKA uknowme

I am not your friend

Offline

Board footer

Powered by FluxBB