Skip to content
Toolkit step

Step 6: Epub It

Create your base EPUB from the template in the Starter Package you downloaded in Step 4. Getting started with the package Reminder Considering you ...

eKitabu Support·Updated 22 May 2026·16 min read
On this page
 Create your base EPUB from the template in the Starter Package you downloaded in Step 4.

Getting started with the package

  1. Navigate into the Guide Package for Rwanda Toolkit folder. 
  2. Right-click on the Kariza akunda kubaza folder and rename it to match the title of the book want to make accessible. ("Book_X")       
  3. Click into the renamed folder, "Book_X" .
  4. Click again into the "EPUB" folder to have such a view of the files and folders inside the "EPUB" folder .

Owning the Template

1\. Replacing the images 

1.

Navigate into the images folder (.../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/images/) from the EPUB directory to access all the images for the the template.    
  1. Replace the front and back cover images with the respective images of your book to be converted.
  2. Preserve the same names for the front and back covers as cover.jpg and bcover.jpg respectively.
  3. Swap out the images in the /EPUB/images folder with your extracted images for your book maintaining the naming convention of img01, img02, img03....

NOTE:

2\. Replacing the Metadata

The metadata is most basic information about the book. The book's metadata is contained in the content.opf file in .../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/content.opf location.

NOTE: The <metadata></metadata> section of the content.opf file lists information about the publication. 

To replace the metadata details:

  1. Ensure you are in the location .../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/
  2. Look for and open the content.opf file using the editor of you choice.
  3. Find the <metadata></metadata> section
  4. Replace the metadata  values within the appropriate metadata properties of the content.opf file to suit the information about your publication content on the last column.
  1. Save the changes. NOTE : DO NOT close the file in the editor.

Below table is a copy of the table in the Metadata Reference Sheet

Metadata Properties

Description

Current Value(s) For Kariza akunda kubaza

Replace With Your Book’s Metadata Value(s) 

1

dc:title

Title of the publication

Kariza akunda kubaza

2

dc:identifier

Element contains a single identifier associated with the given Rendition of the EPUB Publication, such as a UUID, DOI, ISBN or ISSN.

N/A

3

dc:language

Language used in the publication.

rw

4

dcterms:modified

Date when the content of the publication was last modified.

2019-06-18T15:30:00Z

5

dc:creator

Author credited with the creation of the resource.

Jean de Dieu Bavugempore

6

dc:publisher

The organization credited with publishing the resource.

African Storybook

7

dc:date

Date which the resource was created.

2017

8

dc:rights

You are free to download, copy, translate or adapt this story and use the illustrations as long as you attribute the author, translator, illustrator and publisher of this publication.

9

meta property file-as=" "

Match the dc:creator value

Jean de Dieu Bavugempore

10

dc:source

A related resource from which the described resource is derived.

Title: Kariza akunda kubaza, Publisher: African Storybook, Author: Jean de Dieu Bavugempore, Contributor: Rob Owen, Year: 2017, Africa

11

dc:description

Description may include but is not limited to: an abstract, a table of contents, a graphical representation, or a free-text account of the resource.

Ababyeyi ba Kariza bamutoje kubaza. Gukunda kubaza byatumye Kariza asobanukirwa akamaro ko gukaraba mbere yo kurya,  amenya no gukoresha kandagirukarabe.

Metadata section from an editor:

Book Metadata

XML

<metadata xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:opf="http://www.idpf.org/2007/opf"
 xmlns:dcterms="http://purl.org/dc/terms/" xmlns:dc="http://purl.org/dc/elements/1.1/">
 <!-- Title of the book -->
 <dc:title>Kariza akunda kubaza</dc:title>
 <!-- Creator/Author -->
 <dc:creator id="creator01">Jean de Dieu Bavugempore</dc:creator>
 <meta property="role" refines="#creator01">aut</meta>
 <meta property="file-as" refines="#creator01">Jean de Dieu Bavugempore</meta>
 <meta property="dcterms:modified">2019-06-18T12:39:00Z</meta>
 <!-- Date -->
 <dc:date>2017</dc:date>
 <!-- Publisher of the book-->
 <dc:publisher id="en_publisher" xml:lang="en-us">African Storybook</dc:publisher>
 <!-- Language of the book-->
 <dc:language>rw</dc:language>
 <!-- Identifier -->
 <dc:identifier id="uuid_id">N/A</dc:identifier>
 <meta property="identifier-type" refines="#uuid_id">N/A</meta>
 <!-- Rights -->
 <dc:rights id="en_rights" xml:lang="en">You are free to download, copy, translate or adapt this story and use the illustrations as long as you
 attribute the author, translator, illustrator and publisher of this publication.</dc:rights>
 <!-- Source -->
 <dc:source>Title: Kariza akunda kubaza, Publisher: African Storybook, Author: Jean de Dieu Bavugempore, Contributor: Rob Owen, Year: 2017,Africa</dc:source>
 <!-- Description -->
 <dc:description>Ababyeyi ba Kariza bamutoje kubaza. Gukunda kubaza byatumye Kariza asobanukirwa akamaro ko gukaraba mbere yo kurya,
 amenya no gukoresha kandagirukarabe.</dc:description>
 <meta property="ibooks:specified-fonts">true</meta>
 <meta property="ibooks:version">1.1</meta>
 <!-- Meta for the cover -->
 <meta name="cover" content="cover-image"/>

