- gutvol-d - lists.pglaf.org

Apostrophe versus turned comma - Mc, Mac, etc.
by Paul Flo Williams 27 Sep '21

27 Sep '21

Seeing the latest posting of "The Invasion of India", apparently by a "J. W. M'Crindle" (#66388), I wonder why his name is rendered with an apostrophe, instead of either the turned comma (open single quote) or a simple "c". His name was John Watson McCrindle (1825-1913), and the Internet Archive version of the book clearly shows that the turned comma is used for his name, the normal printer's approximation of the superscript "c". Using the apostrophe like this means that "The Invasion of India" isn't found when searching for McCrindle, even though his other book on PG, "The Commerce of the Navigation of the Erythræan Sea" is correctly attributed. There's a very good essay by Michael Collins about this: http://greenbag.org/v12n3/v12n3_collins.pdf Regards, Paul

3 2

Ebookmaker has stopped working, error messages
by James Simmons 29 Aug '21

29 Aug '21

I used Ebookmaker as recently as yesterday with no problems, but today I'm getting no epub generated and output.txt shows the following: unzipping /htdocs/ebookmaker/cache/20210827154639/Vishnupuranam.zip Input file: Vishnupuranam.html EbookMaker 0.11.4 WARNING:root:Gutenberg Database is inactive because psycopg2 not installed Traceback (most recent call last): File "/var/www/.local/share/virtualenvs/ebookmaker-A6HCkzTJ/bin/ebookmaker", line 18, in <module> EbookMaker.main () File "/var/www/.local/share/virtualenvs/ebookmaker-A6HCkzTJ/lib/python3.6/site-packages/ebookmaker/EbookMaker.py", line 534, in main job.url = os.path.join(absoutputdir, output_files['epub.images']) File "/var/www/.local/share/virtualenvs/ebookmaker-A6HCkzTJ/lib/python3.6/posixpath.py", line 94, in join genericpath._check_arg_types('join', a, *p) File "/var/www/.local/share/virtualenvs/ebookmaker-A6HCkzTJ/lib/python3.6/genericpath.py", line 149, in _check_arg_types (funcname, s.__class__.__name__)) from None TypeError: join() argument must be str or bytes, not 'NoneType' I tried it a couple of times to be certain. Other than correcting some spelling errors, my input today is no different from yesterday. James Simmons

3 6

Questions on metadata in HTML files
by James Simmons 28 Aug '21

28 Aug '21

A few weeks ago I got an email saying I was one of the last two PG contributors using RST and that RST would no longer be accepted by PG. It was suggested that if I wanted to use RST I could convert it to HTML using pandoc. I have been experimenting with pandoc and rst2html and have gotten good results with both, so I have a pretty good procedure going where I can make RST files and generate usable HTML files from them. I think rst2html gives better results than pandoc, but both work OK and I don't miss the PG extensions to RST much if at all. HOWEVER, I am not entirely clear on how to submit my HTML docs now. The ebookmaker page suggests that I can include metadata in my HTML files and ebookmaker will pick it up. That does not seem to be happening. My HTML metadata looks like this: <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /><meta name="generator" content="Docutils 0.16: http://docutils.sourceforge.net/" /><title>A PROSE ENGLISH TRANSLATION OF VISHNUPURĀNAM</title><meta content="A Prose English Translation of Vishnupurānam" name="pg.title" /><meta content="99999" name="pg.id" /><meta content="Public Domain" name="pg.rights" /><meta content="James Simmons" name="pg.producer" /><meta content="This file was produced from page images at Internet Archive." name="pg.credits" /><meta content="Manmatha Nath Dutt, M. A., M.R.A.S." name="dc.creator" /><meta content="A Prose English Translation of Vishnupurānam" name="dc.title" /><meta content="en" name="dc.language" /><meta content="1896" name="dc.created" /><meta content="yyyy-mm-dd" name="pg.released" /><meta content="images/cover.jpg" name="coverpage" /> This is pretty much what I used with RST, but with names all lower case. I've tried both ways and ebookmaker ignores them both. So how do I put metadata in HTML so ebookmaker can find it and use it? James Simmons

3 3

Newbie questions on using ReST
by Joseph Koshy 19 Jul '21

19 Jul '21

Greetings, Some newbie questions: Q1: Which tool should I use to check my work, when transcribing a book to ReST? The Project Gutenberg ReST Manual [1] mentions 'epubmaker', but I wasn't able to get this to work on a recent Ubuntu GNU/Linux machine with Python 3. Would 'ebookmaker' [2] be a suitable replacement? [1]: https://www.gutenberg.org/ebooks/181 (ReST Manual) [2]: https://github.com/gutenbergtools/ebookmaker (ebookmaker) Q2: Do we have examples of ReST-sourced books containing complex tables? I am looking for ways to: - to embed tabular material inside block-quoted text and footnotes, - to render tabular material without the horizontal lines between rows, - to format a table caption using small caps, - to right-justify specific sub-columns inside a left-justified column group. Thanks, Joseph Koshy

3 4

Help needed in keeping the modified dates in FileZilla for PG-errata
by Rick Tonsing 18 Feb '21

18 Feb '21

I've been told that some PG-errata users are able to retain the modified date in FileZilla in Windows OS. How does someone do that? I've noticed that the created and accessed dates are blank on the PG book files I've looked at so far. For all of the files downloaded with FileZilla, Windows sets all three dates to the now date and time. Cheers, Rick

2 1

Help needed to diagnose RST problem
by James Simmons 30 Dec '20

30 Dec '20

I have been doing PG donations using the RST format for many years and have encountered and fixed the "Title level inconsistent:" problem MANY times but my latest file is giving me this for no obvious reason. I'm hoping that one of you can see what I'm missing. My RST files all use this underline format for the headings: ============= for the title ----------------------- for h1 `````````````````````` for h2 This is consistent with what the PG footer uses and has NEVER caused problems in the past. An example of where I've used it successfully is here: https://dev.gutenberg.org/files/64046/ The situation where I generally get the error is if I try to add a fourth level. I've learned not to do that. The attached file uses exactly the same convention and fails. Works just fine with no PG footer directive, fails with *Title level inconsistent *once you add that directive. The TOC shows the levels I would expect to get. I have tried removing the ``````` level underlining and that changes the error reported (different character reported as not in list, ` instead of =) ValueError: '=' is not in list but it still fails. Removing the ---- as well doesn't fail but of course you have no headings https://ebookmaker.pglaf.org/cache/20201229095936/ is my latest attempt to run this. The RST file is attached. Thanks. James Simmons

