known issues updated
Gutenberg back end service account
parent
564c9a020e
commit
19181b4511
|
|
@ -1,113 +1,80 @@
|
|||
---
|
||||
layout: default
|
||||
title: Volunteers' FAQ (old) | Project Gutenberg
|
||||
permalink: /attic/volunteers_faq.html
|
||||
title: Volunteers' FAQ | Project Gutenberg
|
||||
permalink: /help/volunteers_faq.html
|
||||
---
|
||||
|
||||
Volunteers' FAQ (old)
|
||||
=====================
|
||||
Volunteers' FAQ
|
||||
===============
|
||||
|
||||
Project Gutenberg welcomes contributions of eBooks from people with the interest, time,
|
||||
and skillset needed to meet our submission standards. Details of the process and the standards
|
||||
are at our copyright clearance site (https://copy.pglaf.org) and upload site (https://upload.pglaf.org).
|
||||
Project Gutenberg welcomes contributions of eBooks from people with
|
||||
the interest, time, and skillset needed to meet our submission
|
||||
standards. Details of the process and the standards are at our
|
||||
copyright clearance site (https://copy.pglaf.org) and upload site
|
||||
(https://upload.pglaf.org).
|
||||
|
||||
Join Distributed Proofreaders, Instead
|
||||
--------------------------------------
|
||||
|
||||
For most people interested in producing eBooks, we recommend starting with Distributed Proofreaders (https://www.pgdp.net).
|
||||
With Distributed Proofreaders, you can get involved with different portions of the production pipeline
|
||||
described below. This is a much easier way to get started, and results in very high quality eBooks.
|
||||
For most people interested in producing eBooks, we recommend starting
|
||||
with Distributed Proofreaders (https://www.pgdp.net). With
|
||||
Distributed Proofreaders, you can get involved with different portions
|
||||
of the production pipeline described below. This is a much easier way
|
||||
to get started, and results in very high quality eBooks.
|
||||
|
||||
If you simply want to suggest a book for digitization, DP has online
|
||||
forums for this, or you can simply send an email (contact information
|
||||
is on the site).
|
||||
|
||||
Distributed Proofreaders maintains canonical guidance on production.
|
||||
See especially:
|
||||
|
||||
* The Post-Processing FAQ --
|
||||
https://www.pgdp.net/wiki/DP_Official_Documentation:PP_and_PPV/Post-Processing_FAQ
|
||||
* Easy Epub -- https://www.pgdp.net/wiki/DP_Official_Documentation:PP_and_PPV/Easy_Epub (It's a guide to how best to handle the HTML that goes through epubmaker to lead to passable epubs/mobis)
|
||||
* HTML Best Practices -- https://www.pgdp.org/~jana/best-practices/ (this was written a while back but DP tries to keep it up-to-date)
|
||||
|
||||
If you simply want to suggest a book for digitization, DP has online forums for this, or you can
|
||||
simply send an email (contact information is on the site).
|
||||
|
||||
Being a Solo Producer
|
||||
---------------------
|
||||
|
||||
If you might be interested in producing an eBook yourself, here is some guidance.
|
||||
|
||||
These steps are for eBooks that are in the public domain in the US, usually because the source
|
||||
printed book was published, and then the term of copyright protection expired. **Project Gutenberg
|
||||
does not accept contemporary or copyrighted works. See our How-To on submitting your own work,
|
||||
for information about our self-publishing portal.**
|
||||
|
||||
Note also that Project Gutenberg does not have a corps of volunteers who can take
|
||||
your partially-completed work and turn it into a completed eBook. Instead, join Distributed
|
||||
Proofreaders to be part of a larger group with many shared roles. But if there is a problem
|
||||
with your ability to complete a digitization process, and you would like to
|
||||
submit partial work for safekeeping for possible future completion, contact us.
|
||||
|
||||
Generally, and as detailed at the upload site, Project Gutenberg eBooks are submitted as
|
||||
fully valid HTML, with accompanying plain text. Two other formats are less frequently utilized:
|
||||
ReStructured text (RST), and LaTeX (which is used mainly for mathematical works). Automated
|
||||
conversion to derivative formats, including the MOBI (Kindle) and EPUB formats, occurs
|
||||
on the Project Gutenberg website back-end.
|
||||
If you might be interested in producing an eBook yourself, without involving
|
||||
Distributed Proofreaders, here is some guidance. But start with what's above,
|
||||
including the DP links.
|
||||
|
||||
In a nutshell, the production process typically involves the following:
|
||||
- Identify a candidate printed book. Confirm it is not already in the collection,
|
||||
or in process by other volunteers.
|
||||
- Obtain a copyright clearance for the printed book. Usually this is based on
|
||||
scanned title page and verso page demonstrating the printed book was published
|
||||
more than 95 years ago.
|
||||
- Obtain scans of the book. This may be done using your own scanner, or there
|
||||
might be online scans from one of the eBook projects. Scans must come from the
|
||||
exact same print edition as your copyright clearance.
|
||||
- Perform optical character recognition (OCR) on the scans, to make an approximate
|
||||
representation of the book in plain text.
|
||||
- Proofread, proofread, proofread: "Fix" the OCR output by carefully fixing any
|
||||
errors it made. Remove page headers & footers. De-hyphenate. Add back italics or
|
||||
other formatting.
|
||||
- Format: Generate the HTML source. Different tools are available for this, and
|
||||
usually involve editing the HTML source code directly. Note that many tools produce
|
||||
convoluted, non-standard, or non-valid HTML, which can be very difficult to clean
|
||||
up for Project Gutenberg.
|
||||
- Check, and recheck. The upload site has various tools, including to test proper
|
||||
conversion to derived formats.
|
||||
- Upload your work, using the copyright clearance key generated earlier.
|
||||
- Coordinate with the Project Gutenberg production volunteers (known as "whitewashers,"
|
||||
after the Mark Twain book) on final formatting and presentation.
|
||||
- Once the eBook is added to the Project Gutenberg collection, confirm it is
|
||||
appearing correctly, and all metadata are correct.
|
||||
- If possible, stay in touch into the future. If we receive errata reports that
|
||||
require access to source material, or are stylistic or subjective in nature, we
|
||||
might get in touch to discuss potential changes.
|
||||
|
||||
More about HTML
|
||||
---------------
|
||||
|
||||
Project Gutenberg is not in the business of teaching HTML,
|
||||
however nearly all Project Gutenberg's editions now have
|
||||
both text and HTML files. The HTML files are not only
|
||||
important in themselves but are the master files for the
|
||||
auto-production of each eBook's mobile viewer files: .mobi
|
||||
and .epub. Almost one third of Project Gutenberg eBooks are
|
||||
now read these eBook formats.
|
||||
|
||||
A good starting point is to look at the HTML of a similar eBook from
|
||||
the Project Gutenberg collection - or peruse a few. See how the simplicity
|
||||
of structural markup is presented, perhaps by inclusion of cascading style
|
||||
sheets (CSS), into a beautiful and functional ebook.
|
||||
|
||||
It is fascinating to learn how to produce valid HTML files and
|
||||
there are many programs to help: https://www.w3schools.com/html/html_editors.asp
|
||||
is one of many sources.
|
||||
|
||||
In Project Gutenberg HTML eBooks, you can see the HTML code in many
|
||||
different tools, including Notepad, NoteTab or word
|
||||
processors. The headings and footers of all our eBooks are
|
||||
very similar. The body of the file has text with various
|
||||
HTML tags such as
|
||||
<p>....</p>, <pre>....</pre>, <h2>....</h2>
|
||||
to make the html display give the text
|
||||
enclosed between these html tags apppear differently.
|
||||
|
||||
If you start with plain text, there are two very helpful programs that producers utilize: "guiguts"
|
||||
at https://sourceforge.net/projects/guiguts/available
|
||||
and "pg2html.exe," an early DP program. These are valuable in the
|
||||
first steps of producing an html file from a properly
|
||||
formatted text file.
|
||||
|
||||
Try to turn a very simple text file into an HTML ebook
|
||||
and you are started on your way to more complex files with
|
||||
the aid of the instructions in the references in
|
||||
https://www.w3schools.com/html/html_editors.asp.
|
||||
- Identify a candidate printed book. Confirm it is not already in the
|
||||
collection, or in process by other volunteers. Use the [Collection
|
||||
Development Policy](/policy/collection_development.html) to guide
|
||||
you on eligibility.
|
||||
- Obtain a copyright clearance for the printed book. Usually this is
|
||||
based on scanned title page and verso page demonstrating the printed
|
||||
book was published more than 95 years ago. See the [Copyright
|
||||
How-To](/help/copyright.html).
|
||||
- Obtain scans of the book. This may be done using your own scanner,
|
||||
or there might be online scans available for reuse. Scans
|
||||
must come from the exact same print edition as your copyright
|
||||
clearance.
|
||||
- Perform optical character recognition (OCR) on the scans, to make an
|
||||
approximate representation of the book in plain text.
|
||||
- Proofread, proofread, proofread: "Fix" the OCR output by carefully
|
||||
fixing any errors it made. Remove page headers &
|
||||
footers. De-hyphenate. Add back italics or other formatting.
|
||||
- Format: Generate valid and well-formed HTML source. Different tools
|
||||
are available for this, and usually involve editing the HTML source
|
||||
code directly. Note that many tools produce convoluted, non-standard,
|
||||
or non-valid HTML, which can be very difficult to clean up for Project
|
||||
Gutenberg: poor HTML is not accepted, even if it is valid.
|
||||
- Check, and recheck. The upload site has various tools, including to
|
||||
test proper conversion to derived formats.
|
||||
- Upload your work, using the copyright clearance key generated
|
||||
earlier.
|
||||
- Coordinate with the Project Gutenberg production volunteers (known
|
||||
as "whitewashers," after the Mark Twain book) on final formatting and
|
||||
presentation.
|
||||
- Once the eBook is added to the Project Gutenberg collection, confirm
|
||||
it is appearing correctly, and all metadata are correct.
|
||||
- If possible, stay in touch into the future. If we receive errata
|
||||
reports that require access to source material, or are stylistic or
|
||||
subjective in nature, we might get in touch to discuss potential
|
||||
changes.
|
||||
|
|
|
|||
|
|
@ -37,6 +37,8 @@ Here are pages that give background about Project Gutenberg, including how new i
|
|||
<h2>T</h2>
|
||||
<li><a href="/help/mobile.html">Tablets, Phones and eReaders How-To</a></li>
|
||||
<li><a href="/policy/license.html">Trademark License</a></li>
|
||||
<h2>V</h2>
|
||||
<li><a href="/help/volunteers_faq.html">Volunteers' FAQ</a></li>
|
||||
<h2>W</h2>
|
||||
<li><a href="/help/new_website.html">Website redesign 2020</a></li>
|
||||
</ul>
|
||||
|
|
|
|||
|
|
@ -23,21 +23,13 @@ THANK YOU for your patience as we continue to update the website to fix remainin
|
|||
### Functionality issues
|
||||
1. Roboting not working properly. URLs such as http://www.gutenberg.org/robot/harvest?filetypes[]=txt sometimes work, and sometimes generate a 500 server error. This might be a missing package on one of the back end servers. Status: Checking with sysadmins.
|
||||
2. "Authors" match in search yields 404. For example, from this page: https://www.gutenberg.org/ebooks/search/?query=a.roosevelt&submit_search=Go%21 the "Authors" link (top left) should list all Roosevelts, but instead give a 404 at https://www.gutenberg.org/ebooks/authors/search/?query=a.roosevelt . Status: This is a template error in autocat3, being investigated.
|
||||
3. "Titles" have the same issue as #4. Same status.
|
||||
4. Bookshelf editing is not currently available. Bookshelves only have older entries. Most bookshelves had not been updated recently anyway, and we hope to add bookshelf editing capabilities soon. Status: Under development.
|
||||
3. "Titles" have the same issue as above. Same status.
|
||||
|
||||
### Content issues
|
||||
1. Revise the Volunteer's FAQ (currently in "the attic" since it was outdated). **Status: The Whitewashers team is looking into this.**
|
||||
2. Add these links to the DP HTML documentation, to the Volunteer's FAQ. **Status: awaiting the Volunteer's FAQ mentioned just above.**
|
||||
The Post-Processing FAQ --
|
||||
https://www.pgdp.net/wiki/DP_Official_Documentation:PP_and_PPV/Post-Processing_FAQ
|
||||
Easy Epub -- https://www.pgdp.net/wiki/DP_Official_Documentation:PP_and_PPV/Easy_Epub (It's a guide to how best to handle the HTML that goes through epubmaker to lead to passable epubs/mobis)
|
||||
HTML Best Practices -- https://www.pgdp.org/~jana/best-practices/ (this was written a while back but DP tries to keep it up-to-date)
|
||||
1. Bookshelf editing is not currently available. Bookshelves only have older entries. Most bookshelves had not been updated recently anyway, and we hope to add bookshelf editing capabilities soon. Status: Under development.
|
||||
|
||||
### User interface and user experience issues
|
||||
1. Selecting text is challenging on landing pages. For example, on this page: https://www.gutenberg.org/ebooks/13930 it is hard to select the title text ("African and European Addresses by Theodore Roosevelt") to copy-and-paste. Instead, the book image and "Download this eBook" are selected. Status: not yet determined.
|
||||
2. At https://www.gutenberg.org/, the 'box of latest books' contains 10 books, but only shows 9, so I get a scroll bar. When I scroll to reveal the 10th book, the covers all shift left, but the titles below don't move. (And in fact, the 10th title is hanging off the right edge of the box.) Status: CSS issue, same as #2 under "Functionality issues."
|
||||
|
||||
1. At https://www.gutenberg.org/, the 'box of latest books' contains 10 books, but only shows 9, so I get a scroll bar. When I scroll to reveal the 10th book, the covers all shift left, but the titles below don't move. (And in fact, the 10th title is hanging off the right edge of the box.) Status: CSS issue, same as #2 under "Functionality issues."
|
||||
|
||||
### Search-related issues
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue