and <BODY> lines are alway provided by pp2html (with options from outside passe through). HTML Template Files ONLY contain HTML text which is placed inside the <BODY>. - templates adapted - Continued numbered lists ( the ## paragraphs are now supported) - Shiftlevels are handled correctly - the \BOXCOLOR and \BOXTEXT Tags are obsolete now. Their syntax was not consistent: \BOXCOLOR<green> has formerly been used to set the box color for code blocks. But normally all text in the tag body (between < and >) is part of the output and NOT a parameter to the (between < and >) is part of the output and NOT a parameter to the tag. Tag parameters are specified in curly brackets. Therefore the new tag is: \BOXCOLORS{bg=backgroundcolor fg=foregroundcolor} which replaces \BOXCOLR<backgroundcolor> and \BOXTEXT<foregroundcolor> - bugfix: escapes in code-blocks were inactive after embedded code - bugfix: URLs in pp2html were doubled in the output - workaround for TreeApplet Bug: Headers which contain a / are not allowed. Therefore all slashes are replaced with commas ... - Language parameter in \EMBED{lang=html ...} is now caseinsensitive - Version information clarified: pp2html and pp2latex have individual version numbers (build numbers) and belong to a certain version of the PerlPoint-Converters package. - Individual colors (foreground and background) for table of contents, index and normal slides, top and bottom templates: --bgcolor, --fgcolor, --toc_bgcolor, --toc_fgcolor, --idx_bgcolor --idx_fgcolor --top_bgcolor, --top_fgcolor, --bot_bgcolor, --bot_fgcolor --top_linkcolor, --bot_linkcolor, --toc_linkcolor, --idx_linkcolor, .... - new options: --no_contents_indent, --no_contents_bullets This will prevent the table of contents from beeing indented by <UL> </UL> tags and the second option avoids bullets in front of each entry in the table of contents. - optional background images for normal slides, index and table of contents: --back_image, --toc_back_image, --idx_back_image --top_back_image, --bot_back_image - use Cwd instead of `pwd` - Images can now be part of an \XREF tag! - \IMAGE tag now supports BORDER=m option - XREF, PAGEREF and SECTIONREF now consider javascript navigation - --trans_table option re-implemented (had been part of an ancient version of pp2html) - different bullet images for different indentation levels --bullet option can be used more than once! >From README:------------ This is the README file for PerlPoint-Converters $Id: README,v 1.8 2001/03/06 21:21:28 lorenz Exp $ Covered topics: o Introduction o About PerlPoint-Converters o Prerequisits o What's new o Bug Reports Introduction ------------ PerlPoint is a simple text format which allows easy typing of text with headlines, bullet lists, normal text paragraphs, indented paragraphs for code examples etc., from which slides for presentations can be generated by a script without the need of proprietary software. Since there is a large variety of platforms which provide web browsers, HTML is a good choice for the output format. In principle, however, it is possible to generate each output format whose specification is known. At the moment there exist converters for HTML, LaTeX (alpha software) and SDF. The latter both may be used to generate printable output or to provide the basis for further processing. About PerlPoint-Converters -------------------------- This package provides two programs: pp2html pp2latex (still alpha software) They convert an ASCII file written in the `PerlPoint' language to a set of HTML files or to Latex Files respectively. The `PerlPoint' language was initially invented by Tom Christiansen as a simple means for preparing slides. The idea was to just write down your headings and bullet items and then use a simple perl script to create the slides: =Header of first slide * Use your favourite editor * Start headings with a `=' * Bullets items start with an asterisk `*' The syntax of the original version was similar to POD and the layout of the slides was hard coded in Tom's pp2html script. The new syntax provides more felxibility and can be parsed with the PerlPoint::Parser from Jochen Stenzel's PerlPoint-Package. The following list persents some of the features of pp2html and pp2latex: - HTML template files for header, footer and navigation bar - Support of Frame Sets - Support of the TreeControl Applet in tabel of contents - Headers with different levels with or wihout numbering (1, 1.1, 1.2, 2, ...) - Hyperlinks to internal and external pages - Automatic generation of table of contents and navigation links - Automatic generation of index - Bullet-Lists with standard <LI> bullets or with bullets from a gif/jpeg file - Numbered lists and definition lists - Simple tables - Simple text formatting possible For more inforamtion about the PerlPoint syntax and history please refer to the documentation in the PerlPoint-Package from Jochen Stenzel (perldoc PerlPoint::Parser). Prerequisits ------------ This version needs Perl5.005. Note: The fields.pm Module which comes with Perl5.005 is quite old. You should get the newest version from CPAN because the PerlPoint::Parser Module needs a newer version! The pp2html program uses the following packages which are available on CPAN or come with your Perl distribution: Pod::Text Getopt::Long Getopt::ArgvFile PerlPoint::Parser PerlPoint::Backend PerlPoint::Constants The TreeApplet classes are contained in the images subdirectory of this distribution. For more information about the TreeApplet classes refer to http://www.naturallyj.com. This distribution contains an older version which was freely available. What's new in this version -------------------------- This is version 0.009 Please refer to file "Changes". Bug Reports ----------- Please send bug reports and requests to <lorenz.domke@gmx.de> Lorenz Domke -- ------------------------------------------------------------------------- Lorenz Domke lorenz.domke@pixel.de Endelhauserstr. 30 GnuPG Key-ID: BACCE490 lorenz.domke@gmx.de D-80686 München Tel: (0 89) 5 70 33 80 --- BBBS/LiI v4.01 Flag-2 * Origin: Prism bbs (1:2320/38) .

Subj : ANNOUNCE: PerlPoint-Converters 0.009 To : All From : Lorenz Domke Date : Mon Mar 12 2001 12:57 am From: Lorenz Domke The PerlPoint-Converters Package 0.009 has been uploaded to CPAN ================================================================ Regards, Lorenz Domke >From Changes: ------------- Revision history for PerlPoint-Converters. Version 0.009 03/04/2001 - require PerlPoint::Parser 0.32 - new parameters --box_width and --filters for pp2html - URL_INDEX did point to last page, not to index (bug reported by Jeffrey Haemer) - Index entries format changed. Now they look like text ref1 [, ref2, ref3 ...] with "text" beeing the (multiple) index entry and ref1, ref2 ... beeing Hyperlinks as references. The text for the references is either the page number or the chapter number when the --num_headers option has been set. - Cleanup with templates. It has not been quite clear, what has to go to the HTML templates and what is generated by pp2html. For example the line and the tag. There were cases where the header and the line were duplicated, and a "cleanup" in version 0.008 even introduced a bug :-( So I decided to make it more clear. Please read the docu for pp2html (pp2html --help) and the ppdoc.pp file for more information about that. In short: , and <BODY> lines are alway provided by pp2html (with options from outside passe through). HTML Template Files ONLY contain HTML text which is placed inside the <BODY>. - templates adapted - Continued numbered lists ( the ## paragraphs are now supported) - Shiftlevels are handled correctly - the \BOXCOLOR and \BOXTEXT Tags are obsolete now. Their syntax was not consistent: \BOXCOLOR<green> has formerly been used to set the box color for code blocks. But normally all text in the tag body (between < and >) is part of the output and NOT a parameter to the (between < and >) is part of the output and NOT a parameter to the tag. Tag parameters are specified in curly brackets. Therefore the new tag is: \BOXCOLORS{bg=backgroundcolor fg=foregroundcolor} which replaces \BOXCOLR<backgroundcolor> and \BOXTEXT<foregroundcolor> - bugfix: escapes in code-blocks were inactive after embedded code - bugfix: URLs in pp2html were doubled in the output - workaround for TreeApplet Bug: Headers which contain a / are not allowed. Therefore all slashes are replaced with commas ... - Language parameter in \EMBED{lang=html ...} is now caseinsensitive - Version information clarified: pp2html and pp2latex have individual version numbers (build numbers) and belong to a certain version of the PerlPoint-Converters package. - Individual colors (foreground and background) for table of contents, index and normal slides, top and bottom templates: --bgcolor, --fgcolor, --toc_bgcolor, --toc_fgcolor, --idx_bgcolor --idx_fgcolor --top_bgcolor, --top_fgcolor, --bot_bgcolor, --bot_fgcolor --top_linkcolor, --bot_linkcolor, --toc_linkcolor, --idx_linkcolor, .... - new options: --no_contents_indent, --no_contents_bullets This will prevent the table of contents from beeing indented by <UL> </UL> tags and the second option avoids bullets in front of each entry in the table of contents. - optional background images for normal slides, index and table of contents: --back_image, --toc_back_image, --idx_back_image --top_back_image, --bot_back_image - use Cwd instead of `pwd` - Images can now be part of an \XREF tag! - \IMAGE tag now supports BORDER=m option - XREF, PAGEREF and SECTIONREF now consider javascript navigation - --trans_table option re-implemented (had been part of an ancient version of pp2html) - different bullet images for different indentation levels --bullet option can be used more than once! >From README:------------ This is the README file for PerlPoint-Converters $Id: README,v 1.8 2001/03/06 21:21:28 lorenz Exp $ Covered topics: o Introduction o About PerlPoint-Converters o Prerequisits o What's new o Bug Reports Introduction ------------ PerlPoint is a simple text format which allows easy typing of text with headlines, bullet lists, normal text paragraphs, indented paragraphs for code examples etc., from which slides for presentations can be generated by a script without the need of proprietary software. Since there is a large variety of platforms which provide web browsers, HTML is a good choice for the output format. In principle, however, it is possible to generate each output format whose specification is known. At the moment there exist converters for HTML, LaTeX (alpha software) and SDF. The latter both may be used to generate printable output or to provide the basis for further processing. About PerlPoint-Converters -------------------------- This package provides two programs: pp2html pp2latex (still alpha software) They convert an ASCII file written in the `PerlPoint' language to a set of HTML files or to Latex Files respectively. The `PerlPoint' language was initially invented by Tom Christiansen as a simple means for preparing slides. The idea was to just write down your headings and bullet items and then use a simple perl script to create the slides: =Header of first slide * Use your favourite editor * Start headings with a `=' * Bullets items start with an asterisk `*' The syntax of the original version was similar to POD and the layout of the slides was hard coded in Tom's pp2html script. The new syntax provides more felxibility and can be parsed with the PerlPoint::Parser from Jochen Stenzel's PerlPoint-Package. The following list persents some of the features of pp2html and pp2latex: - HTML template files for header, footer and navigation bar - Support of Frame Sets - Support of the TreeControl Applet in tabel of contents - Headers with different levels with or wihout numbering (1, 1.1, 1.2, 2, ...) - Hyperlinks to internal and external pages - Automatic generation of table of contents and navigation links - Automatic generation of index - Bullet-Lists with standard <LI> bullets or with bullets from a gif/jpeg file - Numbered lists and definition lists - Simple tables - Simple text formatting possible For more inforamtion about the PerlPoint syntax and history please refer to the documentation in the PerlPoint-Package from Jochen Stenzel (perldoc PerlPoint::Parser). Prerequisits ------------ This version needs Perl5.005. Note: The fields.pm Module which comes with Perl5.005 is quite old. You should get the newest version from CPAN because the PerlPoint::Parser Module needs a newer version! The pp2html program uses the following packages which are available on CPAN or come with your Perl distribution: Pod::Text Getopt::Long Getopt::ArgvFile PerlPoint::Parser PerlPoint::Backend PerlPoint::Constants The TreeApplet classes are contained in the images subdirectory of this distribution. For more information about the TreeApplet classes refer to http://www.naturallyj.com. This distribution contains an older version which was freely available. What's new in this version -------------------------- This is version 0.009 Please refer to file "Changes". Bug Reports ----------- Please send bug reports and requests to <lorenz.domke@gmx.de> Lorenz Domke -- ------------------------------------------------------------------------- Lorenz Domke lorenz.domke@pixel.de Endelhauserstr. 30 GnuPG Key-ID: BACCE490 lorenz.domke@gmx.de D-80686 München Tel: (0 89) 5 70 33 80 --- BBBS/LiI v4.01 Flag-2 * Origin: Prism bbs (1:2320/38) .