Title Revisions

When completing file corrections or revisioning a title from a previously distributed title (usually set as active in Firebrand) corrections should be recorded in a text file and saved in the META-INF folder, example:

txt
1
/ META-INF
2
  container.xml
3
  yy-mm-dd_editoral_edits.txt (for title updates or error corrections reported in file)

The following is an example of corrections requested by editorial and within the file the following are required:

• File in which was modified: EK02_chapter03.xhtml
• Line number: Line 123
• What was modified, example: Removed foobar or Replace “foo” with “bar”

example within 20-11-03_amazon-reworks.txt:

bash
1
EK02_chapter02.xhtml
2
Line 12
3
corrected reported spelling error from foo” with “bar”
4

5
EK03_backmatter01.xhtml
6
Line 100
7
corrected reported URL

If you perform a global search with BBEdit and the result appears. Highlight that line, create a new document and paste the result. Use the regex pattern to format the result of the search:

bash
1
## Find:
2
^.*OEBPS/(text/|)(.*)\.xhtml:(\d{1,6}):\s+.*$
3

4
## Replace:
5
\2\.xhtml\rline \3

All revisioned titles for B&H are expected to be updated and meet the current standards outlined in the documentation. This requirement is not a company standard but an industry channel standard because they do not grandfather titles.

If you're unable to find the site for file uploads please reference the Link file. If you're needing clarification or additions to this file please bring it up in Slack. A Github issue is not necessary.

Minor

When uploading to Alfresco, if the ePub was an ePub 3 version (identified in the OPF file), select minor changes in the upload form when updating the ePub and Cover.

Major

If the ePub was an ePub 2 version (identified in the OPF file) select major change for the version when updating the ePub and Cover.

Failure

If the revision fails, the file should be dropped into the directory and the 13-digit-eISBN dash 1 should be renamed to eISBN_revision.epub and the tag revision-reject added to the new file.

Spreadsheet

When a B&H title has been uploaded please update the Epub Distribution spreadsheet under the yyyy revisions tab. On a new line in the spreadsheet you will enter the uploaded date, eISBN, title, developer and notes. The blue color change and distribution date are completed when the title is uploaded for distribution by the curator.