From af8f4ddefb71f7290484ff5ee6f36f6c529c2c21 Mon Sep 17 00:00:00 2001 From: Weijia Cheng Date: Thu, 6 Jan 2022 09:49:03 -0800 Subject: [PATCH] Explain how to include translator(s) in step-by-step guide --- www/contribute/producing-an-ebook-step-by-step.php | 2 ++ 1 file changed, 2 insertions(+) diff --git a/www/contribute/producing-an-ebook-step-by-step.php b/www/contribute/producing-an-ebook-step-by-step.php index e9fb32bf..a0d3e61e 100644 --- a/www/contribute/producing-an-ebook-step-by-step.php +++ b/www/contribute/producing-an-ebook-step-by-step.php @@ -68,6 +68,8 @@ require_once('Core.php');

  • With the --pg-id option

    You can pass se create-draft the ID of the Project Gutenberg ebook, and it’ll try to download the ebook into ./src/epub/text/body.xhtml and prefill a lot of metadata for you:

    se create-draft --author="Robert Louis Stevenson" --title="The Strange Case of Dr. Jekyll and Mr. Hyde" --pg-id=43 cd robert-louis-stevenson_the-strange-case-of-dr-jekyll-and-mr-hyde/ +

    If the book you’re working on was translated into English from another language, you’ll need to include the translator as well, using the --translator argument. (For translated books that don’t have a translator credited, you can use the name of the publisher for this argument.)

    se create-draft --author="Leo Tolstoy" --translator="Louise Maude" --title="Resurrection" --pg-id=1938 cd leo-tolstoy_resurrection_louise-maude/ +

    In the unusual case that your book has multiple translators, you will include each one by putting each translator’s name in quotation marks after the --translator argument, like so:

    se create-draft --author="Leo Tolstoy" --translator "Louise Maude" "Aylmer Maude" --title="The Power of Darkness" --pg-id=26661 cd leo-tolstoy_the-power-of-darkness_louise-maude_aylmer-maude/

    Because Project Gutenberg ebooks are produced in different ways by different people, se create-draft has to make some guesses and it might guess wrong. Make sure to carefully review the data it prefills into ./src/epub/text/body.xhtml, ./src/epub/text/colophon.xhtml, and ./src/epub/content.opf.

    In particular, make sure that the Project Gutenberg license is stripped from ./src/epub/text/body.xhtml, and that the original transcribers in ./src/epub/text/colophon.xhtml and ./src/epub/content.opf are presented correctly.