Re: [standardebooks] First book - Andre Norton's Storm Over Warlock
142 views
Skip to first unread message
Alex Cabal
Sep 23, 2021, 2:46:57 PM9/23/21
to standar...@googlegroups.com
Great, that one would be a good start.
This looks like a fairly straightforward production. Make sure to cut
the front matter and also the back matter (the blurb, about the author,
etc.)
Please try to find page scans if possible, but you may not be able to
find any for this one. Internet Archive will be your best bet. If you
can't find anything then proceed without scans.
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
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! :)
On 9/22/21 7:11 PM, Brad Barnes wrote:
> I'd love to tackle Andre Norton's "Storm Over Warlock" for my first
> conversion, if no one else has staked it yet.
>
> --
> 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 on the web visit
> https://groups.google.com/d/msgid/standardebooks/747b7168-2c83-4678-8f0d-5368a1f27e1bn%40googlegroups.com
> <https://groups.google.com/d/msgid/standardebooks/747b7168-2c83-4678-8f0d-5368a1f27e1bn%40googlegroups.com?utm_medium=email&utm_source=footer>.
This looks like a fairly straightforward production. Make sure to cut
the front matter and also the back matter (the blurb, about the author,
etc.)
Please try to find page scans if possible, but you may not be able to
find any for this one. Internet Archive will be your best bet. If you
can't find anything then proceed without scans.
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
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! :)
On 9/22/21 7:11 PM, Brad Barnes wrote:
> I'd love to tackle Andre Norton's "Storm Over Warlock" for my first
> conversion, if no one else has staked it yet.
>
> --
> 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 on the web visit
> https://groups.google.com/d/msgid/standardebooks/747b7168-2c83-4678-8f0d-5368a1f27e1bn%40googlegroups.com
> <https://groups.google.com/d/msgid/standardebooks/747b7168-2c83-4678-8f0d-5368a1f27e1bn%40googlegroups.com?utm_medium=email&utm_source=footer>.
Brad Barnes
Sep 24, 2021, 12:58:41 PM9/24/21
to Standard Ebooks
Thanks Alex. I'd tried to delete the post, at least temporarily, as I was having unexpected problems with a Linux install on my Windows PC. But I've worked it out now and added all the S.E. extensions, so I should be able to get cracking soon. Looking forward to pitching in! Cheers.
Brad Barnes
Sep 25, 2021, 8:40:43 AM9/25/21
to Standard Ebooks
Here's the initial commit: https://github.com/barnesstorming/andre-norton_storm-over-warlock/
Two quick questions:
* First, you're right in that I can't find downloadable page scans. But there is a borrowable scan available on the Internet Archive, which I can use to spot-check anything that might come up. Should I source that somehow in the metadata?
* Second, the PG version of the book has a list of errata that they corrected at the end of the file. I was at first inclined to remove this, but I've let it in now, as it explains possible discrepancies from the original source material. ... Was this the right call? Should I leave it there?
Vince
Sep 25, 2021, 1:30:07 PM9/25/21
to Standard Ebooks
As it happens, Alex just said a couple of days ago the “borrowable” scans are OK. They do go in the metadata, like any other scan; see section 9.8 of the manual. (There is already a spot for them in the template metadata that is installed by create-draft.)
You do not need to keep the errata section; the changes the errata made should (usually) be kept; this is a judgment call, but PG’s judgment is almost always correct.
To unsubscribe from this group and stop receiving emails from it, send an email to standardebook...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/standardebooks/29bf1393-4a22-44e0-976f-9c0ae228d632n%40googlegroups.com.
Brad Barnes
Apr 17, 2022, 8:11:57 AM4/17/22
to Standard Ebooks
Hey all. I've been jammed up on the final LINT of this book for some time -- only to scour the forums and realize that some of these errors are probably tied to the fact that I updated my SE tools in the middle of creating the ebook. (Which I now realize was a big mistake. I did so when I was struggling with getting one of the tools to work and was desperate for a solution. Alas.)
Can anyone tell me how to identify which, if any, of these are true code errors. And for the ones that are related to upgrading the toolset, what can I do about them at this point? The list:
m-037 | imprint.xhtml | Transcription/page scan source link not found. Expected:: the <a href="https://archive.org/details/stormoverwarlock0000nort/">Internet Archive</a>.
c-006
| local.css | Semantic found, but missing corresponding style in
local.css. | → | <blockquote epub:type="z3998:poem">
s-004 | titlepage.xhtml | img element missing alt attribute. | →| <img alt="" src="../images/titlepage.svg" epub:type="se:image.color-depth.black-on-transparent">
s-021 │ titlepage.xhtml│Unexpected value for <title> element. Expected: Storm Over Warlock. (Beware hidden Unicode characters!)
s-085
│ titlepage.xhtml│<h#> element found in a <section>
or a <article> at an unexpected level. Hint: Headings not in
the half title page│start at <h2>. If this work has parts,
should this header be <h3> or higher? |→ | <h1
epub:type="title">Storm Over Warlock</h1>
f-006 | uncopyright.xhtml│File does not match│ /home/bradleyb/.local/pipx/venvs/standardebooks/lib/python3.8/site-packages/se/data/templates/uncopyright.xhtml.
Any insight is much appreciated.
Vince
Apr 17, 2022, 12:32:08 PM4/17/22
to Standard Ebooks
The easiest way to handle that is to do a new create-draft into a different (temporary) directory, then copying the appropriate files, in this case uncopyright and titlepage.
Your first two errors are unrelated, they’re actual errors, and the descriptions indicate what the problem is and how to correct it.
Alex Cabal
Apr 17, 2022, 1:53:45 PM4/17/22
to standar...@googlegroups.com
To elaborate a little more on c-006, you have a poem in your book
somewhere but you didn't include the poetry CSS listed in the manual.
Once you include the right CSS that error will go away.
On 4/17/22 11:32 AM, Vince wrote:
> The easiest way to handle that is to do a new create-draft into a
> different (temporary) directory, then copying the appropriate files, in
> this case uncopyright and titlepage.
>
> Your first two errors are unrelated, they’re actual errors, and the
> descriptions indicate what the problem is and how to correct it.
>
>
>> On Apr 17, 2022, at 7:11 AM, Brad Barnes <barness...@gmail.com
>> <https://archive.org/details/stormoverwarlock0000nort>/">Internet
>> Archive</a>. /
>>
>> //
>>
>> /*c-006*| local.css | Semantic found, but missing corresponding style
>>
>> /*s-004*| titlepage.xhtml | img element missing alt attribute. | →|
>> <img alt="" src="../images/titlepage.svg"
>> epub:type="se:image.color-depth.black-on-transparent">/
>>
>> //
>>
>> /*s-021 *│ titlepage.xhtml│Unexpected value for <title> element.
>> Expected: Storm Over Warlock. (Beware hidden Unicode characters!)/
>>
>> //
>>
>> /*s-085*│ titlepage.xhtml│<h#> element found in a <section> or a
>> */
>>
>> /*f-006*| uncopyright.xhtml│File does not match│
>> /home/bradleyb/.local/pipx/venvs/standardebooks/lib/python3.8/site-packages/se/data/templates/uncopyright.xhtml./
> <https://groups.google.com/d/msgid/standardebooks/DE992881-1A27-4995-BAB2-9E00FAC9E0C4%40letterboxes.org?utm_medium=email&utm_source=footer>.
somewhere but you didn't include the poetry CSS listed in the manual.
Once you include the right CSS that error will go away.
On 4/17/22 11:32 AM, Vince wrote:
> The easiest way to handle that is to do a new create-draft into a
> different (temporary) directory, then copying the appropriate files, in
> this case uncopyright and titlepage.
>
> Your first two errors are unrelated, they’re actual errors, and the
> descriptions indicate what the problem is and how to correct it.
>
>
>> On Apr 17, 2022, at 7:11 AM, Brad Barnes <barness...@gmail.com
>> <mailto:barness...@gmail.com>> wrote:
>>
>> Hey all. I've been jammed up on the final LINT of this book for some
>> time -- only to scour the forums and realize that some of these errors
>> are probably tied to the fact that I updated my SE tools in the middle
>> of creating the ebook. (Which I now realize was a big mistake. I did
>> so when I was struggling with getting one of the tools to work and was
>> desperate for a solution. Alas.)
>>
>> Can anyone tell me how to identify which, if any, of these are true
>> code errors. And for the ones that are related to upgrading the
>> toolset, what can I do about them at this point? The list:
>>
>> /*m-037 *| imprint.xhtml | Transcription/page scan source link not
>>
>> Hey all. I've been jammed up on the final LINT of this book for some
>> time -- only to scour the forums and realize that some of these errors
>> are probably tied to the fact that I updated my SE tools in the middle
>> of creating the ebook. (Which I now realize was a big mistake. I did
>> so when I was struggling with getting one of the tools to work and was
>> desperate for a solution. Alas.)
>>
>> Can anyone tell me how to identify which, if any, of these are true
>> code errors. And for the ones that are related to upgrading the
>> toolset, what can I do about them at this point? The list:
>>
>> <https://archive.org/details/stormoverwarlock0000nort>/">Internet
>> Archive</a>. /
>>
>> //
>>
>> /*c-006*| local.css | Semantic found, but missing corresponding style
>> in local.css. | → | <blockquote epub:type="z3998:poem">
>> /
>>
>> /*s-004*| titlepage.xhtml | img element missing alt attribute. | →|
>> <img alt="" src="../images/titlepage.svg"
>> epub:type="se:image.color-depth.black-on-transparent">/
>>
>> //
>>
>> /*s-021 *│ titlepage.xhtml│Unexpected value for <title> element.
>> Expected: Storm Over Warlock. (Beware hidden Unicode characters!)/
>>
>> //
>>
>> /*s-085*│ titlepage.xhtml│<h#> element found in a <section> or a
>> <article> at an unexpected level. Hint: Headings not in the half title
>> page│start at <h2>. If this work has parts, should this header be <h3>
>> or higher? |→ | <h1 epub:type="title">Storm Over Warlock</h1> *
>> page│start at <h2>. If this work has parts, should this header be <h3>
>> */
>>
>> /*f-006*| uncopyright.xhtml│File does not match│
>> /home/bradleyb/.local/pipx/venvs/standardebooks/lib/python3.8/site-packages/se/data/templates/uncopyright.xhtml./
>>
>> Any insight is much appreciated.
>
>> Any insight is much appreciated.
>
> --
> 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 on the web visit
> https://groups.google.com/d/msgid/standardebooks/DE992881-1A27-4995-BAB2-9E00FAC9E0C4%40letterboxes.org
> 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 on the web visit
> <https://groups.google.com/d/msgid/standardebooks/DE992881-1A27-4995-BAB2-9E00FAC9E0C4%40letterboxes.org?utm_medium=email&utm_source=footer>.
Brad Barnes
Apr 18, 2022, 2:53:12 PM4/18/22
to Standard Ebooks
RE poetry, I should probably clarify that tagging the section as poetry is appropriate. The context is, the protagonist is remembering/hearing bits of a chant. It's in fragments. Here's the pertinent section:
Then he might have turned some invisible corner in the mist, for the chant broke out anew in stronger volume, and now he was able to distinguish words he knew.
“… where blow the winds between the worlds,
And hang the suns in dark of space.
For Power is given a man to use.
Let him do so well before the last accounting—”
The voice was hoarse, cracked, the words spaced with uneven catches of breath, as if they had been repeated many, many times to provide an anchor against madness, form a tie to reality. And hearing that note, Shann slowed his pace. This was out of no memory of his; he was sure of that.
“… blow the winds between the worlds,
And hang the suns in … dark—of—of—”
The bits in boldface are what I tagged as poetry. But now I'm questioning whether I should have even bothered. Thoughts?
Alex Cabal
Apr 18, 2022, 3:03:05 PM4/18/22
to standar...@googlegroups.com
That looks fine. Just include the boilerplate CSS.
On 4/18/22 1:53 PM, Brad Barnes wrote:
> RE poetry, I should probably clarify that tagging the section as poetry
> is appropriate. The context is, the protagonist is remembering/hearing
> bits of a chant. It's in fragments. Here's the pertinent section:
>
> /Then he might have turned some invisible corner in the mist, for the
>
> */
>
> /The voice was hoarse, cracked, the words spaced with uneven catches of
>
> */
> <https://groups.google.com/d/msgid/standardebooks/DE992881-1A27-4995-BAB2-9E00FAC9E0C4%40letterboxes.org?utm_medium=email&utm_source=footer
> <https://groups.google.com/d/msgid/standardebooks/DE992881-1A27-4995-BAB2-9E00FAC9E0C4%40letterboxes.org?utm_medium=email&utm_source=footer>>.
> <https://groups.google.com/d/msgid/standardebooks/b82016b7-8845-491b-80b4-c9c4dc91331dn%40googlegroups.com?utm_medium=email&utm_source=footer>.
On 4/18/22 1:53 PM, Brad Barnes wrote:
> RE poetry, I should probably clarify that tagging the section as poetry
> is appropriate. The context is, the protagonist is remembering/hearing
> bits of a chant. It's in fragments. Here's the pertinent section:
>
> chant broke out anew in stronger volume, and now he was able to
> distinguish words he knew./
>
> */
>
> “… where blow the winds between the worlds,
> And hang the suns in dark of space.
> For Power is given a man to use.
> Let him do so well before the last accounting—”
>
> /*
> “… where blow the winds between the worlds,
> And hang the suns in dark of space.
> For Power is given a man to use.
> Let him do so well before the last accounting—”
>
>
> /The voice was hoarse, cracked, the words spaced with uneven catches of
> breath, as if they had been repeated many, many times to provide an
> anchor against madness, form a tie to reality. And hearing that note,
> Shann slowed his pace. This was out of no memory of his; he was sure of
> that./
> anchor against madness, form a tie to reality. And hearing that note,
> Shann slowed his pace. This was out of no memory of his; he was sure of
>
> */
>
> “… blow the winds between the worlds,
> And hang the suns in … dark—of—of—”
>
> /*
> “… blow the winds between the worlds,
> And hang the suns in … dark—of—of—”
>
> <https://groups.google.com/d/msgid/standardebooks/DE992881-1A27-4995-BAB2-9E00FAC9E0C4%40letterboxes.org?utm_medium=email&utm_source=footer>>.
>
>
> --
> 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 on the web visit
> https://groups.google.com/d/msgid/standardebooks/b82016b7-8845-491b-80b4-c9c4dc91331dn%40googlegroups.com
>
> --
> 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 on the web visit
> <https://groups.google.com/d/msgid/standardebooks/b82016b7-8845-491b-80b4-c9c4dc91331dn%40googlegroups.com?utm_medium=email&utm_source=footer>.
Brad Barnes
Apr 18, 2022, 4:07:20 PM4/18/22
to Standard Ebooks
Got it and done. I'm down to one error:
m-037 | imprint.xhtml | Transcription/page scan source link not found. Expected:: the <a href="https://archive.org/details/stormoverwarlock0000nort/">Internet Archive</a>.
Nothing I do to the xhtml file seems to fix this -- including removing any reference or link to the Internet Archive version. And it's got nothing to do with the change in toolset, as I've tried it with both old and new versions of the xhtml. ... Is this maybe a result of the book not being directly downloadable? (It's borrowable only on IA.) And if that's the case, how do I resolve it?
Vince
Apr 18, 2022, 4:29:23 PM4/18/22
to Standard Ebooks
From your repository (errors without the context of the source is difficult to debug remotely).
and on digital scans available at the <a href="IA_URL">Internet Archive</a>.</p>
As the error says, you haven’t replaced the IA_URL with the actual link.
Alex Cabal
Apr 18, 2022, 4:30:07 PM4/18/22
to standar...@googlegroups.com
In imprint.xhtml, the link must be exactly as it's stated in the lint
message, and make sure that the text around it says "the Internet
Archive" exactly
On 4/18/22 3:07 PM, Brad Barnes wrote:
> Got it and done. I'm down to one error:
>
> /*m-037 *//| imprint.xhtml | Transcription/page scan source link not
> Archive</a>./
> <https://groups.google.com/d/msgid/standardebooks/b82016b7-8845-491b-80b4-c9c4dc91331dn%40googlegroups.com?utm_medium=email&utm_source=footer
> <https://groups.google.com/d/msgid/standardebooks/b82016b7-8845-491b-80b4-c9c4dc91331dn%40googlegroups.com?utm_medium=email&utm_source=footer>>.
> <https://groups.google.com/d/msgid/standardebooks/2cf47320-2419-4167-860c-2db95327c3f0n%40googlegroups.com?utm_medium=email&utm_source=footer>.
message, and make sure that the text around it says "the Internet
Archive" exactly
On 4/18/22 3:07 PM, Brad Barnes wrote:
> Got it and done. I'm down to one error:
>
> Archive</a>./
> <https://groups.google.com/d/msgid/standardebooks/b82016b7-8845-491b-80b4-c9c4dc91331dn%40googlegroups.com?utm_medium=email&utm_source=footer>>.
>
>
> --
> 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 on the web visit
> https://groups.google.com/d/msgid/standardebooks/2cf47320-2419-4167-860c-2db95327c3f0n%40googlegroups.com
>
> --
> 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 on the web visit
> <https://groups.google.com/d/msgid/standardebooks/2cf47320-2419-4167-860c-2db95327c3f0n%40googlegroups.com?utm_medium=email&utm_source=footer>.
François Grandjean
Apr 18, 2022, 6:09:52 PM4/18/22
to Standard Ebooks
Bit of nitpick: since the poem is in fragments and not whole, it should be semanticated with z3998:verse instead of z3998:poem (SEMOS 7.5.6.1.2).
Vince
Apr 18, 2022, 6:21:38 PM4/18/22
to Standard Ebooks
If it’s in SEMOS it’s not a nitpick. :) Good catch!
Reply all
Reply to author
Forward
0 new messages