diff options
Diffstat (limited to 'pg181.rst')
| -rw-r--r-- | pg181.rst | 1828 |
1 files changed, 1828 insertions, 0 deletions
diff --git a/pg181.rst b/pg181.rst new file mode 100644 index 0000000..7565b54 --- /dev/null +++ b/pg181.rst @@ -0,0 +1,1828 @@ +.. -*- encoding: utf-8 -*- + +.. meta:: + :PG.Id: 181 + :PG.Title: PG-RST Manual + :PG.Released: 2010-11-25 + :PG.Rights: Public Domain + :DC.Creator: Marcello Perathoner + :DC.Title: The Project Gutenberg RST Manual + :DC.Language: en + :DC.Created: 2010 + +.. style:: document + :class: language-de text-transform-smartquotes + +.. style:: .dropspan + :class: small-caps + +.. role:: directive + +.. role:: option + +.. role:: css + +.. role:: code + +.. role:: file + +.. role:: lb + :class: white-space-pre-line + +.. style:: .directive + :class: monospaced red + +.. style:: .option + :class: monospaced green + +.. style:: .css + :class: monospaced blue + +.. style:: .code + :class: monospaced + +.. style:: .file + :class: monospaced + + +======================================================================== + The Project Gutenberg RST Manual +======================================================================== + +.. _pg-header: + +.. container:: pgheader language-en + + .. style:: paragraph + :class: noindent + + This eBook is for the use of anyone anywhere at no cost and with + almost no restrictions whatsoever. You may copy it, give it away or + re-use it under the terms of the `Project Gutenberg License`_ + included with this eBook or online at + http://www.gutenberg.org/license. + + + + | + + .. _pg-machine-header: + + .. container:: + + Title: The Project Gutenberg RST Manual + + Author: Marcello Perathoner + + Release Date: November 25, 2010 [EBook #181] + + Language: English + + Character set encoding: UTF-8 + + | + + .. _pg-start-line: + + \*\*\* START OF THIS PROJECT GUTENBERG EBOOK PG-RST MANUAL \*\*\* + + | + | + | + | + + .. _pg-produced-by: + + .. container:: + + + + | + + + + +[pg!i] + +.. container:: titlepage + + .. vfill:: + + .. class:: center x-large + + | The + | + | Project Gutenberg + | + | RST Manual + + .. vfill:: + + .. vfill:: + +[pg!iii] + +.. contents:: Contents + :depth: 2 + + +[pg!v] + +.. lot:: List of Tables + + +[pg!vii] + +.. lof:: List of Figures + + +.. mainmatter:: + +[pg!1] + +Installing EpubMaker +==================== + +EpubMaker is Project Gutenberg's file converter. It can convert from +PG-RST to HTML, EPUB, PDF and plain text. + + +Windows +------- + +Prerequisites +````````````` + +1. Install Python. + + Assuming you don't have python yet. If you have either version 2.6 + or 2.7 already installed, skip this. + + From http://www.python.org/download/releases/2.7/ download + the :file:`Windows x86 MSI Installer (2.7)` and run it. + + Select all the default options and install. + +2. Install Python Setuptools. + + From http://pypi.python.org/pypi/setuptools download + :file:`setuptools-0.6c11.win32-py2.7.exe` (or any newer version) + and run it. + + If you are using python 2.6 get the setuptools for 2.6. + +3. Install Groff. (You can skip this step if you don't want to + generate plain text files.) + + From http://gnuwin32.sourceforge.net/packages/groff.htm + download `Complete package, except sources - Setup` + (:file:`groff-1.20.1-setup.exe`) and run it. + + Select all the default options and install. + +4. Install TexLive. (You can skip this step if you don't want to + generate PDF files.) + + Go to http://mirror.ctan.org/systems/texlive/tlnet and download the + file :file:`install-tl.zip`. Then say:: + + > unzip install-tl.zip + > cd install-tl* + > install-tl + + This will open the TeX Live installation wizard. Follow the + instructions. When in doubt use the defaults. + + This will take quite a while. (3 hours on an old Dell Vostro 1000 + laptop. It installs about 2.5 GB in 93,000 files.) If you + experience download problems, restart the wizard: it will resume + the download where it left off. + + Long installation instructions can be found at + http://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-150003 + +5. Install HTML Tidy. (You can skip this step if you only want to + process RST files and don't want to build EPUBs from HTML input.) + + If you are a post-processor you already have this. + + http://tidy.sourceforge.net/ + +6. Update your PATH. + + Start | Control Panel | System | Advanced | Environment Variables. + Click "Path" in the User variables at the top. + Click "Edit" + + If the field is empty just enter (all in one line):: + + C:\Python27; + C:\Python27\Scripts; + C:\Program Files\GnuWin32\bin; + + If the field contains data, go to the end of that data and add a + semicolon if there isn't one already and then add the string above. + + Click Ok three times. + + +EpubMaker +````````` + +1. At the command prompt run:: + + > easy_install epubmaker + +2. Test your installation:: + + > epubmaker --help + > epubmaker http://www.gutenberg.org/masters/rst/181/181.rst + + + +Debian +------ + +Prerequisites +````````````` + +(Does not work with python 3 yet. If your distribution uses python 3 as +default (not likely!), you'll have to parallel install python 2.6 or 2.7.) + +:: + + # apt-get install python python-setuptools python-lxml + # apt-get install groff tidy + # apt-get install libpng-dev libjpeg-dev libfreetype6-dev + +Note: To get PDF generation to work, you have to use TeX Live version +2009-11 or newer. You can get those from debian testing or +unstable. If don't want to switch from debian stable, you have to +install TeX Live manually. + +If you are on testing or unstable:: + + # apt-get install texlive texlive-latex-extra texlive-xetex + # apt-get install ttf-linux-libertine ttf-dejavu + +Else, to install TeX Live manually, go to +http://mirror.ctan.org/systems/texlive/tlnet and download the file +:file:`install-tl-unx.tar.gz`. Unpack it. Then:: + + # cd /path/where/unpacked + # perl install-tl -gui + +Long installation instructions can be found at +http://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-150003 + + +EpubMaker +````````` + +:: + + # easy_install epubmaker + + +Kindlegen +````````` + +(Optional: Used only to make Kindle files): + +:: + + $ wget http://s3.amazonaws.com/kindlegen/kindlegen_linux_2.6_i386_v1.2.tar.gz + $ tar -xzf kindlegen_linux_2.6_i386_v1.2.tar.gz + + +PG-RST Classes +============== + +A list of classes you can use in PG-RST. + +Classes For Inline Text +----------------------- + +These classes have an effect on inline text. If you put them on a block, all +inline contents of the block will be rendered accordingly. + +.. table:: Classes For Inline Text I + :width: 75% + :widths: 1 3 + :class: norules + + ==================== ======================================================== + Class Explanation + ==================== ======================================================== + :css:`italics` Switch to italic font. + :css:`bold` Switch to boldface. + :css:`small-caps` Switch to small capitals. + :css:`gesperrt` Switch to gesperrt (extended letter spacing). + :css:`antiqua` Switch to antiqua. + :css:`monospaced` Switch to monospaced font. + ==================== ======================================================== + +.. table:: Classes For Inline Text II + :width: 75% + :widths: 1 3 + :class: norules + + ==================== ======================================================== + Class Explanation + ==================== ======================================================== + :css:`smaller` Switch to smaller font. + :css:`larger` Switch to larger font. + :css:`xx-small` Switch to smallest font. + :css:`x-small` Switch to very small font. + :css:`small` Switch to small font. + :css:`medium` Switch to normal font size. + :css:`large` Switch to large font. + :css:`x-large` Switch to very large font. + :css:`xx-large` Switch to largest font. + ==================== ======================================================== + +.. table:: Classes For Inline Text III + :width: 75% + :widths: 1 3 + :class: norules + + ==================== ======================================================== + Class Explanation + ==================== ======================================================== + :css:`red` Switch to red font. + :css:`green` Switch to green font. + :css:`blue` Switch to blue font. + :css:`yellow` Switch to yellow font. + :css:`white` Switch to white font. + :css:`gray` Switch to gray font. + :css:`black` Switch to black font. + ==================== ======================================================== + + +Classes For Block Text +---------------------- + +These classes have an effect on block text. Please do not confuse the +alignment of the block with the alignment of the text in the +block. Eg. a table can be centered, while the text inside the table +is left-aligned. The alignment of the block is set with the :option:`align` +option. + +.. table:: Classes For Block Text + :width: 75% + :widths: 1 3 + :class: norules + + =========================== ================================================= + Class Explanation + =========================== ================================================= + :css:`left` Left-aligns the text in the block. + :css:`center` Centers the text in the block. + :css:`right` Right-aligns the text in the block. + :css:`justify` Justifies the text in the block. + :css:`white-space-pre-line` Preserves newlines. + =========================== ================================================= + + + +Classes For Front Matter Markup +------------------------------- + +EpubMaker includes a few classes to markup front matter. While it is +not necessary to do this, it adds value. In future the PG catalog +might automatically extract not only the cover page but also the title +page, verso, etc. + +.. table:: Classes For Front Matter Markup + :width: 75% + :widths: 1 3 + :class: norules + + ==================== ======================================================== + Class Explanation + ==================== ======================================================== + :css:`coverpage` The cover page. + :css:`frontispiece` The frontispiece. + :css:`titlepage` The title page. + :css:`verso` The title page verso. + :css:`dedication` The dedication page. + :css:`plainpage` A general class for page. + ==================== ======================================================== + +Use these classes on a :directive:`container`. These classes already +insert page breaks before the container so you need not insert page +breaks on your own. + +.. example:: + :norender: + + .. container:: titlepage + + | Pride and Prejudice + | + | Written by Jane Austen. + + + +PG-RST Extensions +================= + +You can create custom roles based on the existing ones. This is how +you create and then use custom roles. + +.. example:: + + .. role:: small-caps + :class: small-caps + + This text is in :small-caps:`Small Caps`. + +You can attach more than one class to a role: + +.. example:: + + .. 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: + +.. example:: + + .. style:: emphasis + :class: gesperrt + + Now *emphasis* will be rendered as gesperrt. + +.. example:: + + .. style:: strong + :class: small-caps + + And **Strong Emphasis** will be rendered as small-caps. + +.. example:: + + .. style:: strong + :class: small-caps x-large bold + + And **Strong Emphasis** will be rendered as big bold small-caps. + +.. example:: + + .. style:: literal + :class: red + + ``literally red`` + + .. style:: superscript + :class: green + + :superscript:`sup`\ er + + .. style:: title_reference + :class: blue + + :title-reference:`Hamlet` and `Othello`. + +You can semantically markup foreign text: + +.. example:: + + .. 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. + +.. table:: Directives For Pagination + :width: 100% + :widths: 1 3 + :vertical-aligns: top top + + ============================ ================================================ + Directive Explanation + ============================ ================================================ + :directive:`clearpage` This directive inserts a page break. + + :directive:`cleardoublepage` This directive inserts page breaks so + that the next item starts on + a right-hand page. + + :directive:`vfill` (PDF only.) + + 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 :directive:`vfill` before + that item. + + To vertically align an item about 1/3 + of the page use :directive:`vfill` + once before the item and twice after + the item. + + :directive:`frontmatter` (PDF only.) + + Put this directive at the start of your book. + + The :directive:`pgheader` directive + uses this directive internally, so you + can omit :directive:`frontmatter` + whenever you use + :directive:`pgheader`. + + This directive turns on roman page + numbers. + + :directive:`mainmatter` (PDF only.) + + Put this directive after the table of + contents and before the first chapter. + + This directive switches from roman + page numbering to arabic page + numbering and resets the page counter. + + :directive:`backmatter` (PDF only.) + + Put this directive before appendices or indices. + ============================ ================================================ + + +Table of Contents +----------------- + +Use the RST :directive:`contents` directive to automatically generate +a table of contents. + +N.B. You may also provide a table of contents manually. + +In PG-RST the :directive:`contents` directive requires you to specify +an argument or the :option:`local` option. + +The :option:`local` option displays a local table of contents, containing +only the sub-sections of the section in which it is declared. + +The :option:`page-numbers` option displays the original page number in +the TOC. + +.. example:: + :norender: + + .. contents:: A TOC With Page Numbers + :depth: 2 + :page-numbers: + +.. contents:: A TOC With Page Numbers + :depth: 2 + :page-numbers: + :backlinks: none + + +List of Figures +--------------- + +Use the :directive:`lof` directive to generate a list of figures +automatically. + +N.B. You may also provide a list of figures manually. + +.. example:: + + .. lof:: A List of Figures + :page-numbers: + :backlinks: none + + +List of Tables +-------------- + +Use the :directive:`lot` directive to generate a list of tables. + +N.B. You may also provide a list of tables manually. + +.. example:: + + .. lot:: A List of Tables + :page-numbers: + :backlinks: none + + +Toc-Entry +--------- + +Use the :directive:`toc-entry` directive to: + +- provide an alternate toc entry +- suppress a toc entry, or +- switch toc gathering on or off. + +A :directive:`toc-entry` with argument sets the argument as toc entry +for the next section, figure or table. + +A :directive:`toc-entry` without argument suppresses the toc entry for +the next section, figure or table. + +Use the :option:`depth` option to set the depth up to which section +titles are gathered for the toc. A depth of 0 switches toc gathering +off. + +.. example:: + :norender: + + .. toc-entry:: An Alternative Caption + + +Footnotes +--------- + +Always define footnotes right after the paragraph they are referenced. + +.. toc-entry:: Footnote Positions + +.. table:: Positioning of footnotes + :class: norules + :width: 75% + :align: center + :widths: 2 8 + :summary: Explains where footnotes end up + + ====== ======================================== + Format Position + ====== ======================================== + HTML Collected under the footnotes directive. + EPUB Idem. + TXT Where they are defined. + PDF At the bottom of the current page. + ====== ======================================== + +To collect the footnotes use the :directive:`footnotes` +directive. This directive will output a section with title and all +footnotes in the document will be moved inside the section. + +In PDF and TXT formats the :directive:`footnotes` directive will do +nothing. [#]_ + +Test [#]_ [#]_ . + +.. [#] Not even print the section title. + +.. example:: + :norender: + + .. footnotes:: Footnotes + :class: smaller + +.. [#] Another footnote, to test how multiple footnotes [#]_ stack on + one page. + +.. [#] Later editions continued as follows: + + | When the sands are all dry, he is gay as a lark, + | And will talk in contemptuous tones of the Shark, + | But, when the tide rises and sharks are around, + | His voice has a timid and tremulous sound. + +.. [#] Gibbon test. A footnote inside a footnote. + + + +Page Numbers +------------ + + +The sequence :code:`[pg n]` will convert into a page number marker of +n. n can be any arabic or roman numeral. The sequence itself will be +removed from the text flow leaving a page anchor. There *must* be +spaces around the sequence. If the page break is in the middle of a +word, join the word and put the sequence at the end of the word. + +.. example:: + + Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam + nonumy eirmod tempor invidunt [pg 42] ut labore et dolore magna + aliquyam erat, sed diam voluptua. At vero eos et accusam et justo + duo dolores [pg xviii] et ea rebum. + +A reference to a page number can be inserted with the sequence +:code:`[pg n]_`. This will generate a link to the page anchor. + +.. example:: + + See page [pg 42]_. + +An invisible page number can be inserted with the sequence +:code:`[pg!n]`. + +.. example:: + + Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam + nonumy eirmod tempor invidunt [pg!43] ut labore et dolore magna + aliquyam erat, sed diam voluptua. At vero eos et accusam et justo + duo dolores et ea rebum. See page [pg 43]_. + +See page [pg iii]_. + + + +Dropcaps +-------- + +You can insert dropcaps with the :directive:`dropcap` directive. You +can use either an enlarged character or an image as dropcap. You can +also specify a span of character that should be set in small-caps +after the dropcap initial. + +.. table:: Support for dropcaps in output formats + :class: norules + :width: 80% + :align: center + :widths: 2 5 5 + + ====== ========================== ========================= + Format Letter Image + ====== ========================== ========================= + HTML enlarged and dropped resized and dropped + EPUB enlarged on baseline resized on baseline + TXT normal size alt text + PDF enlarged and dropped [#a]_ resized and dropped [#a]_ + ====== ========================== ========================= + +.. [#a] *Warning:* If a paragraph with a dropcap gets page-broken the + dropcap may stick into the page bottom. Avoid dropcaps unless + you are sure that you are at the top of a page, like at a + chapter start. + +The first argument (mandatory) states the character(s) to replace with +caps. It must match the beginning of the next paragraph. + +The second (optional) argument states the characters to replace with +small-caps. It must also match the beginning of the next paragraph. + +.. example:: + + .. clearpage:: + + .. dropcap:: L Lorem ipsum + :lines: 4 + :indents: -1.25em 0.5em + + 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. + +The :option:`lines` option (PDF only) specifies how many lines the +dropcap should span. Default is 2. + +The :option:`indents` option (PDF only) can specifiy up to 2 length +values. The first one is the indent of the first line, the second one +the indent of the following lines. The indent is calculated from the +right border of the dropcap letter. Defaults are 0em and 0.5em. + +The :option:`image` option specifies the image url. In plain text and +EPUB the image will not be used. + +.. example:: + + .. clearpage:: + + .. dropcap:: G + :image: images/G.png + :lines: 4 + + Gorem 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. + + +Tables +------ + +Be careful with tables because the table support of many ereaders is +weak or nil. + +Tables also support these options: + +:option:`width` + Makes the table that wide. + +:option:`widths` + A space-separated list of unitless values, each specifying the + relative width of one table column. + + If you don't use the option :option:`widths`, the column widths + are calculated from the layout of the table in your source file. + +:option:`aligns` + Horizontally align the columns. + + A space-separated list of alignments, each specifying the + alignment of one column. + + Valid alignments values are: left, center, right and justify. + +:option:`vertical-aligns` + Vertically align the columns. + + A space-separated list of vertical alignments, each specifying the + alignment of one column. + + Valid alignments values are: top, middle, and bottom. + + Note: vertical alignment is fully supported in HTML only. Other + formats may support it in varying degrees. + +:option:`summary` (HTML only.) + Puts a summary attribute on the table element. + +These are the extra classes supported by PG-RST: + +:css:`norules` + Omits the rules between table rows. (Not the rule between header + and body nor the rules at the top and bottom of the table.) + + Use this class when the eye can follow the table rows without the + aid of rules. + + +.. example:: + + .. table:: Demo Table + :width: 100% + :align: center + :widths: 3 1 1 1 + :aligns: justify justify center right + :vertical-aligns: top middle bottom top + :summary: This table contains valuable data. + + +------------------------+-----------+----------+-----------+ + | Header row, column 1 | Justified | Centered | Price ($) | + | (header rows optional) | | | | + +========================+===========+==========+===========+ + | row 1 | column | column | 1.23 | + +------------------------+-----------+----------+-----------+ + | row 2 | col col | col | 45.67 | + | | col col | | | + | | col col | | | + | | col | | | + +------------------------+-----------+----------+-----------+ + | row 3 | Cells may span columns. | + | | Lorem ipsum dolor sit amet, | + | | consetetur sadipscing elitr, sed | + | | nonumy eirmod tempor invidunt ut | + | | labore et dolore magna aliquyam | + | | sed diam voluptua. At vero eos | + | | accusam et justo duo dolores et | + | | rebum. | + +------------------------+-----------+----------+-----------+ + | Cells may span rows and | Cells | row 4 | + | columns. Lorem ipsum dolor sit | may span +-----------+ + | amet, consetetur adipiscing. | rows. | row 5 | + +------------------------------------+----------+-----------+ + +.. example:: + + .. table:: Truth table for “and” + :class: norules + :align: center + :width: 50% + + ===== ===== ========= + A B A and B + ===== ===== ========= + False False False + True False False + False True False + True True True + ===== ===== ========= + + +PG Metadata +=========== + +Top Boilerplate +--------------- + +This section explains the PG boilerplate that you must put at the top +of your PG-RST file. + +It looks like this: + +.. example:: + :norender: + + .. -*- encoding: utf-8 -*- (1) + + .. meta:: (2) + :PG.Id: 181 + :PG.Title: Very Short Title + :PG.Released: 2010-11-25 + :PG.Rights: Public Domain + :PG.Producer: Woody Guthrie + :PG.Producer: Pete Seeger + :PG.Producer: The Almanac Singers + :PG.Credits: This file was produced from images stolen from the Louvre. + :DC.Creator: Jane Austen + :MARCREL.edt: Mark Twain + :MARCREL.ill: Édouard Manet + :DC.Title: Full Title Statement + :DC.Language: en + :DC.Language: fr + :DC.Language: de + :DC.Created: 1900 + :coverpage: images/cover.jpg + + + =========== + Short Title (3) + =========== + + .. pgheader:: (4) + + +(1) Insert this line verbatim. It must be the first line in the + text. [#]_ This tells the converter to use UTF-8 encoding and is + also recognized by many editors. + +(2) The metadata directive: see section below. + +(3) This will be the first line of the generated files. It should + say: “The Project Gutenberg Ebook of Title” or just “Title”. Use + '=' 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. + +.. table:: Fields In the PG Scheme + :width: 75% + :widths: 1 3 + + ============= ============================================================== + 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. + +.. table:: Fields In the DC Scheme + :width: 75% + :widths: 1 3 + + ============== ============================================================== + 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 :option:`class` language-<language-code> 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. + +.. table:: Fields In the MARCREL Scheme + :width: 75% + :widths: 1 3 + + ============== ============================================================== + Name Contents + ============== ============================================================== + MARCREL.edt Editor + MARCREL.ill Illustrator + MARCREL.trl Translator + MARCREL.* See the `full list of MARC relator codes + <http://www.loc.gov/marc/relators/relacode.html>`_. + ============== ============================================================== + + +No Scheme +````````` + +Some fields are associated with none of the above schemes. + +.. table:: Fields Without Scheme + :width: 75% + :widths: 1 3 + + ============== ============================================================== + 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. + +.. example:: + :norender: + + .. pgfooter:: (1) + +(1) This directive inserts the PG footer and license. + + + +PG-RST Best Practices +===================== + +Images +------ + +Specify a :option:`width` option in images and a :option:`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. + +.. example:: + + .. 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. + + + + +[pg!2] + +.. toc-entry:: Examples and Tests + +Tests and Examples +================== + +.. topic:: 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: + +.. contents:: + :local: + +A local table of contents as highlights: + +.. 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. + +.. container:: shrinkwrap align-center + + | ‘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 +----------- + +.. epigraph:: + + 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 + #) Item 1.a.II + #) Item 1.a.III + #) Item 1.a.IV + +2. A) i) Item 2.A.i [pg 8] + #) Item 2.A.ii + #) i) Item 2.B.i + #) Item 2.B.ii + #) Item 2.B.iii + #) 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. +```````````````````` + +.. container:: + + .. style:: line + :class: italics + + .. style:: attribution + :class: small-caps + + .. epigraph:: + + | The dearest friend to me, the kindest man, + | The best-conditioned and unwearied spirit + | In doing courtesies. + + -- Merchant of Venice. + + .. epigraph:: + + | He hath a daily beauty in his life. + + -- Othello. + + .. epigraph:: + + | 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, + +.. epigraph:: + + «Ora si comincia per quelli di + fuori e per quelli di dentro a far + grandissima e crudel guerra.» + + .. class:: right + + `Istorie pistolesi.` + +.. table:: `TABLE 8` Types of Computers Used in the Systems Reported + :width: 50% + :widths: 3 1 1 + :aligns: left right right + :vertical-aligns: top top middle + :summary: TABLE 8 Types of Computers Used in the Systems Reported + :class: norules + + +--------------+--------+-----------+ + | Type | Number | | + +==============+========+===========+ + | ASI 210 | 1 | \(3) | + +--------------+--------+ | + | ASI 2100 | 2 | | + +--------------+--------+-----------+ + | CDC 160A | 2 | \(3) | + +--------------+--------+ | + | CDC 3100 | 1 | | + +--------------+--------+-----------+ + +.. class:: small + +:: + + total computer cost 0.22 ± 0.06 by averaging + ------------------------ = 0.23 -> separate ratios for each + cost of bare accelerator system + + +.. backmatter:: + +.. toc-entry:: + :depth: 0 + +[pg!10] + +.. footnotes:: Footnotes + :class: smaller + +[pg 99] + +.. topic:: Transcriber's Note + + Minor spelling errors have been silently corrected. + + Hyphenation has been made consistent. + + +| +| +| +| +| + +.. _pg_end_line: + +\*\*\* END OF THIS PROJECT GUTENBERG EBOOK PG-RST MANUAL \*\*\* + +.. backmatter:: + +.. toc-entry:: + :depth: 0 + +.. _pg-footer: + +.. class:: pgfooter language-en + +A Word from Project Gutenberg +============================= + +We will update this book if we find any errors. + +This book can be found under: http://www.gutenberg.org/181 + +Creating the works from public domain print editions means that no one +owns a United States copyright in these works, so the Foundation (and +you!) can copy and distribute it in the United States without +permission and without paying copyright royalties. Special rules, set +forth in the General Terms of Use part of this license, apply to +copying and distributing Project Gutenberg™ electronic works to +protect the Project Gutenberg™ concept and trademark. Project +Gutenberg is a registered trademark, and may not be used if you charge +for the eBooks, unless you receive specific permission. If you do not +charge anything for copies of this eBook, complying with the rules is +very easy. You may use this eBook for nearly any purpose such as +creation of derivative works, reports, performances and research. +They may be modified and printed and given away – you may do +practically *anything* with public domain eBooks. Redistribution is +subject to the trademark license, especially commercial +redistribution. + + +.. _Project Gutenberg License: + +The Full Project Gutenberg License +---------------------------------- + +*Please read this before you distribute or use this work.* + +To protect the Project Gutenberg™ mission of promoting the free +distribution of electronic works, by using or distributing this work +(or any other work associated in any way with the phrase “Project +Gutenberg”), you agree to comply with all the terms of the Full +Project Gutenberg™ License available with this file or online at +http://www.gutenberg.org/license. + + +Section 1. General Terms of Use & Redistributing Project Gutenberg™ electronic works +```````````````````````````````````````````````````````````````````````````````````` + +**1.A.** By reading or using any part of this Project Gutenberg™ +electronic work, you indicate that you have read, understand, agree to +and accept all the terms of this license and intellectual property +(trademark/copyright) agreement. If you do not agree to abide by all +the terms of this agreement, you must cease using and return or +destroy all copies of Project Gutenberg™ electronic works in your +possession. If you paid a fee for obtaining a copy of or access to a +Project Gutenberg™ electronic work and you do not agree to be bound by +the terms of this agreement, you may obtain a refund from the person +or entity to whom you paid the fee as set forth in paragraph 1.E.8. + +**1.B.** “Project Gutenberg” is a registered trademark. It may only be +used on or associated in any way with an electronic work by people who +agree to be bound by the terms of this agreement. There are a few +things that you can do with most Project Gutenberg™ electronic works +even without complying with the full terms of this agreement. See +paragraph 1.C below. There are a lot of things you can do with Project +Gutenberg™ electronic works if you follow the terms of this agreement +and help preserve free future access to Project Gutenberg™ electronic +works. See paragraph 1.E below. + +**1.C.** The Project Gutenberg Literary Archive Foundation (“the +Foundation” or PGLAF), owns a compilation copyright in the collection +of Project Gutenberg™ electronic works. Nearly all the individual +works in the collection are in the public domain in the United +States. If an individual work is in the public domain in the United +States and you are located in the United States, we do not claim a +right to prevent you from copying, distributing, performing, +displaying or creating derivative works based on the work as long as +all references to Project Gutenberg are removed. Of course, we hope +that you will support the Project Gutenberg™ mission of promoting free +access to electronic works by freely sharing Project Gutenberg™ works +in compliance with the terms of this agreement for keeping the Project +Gutenberg™ name associated with the work. You can easily comply with +the terms of this agreement by keeping this work in the same format +with its attached full Project Gutenberg™ License when you share it +without charge with others. + + + +**1.D.** The copyright laws of the place where you are located also +govern what you can do with this work. Copyright laws in most +countries are in a constant state of change. If you are outside the +United States, check the laws of your country in addition to the terms +of this agreement before downloading, copying, displaying, performing, +distributing or creating derivative works based on this work or any +other Project Gutenberg™ work. The Foundation makes no +representations concerning the copyright status of any work in any +country outside the United States. + +**1.E.** Unless you have removed all references to Project Gutenberg: + +**1.E.1.** The following sentence, with active links to, or other +immediate access to, the full Project Gutenberg™ License must appear +prominently whenever any copy of a Project Gutenberg™ work (any work +on which the phrase “Project Gutenberg” appears, or with which the +phrase “Project Gutenberg” is associated) is accessed, displayed, +performed, viewed, copied or distributed: + + This eBook is for the use of anyone anywhere at no cost and with + almost no restrictions whatsoever. You may copy it, give it away or + re-use it under the terms of the Project Gutenberg License included + with this eBook or online at http://www.gutenberg.org + +**1.E.2.** If an individual Project Gutenberg™ electronic work is +derived from the public domain (does not contain a notice indicating +that it is posted with permission of the copyright holder), the work +can be copied and distributed to anyone in the United States without +paying any fees or charges. If you are redistributing or providing +access to a work with the phrase “Project Gutenberg” associated with +or appearing on the work, you must comply either with the requirements +of paragraphs 1.E.1 through 1.E.7 or obtain permission for the use of +the work and the Project Gutenberg™ trademark as set forth in +paragraphs 1.E.8 or 1.E.9. + +**1.E.3.** If an individual Project Gutenberg™ electronic work is +posted with the permission of the copyright holder, your use and +distribution must comply with both paragraphs 1.E.1 through 1.E.7 and +any additional terms imposed by the copyright holder. Additional terms +will be linked to the Project Gutenberg™ License for all works posted +with the permission of the copyright holder found at the beginning of +this work. + +**1.E.4.** Do not unlink or detach or remove the full Project +Gutenberg™ License terms from this work, or any files containing a +part of this work or any other work associated with Project +Gutenberg™. + +**1.E.5.** Do not copy, display, perform, distribute or redistribute +this electronic work, or any part of this electronic work, without +prominently displaying the sentence set forth in paragraph 1.E.1 with +active links or immediate access to the full terms of the Project +Gutenberg™ License. + +**1.E.6.** You may convert to and distribute this work in any binary, +compressed, marked up, nonproprietary or proprietary form, including +any word processing or hypertext form. However, if you provide access +to or distribute copies of a Project Gutenberg™ work in a format other +than “Plain Vanilla ASCII” or other format used in the official +version posted on the official Project Gutenberg™ web site +(http://www.gutenberg.org), you must, at no additional cost, fee or +expense to the user, provide a copy, a means of exporting a copy, or a +means of obtaining a copy upon request, of the work in its original +“Plain Vanilla ASCII” or other form. Any alternate format must include +the full Project Gutenberg™ License as specified in paragraph 1.E.1. + +**1.E.7.** Do not charge a fee for access to, viewing, displaying, +performing, copying or distributing any Project Gutenberg™ works +unless you comply with paragraph 1.E.8 or 1.E.9. + +**1.E.8.** You may charge a reasonable fee for copies of or providing +access to or distributing Project Gutenberg™ electronic works provided +that + +.. class:: open + +- You pay a royalty fee of 20% of the gross profits you derive from + the use of Project Gutenberg™ works calculated using the method you + already use to calculate your applicable taxes. The fee is owed to + the owner of the Project Gutenberg™ trademark, but he has agreed to + donate royalties under this paragraph to the Project Gutenberg + Literary Archive Foundation. Royalty payments must be paid within 60 + days following each date on which you prepare (or are legally + required to prepare) your periodic tax returns. Royalty payments + should be clearly marked as such and sent to the Project Gutenberg + Literary Archive Foundation at the address specified in Section 4, + “Information about donations to the Project Gutenberg Literary + Archive Foundation.” + +- You provide a full refund of any money paid by a user who notifies + you in writing (or by e-mail) within 30 days of receipt that s/he + does not agree to the terms of the full Project Gutenberg™ + License. You must require such a user to return or destroy all + copies of the works possessed in a physical medium and discontinue + all use of and all access to other copies of Project Gutenberg™ + works. + +- You provide, in accordance with paragraph 1.F.3, a full refund of + any money paid for a work or a replacement copy, if a defect in the + electronic work is discovered and reported to you within 90 days of + receipt of the work. + +- You comply with all other terms of this agreement for free + distribution of Project Gutenberg™ works. + +**1.E.9.** If you wish to charge a fee or distribute a Project +Gutenberg™ electronic work or group of works on different terms than +are set forth in this agreement, you must obtain permission in writing +from both the Project Gutenberg Literary Archive Foundation and +Michael Hart, the owner of the Project Gutenberg™ trademark. Contact +the Foundation as set forth in Section 3. below. + +**1.F.** + +**1.F.1.** Project Gutenberg volunteers and employees expend +considerable effort to identify, do copyright research on, transcribe +and proofread public domain works in creating the Project Gutenberg™ +collection. Despite these efforts, Project Gutenberg™ electronic +works, and the medium on which they may be stored, may contain +“Defects,” such as, but not limited to, incomplete, inaccurate or +corrupt data, transcription errors, a copyright or other intellectual +property infringement, a defective or damaged disk or other medium, a +computer virus, or computer codes that damage or cannot be read by +your equipment. + +**1.F.2.** LIMITED WARRANTY, DISCLAIMER OF DAMAGES – Except for the +“Right of Replacement or Refund” described in paragraph 1.F.3, the +Project Gutenberg Literary Archive Foundation, the owner of the +Project Gutenberg™ trademark, and any other party distributing a +Project Gutenberg™ electronic work under this agreement, disclaim all +liability to you for damages, costs and expenses, including legal +fees. YOU AGREE THAT YOU HAVE NO REMEDIES FOR NEGLIGENCE, STRICT +LIABILITY, BREACH OF WARRANTY OR BREACH OF CONTRACT EXCEPT THOSE +PROVIDED IN PARAGRAPH 1.F.3. YOU AGREE THAT THE FOUNDATION, THE +TRADEMARK OWNER, AND ANY DISTRIBUTOR UNDER THIS AGREEMENT WILL NOT BE +LIABLE TO YOU FOR ACTUAL, DIRECT, INDIRECT, CONSEQUENTIAL, PUNITIVE OR +INCIDENTAL DAMAGES EVEN IF YOU GIVE NOTICE OF THE POSSIBILITY OF SUCH +DAMAGE. + +**1.F.3.** LIMITED RIGHT OF REPLACEMENT OR REFUND – If you discover a +defect in this electronic work within 90 days of receiving it, you can +receive a refund of the money (if any) you paid for it by sending a +written explanation to the person you received the work from. If you +received the work on a physical medium, you must return the medium +with your written explanation. The person or entity that provided you +with the defective work may elect to provide a replacement copy in +lieu of a refund. If you received the work electronically, the person +or entity providing it to you may choose to give you a second +opportunity to receive the work electronically in lieu of a refund. If +the second copy is also defective, you may demand a refund in writing +without further opportunities to fix the problem. + +**1.F.4.** Except for the limited right of replacement or refund set +forth in paragraph 1.F.3, this work is provided to you ‘AS-IS,’ WITH +NO OTHER WARRANTIES OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT +LIMITED TO WARRANTIES OF MERCHANTIBILITY OR FITNESS FOR ANY PURPOSE. + +**1.F.5.** Some states do not allow disclaimers of certain implied +warranties or the exclusion or limitation of certain types of +damages. If any disclaimer or limitation set forth in this agreement +violates the law of the state applicable to this agreement, the +agreement shall be interpreted to make the maximum disclaimer or +limitation permitted by the applicable state law. The invalidity or +unenforceability of any provision of this agreement shall not void the +remaining provisions. + +**1.F.6.** INDEMNITY – You agree to indemnify and hold the Foundation, +the trademark owner, any agent or employee of the Foundation, anyone +providing copies of Project Gutenberg™ electronic works in accordance +with this agreement, and any volunteers associated with the +production, promotion and distribution of Project Gutenberg™ +electronic works, harmless from all liability, costs and expenses, +including legal fees, that arise directly or indirectly from any of +the following which you do or cause to occur: (a) distribution of this +or any Project Gutenberg™ work, (b) alteration, modification, or +additions or deletions to any Project Gutenberg™ work, and (c) any +Defect you cause. + + +Section 2. Information about the Mission of Project Gutenberg™ +`````````````````````````````````````````````````````````````` + +Project Gutenberg™ is synonymous with the free distribution of +electronic works in formats readable by the widest variety of +computers including obsolete, old, middle-aged and new computers. It +exists because of the efforts of hundreds of volunteers and donations +from people in all walks of life. + +Volunteers and financial support to provide volunteers with the +assistance they need, is critical to reaching Project Gutenberg™'s +goals and ensuring that the Project Gutenberg™ collection will remain +freely available for generations to come. In 2001, the Project +Gutenberg Literary Archive Foundation was created to provide a secure +and permanent future for Project Gutenberg™ and future generations. To +learn more about the Project Gutenberg Literary Archive Foundation and +how your efforts and donations can help, see Sections 3 and 4 and the +Foundation web page at http://www.pglaf.org . + + +Section 3. Information about the Project Gutenberg Literary Archive Foundation +`````````````````````````````````````````````````````````````````````````````` + +The Project Gutenberg Literary Archive Foundation is a non profit +501(c)(3) educational corporation organized under the laws of the +state of Mississippi and granted tax exempt status by the Internal +Revenue Service. The Foundation's EIN or federal tax identification +number is 64-6221541. Its 501(c)(3) letter is posted at +http://www.gutenberg.org/fundraising/pglaf . Contributions to the +Project Gutenberg Literary Archive Foundation are tax deductible to +the full extent permitted by U.S. federal laws and your state's laws. + +The Foundation's principal office is located at 4557 Melan Dr. +S. Fairbanks, AK, 99712., but its volunteers and employees are +scattered throughout numerous locations. Its business office is +located at 809 North 1500 West, Salt Lake City, UT 84116, (801) +596-1887, email business@pglaf.org. Email contact links and up to date +contact information can be found at the Foundation's web site and +official page at http://www.pglaf.org + +For additional contact information: + + | Dr. Gregory B. Newby + | Chief Executive and Director + | gbnewby@pglaf.org + + +Section 4. Information about Donations to the Project Gutenberg Literary Archive Foundation +``````````````````````````````````````````````````````````````````````````````````````````` + +Project Gutenberg™ depends upon and cannot survive without wide spread +public support and donations to carry out its mission of increasing +the number of public domain and licensed works that can be freely +distributed in machine readable form accessible by the widest array of +equipment including outdated equipment. Many small donations ($1 to +$5,000) are particularly important to maintaining tax exempt status +with the IRS. + +The Foundation is committed to complying with the laws regulating +charities and charitable donations in all 50 states of the United +States. Compliance requirements are not uniform and it takes a +considerable effort, much paperwork and many fees to meet and keep up +with these requirements. We do not solicit donations in locations +where we have not received written confirmation of compliance. To SEND +DONATIONS or determine the status of compliance for any particular +state visit http://www.gutenberg.org/fundraising/donate + +While we cannot and do not solicit contributions from states where we +have not met the solicitation requirements, we know of no prohibition +against accepting unsolicited donations from donors in such states who +approach us with offers to donate. + +International donations are gratefully accepted, but we cannot make +any statements concerning tax treatment of donations received from +outside the United States. U.S. laws alone swamp our small staff. + +Please check the Project Gutenberg Web pages for current donation +methods and addresses. Donations are accepted in a number of other +ways including checks, online payments and credit card donations. To +donate, please visit: http://www.gutenberg.org/fundraising/donate + + +Section 5. General Information About Project Gutenberg™ electronic works. +````````````````````````````````````````````````````````````````````````` + + +Professor Michael S. Hart is the originator of the Project Gutenberg™ +concept of a library of electronic works that could be freely shared +with anyone. For thirty years, he produced and distributed Project +Gutenberg™ eBooks with only a loose network of volunteer support. + +Project Gutenberg™ eBooks are often created from several printed +editions, all of which are confirmed as Public Domain in the +U.S. unless a copyright notice is included. Thus, we do not +necessarily keep eBooks in compliance with any particular paper +edition. + +Each eBook is in a subdirectory of the same number as the eBook's +eBook number, often in several formats including plain vanilla ASCII, +compressed (zipped), HTML and others. + +Corrected *editions* of our eBooks replace the old file and take over +the old filename and etext number. The replaced older file is +renamed. *Versions* based on separate sources are treated as new +eBooks receiving new filenames and etext numbers. + +Most people start at our Web site which has the main PG search +facility: + + http://www.gutenberg.org + +This Web site includes information about Project Gutenberg™, including +how to make donations to the Project Gutenberg Literary Archive +Foundation, how to help produce our new eBooks, and how to subscribe +to our email newsletter to hear about new eBooks. + |