Part 2
Some fields are associated with none of the above schemes.
Fields Without Scheme
──────────────────────────────────────────────── Name Contents ──────────────────────────────────────────────── coverpage A coverpage for those formats (eg. Kindle) that support a cover page. This image must be included in the upload but must not necessarily be put in the text flow. ────────────────────────────────────────────────
Bottom Boilerplate
You must put this at the very bottom of your PG-RST file.
.. pgfooter:: (1)
(1) This directive inserts the PG footer and license.
PG-RST Best Practices
Images
Specify a width option in images and a figwidth option in figures and express it in percent.
If you don’t specify a width, the converter will calculate the width percentile for you, using the formula:
image_width / (980px * 0.8) * 100
(980px is the approx. wide of a browser window with scrollbar on a 1024px wide screen, 0.8 are 10% margins left and right.)
Expressing the image size relative to the screen width is the best way to get images right on a wide variety of devices form iPhones to print.
.. toc−entry:: Richard and Drucilla Martin
.. figure:: images/cover.jpg :align: center :alt: Richard and Drucilla Martin
:lb:`Richard Martin was a slave in Memphis, Tennessee. Drucilla Martin was a slave in Giles County, Tennessee.`
The legend consists of all elements after the caption. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.
[Illustration: Richard Martin was a slave in Memphis, Tennessee. Drucilla Martin was a slave in Giles County, Tennessee.]
The legend consists of all elements after the caption. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum.
[pg!2]
Tests and Examples
Notice
The rest of this file contains tests. You may look at the RST source to learn how things are done.
A generated local table of contents:
Section 3.1 Section 3.2 Section 3.3
A local table of contents as highlights:
Kingston — Instructive remarks on early English history — Instructive observations on carved oak and life in general — Sad case of Stivvings, junior — Musings on antiquity — I forget that I am steering — Interesting result — Hampton Court Maze — Harris as a guide.
ÄÖÜ äöüß Æsop Œdipus cœr. Đ. †‡ ウ. §2.1
‘’ ‚‛ “ ” ‹› em — en –.
“ ‘Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.’ ”
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. [pg 3] At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
――――
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
[pg 4]
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
‘Speak roughly to your little boy, And beat him when he sneezes: He only does it to annoy, Because he knows it teases.’
CHORUS.
(In which the cook and the baby joined):—
‘Wow! wow! wow!’
Summer wanes, the children are grown; Fun and frolic no more he knows; Robert of Lincoln’s a humdrum crone; Off he flies and we sing as he goes: Bob-o’link, bob-o’-link, Spink, spank, spink; When you can pipe that merry old strain, Robert of Lincoln, come back again. Chee, chee, chee.
And now a quote by Lorem Ipsum:
Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita [pg 5] kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet. Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam voluptua. At vero eos et accusam et justo duo dolores et ea rebum. Stet clita kasd gubergren, no sea takimata sanctus est Lorem ipsum dolor sit amet.
―― Lorem Ipsum
[pg 7]
Section 3.1
I pity the man who can travel from Dan to Beersheba, and say “’Tis all barren;” and so is all the world to him who will not cultivate the fruits it offers.
―― Sterne: Sentimental Journey.
Simple List with hyphens
- Wash left ear. - Wash right ear. - Brush teeth.
Simple List with bullets
• Wash left ear. • Wash right ear. • Brush teeth.
Nested List
1. Item 1. a) Item 1a. b) Item 1b. I) Item 1.a.I II) Item 1.a.II III) Item 1.a.III IV) Item 1.a.IV 2. A) i) Item 2.A.i [pg 8] ii) Item 2.A.ii B) i) Item 2.B.i ii) Item 2.B.ii iii) Item 2.B.iii C) Item 2.C 3. Item 3.
Definition List
term Definition.
term 2 Definition 2
Definition 2 paragraph 2.
long term 3 Definition 3
Option List (not used by PG)
-a , command-line option "a" -1 [4m_file_[0m , --one =[4m_file_[0m , --two [4m_file_[0m , Multiple options with arguments.
[pg 123]
Section 3.2⁷
⁷ This title contains a footnote reference. The footnote reference will not show up in the TOC.
Some text so this section isn’t empty.
Section 3.3
THE MAN WHO PLEASES.
_The dearest friend to me, the kindest man,_ _The best-conditioned and unwearied spirit_ _In doing courtesies._
_―― Merchant of Venice._
_He hath a daily beauty in his life._
_―― Othello._
_Such a man would win any woman in the world_ _if a’ could get her good will._
_―― Much Ado About Nothing._
There are few subjects of deeper interest to men and women than that of personal fascination,
«Ora si comincia per quelli di fuori e per quelli di dentro a far grandissima e crudel guerra.»
_Istorie pistolesi._
_TABLE 8_ Types of Computers Used in the Systems Reported
────────────────────────────────── Type Number ────────────────────────────────── ASI 210 1 ─────────────────────────── (3) ASI 2100 2 ────────────────────────────────── CDC 160A 2 ─────────────────────────── (3) CDC 3100 1 ──────────────────────────────────
total computer cost 0.22 ± 0.06 by averaging −−−−−−−−−−−−−−−−−−−−−−−− = 0.23 −> separate ratios for each cost of bare accelerator system
[pg!10]
[pg 99]
Transcriber’s Note
Minor spelling errors have been silently corrected.
Hyphenation has been made consistent.