Tips and Pitfalls
This page explains some common mistakes, some bugs in DropBook and/or
the eReader, and some techniques that will allow you to create quality
electronic books for the eReader.
- Check out the Converting to
Palm eBooks page for some pointers on converting text from various formats
into the Palm Markup Language.
- Use a return at the end of each paragraph, not each line.
- Using an extra return between paragraphs reads easier than paragraph indentation.
- The eReader doesn't display empty lines at the top of a page. If you need to
have some "empty" lines at the top of a page, put a space on each line.
- Don't use tables if you can possibly avoid it.
None of the fonts that the eReader supports are monospaced, so tables can
be difficult to represent. Break out the information in another way, or use the \T tag, but
beware of tables that look great on a Palm OS handheld but not on a Pocket PC or vice versa.
- The Reader breaks lines on spaces, dashes or underscores. This has several implications.
- Don't fill more than a line with spaces, dashes or underscores. There's a
bug (which will be fixed in a future release) which causes MakeBook to hang on
such a line. Note that in the large font, the number of spaces, dashes or underscores
will be much smaller than in the small font.
- A string such as
He shouted "Wait!--" may place the last quote on
the beginning of a line, since the line would break after the second dash. Prevent
this by using the PML string:
He shouted "Wait!\a150\a150". The non-breaking
dash, code 150, will not break a line. Use
\a160 for a non-breaking space.
Even better: use
\a151, a long dash, instead of two short dashes.
- The justification codes
\r (center and right
justification) must have closing codes on the beginning of the line following the justified text.
- The indentation tag
\t must have a closing tag at the end of
a line of the indented text.
\s (small font) in the title page(s) of books to force
the page(s) to format nicely. Other than that,
\l should rarely be necessary; the font size used for most text
display should be chosen by the user.