Fubar'ed hints - fixed now
andersonlizardo at yahoo.com.br
Sat Nov 8 11:45:31 PST 2003
On Fri, 07 Nov 2003 21:52:24 -0700, Gerard Beekmans wrote:
> On Fri, 2003-11-07 at 20:44, Anderson Lizardo Gomes wrote:
> > I think it's time to write a README describing each script on the
> > server... I can write it, if you don't mind ;-)
> Go right ahead.
Done and attached. It also describes briefly the templates and which
scripts use them. Feel free to send suggestions to improve this doc.
Should I commit this file to website CVS? It's a nice start guide to
anyone who wants to change something on the site. Jeroen, you may want
to update this doc to include some detail I may have forgotten.
-------------- next part --------------
This README describes the scripts, templates and databases used to generate
Written by Anderson Lizardo <lizardo at linuxfromscratch.org>
Last update: Sat Nov 8 09:14:54 MST 2003
The entire website is generated through a script named update-website.sh. It
fetches the necessary files from CVS and calls some scripts to generate
specific sections. In summary:
Some of the above scripts use pieces of XHTML code called "templates". Those
templates are section-dependent and avoid unecessary duplication of data on
The manage_news.pl script uses simple MIME files, called "databases", for news
2. The scripts
2.1. cvs2cl.pl and cl2html.pl
Those two scripts convert the output of "cvs log" to XHTML, for each section
that uses CVS. They are: LFS, ALFS, BLFS, HINTS, Patches and website
This script is reponsible for publishing news for each website section and for
archiving old news. It uses MIME databases called news-YYYY.txt, where "YYYY"
is the current year.
This script generates RSS feeds from the most recent news items. Currently,
only LFS and BLFS have RSS feeds.
This script generates a brief description of each available hint, and outputs
this information in XHTML format.
3. The templates
3.1. news-top.html and news-bottom.html
Those two templates compose, together with manage_news.pl output, the
news.html file for each section.
3.2. archive-top.html and archive-bottom.html
Those two templates compose, together with manage_news.pl output, the XHTML
tree for the news archives.
3.3. website-top.html and website-bottom.html
Used to generate the website information section. They are concatenated with
3.4. hints/list-top.html and hints/list-bottom.html
Used together with genlist.sh to create a summary of available hints.
4. The news databases
They are plain text files, in MIME format, used to store news items. There is
one database for each website section.
More information about the website