above and below the title. (4) This directive inserts the PG header as generated from the metadata. ⁶ A unicode BOM is allowed before this. In fact most Windows editors will add a BOM without asking you. Metadata Directive The metadata directive contains all data that is used to generate the PG header and the PG catalog entry. The scheme is the part before the dot. PG Scheme The PG scheme holds data that is relevant to Project Gutenberg only. Fields In the PG Scheme ──────────────────────────────────────────────── Name Contents ──────────────────────────────────────────────── PG.Id The ebook number. ──────────────────────────────────────────────── PG.Released The PG release date in YYYY-MM-DD format. ──────────────────────────────────────────────── PG.Rights Either ’Public Domain’ or ’Copyrighted’. ──────────────────────────────────────────────── PG.Title A much shortened form of the title. Used in the PG boilerplate in the lines that say: “Start of this PG ebook …” and “End of this PG ebook …”. ──────────────────────────────────────────────── PG.Producer A personal name or organization that helped produce this text. This field may appear more than once. Don’t put more than one name into one field. Repeat the field if necessary. ──────────────────────────────────────────────── PG.Credits A line acknowledging the source of the images or other stuff. ──────────────────────────────────────────────── DC Scheme This scheme holds standard Dublincore stuff and is used by many search engines and the PG cataloguing software. Fields In the DC Scheme ──────────────────────────────────────────────── Name Contents ──────────────────────────────────────────────── DC.Creator Author. A personal name or organization that created the text. May appear more than once. Don’t put more than one name into one field. Repeat the field if necessary. ──────────────────────────────────────────────── DC.Title The full title statement as found on the book’s title page. ──────────────────────────────────────────────── DC.Language The 2 or 3 letter code for all languages used for substantial portions of the text. May appear more than once. Don’t put more than one code into one field. Repeat the field if necessary. The languages listed here are indicative for the catalog and do not set the text language and hyphenation rules. Use the option class language- for that. ──────────────────────────────────────────────── DC.Created The year of original publication if known. ──────────────────────────────────────────────── MARCREL Scheme This is used to record contributors to the text. All these fields may appear more than once. Don’t put more than one name into one field. Repeat the field if necessary. Fields In the MARCREL Scheme ──────────────────────────────────────────────── Name Contents ──────────────────────────────────────────────── MARCREL.edt Editor ──────────────────────────────────────────────── MARCREL.ill Illustrator ──────────────────────────────────────────────── MARCREL.trl Translator ──────────────────────────────────────────────── MARCREL.* See the full list of MARC relator codes. ──────────────────────────────────────────────── No Scheme 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 _file_ , --one =_file_ , --two _file_ , 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.