[First project] Don Rodriguez by Lord Dunsany

[Markus]

Hi all,

I've tried to post before but it does not seem to have gone through (unless it's awaiting mod approval?). Apologies if I double-posted.

I would like to try my hand at Don Rodriguez by Lord Dunsany. I installed the tool chain. I read the step-by-step guide. I still have to read the manual of style.

PG: https://www.gutenberg.org/ebooks/4282

Scan (IA): https://archive.org/details/donrodriguez0000lord

M

[Markus]

Hi,

I would like to try my hand at Don Rodriguez by Lord Dunsany. The toolchain is set up. I read the step-by-step guide. I still have to read the manual of style.

PG: https://www.gutenberg.org/ebooks/4282

Scan (IA): https://archive.org/details/donrodriguezchro00duns

M

[Alex Cabal]

Great, that one would be a good start.

Since there is a dedication and preface, you will have to include a half
title page. You can use `se add-file halftitlepage` to do that.
Otherwise, this should be pretty straightfoward.

Make sure to read the Standard Ebooks Manual of Style before starting,
as you won't know what to fix if you haven't read the standards. In
particular, please closely review the semantics, high level patterns,
and typography sections:

https://standardebooks.org/manual

https://standardebooks.org/manual/latest/4-semantics

https://standardebooks.org/manual/latest/7-high-level-structural-patterns

https://standardebooks.org/manual/latest/8-typography

The step by step guide will take you from start to finish:

https://standardebooks.org/contribute/producing-an-ebook-step-by-step

This page on common issues in older books may be useful:

https://standardebooks.org/contribute/how-tos/common-issues-when-working-on-public-domain-ebooks

Please email often if you have any questions at all. Our standards are
well-established so there is probably already a standard for formatting
whatever problem you've encountered.

When you're ready, email back with a link to your Github repository so
that I can mark you as having started.

Have fun! :)

> --
> 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/65349cc8-a471-46b8-bff5-fe83548a2758n%40googlegroups.com
> <https://groups.google.com/d/msgid/standardebooks/65349cc8-a471-46b8-
> bff5-fe83548a2758n%40googlegroups.com?utm_medium=email&utm_source=footer>.

[Alex Cabal]

OK, Weijia will manage this with Emma reviewing.

[Weijia Cheng]

Ok, noted.

[Markus]

Hi,

I'm at step 9, reading through the current version and manually editing typography. I have a few questions. I would appreciate your guidance. In general, I would tend to privilege this IA scan (https://archive.org/details/donrodriguezchr00dunsgoog/mode/2up) over the PG transcription. The IA scan seems to be the original 1922 publication. I couldn't find which edition the PG version is based on.

1. Some scans/transcriptions call the preface "Chronology" and others "Preface".  The above IA scan uses "Preface." I would therefore go with that instead of "Chronology."

2. I think that "Chronicles of Shadow Valley" is a subtitle (most versions include it on the title page or halftitle page) but I am a little confused by some online sources' showing "Don Rodriguez" and "The Charwoman's Shadow" (https://en.wikipedia.org/wiki/The_Charwoman%27s_Shadow) making up the "Chronicles of Shadow Valley" series. It seems to me that while the two novels might be related, "CoSV" is properly part of the title of the first novel and not the name of some overarching series. But I thought I'd check with you.

3. The IA scan does not use chapter ordinals. The PG transcription does. I'm leaning towards going with the IA scan.

Thanks,

M

[Weijia Cheng]

In cases like this where there are slight differences between the PG transcription and the IA scan, you should stick with what the PG transcription does unless we have strong reason to believe that the PG edition is worse than the scanned edition. I don't think anything you mentioned rises to that level. I agree with marking "Chronicles of Shadow Valley" as the subtitle.

[Markus]

I finished a first read. Here are the major updates and some questions.

1. There is a character called "Morāno." His name is written with a macron throughout the scan, so this isn't an occasional typo or misprint. AFAICT Spanish does not "officially" use macrons, but I stuck with the scan's spelling.

2. I made an editorial commit. There are two cases of what I think are fairly obvious printer's typos. Just wanted to flag this here.

3. I decided on a solution for chapter titles but I would like your opinion on a possible alternative. Details below.

4. I am wondering how to treat the first "chapter" (chapter-1.xhtml). To me, it feels more like a prologue-as-frame-narrative as mentioned in 3.2.1. Because PG treats it like a chapter and gives it the ordinal "I" (One), this creates a discrepancy in the following chapters whose titles follow the template: II - The First Chronicle; III - The Second Chronicle; ...

Chapter Titles: the PG transcription uses ordinals, titles, and subtitles. The IA scan does not contain ordinals. Following the manual of style, I use an hgroup element, with the ordinal being an h2 element and the title and subtitle being p elements. But since all chapter titles (except for the first, see point 4 above) follow the template "The First/Second/... Chronicle," I was wondering if I should use instead a unique identifier as mentioned in 8.1.4. Regarding the subtitles, they are all single descriptive declarative sentence. If they weren't so short, I would argue for considering them bridgeheads. Let me know what you think.

