1. test01

2. Hello

Hello: @greeting@, world

Hello: hello, world

POD-style markups: hello, world ,   hello, world,

hello, world , hello, world .

Def-style markups: hello, world

This should be red. and this is back to black.

Here are some escaped chars: <, >, &, ", #.

This is will be centered.

As will this (using a skipped line).

But not this.

This is will be centered.
As will this (using a break).
But not this.

Here is a rule or pagebreak:


Here is after the rule or pagebreak.

2.1. test02

3. My level 1

4. My level 1:

4.1. My level 2

4.1.1. My level 3

4.1.1.1. My level 4

4.1.2. My level 3:

5. My level 1

5.1. My level 2

5.2. test03

6. Nested Lists

With various styles
Unordered
Begin with =list *
  • item 1
  • item 2
Numbered
Begin with =list 1
  1. item 1
  2. item 2
Alphabetic
Begin with =list A
  1. item 1
  2. item 2
Begin with =list a
  1. item 1
  2. item 2
Descriptive
Begin with =list []
item 1
Is the first item
item 2
Is the second item
Altogether:
Descriptions, with
  • Bullets, with
    1. Numbers, with
      1. Upper-case alphas, with
        1. Lower-case aplhas

7. over...back

item 1
This is item 1.
item 2
This is item 2

8. Fully numbered

8.1. test04

9. Tables

Feature Example
simple stylewithout caption, using default settings for the table
multi-line rows this is a long, long, long, long, long, long, long, long,long, long,long, long, long, long, long, long, line.

with a break
embedded font markups This is italics

my caption
Feature Example
simple stylewith caption, using default settings for the table
multi-line rows this is a long, long, long, long, long, long, long, long,long, long,long, long, long, long, long, long, line.

with a break
embedded font markups This is italics

With markup block
Feature Example
markup blockThis is a list:
  1. item 1
  2. item 2
  3. item 3
another row with some data

with grid
Feature Example
fancy styleusing set col widths and grid on
multi-line rows this is a long, long, long, long, long, long, long, long,long, long,long, long, long, long, long, long, line.

with a break
embedded font markups This is italics

without grid
Feature Example
fancy styleusing set col widths and grid off
multi-line rows this is a long, long, long, long, long, long, long, long,long, long,long, long, long, long, long, long, line.

with a break
embedded font markups This is italics

9.1. test05

10. verbatim

  This is verbatim

     with spaces and odd indention, 
        and no <BR> interpolation 
And this is after the verbatim.

11. include_verbatim

Next, we do include_verbatim:

=include_verbatim dummy.pdx

line 1: This is I<included> from the dummy.pdx file.
line 2: An embedded include, to another dir:
=include ../../doc/dummy.pdx
line 4
line 5
line 6: final line

12. include

Next we do a pdx include. We mark before and after with "|". Notice that it recursively nests files 3 levels, leading to the closing series of "line 4...".

=include dummy.pdx | line 1: This is included from the dummy.pdx file. line 2: An embedded include, to another dir: line 1: This is included from the dummy.pdx file. line 2: An embedded include line 1: This is doc/dummy2.pdx, included from doc/dummy.pdx file. line 2: An embedded include, to another dir:

line 1: This is I<included> from the dummy.pdx file.
line 2: An embedded include, to another dir:
=include ../../doc/dummy.pdx
line 4
line 5
line 6: final line

line 4 line 5 line 6: final line

line 4 line 5 line 6: final line

line 4 line 5 line 6: final line

|

13. Driver-specific includes

13.1. include_for

This allows inclusion of a pdx file taliored to a given driver

=include_for html dummy_html.pdx This is a block of pdx to be included only in html files. Thus it could be used for autogenerated chunks of html, generated elsewhere and placed here in a begin block. E.g.,:

This is raw HTML

=include_for latex dummy_latex.pdx

=include_for docbook dummy_docbook.pdx

13.2. include_raw

This allows inclusion of a raw driver-style file, for that driver

=include_raw html dummy_raw_html.html

This is raw HTML

=include_raw latex dummy_raw_latex.tex

=include_raw docbook dummy_raw_docbook.sgml

14. Cuts

Pod uses =cut to shift from pod to raw programming code, and =pod to shift back. This allows embedded documentation in perl modules.

Here is a cut. We shouldn't see anything during the cut: And now we are back in business.

14.1. test06

15. dummy.pdx

That was a link in a header

External Link
dummy.pdx
Internal Link
A reference somewhere in the file.

We'll use verbatim to get far way in the file...

.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.
.

Ok, here is our reference

15.1. test07

The following is a quote:

This is a quoted section. It can have internal formatting, e.g.:

  • item 1
  • item 2

This is after the quoted section.

15.2. test08

16. Head1

This is text in Head1.

16.1. Head2

This is text in Head2.

16.1.1. Head3

This is a list in Head3.
  • Item 1
    1. Item 1
  • Item 2

16.2. test10

This is an inline TeX math entry, from here: test09_L036.png: to here

This is a TeX math entry:

test09_L037.png