Introduction

Welcome to the world of PerlPoint. Efforts were made to make your stay as comfortable as possible. Depending on your travel experience, several things might look hard, unusual or rough at very first sight, but don't hesitate to come in and look around. You might discover new promising areas and tell your travel stories another way then.

First, make sure you have the software installed. For these first steps, you need perl (5.00503 or above), PerlPoint::Package and PerlPoint::Converters from CPAN. Install them in the mentioned order, according to the attached instructions (please do not remove the installation directory of PerlPoint::Converters). Additionally, you need a text editor and a Web browser.

PerlPoint is both a presentation and a documentation toolset. More precise, its a toolset to generate presentations and documentations. You will write a simple text and start a converter to make the final documents from this source. The final format is your choice, depending on the used converter. So you can make a presentation, speaker notes, handouts, an internet documentation and a brochure all from the same text source, but looking very individual.

Because of this two step architecture PerlPoint authors deal both with the text format and several converters. The text source describes structure and contents of your document, while a converter adds layout. Let's start.

A First Slide

Open a new text document. Let's communicate the office way of drinking coffee. The first draft may look like this:

* Come when you are thirsty.

* Make new coffee if the pot is empty.

* Fill your cup (regardless of size).

* Insert 0,50 into the box.

This looks perfect - four points to state out. Start a point by a * character at the left margin, and complete it by an empty line. If it contains a lot of text, simply continue on the next line at any position like in

* Fill your cup
  (regardless of size).

The lines will be automatically combined correctly until the documents end or an empty line follows. The whole thing is called a "paragraph". Paragraphs are a base principle of PerlPoint.

Adding Headlines

OK, well - we are almost done with our first sheet. We are only missing a headline. "Enjoy office coffee" might be chosen. We add it to the points.

=Enjoy office coffee

* Come when you are thirsty.

* Make new coffee if the pot is empty.

* Fill your cup (regardless of size).

* Insert 0,50 into the box.

Note that the headline looks very similar to the points - it's a paragraph as well. The startup character makes the difference - each paragraph type has its own. Headlines begin with a =.

Creating Slides

It's time now to make our source a document. HTML can be displayed everywhere, so we choose the converter pp2html which converts PerlPoint sources into HTML pages. As mentioned before, the converter adds layout. HTML layouts can be configured very fine grained by the various options of pp2html, or one can use predeclared layouts called "styles". Luckily, pp2html comes with several example styles, so we take one of those.

Please remember where you installed PerlPoint::Converters from (the directory where you called make install). Let's say it is stored in the environment variable $PPCPATH. Please ask your administrator for assistance if necessary.

Assumed the text source was stored in coffee.pp, you can call pp2html the following way now:

pp2html -style_dir $PPCPATH/pp2html_styles -style orange_slides coffee.pp

Several files are made just where you are. To look at the result, open frame_set.html in a Web browser.

If you want to try another layout, try

pp2html -style_dir $PPCPATH/pp2html_styles -style B<big_blue> coffee.pp

and open slide0001.htm. Notice that with these layouts, a list of contents and navigation elements were automatically added for you, so that a presenter can easily switch between pages.

More Slides

But right now, there's only one page. So back to the source, let's add statistics. Append the following to your source:

=Statistics

We counted our coffee material needs over half a year.
Surprisingly, we consume almost as much milk as coffee!
We need

# 50% coffee

# 40% milk

# 10% sugar

The first paragraph is another headline, opening a new chapter. The next paragraph is of a new type - this is a text paragraph. For convenience, it needs no special startup character. So you can start writing text without thinking of rules. The paragraph ends with an empty line as usual.

The following list consists of paragraphs starting with a #. What's that? The # symbolizes a number, and these paragraphs are made points of an ordered list. They will be replaced by the correct numbers automatically. Store the source, rerun pp2html and look at the results!

pp2html -style_dir $PPCPATH/pp2html_styles -style orange_slides coffee.pp

The new chapter is made a new slide, and the ordered list contains numbers.

Read On

OK, well done! You are now familiar with the base process of PerlPoint working. But there are several more things to discover, including tags, image inclusion, source nesting and on the fly source generation. And there are several more formats to convert sources into, currently including LaTeX, SDF, POD and Clinton Pierce's Perl Projector. Further processing (by additional utilities) provides formatted text, manual pages, PostScript, PDF and more. Read on in the tutorial which will explain these features in detail.

cpanm PerlPoint::Generator::LANGUAGE::Formatter

perl -MCPAN -e shell
install PerlPoint::Generator::LANGUAGE::Formatter