Cheers,

M 

[Weijia Cheng]

1. Ok, that's fine.

2. If you're referring to commit 941c9791ab1ca42e7c7b4aa0fc75359037298594, the changes look fine.

3 and 4. I am not exactly sure I understand what you are talking about. There should be no need for roman ordinals in the titles. Each chapter should have an hgroup with "The Nth Chronicle" and a title with the second line. E.g.

<hgroup>
<h2>The <span epub:type="ordinal">First</span> <span epub:type="label">Chronicle</span></h2>
<p epub:type="title">How He Met and Said Farewell to Mine Host of the Dragon and Knight</p>
</hgroup>

The "Preface" should be semanticated as a prologue, as you surmised, but it should not be called chaper-1.xhtml but prologue.xhtml. The current division of your files is an artifact of how you original file with <!--se:split--> and should be revised. se split-file simply looks for all of the <!--se:split--> comments and puts the first chunk in a file called chapter-1.xhtml and then proceeds from there. Ideally, you would have split off the prologue before running se split-file in order to make the chapter files line up with the actual chapters. At this point you will have to renamed chapter-1.xhtml to prologue.xhtml and then rename the subsequent chapter files accordingly.

[Markus Ruczan]

Hi,

After rereading the step-by-step guide, I thought it might be easier to start with a fresh repo. The changes to the text are the same but I reordered them to be more consistent with the guide. I hope that this makes it easier for you or anyone else wanting to check the work. What do you think? 

New repo: https://github.com/marrrkus-se/Don-Rodriguez-v2

Another question: during step 19 (Build the manifest and spine), should I manually change the position of the prologue in src/epub/content.opf and src/epub/toc.xhtml or is there a specific SE way to do it? 'se build-spine/build-toc' put it after the last chapter and before the footnotes.

Regards,

M

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/7631XgE5thg/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/5dd996d0-9788-4ee6-a4a9-68194a41d4d9n%40googlegroups.com.

[Weijia Cheng]

Did you run the semanticate tool on your new repository?

Yes, you manually adjust the spine as you need to in order to get everything into the right order. Then you rerun built-toc.

[Markus Ruczan]

I did. I overlooked that the automated portion needs its own commit. Should I hard reset (to commit eb0c337)?

OK for the spine/toc.

To view this discussion visit https://groups.google.com/d/msgid/standardebooks/29e7b16c-54d8-403e-ad10-ecb63ea1fc75n%40googlegroups.com.

[Markus]

I reset the repo to commit eb0c337 and reapplied the changes with a separate commit for the semanticate step.

I am not at step 21 "Clean and lint." I attached the output of 'se lint .'. I would appreciate guidance on the m-045 errors ("Heading not found in the ToC").

[Weijia Cheng]

Sorry, it seems I missed your previous comment!

For some reason, the table of contents generation algorithm did not include the leading "The" for each heading. You will need to manually edit toc.xhtml to add the "The" to ensure that the ToC headings match the title element of each chapter.

[Vince]

It wasn’t included because it wasn’t in one of the spans. If a header has spans for ordinal and label, then all of the text has to be in one or the other. It’s also why clean isn’t formatting the headers correctly, with each span on a separate line.

[Weijia Cheng]

Is that rule explicitly mentioned anywhere in the manual of style? I recognize that it's our normal pattern, but I don't remember it being written out anywhere. In any case, it might make more sense to include the "the" in the ordinal span.

[Lukas Bystricky]

This seems like it might be at least tangentially related to the issue in build-toc that was reported last week. 

[Markus Ruczan]

Fixed the ToC manually.

The remaining lint errors are mainly related to the colophon and metadata (which I assume I should ignore as per se the guide) but there are two on which I would appreciate your guidance:

1) 'm-033 │ Manual Review │ endnotes.xhtml  │ endnotes semantic inflection found, but no MARC relator ann (Annotator).' Is this related to metadata and can be ignored?

2) 't-011 │ Manual Review │ chapter-5.xhtml │ Missing punctuation before closing quotes. | ... | Line 123 │ <p>“<b>Fernandez</b>”</p>'

"Fernandez" here represents a shop sign (Fernandez is the local blacksmith). The surrounding sentences are:

"Over the door was burned on oak in ungainly great letters⁠—

“Fernandez”

“For whom do you seek, señor?” he said"

--
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/7631XgE5thg/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/5a2e528f-013c-4441-8979-dec3945678f5n%40googlegroups.com.

[Weijia Cheng]

1. It is related to metadata. You will need to add the "ann" MARC relator tag to whoever wrote the endnotes.

2. That is a case where you could add an se-lint-ignore.xml file, although you will want to put the sign text into a blockquote and add some centered styling for it.