2 3

Publishing RST books with Latex
by James Simmons 21 Oct '20

21 Oct '20

A few months ago I looked at the PDFs produced by ebookmaker and wondered if it would be possible to create a utility that made a PDF good enough to use as interior pages for a print-on-demand book. I have been experimenting with rst2pdf (the utility program that ebookmaker's PDF generation is based on) and I've published a bunch of trade paperback books on Kindle Direct Publishing that started out as my RST donations to Project Gutenberg. The first picture shows proof copies from all the books I've published with this method. The second picture shows just how nice the interior pages look. Pictures can float inside paragraphs and alongside paragraphs, math formulas and fractions are formatted beautifully, and words are hyphenated automatically. I did cover images with The GIMP using either pictures from the book itself or other art in the public domain. I used free fonts and sometimes made them fancier by adding drop shadows and distortion effects in The GIMP. Converting an RST file to a nicely formatted TEX file can be done in one or two afternoons. The TEX file produced by rst2pdf needs to be touched up with a text editor, but this is surprisingly little work. If you don't have an RST file a plain text file from PG can be turned into an RST file with very little work. That is what I did with *Ancient Manners,* James Simmons

3 3

Editing Tools
by kostuch＠earthlink.net 31 Jul '20

31 Jul '20

I am a new member and unfamiliar with your protocol. The site seems to be organized by date, not by subject. My purpose in joining is to share a set of AutoHotKey scripts I developed to simplify ordinary edit operations. For example, joining hyphenated word fragments, inserting non-English characters,and applying page brackets. The code is relatively well organized and commented and amenable to individual modification. I often modify it for specific texts, taking only a few minutes to do so. My objective is to avoid moving my eyes from the screen (I am not a touch typist) and minimizing hand motion. Nearly all corrections are done with two mouse clicks, open the operation menu and select the operation. I would like some feedback, and if positive, a place to post the code. Peace and Light, Don Kostuch

1 0

Image sizes for donated e-books
by James Simmons 19 Jul '20

19 Jul '20

I'm looking for some advice on image sizes for donated books. I'm also thinking of submitting a corrected version of a book I recently submitted and I could use some guidance on that too. I have been using RST for all my submissions, and my latest submission was this one: https://www.gutenberg.org/ebooks/62549 This is my first attempt at an RST book with illustrations. I think the web page turned out pretty well, but when you read the book on a Kindle it is a different story. The illustrations are all 300 DPI and other than some rotation and cleaning up are the same size as was in the original PDF from Google Books. I specified that the illustrations should be displayed at 50% of the screen width, which looks nice in a web page but like postage stamps in the Kindle. The other thing I'm concerned about is the amount of disk space the image files take up. I'm thinking I would have been better off to display the pictures at 75% width or higher, and to use a Linux utility called "mogrify" to do a bulk resize on them to get the disk space usage down. I've got another book in the pipeline: https://www.google.com/books/edition/Aeroplane_construction_and_operation/e… This is a terrific book from 1918 called *Aeroplane Construction and Operation*. It is lavishly illustrated with photos and diagrams, and those images are a significant part of the value of the book. Having said that, the zipped up RST + image files is a hefty 98 mb. You can side load something that size into a Kindle or Nook, but you can't email it. I plan to keep a copy of the 300DPI files so I can make a print on demand version of this book, but I'm willing to bulk resize the images to a smaller size for PG. The question is what a good size would be? Thanks. James Simmons

3 4

Re: [gutvol-d] Using ebookmaker to create PDFs for print on demand publishing
by nicestep＠gmail.com 05 Jun '20

05 Jun '20

Eric, I have experimented with .tex and looked at the source code for ebookmaker and have concluded that updating that code to produce print- on-demand ready files would be more trouble than it is worth. This afternoon I took one of my own RST donations, ran it against rst2xetex.py and with about a half hour of simple edits I made a .tex file that produced a PDF that met all of Kindle Direct Publishing's requirements and looked great. Any .tex file I could produce with a modified ebookmaker would still need a few manual edits to get ready for publication, so I think there would be greater benefit if I just taught people to do what I just learned to do. I understand that RST is not a very popular way to prepare PG donations but I think it would be if more people knew about it. You do have a very short article on RST in the Wiki but it is hard to find, even harder if you don't know what RST is and just want some tips on how to do a PG donation with less work. I think I could write something more fleshed out that actually sells the idea of using RST. I could also do a second article on using RST files for print on demand. I did my first donation back in 2011 https://www.gutenberg.org/files/36378/36378-h/36378-h.htm and discovered RST the following year, after doing several books the hard way. https://www.gutenberg.org/ebooks/39442 James Simmons On Mon, 2020-05-25 at 09:55 -0500, nicestep(a)gmail.com wrote: > Eric, > I'm going to try publishing my book with the .tex file I created > manually. That way I'll have a good Tex file to use as an example for > generating automatically. So far it turns out there is more to Tex > than I thought there was. > I have a fourth volume of Ramayana to finish, so I'll probably do > that before I work on updating ebookmaker. I'll create my own branch > to work in. > I agree that I might be the last user of RST, but there is no reason > it has to stay that way. I just looked at the PG wiki pages and there > are no articles on RST there at all. I can't even remember how I > found out about it. My first RST donation was done back in 2012. > There is other information that I don't see on the Wiki either. For > example, articles talk about getting old books from secondhand shops, > but I don't see any mention of archive.org and the fact that they > have page images and OCR'ed text for tons of books. > I could contribute a Wiki article on RST if you like. I have some > experience writing about e-books from the One Laptop Per Child > project: > https://archive.org/details/EBookEnlightenment/mode/2up > James Simmons > > On Sun, 2020-05-24 at 21:38 -0400, Eric Hellman wrote: > > OK, that's interesting; I'm not sure why they didn't show up on my > > spreadsheet. > > I'm in a position now where I can fix things at PG and move them > > forward; don't hesitate to contact me if you think you can help. > > Everyone wants to do the right thing, but the code and especially > > the workflow is from another era. The ebookmaker software is in > > relatively good shape now. > > > > Eric > > > > > On May 24, 2020, at 6:24 PM, nicestep(a)gmail.com wrote: > > > > > > Eric, > > > I would question your statement that the most recent RST sourced > > > book is 5 years old. I donated four of them more recently than > > > that: > > > https://www.gutenberg.org/ebooks/61937 > > > https://www.gutenberg.org/ebooks/57265 > > > https://www.gutenberg.org/ebooks/57826 > > > https://www.gutenberg.org/ebooks/60188 > > > I have done PG donations before discovering RST, but I would not > > > go back. The books I've been doing lately have hundreds of > > > footnotes. RST makes this tolerable. I think if more people knew > > > it existed more would use it. It saves a great deal of work. > > > I'll have to look at the code again to see how docutils is being > > > subclassed. I hadn't noticed that. I've done Python programming > > > in the past, for the One Laptop Per Child project, but I'm rusty > > > at it. > > > James Simmons > > > > > > > > > On Sun, 2020-05-24 at 10:09 -0400, Eric Hellman wrote: > > > > The ebookmaker rst code is basically subclassed docutils - so > > > > deeply that upgrades to docutils broke ebookmaker and I had to > > > > fix it. My impression is that Marcello, the original author of > > > > ebookmaker, was a contributor to docutils. > > > > There are 485 RST-sourced books in PG, the most recent is 5 > > > > years old. > > > > > > > > the intermediate tex files generated by ebookmaker during rst > > > > processing are accessible but not exposed on the pg website. > > > > For example: > > > > http://www.gutenberg.org/cache/epub/48620/pg48620.tex > > > > > > > > In the rest of the world, there's been a lot more development > > > > of rst-ish tools outside of rst. Github flavored Markdown is > > > > the most widely used, but even asciidoc has found some adoption > > > > in the publishing industry. Gitbooks is a rather nice markdown- > > > > based book generator. > > > > > > > > By all means, if you can make improvements to the ebookmaker > > > > code, submit a PR on github. No one is working on anything > > > > related to tex or rst. > > > > https://github.com/gutenbergtools/ebookmaker A "PODWriter" > > > > class might be what you're thinking about. > > > > > > > > Eric > > > > > > > > > On May 24, 2020, at 8:51 AM, nicestep(a)gmail.com wrote: > > > > > > > > > > My first impression of the PDF's created by ebookmaker was > > > > > that with a little work they might be suitable for print on > > > > > demand publishing like I have done several times with Create > > > > > Space. I have spent a few hours installing ebookmaker on my > > > > > own computer and experimenting with Tex and the attached > > > > > files represent the kind of thing that ebookmaker might be > > > > > modified to produce. They are not perfect, but I think they > > > > > are good enough to criticize. > > > > > > > > > > Some observations: > > > > > > > > > > 1. The Tex file was created by running my original RST file > > > > > against both ebookmaker and rst2xetex.py. The two files that > > > > > were produced were combined to produce the Tex file attached. > > > > > Rst2xetex.py does not understand the custom RST elements PG > > > > > uses so I had to make a version of the RST file without them > > > > > to get rst2xetex to run properly. > > > > > 2. The output of rst2xetex was actually closer to what I > > > > > wanted than what ebookmaker produced. Ebookmaker does a table > > > > > of contents that is just links with no page numbers, and the > > > > > headings are not regular headings and subheadings that Tex > > > > > uses. Rst2xetex gave me regular headings and subheadings that > > > > > could create the TOC I wanted. I had to run xelatex against > > > > > the Tex file twice to create the PDF with a TOC. > > > > > 3. I think that a Tex file is a more useful output for > > > > > ebookmaker than a finished PDF. Create Space wants you to > > > > > have ISBN and ISBN-13 numbers on the Verso, so having a Tex > > > > > file to edit is easier than trying to edit a PDF. Also, PG > > > > > has a lot of short stories that could be combined to create > > > > > anthologies and that would be easier with Tex files. > > > > > 4. Looking at the code for ebookmaker it looks like some of > > > > > it might have been adapted from code written for docutils. > > > > > Some of the code is clear enough, and some is not. > > > > > > > > > > James Simmons > > > > > > > > > > > > > > > -- > > > > >

2 1