Tools included in this package:

lfparser -- article meta file format compiler (compiles
            the source code article to the final article)
runlfparser -- script to run lfparser on a whole directory

webls_issue -- script to generate an index.html file from compiled
               (lfparser output files) articles in this directory

lfpdf_remote -- generate pdf files with netscape 4.x This script
                processes the file LangSection/Archives/htmlfiles.txt
                to get information about available articles.

---------------------------------------------
lfparser
========
This is the LinuxFocus article meta file format compiler.

To run lfparser you need perl 5.004 or higher.

Examples of the meta file format can be found in Examples/article
template.meta.html is the meta file and template.html the compiled output.

run lfparser -h to get help and usage imformation.

The ArticleCategory can have one of the following values:
 Forum, Applications, Hardware, Webdesign, System Administration,
 Software Development, Graphics, UNIX Basics, Kernel Corner, Interviews
 Community
---------------------------------------------
Usage Example:
 lfparser -l il 001
Language: il, Reading article001.meta.shtml .... writing article001.shtml ...
  
---------------------------------------------
The script runlfparser can be used to run lfparser on a whole
directory:
> runlfparser ./March2000
running lfparser  ./March2000/article137.meta.html > ./March2000/article137.html
running lfparser  ./March2000/article138.meta.html > ./March2000/article138.html
running lfparser  ./March2000/article140.meta.html > ./March2000/article140.html
running lfparser  ./March2000/article142.meta.html > ./March2000/article142.html
running lfparser  ./March2000/article146.meta.html > ./March2000/article146.html
running lfparser  ./March2000/article147.meta.html > ./March2000/article147.html

---------------------------------------------
Optionally you can have a .lfparsercfg file in
your home directory where you can specify the follwing options:
default language: lang
output style: style

Example:
# comment
lang = de # is german the default language
style = 2 # new style, 1 would be old style
#

---------------------------------------------
lfparser was written by Guido Socher <guido@linuxfocus.org>

revision history:
-----------------
1999-06-15: version 0.1: initial version
1999-06-16: version 0.2: WSIWYG editors add lots of <BR> &nbsp; stuff
                         this can now also be handled.
1999-06-18: version 0.3: Now everything can be internationalized by 
                         use of the intdat table.
                         Entries for French added.

1999-06-20: version 0.4: Minor bug fixes.
                         Dutch version added.

1999-06-20: version 0.5: Serious bug fix: a html comment was not interpreted
                         correctly.
                         The doctype macro is not internationalised.
1999-07-26: version 0.6: The table of content generation works now
                         also for headers that have a <font ..> tag inside
                         the <h2> or <h3>.
                         Option -t added. This adds a 
                         <BASE href="http://www.nl.linuxfocus.org/English/articles/">
                         to the article to allow testing when the images
                         from ../../common/images are not available locally.
                         _LF_ expands to Linux<font color="red">Focus</font>
                         "by" is now written infront of the author name.
                         New tag TranslationInfo replaces AuthorName tag.

1999-09-17: version 0.7: -use UL instead of OL for the index.
                         -The AboutTheAuthor is mandatory but you may choose
                         not to provided any data after it. In this case the
                         'about the author' line will not be printed in the
                         final article. This should mainly be use for old
                         articles where it is difficult to get that info.

