The LinuxFocus Article Template Format
ArticleCategory: [Es gibt verschiedene Artikel Kategorien]
AuthorImage:[Ein Bild von Dir]
TranslationInfo:[Autor und ‹bersetzer]
original in en Joe Templatewriter
en to es Joe Translator
es to fr Jim Jimmy
AboutTheAuthor:[Eine kleine Biographie über den Autor]
Here you write a little paragraph about you. What you do, who you
Abstract:[Hier sollte eine kleine Zusammenfassung stehen]
In the "Abstract chapter" you write a little summary about your
This article is an example article which shows how to use the
the LinuxFocus article template format. This format is used as a internal format
for EVERY article. We call the format also meta format as it is only
the internal format.
ArticleIllustration:[Das Titelbild des Artikels]
ArticleBody:[Der eigentliche Artikel. Überschriften innerhalb des Artikels sollten h2 oder h3 sein.]
What is the template format?
At LinuxFocus we use an internal html file format. This is a very
simple html file which can then easily be converted into the final
article format. We call this template format also meta file format.
What is a meta file format?
A meta file format is something that is only used during development
and it is not intended to be the final format in which documents are published.
The advantage of such a file format is that you can change the layout of
the final articles without the need to re-write the articles.
It is also easier to feed information about the articles into a database as
the articles have a in the meta file format a very strict structure.
The LinuxFocus meta file article format is
simple but powerful and flexible.
A number of different possibilities exist for the definition of such
a meta file format. Here are some possibilities:
- use a plain text file
- use html and put the extra information like abstract, about the author, category etc ... into an extra text file.
- use xml
- use M4
All these possibilities are valid alternatives but we wanted something
for LinuxFocus that is self contained (all information in one file), easy
to use and well known to everybody.
The LinuxFocus article meta file format is plain HTML but with a special
structure. The format is such that it can be viewed with any browser (no
special tags) and is very simple (no nested constructs).
When should I use this meta file format?
The LinuxFocus HTML meta file format is the official format since June 1999.
is internally handled in that format. It is the file format used during
translation of the articles. All articles must be written in that format.
It is only before publishing that they get converted. The program lfparser
is used to check and convert an article form the meta file format into
the final format.
How does the file meta file format look like?
The LinuxFocus HTML meta file format is plain html but starts with a number
of headings with clearly defined order and heading level.
- title of the article on heading level 1
- ArticleCategory on heading level 4 followed by one of the valid
LinuxFocus article categories. The lfparser program will also tell you what the
categories are if you get them wrong.
- AuthorImage on heading level 4 followed by a <IMG SRC...>
tag with an image of the author.
- AuthorName on heading level 4 followed by a HREF to the home page
of the author or his e-mail.
- AboutTheAuthor on heading level 4 followed by a short biography about
- Abstract on heading level 4 followed an abstract of the article.
The abstract is just a normal html paragraph.
- ArticleIllustration on heading level 4 followed by a <IMG SRC...> tag with a title page image for the article.
- ArticleBody on heading level 4. After this tag the actual article comes
as a normal html article. You should arrange your chapter headings
on H2 or H3 heading level. This will make it possible to generate the index
automatically. Please note that the heading tags <H2>, <H3> may not contain any other tags like <FONT...> etc...
As you see it is a number of simple heading and the actual article body
is just plain html. You can write there what ever you want. For you as an
author of an article the meta file format is much easier to use than
the final article structure as it does not have any complex tables and
What article categories are available?
Under the keyword <H4>ArticleCategory:</H4> you say to which
category your article belongs.
The ArticleCategory can have one of the following values:
- System Administration
- Software Development
- UNIX Basics
- Kernel Corner
Software and Tools
A perl program called lfparser exists to check and convert a LinuxFocus meta format
article into the final format. You should run this program every time
when you write, translate or updated an article. You can think of
lfparser as a compiler that takes meta file html articles as input
and produces the final article.
lfparser can be down loaded free from
As the author of an article you can also get templates from the
To run lfparser you need only a working installation of perl 5.004
or higher. Perl is included in every distribution of Linux®. Therefore
you just unpack the tar archive in which lfparser is delivered
(tar zxvf lfparser-X.Y.tar.gz)
and you can use it right away.