[Image]
NuvoMedia, Inc.
310 Villa Street
Mountain View, CA
94041
http://www.rocket-ebook.com/
What Is a RocketEdition?
How Is This Document Organized?
Brief Introduction to HTML
HTML Tags
HTML File Conventions
Rocket eBook Considerations
Supported HTML
Avoiding Page Numbers
RocketEdition File Size
Display Specifications
Planning Your Content Files
Required and Optional Files
File Partitioning
Headings
Body Text
Bold
Italic
Fixed Width
Size
Subscripts/Superscripts
Line Breaks
Horizontal Rules
Special Characters
Paragraphs
Setting Alignments
Indenting
Hyperlinks
Bullet Lists
Images
Sound Files
Title and Author
Chapters
Page Breaks
Table of Contents
"Go To" Menu Customization
Footnotes/Endnotes
Supported HTML Tags
Simple RocketEdition Example Files
This document is an adjunct to the documentation on the RocketWriter™ software utility. It will help you use HTML to control the appearance of your RocketEditions™. It does not assume any prior knowledge of HTML.
For more details on obtaining and using RocketWriter, visit the Rocket eBook web site at http://www.rocket-ebook.com/.
A RocketEdition is a document that has been formatted for use with the Rocket eBook™ handheld electronic reader. Anyone can create their own RocketEdition using the RocketWriter. This software is freely available both to Rocket eBook owners and non-owners alike.
When you use RocketWriter to create a RocketEdition, you need to provide your content in one of two formats: HTML or ASCII text. Although ASCII text is easiest to use, you have much less control over the appearance of the RocketEditions you create. With HTML, however, you can create RocketEditions with the same formatting quality available in RocketEditions you buy.
Many applications allow their content to be saved as HTML files, and you can use RocketWriter to create RocketEditions from these files. If you want to improve the appearance of these RocketEditions, use this document to find out how to modify the HTML to tune it for use with the Rocket eBook. You can also use this document to create your HTML content files directly, using a HTML or text editor.
The next section of this document covers the basics of using HTML and gives an overview of what you need to think about when formatting your RocketEditions. The following three sections present the specifics of using HTML to control formatting. The HTML descriptions are grouped according to the type of formatting:
Throughout this document there are examples that show the HTML tags and how the HTML will be displayed. Each example has the following structure:
Example:
examplefilename.html(Only where appropriate)expected appearance on Rocket eBook.
HTML tags:
example HTML
What you will see:
To quickly view an example, copy the example's HTML tags into your HTML or text editor and view the file in your browser, or RocketWrite the file and view it on your Rocket eBook.
After you use the information in this document to format your own content in HTML, use RocketWriter to convert it to a RocketEdition. The final reference section of this document includes a complete HTML example you can use to create a simple RocketEdition using RocketWriter.
This chapter gives an overview of putting your content into HTML format. If you are familiar with HTML basics, you may want to skip to Rocket eBook Considerations.
HTML is an acronym for "HyperText Markup Language." It is a language used to represent formatted text (headings, indents, type styles, etc.) that is interpreted and displayed by HTML viewers. A standard Internet browser, such as Netscape® Navigator or Internet Explorer, is an HTML viewer, as is the Rocket eBook.
HTML provides a way to represent "hyperlinks" for quick navigation to different locations within the title. In both a browser and the Rocket eBook, when you use a hyperlink, the displayed text jumps to the location it points to.
All HTML formatting instructions are represented as "tags." Each HTML tag is enclosed in "less-than" (<) and "greater-than" (>) signs. An HTML viewer will use its default settings to display characters for which no special instructions are given. Thus, you don't have to specify anything except special instructions.
For example, a file that contains the following text could be considered to be in HTML and can be displayed on an HTML viewer:
This is simple text.
An HTML viewer might display this text as:
This is simple text.
By adding a few HTML "tags" you can get the sentence to look a bit fancier:
This is <i><b>simple</b></i> text.
Which an HTML viewer might display as:
This is simple text.
HTML tags most often come in pairs. The first tag in a pair means "start this formatting option" and the second means "end this formatting option." In the example above, <i> means "start displaying characters in italic," and </i> means "stop displaying characters in italic." Similarly <b> and </b> tell the HTML viewer where to start and stop displaying characters in bold. As you can see, some tags can be combined, although others (like headings) cannot, as described in later sections.
You can control the appearance of text by using a HTML feature called "attribute." Attribute values are set using an equals sign and are generally enclosed in double quotes. For example, paragraph text can be centered using the Align attribute <p align="center">. Not all tags support attributes.It can be helpful to know some of the conventions generally followed when creating HTML files.
Simple Text/HTML Editor. As you work through this document, you can enter HTML tags directly into the files with which you are working. To do this, you can use any simple text editor you're familiar with. For example, if you're working on a PC, you can use Notepad (or WordPad, for larger files). HTML editors are also available, such as HomeSite from Allaire (http://www.alliare.com/). These applications have built-in tools to assist with the creation of HTML documents.
Filename Extensions. Give files that contain HTML formatting instructions a ".htm" or ".html" filename extension. This lets HTML viewers know that they should look for HTML tags within the file and interpret them as formatting instructions.
Tag Appearance. The HTML tags are case-insensitive. This means <b> or <B> will have the same effect. Your files will be easier to review if you pick a particular capitalization style and stick with it. This document uses all lower case letters for tag names.
HTML Document Format. HTML tags or tag pairs can be "nested" inside other HTML tag pairs. In fact, by convention each HTML file is bounded by an <html></html> pair. The <html> tag usually appears by itself on the first line of the file and </html> on the last line. You don't have to put tags like these on separate lines, but it improves the readability of your file.
You can use blank spaces, indents, or empty lines between tags to improve readability of the HTML file. These do not affect the display of the file on the HTML viewer.
After the opening <html> tag, a HTML file includes a document header section, beginning and ending with -- delimited by -- a <head></head> pair. Again, each of these tags appears separately on its own line. You'll include any tags with information about the document between these two lines. For example, this is where you can include title information.
The next section is the body, delimited by a <body></body> pair. Again, each body delimiter appears on its own line. You'll include all the RocketEdition content between these two lines. This may include text, HTML formatting tags, images, or sound files. Most of the tags described in this document will be used within the body section.
Try creating a file with the lines shown below using your editor, and save it on your computer as a text file with a name like test.html. Then open the file in your browser. (You can do this by double-clicking the file name.) You should see "Here's the body text" in the browser's display window. The title information may also appear in the top border of your browser. If you can do this, you are ready to begin!
Example:
Note: If you are viewing this document on your computer's browser, you are encouraged to cut and paste into your test file any of the HTML examples given in the sections below. After you save your changes, open the test file in your browser to view the results.Here's the body text.test.html
HTML tags:
<html> <head> <title>This is the Title of This Document </title> </head> <body> Here's the body text. </body> </html>
What you will see:
If you're interested in a more detailed introduction, many beginner's guides to HTML are available in bookstores. "HTML for Dummies" is a good basic reference, and "HTML: The Definitive Guide, 3rd Ed, by O'Reilly & Associates is a good advanced reference title. Introductory information on HTML is also available on the Internet.
This section covers some Rocket eBook-related issues you should consider when setting up your RocketEdition content files.
The Rocket eBook supports, or will display, a subset of HTML 3.2 (ISO 8859-1), for 8-bit characters. If you are using an HTML reference book, you need to be aware that not everything in HTML 3.2 is supported. In general, basic formatting and positioning tags are supported, while more complex formatting items like tables, frames and style sheets are not supported at this time. This document describes how to use the tags that are supported.
You can, however, include any tags that are not supported anyway. Unsupported tags are simply ignored by the Rocket eBook. This means that you can put unsupported commands into your HTML content files for use with future releases of the Rocket eBook firmware or for other uses of your HTML files.
The Rocket eBook supports HTML 3.2 supported character entities; those that are labeled "non-standard" in HTML 3.2 are not supported.
You should avoid using page numbers when referring to other areas of your text; use hyperlinks instead. This is important with the Rocket eBook, since the amount of text that appears on the display can change (depending on the print size you choose, for example). That means you can't count on any particular section of text appearing on any particular page.
After you complete your content files and use RocketWriter to create your RocketEdition, it's advisable to check its size. A RocketEdition that is 3.5 megabytes or less should pose no problem. This is because the standard Rocket eBook has about that much memory available for the RocketEdition that is currently being read.
There are also larger memory configurations for the Rocket eBook. However, not every Rocket eBook owner will have chosen to purchase a device with more than the standard 4Mb of memory. So you still should take the time to evaluate the size of your RocketEditions.
If you decide you'd like to reduce the size of your RocketEdition, the best way to proceed is usually to eliminate or simplify any included images or sound files. Sound and image files are very large relative to text and are responsible for most of a RocketEdition's size.
You need to be aware of the Rocket eBook's display specifications when planning your content's appearance. Note, however, that there are several user-selectable display options. For example, users can select one of four 90° page orientations as well as the display font characteristics.
The Rocket eBook's screen specifications are as follows:
Images that exceed the display size can be "panned," or scrolled into view.
This section gives an overview of the files you'll work with when formatting your RocketEdition content.
Before you can create your RocketEdition, you'll need to have set up all your content files. You'll need a HTML file (or set of HTML files) for the document text; image files, if illustrations are used; sound files, if sound recordings are used; and a Menumark file, if custom "Go To" menu links are desired (see "Go To" Menu Customization for more information).
Below are descriptions of files in an example RocketEdition file set.
Main document (main body file).
Any additional HTML files hyperlinked to the main body document and/or to each other.
Any images included in the document.
Any sound recordings included in the document.
List of links to noteworthy places in the body document; used for customizing the "Go To" menu.
You can have any number of image or sound files included in your document. However, as noted above, using many images or sound files increases the size of your RocketEdition dramatically.
You use hyperlinks to link the text together when you use multiple HTML files. You can split the body of the text into as many HTML files as you choose. The main body file acts as the starting point for the title. When you include a hyperlink in the main file pointing to text in a second file, then the second file is included when RocketWriter generates the RocketEdition (assuming the second file is in the same directory). If that file includes hyperlinks that point to other files in the same directory, they will be included.
As an example of when you might want to use multiple HTML files, you might decide to place each chapter in a separate file. In this case, you could include a set of hyperlinks in the main body file that point to each chapter. As an alternative, you could include in the main body file a hyperlink that points to the first chapter, and include a hyperlink at the end of each chapter that points to the next.
See Hyperlinks for more information on setting up hyperlinks.
Note that the text at the bottom of each file is followed by an implied page break. See Page Breaks for more information on how this affects the flow of reading.
This section describes HTML tags relating to text elements.
Note that the Rocket eBook lets the reader control the display fonts. It provides two primary font selections: one for large print and one for small. Since the user chooses two specific typeface and size combinations according to personal preference, HTML "font" tags, <font></font>, will be ignored by RocketWriter when creating the RocketEdition.
Heading tags are used to display text as a heading. HTML lets you identify the headings hierarchically only. The HTML viewer controls the particulars of how each heading is displayed.
The top-level heading is identified by the <h1> tag. The next level heading is identified by the <h2> tag, and so on through <h5>. A closing tag (for example, </h1>) returns the font to normal. A paragraph break is automatically inserted after a heading. See Setting Alignments for information on aligning text with heading tags.
On the Rocket eBook, headings are displayed as follows:
Example:
HTML tags:
<h2>Chapter 1 - Down The Rabbit-Hole</h2> <h2>Chapter 2 - The Pool of Tears</h2> <h3>Chapter 3 - A Caucus-Race and a Long Tale</h2> <h4>Chapter 4 - The Rabbit Sends in a Little Bill</h2> <h5>Chapter 5 - Advice from a Caterpillar</h2>
What you will see:Chapter 1 - Down the Rabbit-Hole
Chapter 2 - The Pool of Tears
Chapter 3 - A Caucus-Race and a Long Tale
Chapter 4 - The Rabbit Sends in a Little Bill
Chapter 5 - Advice from a Caterpillar
The following tags let you control the appearance of the main text in the title. These tags only apply to text that is not part of a heading.
The Bold tag <b> lets you display text in bold. The closing tag </b> returns the text to its previous appearance.
Example:
HTML tags:It's important that you know this!
It's <b>important</b> that you know this!
What you will see:
The Italics tag <i> lets you display text in italics. The closing tag </i> returns the text to its previous appearance.
Example:
HTML tags:Alice was not going to do that in a hurry.
Alice was not going to do <i>that</i> in a hurry.
What you will see:
The Preformatted Text tag <pre> lets you display preformatted text. Because the Rocket eBook uses a fixed width font for <pre> text, spacing is maintained. The closing tag </pre> returns the text to its previous appearance. A line break is added before and after the text enclosed by <pre></pre> tags.
Example:
HTML tags:
<pre>Title Author ------------- ------------- Alice's Ad... Lewis Carroll ------------- -------------</pre>
What you will see:Title Author ------------- ------------- Alice's Ad... Lewis Carroll ------------- -------------
You can also identify text to be displayed in a fixed width font with either the Code tags <code></code> or the Typewriter tags <tt></tt>. The Rocket eBook does not add line breaks before and after enclosed text with these tags. This means you can use these tags to embed fixed width characters within a paragraph.
Example 2:
HTML tags:Here is typewriter and here is
Here is <tt>typewriter</tt> and here is <code>code</code> text.
What you will see:codetext.
The Big tag <big> lets you display text in the Rocket eBook's larger print selection. The closing tag </big> returns the text to the previous size. If Large Print on the Rocket eBook is currently selected, this tag is ignored.
Use the Small tag <small> to display text in the Rocket eBook's smaller print selection. The closing tag </small> returns the text to the previous size. If Small Print on the Rocket eBook is currently selected, this tag is ignored.
Example:
HTML tags:He tried hard to look very inconspicuous.
He tried hard to look very <small>inconspicuous</small>. But, he was actually quite <big>prominent</big>.
What you will see:
But, he was actually quite prominent.Note: On the Rocket eBook, switch between small and large font to see the difference between the <small> and <big> tags. Remember, if Small Print is selected, the <small> tag is ignored, and if Large Print is selected the <big> tag is ignored.
The Superscript tag <sup> lets you display superscripts. The Rocket eBook raises superscript text half the height of a character. The closing tag </sup> identifies the end of the superscript.
The Subscript tag <sub> lets you display subscripts. The Rocket eBook lowers subscript text half the height of a character. The closing tag </sub> identifies the end of the subscript.
Example:
HTML tags:Everyone knows that E=mc2!
Everyone knows that E=mc<sup>2</sup>!
What you will see:
The Break tag <br> lets you force a line break. When you don't specify line breaks explicitly, text wraps automatically as appropriate for the current display and font characteristics.
Example:
HTML tags:This text appears on one line.
This text appears on one line.<Br> This appears on the next line.
What you will see:
This appears on the next line.
The Rocket eBook supports the standard horizontal rule tag <hr>. Horizontal rules are used for drawing horizontal separator lines.
You can set the Size attribute to a value greater than zero to control the number of pixels high (thickness) to draw the rule. You can also set the Width attribute, to control how wide (length) to draw the horizontal line, in pixels. If you don't use the Width attribute to specify a width, the horizontal rule is drawn from the left edge to the right edge of the display.
Note that the <hr> tag is also used by the Rocket eBook to indicate a page break if you set the Size attribute to zero (see Page Breaks for more information). To draw a horizontal line rather than indicating a page break, don't set the Size attribute to zero!
Example:
HTML tags:
Here are two horizontal rules: <hr><Br> <hr size="1" width="10">
What you will see:
As mentioned above, the Rocket eBook also supports character entities supported in HTML 3.2. Special characters are represented by sequences that begin with an "&" and end with a ";".
You can refer to documentation on HTML 3.2 to get a full list of these characters, but a few useful special characters are given in the example below.
Example:
HTML tags:- Single space (non-breaking space)
- Single space (non-breaking space)
™ - Trademark symbol
© - Copyright symbol
® - Registered trademark symbol
< - < sign (when not part of an HTML tag)
> - > sign (when not part of an HTML tag)
What you will see:
- Trademark symbol
© - Copyright symbol
® - Registered trademark symbol
< - < sign (when not part of an HTML tag)
> - > sign (when not part of an HTML tag)
This section describes HTML tags that identify elements of the overall document.
The paragraph tags <p> and </p> let you identify paragraphs. If you want a sentence to appear on a separate line, you need to enclose it in paragraph tags. If you cut and paste the example text into your test.html file and view it in your browser, you'll see how the paragraph tags control the display.
Example:
HTML tags:
<p>This is the first sentence. This is the second sentence. This is the sentence in the same paragraph.</p><p>Only this line stands alone.</p>
What you will see:This is the first sentence. This is the second sentence. This is the sentence in the same paragraph.
Only this line stands alone.
Paragraph and heading text is aligned using the Align attribute. This attribute can take on one of the following values: Left, Right, Justify or Center. If no alignment is specified, text is displayed with left alignment.
The <center> tag of HTML 3.2 is not supported by the Rocket eBook. Use <p align="center"> instead.
Try entering the following example text into your test.html file and see how it is displayed in your browser.
Example 1: Setting Paragraph Text Alignment:
HTML tags:
<p align="left">Appears on the left</p>
<p align="center">Appears in the center</p>
<h3 align="right">Appears on the right</h3>
What you will see:Appears on the left
Appears in the center
This appears on the right
The Divide tags <div> and </div> can be used to divide and separate large sections of a document. The <div> tag also supports the Align attribute. Use the <div> tag to align preformatted text that uses the <pre> tag.
Example 2: Setting Preformatted Text Alignment:
HTML tags:
<div align="center"> <pre> Title Author -------------- ------------- Alice's Adv... Lewis Carroll -------------- ------------- </pre> </div>
What you will see:Title Author -------------- ------------- Alice's Adv... Lewis Carroll -------------- -------------
The Blockquote tags <blockquote> and </blockquote> set off text by indenting the left and right margins. These tags may be nested, and the closing tag </blockquote> returns the text to the previous level of indentation.
Example 1: Indenting paragraphs
HTML tags:The example below is indented.
The example below is indented. <blockquote> Example 1: <blockquote> <p>This is indented further.</p> </blockquote> Example 2: <p>This lines up with the "Example 1" text.</p> </blockquote> <p>And now we're back.</p>
What you will see:Example 1:Example 2:This is indented further.
This lines up with the "Example 1" text.
And now we're back.
To indent the first line of a paragraph use the non-breaking space special character entity ( ).
Example 2: Indenting the first sentence in a paragraph
HTML tags:
The first sentence of this paragraph is indented. The second sentence of this paragraph is not indented.
What you will see:The first sentence of this
paragraph is indented. The second
sentence of this paragraph
is not indented.
The Anchor tags <a></a> let you set up hyperlinks. When a user clicks a hyperlink (text or an image displayed with a solid underline) the destination text (or image) is displayed. The new text might be somewhere else in the same HTML file or somewhere in a different HTML file.
The two main components of a hyperlink are specified using attributes of the anchor tag:
If the hyperlink is to point somewhere within a file you need to set up a "destination bookmark." For example, if you want to set a hyperlink to the beginning of the first chapter, put a destination bookmark at that location. This destination bookmark can have any name - just make sure it's different than any other bookmark name in the same file. The closing tag </a> can be placed immediately after the opening tag (or later, if desired).
Example 1: Setting a Bookmark:
HTML tags:
<a name="chap1"></a> <h2>Chapter 1 - Down the Rabbit-Hole</h2>
What you will see:Chapter 1 - Down the Rabbit-Hole
Now you can set hyperlinks to that bookmark. Let's say you're setting up a hyperlink to the first chapter from a paragraph in the main body file, and the first chapter is in a different file. In this case you must specify the filename as well as the bookmark name in the hyperlink reference. The bookmark name is always preceded by a "#" sign.
The active region, or the text you can click on, lies between the anchor tag with the Href attribute and the closing </a> tag. In examples 2 and 3 below, the words "Chapter One" will be underlined and the reader will be able to click on (or tap) them to jump to the first chapter. Click on and try out the example hyperlinks below.Example 2: Setting to a Destination in a Different File:
HTML tags:As described in Chapter One, ...
As described in <a href="OtherFile.html#chap1">Chapter One</a>, ...
What you will see:Note: If the hyperlink were to point to the beginning of the file, you'd set the hyperlink reference the destination filename only (no "#" or destination bookmark required).
When the hyperlink is in the same file as the destination bookmark, you may omit the filename in the hyperlink reference. In this case, the "#" sign is still required.
Example 3 - Setting a Hyperlink to a Destination in the Same File:
Note: By clicking on the link in the example below you will jump to the bookmark in Example 1: Setting a Bookmark. To return to this spot either page down, or use the Previous Location feature on the Rocket eBook.
HTML tags:
As described in <a href="#chap1">Chapter One</a>, ...
What you will see:As described in Chapter One, ...
The Unordered List <ul></ul> tags let you set up bullet lists. List items are nested within these tags, and each list item is itself enclosed in <li></li> tags.
Example:
HTML tags:
<UL> <li>First item</li> <li>Second item</li> </UL>
What you will see:
- First item
- Second item
The Ordered List <ol></ol> tags currently work the same way as the unordered list tags. List items in ordered lists will also be bulleted.
The image tag <img> lets you include images in your document. It supports two attributes:
Images that are 312x312 pixels or less will fit on the display in any orientation. Although images larger than the screen can be "panned" into view, it is recommended that images not exceed 1024x768 (or 1000x800) pixels. If the Rocket eBook does not have enough free memory for an image, the image will be clipped to the size of the screen.
You can use a graphics program like Paint Shop Pro from Jasc Software (www.jasc.com/psp.html or Adobe Photoshop from Adobe (www.adobe.com/products/photoshop/main.html) to create your images. Images should be saved in 2 color (1 bit), black and white, Portable Network Graphics, or PNG (pronounced "ping") format. Although you can use other image formats, this requires RocketWriter to do some image conversion first, which can degrade the image quality slightly.
See the manual for your graphics program for more information on graphics formats and conversions.
Example:
HTML tags:
<p>Here's my image:<Br> <img src="myImage.png" align="left"></p> <p>Text formatted to the Left of the image.</p>
What you will see:Here's my image:
[Image]Text formatted to the Left of the image.
Although the Rocket eBook is an excellent display for reading text and can display graphic images, some titles will not be appropriate for the Rocket eBook. Titles that contain images of tables, symbols and line drawings are easily rendered on the Rocket eBook. However, titles that require high-resolution color or gray-scale images are not appropriate for the Rocket eBook at this time.
The Rocket eBook can play small sound files using hyperlinks. As before, you use anchor tags to set up the hyperlink. In this case, however, the href attribute identifies the sound file (see Hyperlinks for more information).
Sound files must be properly formatted as 8 bit, unsigned single channel (mono), 16khz sample rate, 16KB/s, .wav files. Shareware sound conversion programs are available on the Internet. If you're using a PC running Windows, it has a "Sound recorder" utility you can use for sound file conversion.
Example:
HTML tags:[Image]
<a href="mySound.wav"> <img src="SpeakerIcon.png"> </a>
What you will see:
Click the speaker graphic to play the sound file. If you don't have an image, you can use text in the active region instead.
This section describes HTML tags used in setting up document elements specific to RocketEditions.
You can include title and author information in the header section at the top of the main body file. If you do this, the title and author will be automatically entered when you run RocketWriter, and you won't have to enter it manually. Because you may end up running RocketWriter several times (perhaps after fixing formatting problems or making improvements), it can be convenient to have this information entered automatically.
The title tags <title></title> let you set the title. Author information is set using a <meta> tag with Name and Content attributes. The Name attribute is followed by an equals sign and the word "author" in double quotes. Similarly, the Content attribute is followed by an equals sign and the author's name in double quotes.
When setting the author information, use "Last Name, First Name" format. Multiple authors should be separated by a semicolon. When setting title information, place any leading articles last (e.g. "Black Rose, The" or "Different Drummer, A").
Example:
HTML tags:
<head> <title>Alice's Adventures in Wonderland</title> <meta name="author" content="Carroll, Lewis"> </head>
What you will see:
Note 1: You will not see anything, since this information is used by RocketWriter and browsers and is not displayed.
Note 2: When RocketWriter prompts you for title and author information, leave these fields blank (title and author HTML information are read in only after the conversion begins).
Because page numbers can vary, depending on the display options readers select on their Rocket eBooks, it is important to use chapters. This provides all readers with fixed reference points within the text. Use anchor tags <a></a> with the Name attribute to set destination bookmarks at the beginning of each chapter.
Example:
HTML tags:
<a name="chap2"><a> <h2>Chapter II - The Pool of Tears</h2></a>
What you will see:Chapter II - The Pool of Tears
Page breaks are supported by the Rocket eBook, even though they are not supported in HTML. This is because page breaks at the end of chapters, sections or front matter, can improve the readability of a RocketEdition. You can use page breaks to separate major sections, but it is not advisable to use them anywhere else or it can interfere with the normal flow of reading.
When you use page breaks, the Rocket eBook displays text normally up to the point where the page break is encountered. After the page break, the remaining area of the display at the bottom of the page is blank. The reader must use the Rocket eBook's Page Forward button to display the beginning of the next section.
The Rocket eBook displays the horizontal rule tag <hr> with a Size attribute set to zero as page breaks. If a size other than zero is specified, a horizontal rule will be drawn as specified in HTML 3.2. You can still check the title using a browser, since the "page break" will appear as a horizontal line 1 pixel wide.
Example:
HTML tags:...
<html> ... <h2>Chapter 1 - Down The Rabbit-Hole</h2> <hr size="0"> <h2>Chapter 2 - The Pool of Tears</h2> ... </html>
What you will see:Page Break Here.
Chapter 1 - Down The Rabbit-Hole
Note: A page break has not been rendered in the example above on the Rocket eBook, since this would disrupt the flow of this section. However, if you are reading this on a Rocket eBook, please note the page break immediately following this paragraph.
Chapter 2 - The Pool of Tears
...
We recommend that you include a table of contents in any RocketEditions you create. The table of contents provides hyperlinks to chapter bookmarks. Although it's not required, a table of contents will allow your readers to move quickly to specific locations within the RocketEdition.
As a general guideline, it is desirable that the table of contents be no longer than one or two Rocket eBook pages (using an average sized font), to provide a quick lookup. The reader can use the search feature to find more specific items that might normally be included in a detailed table of contents.
Example:
Note:The Chapter II link in the example below will jump you to the beginning of this section, Table of Contents. Page forward or select the back button on your browser, or the Previous Location feature on your Rocket eBook, to return to this example.
HTML tags:
<h2>Table of Contents</h2> <p><a href="OtherFile2.html#chap1">
Chapter I - Down the Rabbit-Hole</a></p> <p><a href="#chap2">
Chapter II - The Pool of Tears</a></p> ...
What you will see:Table of Contents
...
The Rocket eBook's "Go To" menu appears when you tap the Book icon, [Image], and then tap the "Go To" menu item on the Rocket eBook. You can customize the Rocket eBook "Go To"' menu so it includes hyperlinks to up to seven locations in your RocketEdition. Your custom links will appear as selections in the "Go To" menu whenever your RocketEdition is loaded.
Customize the "Go To" menu if there are a few important areas in your RocketEdition that you want to make very easy to access. For example, you could provide a menu link to the index, or to the table of contents (useful if there are several pages of front matter).
To set up "Go To" menu links,
1. Add menu link support to your HTML file(s):
- Put <a href="menumark.html"></a> in the main body file.
This tells the Rocket eBook to include the menu customization file, Menumark.html (see step 2 below).
- Make sure each menu link that needs one has a destination bookmark.
Remember that a hyperlink uses the Name attribute to identify a destination bookmark (the location it will jump to within a file). Set up any needed destination bookmarks in your content files.
2. Create a file called menumark.html:
Put the menu link Href anchors in this file. These special hyperlinks have two requirements:
- Include the filename for the link.
Because there could be any number of HTML files, you need to specify the filename in the hyperlink reference for each menu link.
- Include the attribute Rel="toc".
Each menumark link must have a relationship (Rel) attribute set equal to "toc". If this attribute is missing, the link won't appear in the "Go To" menu.
The text you place before the closing </a> tag will appear as a selectable item in the "Go To" menu when this title is loaded.
Example:
Adds "Table of Contents" and "About the Author" to "Go To" Menu.
Example:
MyBook.html (main body file): HTML tags:...
<html> <head>
... </head>
<body>
<a href="menumark.html"></a>
<a name="toc"></a><h2>TABLE OF CONTENTS</h2>
<h3>Chapter 1 - Down The Rabbit-Hole</h3>
<h3>Chapter 2 - The Pool of Tears</h3> ... <img src="rabbit.png"> </body> </html>
What you will see:TABLE OF CONTENTS
Chapter 1 - Down The Rabbit-Hole
Chapter 2 - The Pool of Tears
... [Image]AboutAuthor.html (author info file):HTML tags:
<html>
<body>
<p><h2>Short Biography of the Author</h2></p>
<p><a href="MyBook.html">Click
here</a> to return to MyBook.</p> ... </html>
What you will see:Short Biography of the Author
Click here to return to MyBook.
Menumark.html (menumark file): HTML tags:
<html>
<a href="MyBook.html#toc"
rel="toc">Table of Contents</a>
<a href="AboutAuthor.html"
rel="toc">About The Author</a>
</html>
What you will see:In the GoTo menu you will see:
[Image]
The recommended way of adding footnotes with the current release of the Rocket eBook is to place the text for each footnote in a separate HTML file or at the bottom of the HTML file containing the reference. Then set up two hyperlinks for each footnote:
When you use a separate file for each footnote, you can prevent the reader from mistakenly clicking on the wrong return link and getting lost. This is because the text (and return link) for one footnote only is displayed at any given time.
Example:
MyBook2.html (main body file):
HTML tags:
<html> ... <p>Lewis Carroll <a name="fn1"></a> <a href="footnote1.html"> <sup>Footnote1</sup></a> was prone to having vivid dreams. This may account for...</p> ... </html>
What you will see:Lewis Carroll Footnote2 was prone to having vivid dreams. This may account for...
...
footnote1.html (first footnote file)HTML tags: <html> <p>Author of "Alice's Adventures in Wonderland" and "Behind the Looking Glass."</p><p><a href="MyBook.html#fn1"> Continue</a></p> </html> What you will see:Author of "Alice's Adventures in Wonderland" and and "Behind the Looking Glass."
This section provides an index for supported HTML tags and a complete example file set for a simple RocketEdition.
The following HTML 3.2 tags are supported by the Rocket eBook.
<a>
<body>
<b>
<big>
<blockquote>
<Br>
<code>
<div>
<h1>
- <h5>
<head>
<hr>
<html>
<i>
<img>
<li>
<meta>
<ol>
<p>
<pre>
<ul>
<small>
<sub>
<sup>
<title>
<tt>
The following example files could be used to create a simple RocketEdition using RocketWriter.
MyBook.html
Footnote1.html
AboutAuthor.html
Menumark.html
Rabbit.png
Music.wav
You're encouraged to try creating a RocketEdition from the following example which illustrates items described in this guide.
MyBook.html: HTML tags:
<html>
<head>
<title>My Book</title>
<meta name="author" content="Name, My">
</head> <body>
<a href="Menumark.html"></a> <h1 align="center">My Book</h1><Br>
<p align="center">by My Name</p>
<h1><Br><Br><Br><Br><Br></h1>
<p align="center">Copyright © 2000</p> <hr size="0">
<a name="toc"></a>
<h2>Table of Contents</h2>
<p><a href="#chap1">Chapter 1 - First Things First</a></p>
<p><a href="#chap2">Chapter 2 - Next Things Next</a></p>
<p><a href="AboutAuthor.html">About the Author</a></p> <hr size="0">
<a name="chap1"></a>
<h2>Chapter 1 - First Things First</h2>
<p>Lewis Carroll
<a name="fn1"></a>
<a href="Footnote1.html">
<sup>1</sup></a>
was prone to having vivid dreams.
This may account for the dreamlike
quality of his writings.</p> <hr size="0">
<a name="chap2"></a>
<h2>Chapter 2 - Next Things Next</h2>
<p>This is where I make very <b>important</b> points.
<ol>
<li>point 1</li>
<li>point 2</li>
<li>point 3</li>
</ol>
</p>
<p>As discussed in <a href="#chap1">Chapter 1</a>,
Lewis Carroll was prone to having vivid dreams.</p>
</body>
</html>Footnote1.html: HTML tags:
<html>
<body>
<p>Author of "Alice's Adventures in Wonderland" and
"Behind the Looking Glass."</p>
<p><a href="MyBook.html#fn1">Continue</a></p>
</body>
</html>AboutAuthor.html:
HTML tags:
<html>
<body>
<h2>About the Author</h2>
<p><img src="AuthorPortrait.png" align="left">
The author, My Name, was born in
the South and later moved North.</p>
<p><a href="AuthorQuote.wav">
Message From the Author</a></p>
</body>
</html>Menumark.html:
HTML tags:
<html>
<body>
<a href="MyBook.html#toc" rel="toc">Table of Contents</a>
<a href="AboutAuthor.html" rel="toc">About the Author</a>
</body>
</html>Rabbit.png:
HTML tags:
<img src="rabbit.png">
Music.wav:
HTML tags:
<a href="mySound.wav"><img scr="SpeakerIcon.png"></a>