Re: Article ready for a once over

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Tue, May 19, 2020 at 1:34 AM John Paul Wohlschied
<wohlschied@xxxxxxxxx> wrote:
>
> I just finished writing the article about how to create epub files:
> https://fedoramagazine.org/?p=31075&preview=true&preview_id=31075. Please
> take a look and give me your thought. Tried to follow the rules as best I
> could.
>
This is a great start. I've made a few small edits:

* Remove first-person references per our style recommendations
* Minor edits for active voice and other grammatical tweaks (e.g.
s/(you|we) need to//g)
* Be consistent in the casing of "Calibre"

More substantively:
* You say "Once you open your ebook file, you may notice that it has
UNTITLED above the table of contacts. I'm not sure how to remove it.
That what I mean when I said that this method was quick and dirty." If
possible, it would be good to do a little more research and see if you
can figure it out. This will help your credibility with the reader. It
looks like this might be the answer:
https://pandoc.org/MANUAL.html#extension-pandoc_title_block (and if
so, then the title should not be an H1)
* In the Calibre section, you say "Next, export your document as an
HTML file." How? Where does this file get created? You have the reader
launch Calibre, but there's no indication of where the file is edited
or how they export it. Is it in ghostwriter still?
* You may want to explain the advantages of generating an epub over
using a PDF file, particularly since PDF is generally simpler to
produce.

I'm moving the card back to "In Progress". I'm happy to discuss this
more on-list or in the IRC channel. If you have any questions or
anything is unclear, please let me know!

-- 
Ben Cotton
He / Him / His
Senior Program Manager, Fedora & CentOS Stream
Red Hat
TZ=America/Indiana/Indianapolis
_______________________________________________
Fedora Magazine mailing list -- magazine@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to magazine-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/magazine@xxxxxxxxxxxxxxxxxxxxxxx




[Index of Archives]     [Fedora Users]     [Older Fedora Users]     [Fedora Announce]     [Fedora Package Announce]     [EPEL Devel]     [EPEL Announce]     [Fedora Laptop]     [Fedora Cloud]     [Fedora Advisory Board]     [Fedora Security]     [Fedora Scitech]     [Fedora Robotics]     [Fedora Infrastructure]     [Fedora Websites]     [Anaconda Devel]     [Fedora Devel Java]     [Fedora Desktop]     [Fedora Fonts]     [Fedora Marketing]     [Fedora Mentors]     [Fedora Package Review]     [Fedora PHP Devel]     [Kickstart]     [Fedora Music]     [Fedora Packaging]     [Fedora SELinux]     [ET Management Tools]     [Yum Users]     [Fedora Art]     [Fedora ARM]

  Powered by Linux