Accessibility metadata

XML

<!-- ACCESSIBLITY METADATA PROPERTIES -->
 <meta property="schema:accessibilityHazard">none</meta>
 <meta property="schema:accessibilityFeature">alternativeText</meta>
 <meta property="schema:accessibilityFeature">structuralNavigation</meta>
 <meta property="schema:accessibilityFeature">tableOfContents</meta>
 <meta property="schema:accessMode">textual</meta>
 <meta property="schema:accessMode">visual</meta>
 <meta property="schema:accessibilityAPI">ARIA</meta>
 <meta property="schema:accessModeSufficient">textual</meta>
 <meta property="schema:accessModeSufficient">visual</meta>
 <meta property="schema:accessModeSufficient">textual,visual</meta>
 <meta property="schema:accessibilitySummary">This title is a well-marked up and structured book, which is fully accessible. All images have sufficient alt text.</meta>
 </metadata>

3. **Changing the OPF Manifest and Spine**

The Manifest

The manifest is an unordered list of all of the files within the OEBPS/OPS/EPUB directory.  It is contained in the content.opf file in .../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/ .

Each item in the manifest has three components

  1. An item ID, which you can make up, and should describe the file:

    item-id

    CODE
<item id="cover"
  1. A reference to the actual file:

    item-id

    XML
href="cover.xhtml"
  1. The media-type, which tells the parser what type of file it is:

    item-id

    XML
media-type="application/xthml+xml"
  1. Media types can either be:
  • - Fonts.
  • All of the XHTML pages in the book (introduction, copyright, chapters, epigraph, etc.).
  • Images.
  • Audio or video files, if applicable.
  • The (Cascading Style Sheets) CSS file.
  • The NCX file, if you’re working with the ePUB 2.0 format.

To make changes in the Manifest section:

  1. Ensure the content.opf file is still open for editing using the editor of your choice.
  2. Move to the manifest section within the following tags <manifest></manifest>.
  3. Add any necessary media type using the syntax below: 

    item-id

    XML
<item id="cover" href="images/cover.jpg" media-type="image/jpeg"/>
  1. Save the changes to the file. DO NOT close the file in the editor.

Manifest section

XML

<manifest>

 <item id="font01" href="fonts/GillSansMt-Schlbk.ttf" media-type="application/vnd.ms-opentype"/>
 <item id="font02" href="fonts/GillSansMt-SchlbkBold.ttf" media-type="application/vnd.ms-opentype"/>
 <item id="font03" href="fonts/OpenDyslexic3-Regular.ttf" media-type="application/vnd.ms-opentype"/>

 <item id="Cover" href="cover.xhtml" media-type="application/xhtml+xml"/>
 <item id="nav" href="nav.xhtml" media-type="application/xhtml+xml" properties="nav"/>
 <item id="ch01" href="ch01.xhtml" media-type="application/xhtml+xml"/>
 <item id="Bcover" href="bcover.xhtml" media-type="application/xhtml+xml"/>

 <item id="item_image_0" href="images/logowhite.png" media-type="image/png"/>
 <item id="item_image_1" href="images/asblogo.png" media-type="image/png"/>
 <item id="cover-image" href="images/cover.jpeg" media-type="image/jpeg" properties="cover-image"/>
 <item id="image201" href="images/img01.jpg" media-type="image/jpeg"/>
 <item id="image202" href="images/img02.jpg" media-type="image/jpeg"/>
 <item id="image203" href="images/img03.jpg" media-type="image/jpeg"/>
 <item id="image204" href="images/img04.jpg" media-type="image/jpeg"/>
 <item id="image205" href="images/img05.jpg" media-type="image/jpeg"/>
 <item id="image206" href="images/img06.jpg" media-type="image/jpeg"/>
 <item id="image207" href="images/img07.jpg" media-type="image/jpeg"/>
 <item id="image209" href="images/img08.jpg" media-type="image/jpeg"/>
 <item id="image210" href="images/img09.jpg" media-type="image/jpeg"/>
 <item id="image211" href="images/img10.jpg" media-type="image/jpeg"/>
 <item id="image212" href="images/img11.jpg" media-type="image/jpeg"/>
 <item id="image213" href="images/img12.jpg" media-type="image/jpeg"/>

 <item id="css" href="stylesheet.css" media-type="text/css"/>
 <item id="ncx" href="toc.ncx" media-type="application/x-dtbncx+xml"/>

 </manifest>

