Go Back   DaemonForums > Miscellaneous > Guides

Guides All Guides and HOWTO's.

Thread Tools Display Modes
Prev Previous Post   Next Post Next
  #1   (View Single Post)  
Old 7th May 2008
J65nko J65nko is offline
Join Date: May 2008
Location: Budel - the Netherlands
Posts: 3,503
Default Why you should write a guide/howto in XML

Several of the howto's/guides I have written I wrote in XML.. You can consider this XML file as a source file.

With a XSLT file you can compile/transform this XML source file into another format. I have one to produce Vbulletin formatting and another XSLT file produces HTML.

Advantage is that you need only once source file.

The Vbulletin version can be pasted into a post in the Guides section.
The HTML version you can attach to the post for downloading. That way people can easily print your HTML formatted guide from a browser.

For example see http://www.bsdforums.org/forums/showthread.php?t=50433 where the first three posts are text formatted with Vbulletin tags. In the fourth and last post you can download the HTML version.

The Vbulletin version has these CVS tags
$Id: new-iso-itis.xml,v 1.11 2007/06/27 04:41:19 j65nko Exp $
$Id: vbul-html.xsl,v 1.6 2007/06/27 04:49:57 j65nko Exp $
The HTML version has
Id: new-iso-itis.xml,v 1.11 2007/06/27 04:41:19 j65nko Exp $
$Id: howto.xsl,v 1.7 2007/06/27 01:04:44 j65nko Exp $
Notice the identical CVS tags for the new-iso-itis.xml source file while the *xsl files are different.

Before I write a guide about writing a guide using this method, I would like to have some feedback from others. So if somebody is interested in playing with this stuff then please let me know.
You don't need to be a genius to debug a pf.conf firewall ruleset, you just need the guts to run tcpdump
Reply With Quote

Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off

Forum Jump

Similar Threads
Thread Thread Starter Forum Replies Last Post
/tmp on ram write denied gosha OpenBSD General 8 29th March 2009 04:46 PM
I've read the installation guide...but! wubrgamer FreeBSD General 5 20th September 2008 02:37 PM
[F1] write usb modem driver raixun Programming 7 17th July 2008 11:06 AM
Guide for KDE over SSH from Vista ua549 FreeBSD General 13 13th June 2008 07:20 PM
[VSFTPD] Can't write in directory Sunsawe General software and network 7 1st June 2008 11:29 PM

All times are GMT. The time now is 08:09 PM.

Powered by vBulletin® Version 3.8.4
Copyright ©2000 - 2018, Jelsoft Enterprises Ltd.
Content copyright © 2007-2010, the authors
Daemon image copyright ©1988, Marshall Kirk McKusick