[First Project] The Emerald City of Oz by L. Frank Baum

82 views
Skip to first unread message

Alex Hedges

unread,
Apr 3, 2026, 4:55:15 PM (9 days ago) Apr 3
to Standard Ebooks
As my first production, I would like to work on _The Emerald City of Oz_ by L. Frank Baum. This is already a wanted book, [The Emerald City of Oz](https://standardebooks.org/ebooks/l-frank-baum/the-emerald-city-of-oz), and I'm finishing up the previous book, so I'd like to be able to read a Standard Ebooks version.

For the transcription, I will use the transcription of the 1910 edition, <https://gutenberg.org/ebooks/517>. The other one hosted on Project Gutenberg, <https://gutenberg.org/ebooks/41667>, is illustrated and includes editorial changes by the transcribers, so I will not use it. The books' credits do not reference any specific scans, but I found <https://archive.org/details/emeraldcityofoz00baum> on the Internet Archive, which seems to correspond to the transcription.

I tried to do my first production two years ago (<https://groups.google.com/g/standardebooks/c/PExvBO_CALs/m/B6tl9-CsCQAJ>), but I ended up silently dropping it due to a lack of time. I will make sure to work faster and be more communicative this time!

Alex Cabal

unread,
Apr 6, 2026, 2:39:43 PM (6 days ago) Apr 6
to standar...@googlegroups.com
OK sure, you can work on this one.

I suggest starting with the illustrated PG edition because it looks like
they made spelling consistent and corrected obvious errors which is what
we would do anyway. So that's less work for you to start with. Removing
the images is easy. You can also re-add the preface that is found in the
earlier PG edition.

Please send a link to your repo once you start.
> --
> You received this message because you are subscribed to the Google
> Groups "Standard Ebooks" group.
> To unsubscribe from this group and stop receiving emails from it, send
> an email to standardebook...@googlegroups.com
> <mailto:standardebook...@googlegroups.com>.
> To view this discussion visit https://groups.google.com/d/msgid/
> standardebooks/196c68c0-bfe5-4148-9cfa-550e7a55db41n%40googlegroups.com
> <https://groups.google.com/d/msgid/standardebooks/196c68c0-
> bfe5-4148-9cfa-550e7a55db41n%40googlegroups.com?
> utm_medium=email&utm_source=footer>.

Alex Hedges

unread,
Apr 8, 2026, 8:41:38 AM (4 days ago) Apr 8
to standar...@googlegroups.com
Thanks for the suggestion! I diffed the two versions, and
spot-checking the differences, I can see that the edited one is more
correct to the scan's text.

I've started the production at
<https://github.com/aphedges/l-frank-baum_the-emerald-city-of-oz>. I'm
doing work on the `dev` branch and pushing to `main` once I'm more
confident about its correctness. Please let me know if you prefer
another workflow. I've made enough changes on `dev` to be able to
start proofreading the book, but I need to clean up the commit
history, so I don't recommend looking over it now.

I have some questions about things I've come across so far:

- How does one make a preface?
<https://standardebooks.org/contribute/producing-an-ebook-step-by-step#split>
suggests using `se add-file`, but it doesn't support a preface. I used
the file created by `se add-file dedication .` and added some changes
from the SEMOS. Is that the correct way to do it?
- I couldn't find any specific guidance on how to format signage. Is
there some undocumented style I should be following?
- Most of the signage in the book starts with an image that
roughly resembles 👉. Should I use the emoji or the original image, or
should I just leave it out?
- How does one figure out the indentation level for poetry? The
Project Gutenberg HTML used the classes classes `indent2` and
`indent4` (only 1 em of difference between them), so I created similar
classes `i2` and `i4`. Is that correct, or should all indentation
start with `i1` as the first level?
- The Oz books have a robot-like character named Tik-Tok, and his
dialogue is written differently. Chapter 4 of _Ozma of Oz_
(<https://standardebooks.org/ebooks/l-frank-baum/ozma-of-oz/text/chapter-4>)
describes his voice as follows: "The words sounded a little hoarse and
creakey, and they were uttered all in the same tone, without any
change of expression whatever." Section 8.7.7.6 of the SEMOS
(<https://standardebooks.org/manual/1.8.7/single-page#8.7.7.6>) says
to use non-breaking hyphens for words that are "stretched out by a
speaker for prosodic effect," but this seems different. _Ozma of Oz_
just uses the normal hyphen-minus for Tik-Tok's speech, so that
doesn't answer my question. On a similar note, how does one format a
stutter? That seems similar enough, and I noticed at least one case in
this book.
- I've been committing more granularly than recommended by "Producing
an Ebook, Step by Step". Is that okay? Do you want me to make empty
commits as checkpoints to match what is used in the guide, or is what
I am doing good enough?

I'll be traveling over the next several days without access to my dev
computer, but it'll give me plenty of time to read over the draft. I
probably won't respond to any responses until next week.

- Alex
> You received this message because you are subscribed to a topic in the Google Groups "Standard Ebooks" group.
> To unsubscribe from this topic, visit https://groups.google.com/d/topic/standardebooks/3XatN4QIdLk/unsubscribe.
> To unsubscribe from this group and all its topics, send an email to standardebook...@googlegroups.com.
> To view this discussion visit https://groups.google.com/d/msgid/standardebooks/7ad6e102-98be-44b3-ab23-796d13d5d46e%40standardebooks.org.

Emma Sweeney

unread,
Apr 8, 2026, 12:35:43 PM (4 days ago) Apr 8
to Standard Ebooks
- How does one make a preface?
<https://standardebooks.org/contribute/producing-an-ebook-step-by-step#split>
suggests using `se add-file`, but it doesn't support a preface. I used
the file created by `se add-file dedication .` and added some changes
from the SEMOS. Is that the correct way to do it?

That can work; make sure it has preface semantics. You can also manually create a `preface.xhtml` file, then copy and paste the text into the file.
 
- I couldn't find any specific guidance on how to format signage. Is
there some undocumented style I should be following?

That seems like it requires some custom styling. Sometimes you can borrow styling from other Oz books. Can you send a picture of the signage?
 
- Most of the signage in the book starts with an image that
roughly resembles 👉. Should I use the emoji or the original image, or
should I just leave it out?

You can use ☞ (U+261E) for the manicule.
 
- How does one figure out the indentation level for poetry? The
Project Gutenberg HTML used the classes classes `indent2` and
`indent4` (only 1 em of difference between them), so I created similar
classes `i2` and `i4`. Is that correct, or should all indentation
start with `i1` as the first level?

You just have to eyeball them. Open the file in a browser and see if the indents match the page scans.
 
- The Oz books have a robot-like character named Tik-Tok, and his
dialogue is written differently. Chapter 4 of _Ozma of Oz_
(<https://standardebooks.org/ebooks/l-frank-baum/ozma-of-oz/text/chapter-4>)
describes his voice as follows: "The words sounded a little hoarse and
creakey, and they were uttered all in the same tone, without any
change of expression whatever." Section 8.7.7.6 of the SEMOS
(<https://standardebooks.org/manual/1.8.7/single-page#8.7.7.6>) says
to use non-breaking hyphens for words that are "stretched out by a
speaker for prosodic effect," but this seems different. _Ozma of Oz_
just uses the normal hyphen-minus for Tik-Tok's speech, so that
doesn't answer my question. On a similar note, how does one format a
stutter? That seems similar enough, and I noticed at least one case in
this book.

Just use regular hyphens. Otherwise the line breaks will get really messed up. `se typography` will take care of the rest.
 
- I've been committing more granularly than recommended by "Producing
an Ebook, Step by Step". Is that okay? Do you want me to make empty
commits as checkpoints to match what is used in the guide, or is what
I am doing good enough? 

For your first production, your commit history should match the steps taken in the Step-by-Step Guide. Do not make empty commits. Granular commit changes should mostly be for [Editorial] commits in your production.


Emma

Alex Cabal

unread,
Apr 8, 2026, 3:18:13 PM (4 days ago) Apr 8
to standar...@googlegroups.com
OK, David will manage with Emma reviewing. Emma already answered your
questions in this thread.
Reply all
Reply to author
Forward
0 new messages