The Spine

The spine is an ordered list of all of the contents of the book. It uses the item IDs you created in the manifest. Each item gets an item ref, and use the item id that you created in the manifest for the id ref.

Match the item's id in the spine for every item in the manifest section using the editor, save the changes and close the file.

Spine section

XML

<spine toc="ncx">
 <itemref idref="Cover"/>
 <itemref idref="nav"/>
 <itemref idref="ch01"/>
 <itemref idref="Bcover"/>
 </spine>

4\. Chapters

To make changes to the chapter content:

  1. Navigate to .../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/ch01.xhtml 
  2. Open ch01.xhtml file with the editor.
  3.  Rename the chapter title within the <title></title> tags found at the top.
  4. Transcribe the texts into the chapter's <p></p> tags, replacing the content with that available in the book to be made

Adding a chapter

  • Create a new HTML file anywhere, preferably beside the other XHTML files. To avoid basic errors, it’s better to copy one of the existing chapters and modify it as needed.
  • Inside the package file, under the manifest list, add a new item similar to any of the other existing chapters in the list (the order does not matter). Enter the new path of the chapter into the href attribute. The path must be relative to the package file. Also, enter a unique ID to the id property.
  • Under the spine list, add a new item as such: <itemref idref=”YOUR_UNIQUE_ID”/>. Here order does matter. So make sure you’ve placed it before and after the appropriate items.
 Create your base EPUB from the template in the Starter Package you downloaded in Step 4.

Getting started with the package

  1. Navigate into the Guide Package for Rwanda Toolkit folder. 
  2. Right-click on the Kariza akunda kubaza folder and rename it to match the title of the book want to make accessible. ("Book_X")       
  3. Click into the renamed folder, "Book_X" .
  4. Click again into the "EPUB" folder to have such a view of the files and folders inside the "EPUB" folder .

Owning the Template

1\. Replacing the images 

1.

Navigate into the images folder (.../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/images/) from the EPUB directory to access all the images for the the template.    
  1. Replace the front and back cover images with the respective images of your book to be converted.
  2. Preserve the same names for the front and back covers as cover.jpg and bcover.jpg respectively.
  3. Swap out the images in the /EPUB/images folder with your extracted images for your book maintaining the naming convention of img01, img02, img03....

NOTE:

2\. Replacing the Metadata

The metadata is most basic information about the book. The book's metadata is contained in the content.opf file in .../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/content.opf location.

NOTE: The <metadata></metadata> section of the content.opf file lists information about the publication. 

To replace the metadata details:

  1. Ensure you are in the location .../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/
  2. Look for and open the content.opf file using the editor of you choice.
  3. Find the <metadata></metadata> section
  4. Replace the metadata  values within the appropriate metadata properties of the content.opf file to suit the information about your publication content on the last column.
  1. Save the changes. NOTE : DO NOT close the file in the editor.

Below table is a copy of the table in the Metadata Reference Sheet

Metadata Properties

Description

Current Value(s) For Kariza akunda kubaza

Replace With Your Book’s Metadata Value(s) 

1

dc:title

Title of the publication

Kariza akunda kubaza

2

dc:identifier

Element contains a single identifier associated with the given Rendition of the EPUB Publication, such as a UUID, DOI, ISBN or ISSN.

N/A

3

dc:language

Language used in the publication.

rw

4

dcterms:modified

Date when the content of the publication was last modified.

2019-06-18T15:30:00Z

5

dc:creator

Author credited with the creation of the resource.

Jean de Dieu Bavugempore

6

dc:publisher

