Read Ebook: The Project Gutenberg RST Manual by Perathoner Marcello

Font size: 10 px 15 px 20 px 25 px 30 px 35 px

Background color: BlackWhiteGrayLight GrayDark GrayDim Gray

Text color: BlackWhiteGrayLight GrayDark GrayDim Gray

Apply/Save settings

Ebook has 236 lines and 15650 words, and 5 pages

You can attach more than one class to a role:

.. role:: big-and-bold :class: x-large bold

This text is :big-and-bold:`big and bold`.

Styles

You can redefine the rendering of elements:

.. style:: emphasis :class: gesperrt

.. style:: strong :class: small-caps

.. style:: strong :class: small-caps x-large bold

.. style:: literal :class: red

``literally red``

.. style:: superscript :class: green

:superscript:`sup` er

:title-reference:`Hamlet` and `Othello`.

literally red

super

You can semantically markup foreign text:

.. role:: french :class: language-fr italics

:french:`Pas de double` is the French for "father of twins".

Pagination

Pagination is important if you generate PDFs. See the Directives For Pagination Table.

Directives For Pagination

This directive generates 'elastic? vertical space. This space expands to all of the free space on one page. If you use this more than once on a page, the free space is equally divided among all invocations.

To vertically align an item to the bottom, use vfill before that item.

Put this directive at the start of your book.

The pgheader directive uses this directive internally, so you can omit frontmatter whenever you use pgheader.

Put this directive after the table of contents and before the first chapter.

Table of Contents

Use the RST contents directive to automatically generate a table of contents.

N.B. You may also provide a table of contents manually.

In PG-RST the contents directive requires you to specify an argument or the local option.

The local option displays a local table of contents, containing only the sub-sections of the section in which it is declared.

The page-numbers option displays the original page number in the TOC.

.. contents:: A TOC With Page Numbers :depth: 2 :page-numbers:

A TOC With Page Numbers

Installing EpubMaker .............................................. Windows ......................................................... Debian .......................................................... PG-RST Classes .................................................... Classes For Inline Text ......................................... Classes For Block Text .......................................... Classes For Front Matter Markup ................................. PG-RST Extensions ................................................. Styles .......................................................... Pagination ...................................................... Table of Contents ............................................... List of Figures ................................................. List of Tables .................................................. Toc-Entry ....................................................... Footnotes ....................................................... Page Numbers .................................................... Dropcaps ........................................................ Tables .......................................................... PG Metadata ....................................................... Top Boilerplate ................................................. Metadata Directive .............................................. Bottom Boilerplate .............................................. PG-RST Best Practices ............................................. Examples and Tests ................................................ Section 3.1 ..................................................... Section 3.2 ..................................................... Section 3.3 .....................................................

List of Figures

Use the lof directive to generate a list of figures automatically.

N.B. You may also provide a list of figures manually.

.. lof:: A List of Figures :page-numbers: :backlinks: none

A List of Figures

Richard and Drucilla Martin .......................................

List of Tables

Use the lot directive to generate a list of tables.

N.B. You may also provide a list of tables manually.

.. lot:: A List of Tables :page-numbers: :backlinks: none

A List of Tables

Toc-Entry

Use the toc-entry directive to:

- provide an alternate toc entry - suppress a toc entry, or - switch toc gathering on or off.

A toc-entry with argument sets the argument as toc entry for the next section, figure or table.

A toc-entry without argument suppresses the toc entry for the next section, figure or table.

Share on: WhatsApp @Hash Facebook Tweet