44 pg-produced-by3 44 container33 pg6i 44 container33 titlepage 44 vfill33 44 class33 center x-large ,the ,,rst ,manual 44 vfill33 44 vfill33 pg6iii 44 contents33 ,contents 3depth3 #b pg6v 44 lot33 ,list of ,tables pg6vii 44 lof33 ,list of ,figures 44 mainmatter33 pg6#a ,installing ,epub,maker ,epub,maker is ,project ,gutenberg's file converter4 ,it can convert from ,,pg-,,rst to ,,html1 ,,epub1 ,,pdf and plain text4 ,windows ------- ,prerequisites #a4 ,install ,python4 ,assuming you don't have python yet4 ,if you have either version #b4f or #b4g already installed1 skip this4 ,from http3_/_/www4python4org_/download_/relea ses_/#b4g_/ download the 3file3,windows x#hf ,,msi ,installer 7#b4g7 and run it4 ,select all the default options and install4 #b4 ,install ,python ,setuptools4 ,from http3_/_/pypi4python4org_/pypi_/setuptoo ls download 3file3setuptools-#j4f;c#aa4win#cb-py#b4g 4;exe 7or any newer version7 and run it4 ,if you are using python #b4f get the setuptools for #b4f4 #c4 ,install ,groff4 7,you can skip this step if you don't want to generate plain text files47 ,from http3_/_/gnuwin#cb4sourceforge4net_/pack ages_/groff4htm download ,complete package1 except sources - ,setup 73file3groff-#a4bj4a-setup4exe7 and run it4 ,select all the default options and install4 #d4 ,install ,tex,live4 7,you can skip this step if you don't want to generate ,,pdf files47 ,go to http3_/_/mirror4ctan4org_/systems_/texli ve_/tlnet and download the file 3file3install-tl4zip4 ,then say33 unzip install-tl4zip cd install-tl99 install-tl ,this will open the ,te,x ,live installation wizard4 ,follow the instructions4 ,when in doubt use the defaults4 ,this will take quite a while4 7#c hours on an old ,dell ,vostro #ajjj laptop4 ,it installs about #b4e ,,gb in #ic1jjj files47 ,if you experience download problems1 restart the wizard3 it will resume the download where it left off4 ,long installation instructions can be found at http3_/_/www4tug4org_/texlive_/doc_/texl ive-en_/texlive-en4htmlx#a-aejjjc #e4 ,install ,,html ,tidy4 7,you can skip this step if you only want to process ,,rst files and don't want to build ,e,p,u,bs from ,,html input47 ,if you are a post-processor you already have this4 http3_/_/tidy4sourceforge4net_/ #f4 ,update your ,,path4 ,start ,control ,panel ,system ,advanced ,environment ,variables4 ,click ,path in the ,user variables at the top4 ,click ,edit ,if the field is empty just enter 7all in one line733 ,c3,python#bg2 ,c3,python#bg,scripts2 ,c3,program ,files,gnu,win#cb;bin2 ,if the field contains data1 go to the end of that data and add a semicolon if there isn't one already and then add the string above4 ,click ,ok three times4 ,epub,maker #a4 ,at the command prompt run33 easyinstall epubmaker #b4 ,test your installation33 epubmaker --help epubmaker https3_/_/www4gutenberg4org_/masters_/rs t_/#aha_/aha4rst ,debian ------ ,prerequisites 7,does not work with python #c yet4 ,if your distribution uses python #c as default 7not likely671 you'll have to parallel install python #b4f or #b4g47 33 apt-get install python python-setuptools python-lxml apt-get install groff tidy apt-get install libpng-dev libjpeg-dev libfreetype#f-;dev ,note3 ,to get ,,pdf generation to work1 you have to use ,te,x ,live version #bjji-aa or newer4 ,you can get those from debian testing or unstable4 ,if don't want to switch from debian stable1 you have to install ,te,x ,live manually4 ,if you are on testing or unstable33 apt-get install texlive texlive-latex-extra texlive-xetex apt-get install ttf-linux-libertine ttf-dejavu ,else1 to install ,te,x ,live manually1 go to http3_/_/mirror4ctan4org_/systems_/texli ve_/tlnet and download the file 3file3install-tl-unx4tar4gz4 ,unpack it4 ,then33 cd _/path_/where_/unpacked perl install-tl -gui ,long installation instructions can be found at http3_/_/www4tug4org_/texlive_/doc_/texl ive-en_/texlive-en4htmlx#a-aejjjc ,epub,maker 33 easyinstall epubmaker ,kindlegen 7,optional3 ,used only to make ,kindle files73 33 wget http3_/_/s#c4;amazonaws4com_/kindlegen_/ kindlegenlinux#b4f;i#chfv#a4b4tar4gz tar -xzf kindlegenlinux#b4f;i#chfv#a4b4tar4gz ,,pg-,,rst ,classes ,a list of classes you can use in ,,pg-,,rst4 ,classes ,for ,inline ,text ----------------------- ,these classes have an effect on inline text4 ,if you put them on a block1 all inline contents of the block will be rendered accordingly4 44 table33 ,classes ,for ,inline ,text ,i 3width3 #ge 3widths3 #a #c 3class3 norules ,class ,explanation 3css3italics ,switch to italic font4 3css3bold ,switch to boldface4 3css3small-caps ,switch to small capitals4 3css3gesperrt ,switch to gesperrt 7extended letter spacing74 3css3antiqua ,switch to antiqua4 3css3monospaced ,switch to monospaced font4 44 table33 ,classes ,for ,inline ,text ,,ii 3width3 #ge 3widths3 #a #c 3class3 norules ,class ,explanation 3css3smaller ,switch to smaller font4 3css3larger ,switch to larger font4 3css3xx-small ,switch to smallest font4 3css3x-small ,switch to very small font4 3css3small ,switch to small font4 3css3medium ,switch to normal font size4 3css3large ,switch to large font4 3css3x-large ,switch to very large font4 3css3xx-large ,switch to largest font4 44 table33 ,classes ,for ,inline ,text ,,iii 3width3 #ge 3widths3 #a #c 3class3 norules ,class ,explanation 3css3red ,switch to red font4 3css3green ,switch to green font4 3css3blue ,switch to blue font4 3css3yellow ,switch to yellow font4 3css3white ,switch to white font4 3css3gray ,switch to gray font4 3css3black ,switch to black font4 ,classes ,for ,block ,text ---------------------- ,these classes have an effect on block text4 ,please do not confuse the alignment of the block with the alignment of the text in the block4 ,eg4 a table can be centered1 while the text inside the table is left-aligned4 ,the alignment of the block is set with the 3option3align option4 44 table33 ,classes ,for ,block ,text 3width3 #ge 3widths3 #a #c 3class3 norules ,class ,explanation 3css3left ,left-aligns the text in the block4 3css3center ,centers the text in the block4 3css3right ,right-aligns the text in the block4 3css3justify ,justifies the text in the block4 3css3white-space-pre-line ,preserves newlines4 ,classes ,for ,front ,matter ,markup ------------------------------- ,epub,maker includes a few classes to markup front matter4 ,while it is not necessary to do this1 it adds value4 ,in future the ,,pg catalog might automatically extract not only the cover page but also the title page1 verso1 etc4 44 table33 ,classes ,for ,front ,matter ,markup 3width3 #ge 3widths3 #a #c 3class3 norules ,class ,explanation 3css3coverpage ,the cover page4 3css3frontispiece ,the frontispiece4 3css3titlepage ,the title page4 3css3verso ,the title page verso4 3css3dedication ,the dedication page4 3css3plainpage ,a general class for page4 ,use these classes on a 3directive3container4 ,these classes already insert page breaks before the container so you need not insert page breaks on your own4 44 example33 3norender3 44 container33 titlepage ,pride and ,prejudice ,written by ,jane ,austen4 ,,pg-,,rst ,extensions ,you can create custom roles based on the existing ones4 ,this is how you create and then use custom roles4 44 example33 44 role33 small-caps 3class3 small-caps ,this text is in 3small-caps3,small ,caps4 ,you can attach more than one class to a role3 44 example33 44 role33 big-and-bold 3class3 x-large bold ,this text is 3big-and-bold3big and bold4 ,styles ------ ,you can redefine the rendering of elements3 44 example33 44 style33 emphasis 3class3 gesperrt ,now 99emphasis99 will be rendered as gesperrt4 44 example33 44 style33 strong 3class3 small-caps ,and 9999,strong ,emphasis9999 will be rendered as small-caps4 44 example33 44 style33 strong 3class3 small-caps x-large bold ,and 9999,strong ,emphasis9999 will be rendered as big bold small-caps4 44 example33 44 style33 literal 3class3 red literally red 44 style33 superscript 3class3 green 3superscript3sup er 44 style33 titlereference 3class3 blue 3title-reference3,hamlet and ,othello4 ,you can semantically markup foreign text3 44 example33 44 role33 french 3class3 language-fr italics 3french3,pas de double is the ,french for father of twins4 ,pagination ---------- ,pagination is important if you generate ,p,d,fs4 ,see the ,directives ,for ,pagination ,table4 44 table33 ,directives ,for ,pagination 3width3 #ajj 3widths3 #a #c 3vertical-aligns3 top top ,directive ,explanation 3directive3clearpage ,this directive inserts a page break4 3directive3cleardoublepage ,this directive inserts page breaks so that the next item starts on a right-hand page4 3directive3vfill 7,,pdf only47 ,this directive generates elastic vertical space4 ,this space expands to all of the free space on one page4 ,if you use this more than once on a page1 the free space is equally divided among all invocations4 ,to vertically align an item to the bottom1 use 3directive3vfill before that item4 ,to vertically align an item about #a_/c of the page use 3directive3vfill once before the item and twice after the item4 3directive3frontmatter 7,,pdf only47 ,put this directive at the start of your book4 ,the 3directive3pgheader directive uses this directive internally1 so you can omit 3directive3frontmatter whenever you use 3directive3pgheader4 ,this directive turns on roman page numbers4 3directive3mainmatter 7,,pdf only47 ,put this directive after the table of contents and before the first chapter4 ,this directive switches from roman page numbering to arabic page numbering and resets the page counter4 3directive3backmatter 7,,pdf only47 ,put this directive before appendices or indices4 ,table of ,contents ----------------- ,use the ,,rst 3directive3contents directive to automatically generate a table of contents4 ,n4,b4 ,you may also provide a table of contents manually4 ,in ,,pg-,,rst the 3directive3contents directive requires you to specify an argument or the 3option3local option4 ,the 3option3local option displays a local table of contents1 containing only the sub-sections of the section in which it is declared4 ,the 3option3page-numbers option displays the original page number in the ,,toc4 44 example33 3norender3 44 contents33 ,a ,,toc ,with ,page ,numbers 3depth3 #b 3page-numbers3 44 contents33 ,a ,,toc ,with ,page ,numbers 3depth3 #b 3page-numbers3 3backlinks3 none ,list of ,figures --------------- ,use the 3directive3lof directive to generate a list of figures automatically4 ,n4,b4 ,you may also provide a list of figures manually4 44 example33 44 lof33 ,a ,list of ,figures 3page-numbers3 3backlinks3 none ,list of ,tables -------------- ,use the 3directive3lot directive to generate a list of tables4 ,n4,b4 ,you may also provide a list of tables manually4 44 example33 44 lot33 ,a ,list of ,tables 3page-numbers3 3backlinks3 none ,toc-,entry --------- ,use the 3directive3toc-entry directive to3 - provide an alternate toc entry - suppress a toc entry1 or - switch toc gathering on or off4 ,a 3directive3toc-entry with argument sets the argument as toc entry for the next section1 figure or table4 ,a 3directive3toc-entry without argument suppresses the toc entry for the next section1 figure or table4 ,use the 3option3depth option to set the depth up to which section titles are gathered for the toc4 ,a depth of #j switches toc gathering off4 44 example33 3norender3 44 toc-entry33 ,an ,alternative ,caption ,footnotes --------- ,always define footnotes right after the paragraph they are referenced4 44 toc-entry33 ,footnote ,positions 44 table33 ,positioning of footnotes 3class3 norules 3width3 #ge 3align3 center 3widths3 #b #h 3summary3 ,explains where footnotes end up ,format ,position ,,html ,collected under the footnotes directive4 ,,epub ,idem4 ,,txt ,where they are defined4 ,,pdf ,at the bottom of the current page4 ,to collect the footnotes use the 3directive3footnotes directive4 ,this directive will output a section with title and all footnotes in the document will be moved inside the section4 ,in ,,pdf and ,,txt formats the 3directive3footnotes directive will do nothing4 ,test 4 44 ,not even print the section title4 44 example33 3norender3 44 footnotes33 ,footnotes 3class3 smaller 44 ,another footnote1 to test how multiple footnotes stack on one page4 44 ,later editions continued as follows3 ,when the sands are all dry1 he is gay as a lark1 ,and will talk in contemptuous tones of the ,shark1 ,but1 when the tide rises and sharks are around1 ,his voice has a timid and tremulous sound4 44 ,gibbon test4 ,a footnote inside a footnote4 ,page ,numbers ------------ ,the sequence 3code3pg n will convert into a page number marker of n4 n can be any arabic or roman numeral4 ,the sequence itself will be removed from the text flow leaving a page anchor4 ,there 99must99 be spaces around the sequence4 ,if the page break is in the middle of a word1 join the word and put the sequence at the end of the word4 44 example33 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt pg #db ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores pg xviii et ea rebum4 ,a reference to a page number can be inserted with the sequence 3code3pg n4 ,this will generate a link to the page anchor4 44 example33 ,see page pg #db4 ,an invisible page number can be inserted with the sequence 3code3pg6n4 44 example33 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt pg6#dc ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,see page pg #dc4 ,see page pg iii4 ,dropcaps -------- ,you can insert dropcaps with the 3directive3dropcap directive4 ,you can use either an enlarged character or an image as dropcap4 ,you can also specify a span of character that should be set in small-caps after the dropcap initial4 44 table33 ,support for dropcaps in output formats 3class3 norules 3width3 #hj 3align3 center 3widths3 #b #e #e ,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 44 a 99,warning399 ,if a paragraph with a dropcap gets page-broken the dropcap may stick into the page bottom4 ,avoid dropcaps unless you are sure that you are at the top of a page1 like at a chapter start4 ,the first argument 7mandatory7 states the character7s7 to replace with caps4 ,it must match the beginning of the next paragraph4 ,the second 7optional7 argument states the characters to replace with small-caps4 ,it must also match the beginning of the next paragraph4 44 example33 44 clearpage33 44 dropcap33 ,l ,lorem ipsum 3lines3 #d 3indents3 -#a4be;em #j4e;em ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,the 3option3lines option 7,,pdf only7 specifies how many lines the dropcap should span4 ,default is #b4 ,the 3option3indents option 7,,pdf only7 can specifiy up to #b length values4 ,the first one is the indent of the first line1 the second one the indent of the following lines4 ,the indent is calculated from the right border of the dropcap letter4 ,defaults are #j;em and #j4e;em4 ,the 3option3image option specifies the image url4 ,in plain text and ,,epub the image will not be used4 44 example33 44 clearpage33 44 dropcap33 ,g 3image3 images_/,g4png 3lines3 #d ,gorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,tables ------ ,be careful with tables because the table support of many ereaders is weak or nil4 ,tables also support these options3 3option3width ,makes the table that wide4 3option3widths ,a space-separated list of unitless values1 each specifying the relative width of one table column4 ,if you don't use the option 3option3widths1 the column widths are calculated from the layout of the table in your source file4 3option3aligns ,horizontally align the columns4 ,a space-separated list of alignments1 each specifying the alignment of one column4 ,valid alignments values are3 left1 center1 right and justify4 3option3vertical-aligns ,vertically align the columns4 ,a space-separated list of vertical alignments1 each specifying the alignment of one column4 ,valid alignments values are3 top1 middle1 and bottom4 ,note3 vertical alignment is fully supported in ,,html only4 ,other formats may support it in varying degrees4 3option3summary 7,,html only47 ,puts a summary attribute on the table element4 ,these are the extra classes supported by ,,pg-,,rst3 3css3norules ,omits the rules between table rows4 7,not the rule between header and body nor the rules at the top and bottom of the table47 ,use this class when the eye can follow the table rows without the aid of rules4 44 example33 44 table33 ,demo ,table 3width3 #ajj 3align3 center 3widths3 #c #a #a #a 3aligns3 justify justify center right 3vertical-aligns3 top middle bottom top 3summary3 ,this table contains valuable data4 ---------------------------------------- ---------------- ,header row1 column #a ,justified ,centered ,price 77 7header rows optional7 row #a column column #a4bc ---------------------------------------- ---------------- row #b col col col #de4fg col col col col col ---------------------------------------- ---------------- row #c ,cells may span columns4 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam sed diam voluptua4 ,at vero eos accusam et justo duo dolores et rebum4 ---------------------------------------- ---------------- ,cells may span rows and ,cells row #d columns4 ,lorem ipsum dolor sit may span ----------- amet1 consetetur adipiscing4 rows4 row #e ---------------------------------------- ----------------- 44 example33 44 table33 ,truth table for 8and0 3class3 norules 3align3 center 3width3 #ej ,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 file4 ,it looks like this3 44 example33 3norender3 44 -99- encoding3 utf-#h -99- 7#a7 44 meta33 7#b7 3,,pg4,id3 #aha 3,,pg4,title3 ,very ,short ,title 3,,pg4,released3 #bjaj-aa-be 3,,pg4,rights3 ,public ,domain 3,,pg4,producer3 ,woody ,guthrie 3,,pg4,producer3 ,pete ,seeger 3,,pg4,producer3 ,the ,almanac ,singers 3,,pg4,credits3 ,this file was produced from images stolen from the ,louvre4 3,,dc4,creator3 ,jane ,austen 3,,marcrel4edt3 ,mark ,twain 3,,marcrel4ill3 douard ,manet 3,,dc4,title3 ,full ,title ,statement 3,,dc4,language3 en 3,,dc4,language3 fr 3,,dc4,language3 de 3,,dc4,created3 #aijj 3coverpage3 images_/cover4jpg ,short ,title 7#c7 44 pgheader33 7#d7 7#a7 ,insert this line verbatim4 ,it must be the first line in the text4 ,this tells the converter to use ,,utf-#h encoding and is also recognized by many editors4 7#b7 ,the metadata directive3 see section below4 7#c7 ,this will be the first line of the generated files4 ,it should say3 8,the ,project ,gutenberg ,ebook of ,title0 or just 8,title04 ,use '' above and below the title4 7#d7 ,this directive inserts the ,,pg header as generated from the metadata4 44 ,a unicode ,,bom is allowed before this4 ,in fact most ,windows editors will add a ,,bom without asking you4 ,metadata ,directive ------------------ ,the metadata directive contains all data that is used to generate the ,,pg header and the ,,pg catalog entry4 ,the scheme is the part before the dot4 ,,pg ,scheme ,the ,,pg scheme holds data that is relevant to ,project ,gutenberg only4 44 table33 ,fields ,in the ,,pg ,scheme 3width3 #ge 3widths3 #a #c ,name ,contents ,,pg4,id ,the ebook number4 ,,pg4,released ,the ,,pg release date in ,,yyyy-,,mm-,,dd format4 ,,pg4,rights ,either ',public ,domain' or ',copyrighted'4 ,,pg4,title ,a much shortened form of the title4 ,used in the ,,pg boilerplate in the lines that say3 8,start of this ,,pg ebook '''0 and 8,end of this ,,pg ebook '''04 ,,pg4,producer ,a personal name or organization that helped produce this text4 ,this field may appear more than once4 ,don't put more than one name into one field4 ,repeat the field if necessary4 ,,pg4,credits ,a line acknowledging the source of the images or other stuff4 ,,dc ,scheme ,this scheme holds standard ,dublincore stuff and is used by many search engines and the ,,pg cataloguing software4 44 table33 ,fields ,in the ,,dc ,scheme 3width3 #ge 3widths3 #a #c ,name ,contents ,,dc4,creator ,author4 ,a personal name or organization that created the text4 ,may appear more than once4 ,don't put more than one name into one field4 ,repeat the field if necessary4 ,,dc4,title ,the full title statement as found on the book's title page4 ,,dc4,language ,the #b or #c letter code for all languages used for substantial portions of the text4 ,may appear more than once4 ,don't put more than one code into one field4 ,repeat the field if necessary4 ,the languages listed here are indicative for the catalog and do not set the text language and hyphenation rules4 ,use the option 3option3class language-language-code for that4 ,,dc4,created ,the year of original publication if known4 ,,marcrel ,scheme ,this is used to record contributors to the text4 ,all these fields may appear more than once4 ,don't put more than one name into one field4 ,repeat the field if necessary4 44 table33 ,fields ,in the ,,marcrel ,scheme 3width3 #ge 3widths3 #a #c ,name ,contents ,,marcrel4edt ,editor ,,marcrel4ill ,illustrator ,,marcrel4trl ,translator ,,marcrel499 ,see the full list of ,,marc relator codes http3_/_/www4loc4gov_/marc_/relators_/re lacode4html4 ,no ,scheme ,some fields are associated with none of the above schemes4 44 table33 ,fields ,without ,scheme 3width3 #ge 3widths3 #a #c ,name ,contents coverpage ,a coverpage for those formats 7eg4 ,kindle7 that support a cover page4 ,this image must be included in the upload but must not necessarily be put in the text flow4 ,bottom ,boilerplate ------------------ ,you must put this at the very bottom of your ,,pg-,,rst file4 44 example33 3norender3 44 pgfooter33 7#a7 7#a7 ,this directive inserts the ,,pg footer and license4 ,,pg-,,rst ,best ,practices ,images ------ ,specify a 3option3width option in images and a 3option3figwidth option in figures and express it in percent4 ,if you don't specify a width1 the converter will calculate the width percentile for you1 using the formula33 imagewidth _/ 7#ihjpx 99 #j4h7 99 #ajj 7#ihjpx is the approx4 wide of a browser window with scrollbar on a #ajbdpx wide screen1 #j4h are #aj margins left and right47 ,expressing the image size relative to the screen width is the best way to get images right on a wide variety of devices form i,phones to print4 44 example33 44 toc-entry33 ,richard and ,drucilla ,martin 44 figure33 images_/cover4jpg 3align3 center 3alt3 ,richard and ,drucilla ,martin 3lb3,richard ,martin was a slave in ,memphis1 ,tennessee4 ,drucilla ,martin was a slave in ,giles ,county1 ,tennessee4 ,the legend consists of all elements after the caption4 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 pg6#b 44 toc-entry33 ,examples and ,tests ,tests and ,examples 44 topic33 ,notice ,the rest of this file contains tests4 ,you may look at the ,,rst source to learn how things are done4 ,a generated local table of contents3 44 contents33 3local3 ,a local table of contents as highlights3 44 highlights33 ,kingston -- ,instructive remarks on early ,english history -- ,instructive observations on carved oak and life in general -- ,sad case of ,stivvings1 junior -- ,musings on antiquity -- ,i forget that ,i am steering -- ,interesting result -- ,hampton ,court ,maze -- ,harris as a guide4 sop dipus cr4 4 4 #b4a #8' 80 em -- en -4 8#8,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4'0 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 pg #c ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 ---- ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 pg #d ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 44 container33 shrinkwrap align-center #8,speak roughly to your little boy1 ,and beat him when he sneezes3 ,he only does it to annoy1 ,because he knows it teases4' ,,chorus4 7,in which the cook and the baby joined73-- #8,wow6 wow6 wow6' ,summer wanes1 the children are grown2 ,fun and frolic no more he knows2 ,robert of ,lincoln's a humdrum crone2 ,off he flies and we sing as he goes3 ,bob-o'link1 bob-o'-link1 ,spink1 spank1 spink2 ,when you can pipe that merry old strain1 ,robert of ,lincoln1 come back again4 ,chee1 chee1 chee4 ,and now a quote by ,lorem ,ipsum3 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita pg #e kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 ,lorem ipsum dolor sit amet1 consetetur sadipscing elitr1 sed diam nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat1 sed diam voluptua4 ,at vero eos et accusam et justo duo dolores et ea rebum4 ,stet clita kasd gubergren1 no sea takimata sanctus est ,lorem ipsum dolor sit amet4 -- ,lorem ,ipsum pg #g ,section #c4a ----------- 44 epigraph33 ,i pity the man who can travel from ,dan to ,beersheba1 and say 8',tis all barren20 and so is all the world to him who will not cultivate the fruits it offers4 -- ,sterne3 ,sentimental ,journey4 ,simple ,list with hyphens - ,wash left ear4 - ,wash right ear4 - ,brush teeth4 ,simple ,list with bullets 99 ,wash left ear4 99 ,wash right ear4 99 ,brush teeth4 ,nested ,list #a4 ,item #a4 a7 ,item #a;a4 b7 ,item #a;b4 ,i7 ,item #a4;a4,i 7 ,item #a4;a4,,ii 7 ,item #a4;a4,,iii 7 ,item #a4;a4,,iv #b4 ,a7 i7 ,item #b4;,a4i pg #h 7 ,item #b4;,a4ii 7 i7 ,item #b4;,b4i 7 ,item #b4;,b4ii 7 ,item #b4;,b4iii 7 ,item #b4;,c #c4 ,item #c4 ,definition ,list term ,definition4 term #b ,definition #b ,definition #b paragraph #b4 long term #c ,definition #c ,option ,list 7not used by ,,pg7 -a command-line option a -#a file1 --onefile1 --two file ,multiple options with arguments4 pg #abc ,section #c4b ---------------- 44 ,this title contains a footnote reference4 ,the footnote reference will not show up in the ,,toc4 ,some text so this section isn't empty4 ,section #c4c ----------- ,,the ,,man ,,who ,,pleases4 44 container33 44 style33 line 3class3 italics 44 style33 attribution 3class3 small-caps 44 epigraph33 ,the dearest friend to me1 the kindest man1 ,the best-conditioned and unwearied spirit ,in doing courtesies4 -- ,merchant of ,venice4 44 epigraph33 ,he hath a daily beauty in his life4 -- ,othello4 44 epigraph33 ,such a man would win any woman in the world if a' could get her good will4 -- ,much ,ado ,about ,nothing4 ,there are few subjects of deeper interest to men and women than that of personal fascination1 44 epigraph33 ,ora si comincia per quelli di fuori e per quelli di dentro a far grandissima e crudel guerra4 44 class33 right ,istorie pistolesi4 44 table33 ,,table #h ,types of ,computers ,used in the ,systems ,reported 3width3 #ej 3widths3 #c #a #a 3aligns3 left right right 3vertical-aligns3 top top middle 3summary3 ,,table #h ,types of ,computers ,used in the ,systems ,reported 3class3 norules --------------------------------- ,type ,number ,,asi #baj #a 7#c7 ---------------------- ,,asi #bajj #b --------------------------------- ,,cdc #afj;,a #b 7#c7 ---------------------- ,,cdc #cajj #a --------------------------------- 44 class33 small 33 total computer cost #j4bb #j4jf by averaging ------------------------ #j4bc - separate ratios for each cost of bare accelerator system 44 backmatter33 44 toc-entry33 3depth3 #j pg6#aj 44 footnotes33 ,footnotes 3class3 smaller pg #ii 44 topic33 ,transcriber's ,note ,minor spelling errors have been silently corrected4 ,hyphenation has been made consistent4 44 pgendline3 9999