The organization credited with publishing the resource.

African Storybook

7

dc:date

Date which the resource was created.

2017

8

dc:rights

You are free to download, copy, translate or adapt this story and use the illustrations as long as you attribute the author, translator, illustrator and publisher of this publication.

9

meta property file-as=" "

Match the dc:creator value

Jean de Dieu Bavugempore

10

dc:source

A related resource from which the described resource is derived.

Title: Kariza akunda kubaza, Publisher: African Storybook, Author: Jean de Dieu Bavugempore, Contributor: Rob Owen, Year: 2017, Africa

11

dc:description

Description may include but is not limited to: an abstract, a table of contents, a graphical representation, or a free-text account of the resource.

Ababyeyi ba Kariza bamutoje kubaza. Gukunda kubaza byatumye Kariza asobanukirwa akamaro ko gukaraba mbere yo kurya,  amenya no gukoresha kandagirukarabe.

Metadata section from an editor:

Book Metadata

XML

<metadata xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:opf="http://www.idpf.org/2007/opf"
 xmlns:dcterms="http://purl.org/dc/terms/" xmlns:dc="http://purl.org/dc/elements/1.1/">
 <!-- Title of the book -->
 <dc:title>Kariza akunda kubaza</dc:title>
 <!-- Creator/Author -->
 <dc:creator id="creator01">Jean de Dieu Bavugempore</dc:creator>
 <meta property="role" refines="#creator01">aut</meta>
 <meta property="file-as" refines="#creator01">Jean de Dieu Bavugempore</meta>
 <meta property="dcterms:modified">2019-06-18T12:39:00Z</meta>
 <!-- Date -->
 <dc:date>2017</dc:date>
 <!-- Publisher of the book-->
 <dc:publisher id="en_publisher" xml:lang="en-us">African Storybook</dc:publisher>
 <!-- Language of the book-->
 <dc:language>rw</dc:language>
 <!-- Identifier -->
 <dc:identifier id="uuid_id">N/A</dc:identifier>
 <meta property="identifier-type" refines="#uuid_id">N/A</meta>
 <!-- Rights -->
 <dc:rights id="en_rights" xml:lang="en">You are free to download, copy, translate or adapt this story and use the illustrations as long as you
 attribute the author, translator, illustrator and publisher of this publication.</dc:rights>
 <!-- Source -->
 <dc:source>Title: Kariza akunda kubaza, Publisher: African Storybook, Author: Jean de Dieu Bavugempore, Contributor: Rob Owen, Year: 2017,Africa</dc:source>
 <!-- Description -->
 <dc:description>Ababyeyi ba Kariza bamutoje kubaza. Gukunda kubaza byatumye Kariza asobanukirwa akamaro ko gukaraba mbere yo kurya,
 amenya no gukoresha kandagirukarabe.</dc:description>
 <meta property="ibooks:specified-fonts">true</meta>
 <meta property="ibooks:version">1.1</meta>
 <!-- Meta for the cover -->
 <meta name="cover" content="cover-image"/>

Accessibility metadata

XML

<!-- ACCESSIBLITY METADATA PROPERTIES -->
 <meta property="schema:accessibilityHazard">none</meta>
 <meta property="schema:accessibilityFeature">alternativeText</meta>
 <meta property="schema:accessibilityFeature">structuralNavigation</meta>
 <meta property="schema:accessibilityFeature">tableOfContents</meta>
 <meta property="schema:accessMode">textual</meta>
 <meta property="schema:accessMode">visual</meta>
 <meta property="schema:accessibilityAPI">ARIA</meta>
 <meta property="schema:accessModeSufficient">textual</meta>
 <meta property="schema:accessModeSufficient">visual</meta>
 <meta property="schema:accessModeSufficient">textual,visual</meta>
 <meta property="schema:accessibilitySummary">This title is a well-marked up and structured book, which is fully accessible. All images have sufficient alt text.</meta>
 </metadata>

3. **Changing the OPF Manifest and Spine**

The Manifest

The manifest is an unordered list of all of the files within the OEBPS/OPS/EPUB directory.  It is contained in the content.opf file in .../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/ .

Each item in the manifest has three components

  1. An item ID, which you can make up, and should describe the file:

    item-id

    CODE
<item id="cover"
  1. A reference to the actual file:

    item-id

    XML
href="cover.xhtml"
  1. The media-type, which tells the parser what type of file it is:

    item-id

    XML
