Etext HomeGeneral InfoCollectionsServicesFeaturesStandardsContact UsQuestions?VIRGO

Quick Start Guide for New Etexters

Text Center]


Making ebooks


Prepare your file:

At the UNIX prompt in your working directory, make sure your text has an *.xml file extension. Use the mv command to change the name if necessary:

     mv filename filename.xml


Making a Palm (.pdb) file:

  1. Transfer your .xml file to /lv26/ebooks/pdb/ :

         cp filename.xml /lv26/ebooks/pdb/

  2. Now go to /lv26/ebooks/pdb and run the xml2pdb script. This script will create a .pdb file version of all .xml files currently in that directory:

         cd /lv26/ebooks/pdb


  3. Do a ls to see that your .pdb file was created successfully, and then open SecureFX to transfer it to your C:\data\YourName directory on your desktop PC.

  4. From your desktop, double-click to open the Palm Reader software.

    Palm Reader icon

  5. When Palm Reader is open, click on File, Open, and then navigate to C:\data\YourName to find your .pdb text that you'd like to view. Once you've chosen the correct file, click "Open" and the text will open in the Palm Reader emulator.

  6. Check the file to make sure everything works properly. Use the Navigate menu button to navigate to new pages and chapters, do searches, add and locate notes and bookmarks, etc.


Making a Microsoft Reader ebook (.lit) file:

  1. Go back to your working directory, and at the UNIX prompt, copy your .xml file to /lv26/ebooks/parsed :

         cp filename.xml /lv26/ebooks/parsed

  2. Now navigate to /lv26/ebooks/parsed and do a list to find your file:

         cd /lv26/ebooks/parsed

         ls filename.xml

  3. Once you've located your file to make sure it copied correctly, put it into a list file:

         ls filename.xml > list

    This creates a file named list whose contents are the name of your file. When you open the list file in the jove editor:

         jove list

    you should delete the .xml file extension from your file name, then save the file:

         CTRL x CTRL s

    If permission is denied, you will need to open up another window in Exceed and delete the current list file or its backup versions (del list*). Then try saving your list again.

  4. At the UNIX prompt in /lv26/ebooks/parsed, execute the TEI2OEBx script:


    This creates two files, an ".html" and an ".opf" file. Now you'll want to move these two files into the /lv26/ebooks/html-opf directory:

         mv filename.html filename.opf ../html-opf

  5. The rest of the ebook creation process will be done in the Windows environment. First open SecureFX and transfer the .html and .opf files you just created into C:\data\ebooks on your PC.

  6. Open the ReaderWorks Publisher program from the desktop (or from the Start menu → Programs → OverDrive ReaderWorks → ReaderWorks Publisher):

    ReaderWorks Publisher icon

  7. In the Quick Start box that opens when you open ReaderWorks Publisher, select "Open eBook Package File" and click "OK." You will then be asked to specify the .opf file to open; click the "…" button to browse to find your file in C:\data\ebooks, and click "Open."

  8. The rest of the process includes changing the parameters that are listed in button form on the left side of the window: Source Files, Properties, Table of Contents, Cover Page, and Marketing Data. The only alterations you will need to make are under Properties, Table of Contents, and Cover Page.

    • Properties:

      Click on the Properties button. At the left of the screen, you will see "Property:" and a list of header elements. Confirm that the information included under each of the elements is correct, in addition to changing the following:

      Author(s): Double-click on the author listed under "Value," which will bring up a "Creator Properties" box. Change the values to the following:

           Name: FirstName LastName (i.e. Louisa May Alcott)
           Role: select appropriate role, i.e. Author
           File-as: select LastName, FirstName

      Subject: Select the appropriate field (usually Literature/Poetry)

      Description: If there is publisher information in this section, make sure to delete it.

      Publisher: Should list "Electronic Text Center, University of Virginia Library."

      Contributor(s): Not applicable.

      Date: Enter today's date.

      Rights: Change the date to the current year.

    • Table of Contents:

      Click on the Table of Contents button.

      1. Make sure "Include Table of Contents" is checked.

      2. Select the TOC Wizard button. The Table of Contents Wizard will pop up

      3. Click "Next." If asked to overwrite an existing "Contents.htm" file, select "Yes."

      4. At the following menu:

        Table of Contents Wizard

        • Make sure "Use source file titles" is unchecked;
        • Extract headings up to level 3
        • Make sure the tag used to indicate the heading levels is as follows:
          • Level 1: <h2>
          • Level 2: <h3>
          • Level 3: <h4>
        • Select "Next.

      5. Make sure the "classic" style is selected, and click "Next."

      6. Wait while ReaderWorks builds the Table of Contents. Once it pops up, review it to make sure it built correctly.

    • Cover Page:

      Click on the Cover Page button.

      1. Change "Standard thumbnail image" to C:\data\ebooks\thumb.jpg

      2. Change "Standard cover image" to C:\data\ebooks\cover.jpg

      3. Change "Standard title image" to C:\data\ebooks\title.jpg

      4. Change "PocketPC thumbnail image" to C:\data\ebooks\PCthumb.jpg

      5. Change "PocketPC cover image" to C:\data\ebooks\PCcover.jpg

      6. Change "Copyright link" to C:\data\ebooks\copyright.html

  9. Now, build your ebook!

    1. Click on the multicolored gears icon on the ReaderWorks toolbar:

      Multicolored ReaderWorks gears

    2. Change the file name to your text's text id, keeping the .lit extension: i.e. AlcLtmn.lit for Alcott's Little Men.

    3. Click "Next" and wait for the ebook to be created. There will probably be some errors generated, but if none of them are fatal, click "Finish" when the process is complete.

  10. Last step: Review/Check your ebook. Check especially for errors in the Table of Contents, searching, copyright notice, etc.

  11. If the ebook looks good, use Secure FX to transfer the .lit file to /lv26/ebooks/new-lit, and email Cindy again to let her know the file is there.

You're done!

| Back | Table of Contents |

By Scott Cohen
Revised Cindy Speer, 2004