EPUB From the Ground Up: A Hands-On Guide to EPUB 2 and EPUB 3 Instruction Manual

1. Introducció

This guide provides comprehensive instructions for developing electronic publications using the EPUB standard. It covers both EPUB 2 and EPUB 3 specifications, detailing the use of fundamental web technologies such as HTML, XHTML, XML, CSS, and JavaScript for e-book creation. The manual is designed for users with no prior experience in markup languages or programming, offering a step-by-step approach to creating, formatting, and distributing EPUB files.

Figure 1.1: Cover of the "EPUB From the Ground Up" guide. This image displays the book's title and a graphic representing digital content creation.

2. Setup: Preparing Your Environment for EPUB Creation

Before commencing EPUB development, it is essential to set up the appropriate software and understand the foundational technologies. This section outlines the necessary tools and basic concepts.

2.1 Required Software

• EPUB Editor: Software like Sigil is recommended for creating and editing EPUB files.
• E-book Management: Calibre is a versatile tool for managing e-book libraries, converting formats, and viewing EPUBs.
• Editor de textos: A plain text editor (e.g., Notepad++, VS Code) for direct manipulation of HTML, CSS, and XML files.

2.2 Foundational Knowledge

Familiarity with the following web technologies is beneficial, though the guide covers them from the ground up:

• HTML/XHTML: For structuring content.
• XML: For defining data structures, particularly for EPUB metadata.
• CSS: For styling the visual presentation of the e-book.
• JavaScript: For adding interactivity, especially with EPUB 3.

3. Operating Principles: Creating Your EPUB File

This section details the core steps involved in constructing an EPUB file, from initial setup to incorporating advanced features.

3.1 Structuring Content with HTML/XHTML

EPUB files are essentially ZIP archives containing web content. The primary content is structured using HTML or XHTML. Each chapter or section of your e-book typically corresponds to a separate HTML file.

• Use standard HTML tags (<p>, <h1>-<h6>, <ul>, <ol>, <img>) to organize text, headings, lists, and images.
• Ensure all HTML is well-formed and valid to prevent rendering issues on e-readers.

3.2 Styling with CSS

Cascading Style Sheets (CSS) control the visual appearance of your EPUB. This includes fonts, colors, spacing, and layout.

• Define styles in external CSS files linked to your HTML documents.
• Specify font families, sizes, and colors.
• Manage margins, padding, and text alignment for optimal readability.
• Add images and ensure they are properly sized and positioned.

3.3 Navigation and Metadata (NCX and OPF)

The Navigation Center eXtended (NCX) file defines the hierarchical table of contents, allowing users to navigate through the e-book. The Open Packaging Format (OPF) file acts as the manifest for the entire EPUB, listing all components and metadata.

• NCX: Create a logical structure for your e-book's table of contents.
• OPF: Declare all content files (HTML, CSS, images), define the reading order, and include metadata such as title, author, and publisher.

3.4 EPUB 3 Enhancements

EPUB 3 introduces advanced features for richer e-book experiences.

• Multimèdia: Embed audio and video files using standard HTML5 media tags.
• Interactivitat: Utilize JavaScript to create dynamic and interactive elements.
• MathML: Support for mathematical equations.
• SMIL: Synchronized Multimedia Integration Language for synchronized text and audio/video.

4. Maintenance: Ensuring EPUB Quality and Compatibility

Maintaining the quality and compatibility of your EPUB files involves validation, conversion, and understanding digital rights management.

4.1 EPUB Validation

Regularly validate your EPUB files using tools like EPUBCheck to ensure compliance with EPUB specifications. This helps identify and correct errors in structure, metadata, and content.

4.2 Format Conversion

To reach a wider audience, converting your EPUB file to other formats, such as Amazon Kindle's AZW3 or MOBI, is often necessary. Tools like Calibre facilitate these conversions.

• Kindle Conversion: Use Calibre or Amazon's Kindle Create to convert EPUBs for Kindle devices.
• Prova: Always test converted files on target devices or emulators to ensure proper rendering.

4.3 Digital Rights Management (DRM) and Font Obfuscation

DRM systems are used to protect copyrighted e-books from unauthorized distribution. Font obfuscation secures embedded fonts within an EPUB file.

• Understand the implications of applying DRM, as it can affect user experience and device compatibility.
• Implement font obfuscation to protect proprietary fonts used in your e-book.

5. Troubleshooting Common EPUB Issues

This section addresses common problems encountered during EPUB creation and provides solutions.

5.1 Formatting and Layout Problems

• Incorrect Font Display: Verify that fonts are correctly embedded and referenced in CSS. Ensure font obfuscation is properly applied if used.
• Unexpected Layout Shifts: Check CSS for conflicting styles or incorrect box model properties. Test on multiple e-readers as rendering engines vary.
• Problemes de visualització d'imatges: Confirm image paths are correct and images are in supported formats (JPEG, PNG, SVG). Ensure images are appropriately sized for e-readers.

5.2 Navigation and Metadata Errors

• Table of Contents Not Appearing: Review the NCX file for structural errors or incorrect file references. Ensure the NCX is correctly linked in the OPF file.
• Missing Book Information: Check the OPF file for complete and accurate metadata (title, author, publisher, ISBN).

5.3 Validation Failures

• EPUBCheck Errors: Use the detailed error messages from EPUBCheck to pinpoint issues in HTML, CSS, XML, or OPF files. Common errors include unclosed tags, invalid attributes, or missing manifest entries.

6. Especificacions

7. Suport i altres recursos

For specific inquiries regarding the content of this guide, please refer to the publisher's official channels. For technical support related to EPUB standards or software mentioned, consult the respective community forums and documentation.

• Editor: McGraw Hill (www.mheducation.com)
• EPUB Standard: W3C EPUB Community Group
• Sigil Support: Sigil Forum
• Calibre Support: Calibre Help

Note: As this product is a book, a traditional product warranty does not apply.