media-type="application/xthml+xml"
  1. Media types can either be:
  • - Fonts.
  • All of the XHTML pages in the book (introduction, copyright, chapters, epigraph, etc.).
  • Images.
  • Audio or video files, if applicable.
  • The (Cascading Style Sheets) CSS file.
  • The NCX file, if you’re working with the ePUB 2.0 format.

To make changes in the Manifest section:

  1. Ensure the content.opf file is still open for editing using the editor of your choice.
  2. Move to the manifest section within the following tags <manifest></manifest>.
  3. Add any necessary media type using the syntax below: 

    item-id

    XML
<item id="cover" href="images/cover.jpg" media-type="image/jpeg"/>
  1. Save the changes to the file. DO NOT close the file in the editor.

Manifest section

XML

<manifest>

 <item id="font01" href="fonts/GillSansMt-Schlbk.ttf" media-type="application/vnd.ms-opentype"/>
 <item id="font02" href="fonts/GillSansMt-SchlbkBold.ttf" media-type="application/vnd.ms-opentype"/>
 <item id="font03" href="fonts/OpenDyslexic3-Regular.ttf" media-type="application/vnd.ms-opentype"/>

 <item id="Cover" href="cover.xhtml" media-type="application/xhtml+xml"/>
 <item id="nav" href="nav.xhtml" media-type="application/xhtml+xml" properties="nav"/>
 <item id="ch01" href="ch01.xhtml" media-type="application/xhtml+xml"/>
 <item id="Bcover" href="bcover.xhtml" media-type="application/xhtml+xml"/>

 <item id="item_image_0" href="images/logowhite.png" media-type="image/png"/>
 <item id="item_image_1" href="images/asblogo.png" media-type="image/png"/>
 <item id="cover-image" href="images/cover.jpeg" media-type="image/jpeg" properties="cover-image"/>
 <item id="image201" href="images/img01.jpg" media-type="image/jpeg"/>
 <item id="image202" href="images/img02.jpg" media-type="image/jpeg"/>
 <item id="image203" href="images/img03.jpg" media-type="image/jpeg"/>
 <item id="image204" href="images/img04.jpg" media-type="image/jpeg"/>
 <item id="image205" href="images/img05.jpg" media-type="image/jpeg"/>
 <item id="image206" href="images/img06.jpg" media-type="image/jpeg"/>
 <item id="image207" href="images/img07.jpg" media-type="image/jpeg"/>
 <item id="image209" href="images/img08.jpg" media-type="image/jpeg"/>
 <item id="image210" href="images/img09.jpg" media-type="image/jpeg"/>
 <item id="image211" href="images/img10.jpg" media-type="image/jpeg"/>
 <item id="image212" href="images/img11.jpg" media-type="image/jpeg"/>
 <item id="image213" href="images/img12.jpg" media-type="image/jpeg"/>

 <item id="css" href="stylesheet.css" media-type="text/css"/>
 <item id="ncx" href="toc.ncx" media-type="application/x-dtbncx+xml"/>

 </manifest>

The Spine

The spine is an ordered list of all of the contents of the book. It uses the item IDs you created in the manifest. Each item gets an item ref, and use the item id that you created in the manifest for the id ref.

Match the item's id in the spine for every item in the manifest section using the editor, save the changes and close the file.

Spine section

XML

<spine toc="ncx">
 <itemref idref="Cover"/>
 <itemref idref="nav"/>
 <itemref idref="ch01"/>
 <itemref idref="Bcover"/>
 </spine>

4\. Chapters

To make changes to the chapter content:

  1. Navigate to .../Book_X/Guide Package for Rwanda Toolkit/Book_X/EPUB/ch01.xhtml 
  2. Open ch01.xhtml file with the editor.
  3.  Rename the chapter title within the <title></title> tags found at the top.
  4. Transcribe the texts into the chapter's <p></p> tags, replacing the content with that available in the book to be made

Adding a chapter

  • Create a new HTML file anywhere, preferably beside the other XHTML files. To avoid basic errors, it’s better to copy one of the existing chapters and modify it as needed.
  • Inside the package file, under the manifest list, add a new item similar to any of the other existing chapters in the list (the order does not matter). Enter the new path of the chapter into the href attribute. The path must be relative to the package file. Also, enter a unique ID to the id property.
  • Under the spine list, add a new item as such: <itemref idref=”YOUR_UNIQUE_ID”/>. Here order does matter. So make sure you’ve placed it before and after the appropriate items.

×

Was this article helpful?

Related articles