Read Ebook: The Project Gutenberg RST Manual by Perathoner Marcello
Font size:
Background color:
Text color:
Add to tbrJar First Page Next Page Prev Page
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.
Add to tbrJar First Page Next Page Prev Page