Arch Linux

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

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

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

---

** Arch Linux Apparel and more ** Arch Linux stickers, laptop bags, jewelery ** I wrote a book on Python 3 ** and one on mental health **

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
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

campy

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