1999-09-17: version 0.8: -new article category: Games
1999-11-04: version 0.9: -chinese gb added.
1999-12-06: version 1.0: -do not remove paragraph in abstract
                         -do not ignore text tags with out a word character
                          in the heading part. This used to
                          corrupt a string like ...</TT> (<TT>... 
1999-12-18: version 1.1: -link to lfcomment
2000-01-21: version 1.2: -link to lftalkback
2000-01-22: version 1.2b: -make it possible to switch of lftalkback
2000-03-01: version 1.3: -lftalkback chapter
2000-03-20: version 1.4: - option -T works now.
2000-04-23: version 1.5: - write LinuxFocus.org in footer
                         - Use Server Side Include to include ../../dynahead.shtml
                         - the script runlfparser added
2000-07-10: version 1.6: - bugfix remove newline from transinfo
2000-07-13: version 1.7: - bugfix default language handling and 
                           latin1 char conversion changed.
2000-08-22: version 1.8: - make it look better in mozilla (alignment of hr)
2000-10-30: version 1.8: - make it look better in mozilla (alignment of hr)
2000-11-02: version 1.9: - new layout, FDL copy right
2000-11-04: version 2.0: - link to FDL now working
2000-11-05: version 2.1: - there was still a bug in the fix for the 
                           tailing space problem.
2000-11-15: version 2.2: - more hidden instructions in the generated code
2000-11-26: version 2.3: - palm doc
2000-12-22: version 2.4: - tidy inserted some new lines that caused problems.
2001-01-04: version 2.5: - customized for Turkish
2001-01-06: version 2.6: - Corrected errors in Turkish added updates for Dutch.
2001-01-20: version 2.7: - Russian added, style sheet for fixed width <pre>
                           tags
2001-01-25: version 2.8: - gutenpalm conversion
                         - palm conversion only for european languages
                           (produces garbage otherwise)
                         - added special comments to make 2pda conversion
                           better.
2001-02-02: version 2.9: - handle author names in e-mail addr with no
                           latin 1 characters.
                         - korean support added
2001-03-02: version 2.10: - remove alt tags from the map.
                          - arabic added  
2001-03-09: version 2.11: - more arabic updates
2001-03-31: version 2.12: - new header, no more image maps
2001-04-30: version 2.13: - put a number of tags as comments such
                            that one can obtain important information
                            easily with grep.
                          - don't hardcode index.html it might be in future
                            index.shtml
                          - Spanish updated
2001-05-23: version 2.14: - Portugues added
2001-05-24: version 2.15: - Error when space in translation info
                            Check for all keywords.
2001-06-09: version 2.16: - Check line length inside <pre> for better printing.
2001-07-01: version 2.17: - 
2001-10-16: version 2.18: - Turkish images for old layout, Translator at the
                            top of the page ~/.lfparsercfg file
2001-10-21: version 2.19: - Italian added, Russian updated. Shortcut: 
                            just specify article number and not the full file
                            name.
2001-10-22: version 2.20: - Italian updated
                          - cosmetc updates
2001-10-28: version 2.21: - removed warning when no config file found
                          - e-mail addresses where too small.  
2001-11-10: version 2.22: - Hebrew added.
2001-12-13: version 2.23: - Chinese GB2312 encoding (new simplified char set)
                            updated.
2002-01-03: version 2.24: - There is now support for female and multiple
                            authors and translators gender="female" 
                            gender="mplural" gender="fplural"
2002-01-18: version 2.25: - Ensure better and faster formatting of
                            the left column.
2002-01-19: version 2.26: - Shorten the header, updates in arabic
2002-02-27: version 2.27: - make lines in style sheet shorter
                          - blue divider bar constructed with table is better
                            for mozilla.
2002-05-13: version 2.28: - added style sheet for .mark
                          - chinese should have its own talkback and not
                            the english.
                          - Polish added as language
                          - allow nospam: as mailto tag
2002-06-27: version 2.29: - Fix: Mozilla has problems with the divider line
                            after the abstract.

2002-09-03: version 2.30: - Fix: DOCTYPE must always end in //EN

2002-09-20: version 2.31: - include icon for mozilla
                          - check for unescaped &

2002-10-25: version 2.32: - new ancient to generate articles from 1998
                          - option to not include palm download

2002-11-01: version 2.33: - option to handle old article headers
                          - updates on Polish

2002-11-04: version 2.34: - fix display bug in old header for opera

2002-12-19: version 2.35: - pre.code style sheet

2003-03-07: version 2.36: - Don't not act on LANG environment variable.

2003-04-18: version 2.37: - Hindi added as lanuguage
                          - no more palm conversion by default

2003-05-29: version 2.38: - A button to go back to the issue

2003-06-16: version 2.39: - Back button now translated to several languages

2003-06-18: version 2.40: - turkish and portugues "Back button" added.
                          
2003-07-02: version 2.41: - errors in spanish text corrected

2003-07-11: version 2.42: - turkish updates

2003-07-21: version 2.43: - more turkish updates: "Ev" -> "Ana Sayfa"

2003-12-09: version: 2.44 - serbian and farsi (Iran)

2003-12-16: version: 2.45 - farsi (Iran) must be dir="rtl"

2004-01-21: version: 2.46 - serbian and polish updates

2004-08-21: version: 2.47 - replace %28 %29 by ( and ) in e-mail addr.
                          - creative commons license

2004-08-31: version: 2.48 - css to keep left table from running into the text

2004-10-13: version: 2.49 - update for new frontpage

2004-10-17: version: 2.50 - more updates for new frontpage
                          - added webls_issue program

2004-11-06: version: 2.51 - Indonesian now supported

/* vim: set sw=4 ts=4 et: */
