Professional Documents
Culture Documents
Ebsco Ebook Content & Delivery - Guidelines in Brief: When To Deliver Files
Ebsco Ebook Content & Delivery - Guidelines in Brief: When To Deliver Files
We prefer that you send content with the corresponding metadata at the same time. You may also send
metadata ahead of content. Please do not send content ahead of metadata.
On-Sale Dates/Embargos
If you specify an on-sale date in your metadata, EBSCO will not allow your eBook to be sold prior to this
date. If your agreement with EBSCO includes embargos on certain models, our systems will not place
your book for sale for those models until the embargo has ended.
Please deliver your books as early as possible so that we can process your content and have it ready to
go up on product as soon as it should be available for sale. If you wait until after the on-sale date or
embargo date, it's possible the content could encounter production problems that delay its placement
on product, and thus delays usage or sales.
How to Deliver
Please deliver your eBooks via EBSCO's FTP. We will supply you with credentials during the licensing and
onboarding process.
File Structure
All files for every title should be delivered together in the same folder. Please do not deliver compressed
folders (.ZIP, .RAR, etc).
For publishers with multiple, contractual imprints, all files should be sorted into folders labeled with the
imprint name.
Example:
Imprint A
o 9781234567891.epub
o 9781234567891.pdf
o 9781234567892.epub
o 9781234567892.pdf
Imprint B
o 9781234567893.epub
o 9781234567893.pdf
o 9781234567894.epub
o 9781234567894.pdf
FTP
EBSCO eBooks' FTP location is: ftp2.netlibrary.com. EBSCO acquired NetLibrary in 2010.
You can connect to it using any FTP client and your credentials.
What to Deliver
Titles
Please deliver, at minimum, all titles that you deliver to other sales platforms, unless your licensing
agreement specifies otherwise.
File Formats
EBSCO accepts two file formats for eBooks:
EPUB
PDF
We prefer for each title to be available in both EPUB and PDF, as this creates the best experience for
users. Therefore, if you have both formats, please supply them. When both formats are delivered,
EBSCO will bundle them into one sellable unit. Please see ONIX metadata documentation on page 8 for
more detail on how this will impact your metadata creation.
We will also accept whichever single format you have available, EPUB or PDF.
Generally, EBSCO accepts PDFs and EPUB files that are created according to standard publishing and
accessibility guidelines.
EBSCO does have some requirements and recommendations that are unique to EBSCO and may not be
required for other sales platforms. We have extensively researched library customer needs and these
additional requirements result in a higher quality user experience.
We have also provided guidance to help prevent common errors that would make files invalid on any
platform.
Accessibility
EBSCO is committed to providing accessible content for our mutual customers, and we recommend
content that is accessible according to WCAG 2.0 guidelines.
For a detailed overview of best practices for creating accessible eBooks, please refer to EBSCO's guide in
the appendix of this document, on page 15.
EPUB Checklist
Please check the following before submitting files.
Run your file through a standard validation engine and ensure you correct any of the following errors
Nested A Element errors: links cannot be buried inside other links
Referenced Resource errors: code contains references to objects the validator can't locate
CSS Parsing errors
Cover Display errors: should resize to fit eReader
Invalid .ncx IDs
EPUB Page Numbers
epub:type="pagebreak”
title="page#"
For more detail on how to use pagebreaks please refer to IDPF documentation.
Backwards Compatibility
For more information on industry standard recommendations to make backwards compatible files,
please refer to IDPF's guide: http://www.idpf.org/epub/30/spec/epub30-changes.html
PDF Checklist
Text must be embedded and available for search and copy and paste. If all or part of your PDF
was created from hardcopy scans, you must capture the text using an OCR program.
All fonts should be embedded as complete sets.
o Use supported fonts: Supported fonts include Western Latin 1252, Unicode 8 character
entities, and the Standard Base 14 fonts. Do not use custom fonts.
o Fonts must use standard encoding. Custom encoding will not allow for text to be
searched.
Cover image should be the first page of the PDF.
Files must be free of encryption, password protection, or any security features applied in Adobe
Acrobat
Digital Pagination must match content pagination
o Non-standard page numbering, such as chapter 1 page 2 being represented as "1.2,"
must match for optimal user experience.
o Every page must be labeled, and every label must be unique. Multi-volume books
should include a volume number followed by a hyphen and then a page number so that
there are not multiple page 1s, etc.
o Use a hyphen in pagination, if needed. Do not use em or en dashes in pagination.
o Blank pages may be labeled "Blank-1" etc if they are not included in the pagination of
the original book. Do not remove blank pages which ARE part of the book's pagination.
Include at least 1 bookmark, although more are preferable
o We strongly recommend bookmarks for front matter pages and each section or chapter.
o Bookmarks must match the content of the original book's table of contents, including
special characters.
o Some non-English language books position their table of contents at the end of the
book. This positioning should be retained in the bookmarks.
The electronic table of contents (eTOC) should mirror the original book's table of contents,
match any parent-child hierarchies, and not exceed three nested levels deep.
Pages must be cropped and free of registration and/or printer marks. We recommend cropping
pages uniformly through the document, with text on both even and odd pages centered on the
page.
Cropping should be relatively tight, compared to a printed page, so that the text is as large as
possible within the page image box in EBSCO's Online PDF Reader, but not so tight that it
becomes unsightly or endangers the text. One half of an inch / 1.25 cm is suggested.
Any full-page landscape pages (such as maps and graphs) must be rotated horizontally for left to
right reading.
File sizes: all files must be optimized for the web to be as small as possible. Best practice for
individual pages is to have a file size that is smaller than 200 KB.
Metadata
Metadata must be submitted for every eBook. We accept metadata formats:
File Naming
Please label each content file with the electronic ISBN. Do not include any additional text, such as the
title of the book.
Example
9781234567890.epub
9781234567890.pdf
Example
9781234567890_replacement.epub
9781234567890_replacement.pdf
Example
PublisherName_delta_yyyymmdd.xml
Revised content file: send the updated file to the FTP as usual, using the replacement file
naming structure on page 6.
Revised metadata: examples include changing the price or you'd like to remove a title from sale.
Please refer to the metadata guidelines on page 8.
If you would like a more thorough overview of best practices, we recommend downloading Book
Industry Study Group and BookNet Canada’s free resource, “Best Practices for Product Metadata: Guide
for North American Data Senders and Receivers (June 1, 2015).”
The guidelines in this document highlight some commonly misused elements of the standard as well as
guidelines that are required for EBSCO delivery but may only be recommendations or options in the
standard.
For more detail on any of these requirements, please refer to EDItEUR’s ONIX Books Product 2.1
Revision 03.
File Preparation
We prefer for all titles in the feed to be packaged in a single .XML file rather than multiple single-title
.XML files.
All the records in an ONIX file will be processed under the same contract. Therefore, titles from different
publishers or imprints with distinct agreements and royalty reports should be submitted in unique ONIX
files.
Order
It is important for your ONIX code to follow the correct order. Your ONIX file must adhere to the schema
outlined by EDItEUR for ONIX 2.1.
Please see List 32, “06”: “The Lexile measure in <ComplexityCode> combines the Lexile number (for
example 620L or 880L) and optionally the Lexile code (for example AD or HL). Examples might be ‘880L’,
‘AD0L’ or ‘HL600L’.”
Note: In earlier versions of ONIX the Lexile code/measure was listed in the Audience composite,
however this usage is deprecated and will not be captured in EBSCO’s ingestion of your ONIX feed.
Active Codes
00: Unspecified
02: Forthcoming
04: Active
09: Unknown
Inactive Codes
01: Cancelled
03: Postponed indefinitely
05: No longer our product
06: Out of stock indefinitely
07: Out of print
08: Inactive
10: Remaindered
11: Withdrawn from sale
12: Recalled (deprecated code)
15: Recalled
16: Temporarily withdrawn from sale
17: Permanently withdrawn from sale
If you would like to define both includes and excludes, you must give a full accounting of all
countries/territories: the whole world must be represented.
PR.21.1
Reference name: <SalesRightsType>
Short tag: <b089>
Accepted value range: 01–06
PR.21.2
Reference name: <RightsCountry>
Short tag: <b090>
Example: US CA AU
PR.21.3
Reference name: <RightsTerritory>
Short tag: <b388>
Example: WORLD or ROW
13 or 06.
PR.23.7
Reference Name: <RelationCode>
Short code: <h208>
Required values: 13 or 06
<SupplierName> and <ProductAvailability> fields are required. We strongly suggest using the
<OnSaleDate> field, particularly if embargos apply.
First, if you do not already have it, download the FileZilla FTP client for free from https://FileZilla-
project.org. FileZilla is a popular FTP client that works on all computer platforms.
Then enter your unique Username and Password that was provided to you by your eBook Publisher
Content Management Specialist.
If you are in need of an FTP account, or if you have any trouble logging in, please email the eBook PCM
team at [email protected].
Once you are connected, you will see your local files on the left side and the FTP server files (or empty
folder, if nothing has been uploaded yet) on the right. In the box containing your local file directory,
highlighted in green below, navigate to (double click on) the folder where your content files are located.
When you select a folder within the local site (highlighted in green) the files within that local folder will
display in the lower left box (highlighted in blue). In this example, the desktop folder named “20141001”
is highlighted and the blue highlighted box shows all the files within “20141001.”
Select all the files you wish to transfer (hold Ctrl and click the files you need, or to select all files in the
folder, hold Ctrl + a) and then drag the selected files across to the lower right quadrant, which will copy
them onto the FTP server.
Note:
Content file naming conventions – all files should be named by eISBN.
More information about file naming conventions on page 6.
More information about recommended folder structure on page 2.
Our FTP system for eBooks mirrors content every hour to our production platform for
processing. So don’t worry if you see files quickly “disappear” from your FTP view.
Helpful Tips:
One of the reasons that FileZilla is a great FTP solution is because it helps you to manage and
store your FTP accounts and password info.
To save your login information for future use, go to “File – Copy Current Connection to Site
Manager”. The below pop-up window will appear.
In general, efficient navigation is difficult for visually impaired users if the document is in plain text and
not tagged. Tagging appropriately conveys a document’s structure and semantics back to users so that
they can navigate and consult the resource. Additionally, EPUB affords much greater accessibility for
users, so EBSCO encourages all publishers to send titles in EPUB format whenever possible.
It is important that in both PDF and EPUB, images have alternative text, figures have accessible captions
and tables have proper semantic table markup. There are two critical use cases to keep in mind when
developing alternative text and captions for images and figures.
First, it is important that blind users know that there is an image or figure in the content they are using
and what that image or figure shows or conveys. The screen reader should say, “Following is an image of
___.” If there is no alternative text, a blind user would not know there was any additional content.
Secondly, EPUB allows images and figures to be searchable when a user performs a search within the
content. If the alternative text is appropriate, any relevant images should appear in the user’s search
results. Tables can be a particular challenge for accessibility. Rows and columns must be associated with
relevant headers to provide context for data. In general, simpler tables are more accessible.
Below are more detailed guidelines for creating accessible and usable content for our shared users.
PDF Content
Use semantic tags to convey the document structure clearly. In particular, use tags for headings,
paragraphs, lists and tables. Semantic elements such as <p> and <h1>…<h6> can be used to
convey the document structure to screen reader users. For more information, see WCAG 1.3.1 A
and the following pages for more information:
https://helpx.adobe.com/acrobat/using/editing-document-structure-content-
tags.html#standard_pdf_tags
https://www.w3.org/TR/UNDERSTANDING-WCAG20/content-structure-separation-
programmatic.html
PDF6: Using table elements for table markup in PDF Documents
PDF9: Providing headings by marking content with heading tags in PDF documents
PDF17: Specifying consistent page numbering for PDF documents
PDF21: Using List tags for lists in PDF documents
Avoid over-using non-semantic tags, or tags that do not convey structural information and are
used as generic groupings, such as <div> and <span>.
Avoid breaking up individual words and sentences with tags.
Use consistent page numbering throughout the document. Other notes:
PDF17: Specifying consistent page numbering for PDF documents
Other information about EPUB accessibility can be found on the IDPF site: https://idpf.github.io/a11y-
guidelines/
EPUB Pagination
It is critical to have stable pagination (that corresponds to the print and/or PDF version of the work) in
order for researchers to generate proper citations. EBSCO has built support of EPUB pagination into the
EBSCO eBook viewer, so that the EPUB format can be used and cited by all users. Please ensure your
EPUB files have pagination according to the IDPF https://idpf.github.io/a11y-
guidelines/content/xhtml/pagenum.html
Information such as page number should be conveyed consistently via HTML so that it is
accessible to screen readers.
Add visually hidden text such as "Page" so when the screen reader user gets to the "3" they will
hear "Page 3". See 1194.22 d and 1.3.1 A for more information
https://section508.gov/content/quick-reference-guide#1194.22d
Tag end-of-chapter references and the reference pages with IDs and use anchors to link
between the two so that the user can return to the referencing page and continue reading
Tag all references to Chapters or Section headings
Provide complete navigation by always using the structural semantics vocabulary governed by
the IDPF http://www.idpf.org/epub/vocab/structure/
Follow guidelines for ARIA landmarks
http://www.w3.org/WAI/GL/wiki/Using_ARIA_landmarks_to_identify_regions_of_a_page