- 1. How can I customize the layout of the widget?
- The dotEPUB widget comes in three flavors: button widget (in different sizes), icon widget (in different sizes) and text-only widget. All of them generate a link with
class="dotEPUB". Apply CSS to that link to customize the layout of the widget.
- 2. What flavor of the widget should I use?
- The button widget is meant to be used on its own, while the icon and text-only widgets improve when combined with your content: the icon widget could be followed by your own text and the text-only widget could follow your own icon.
- 3. How can I keep the links in the content of the e-book?
- By default, dotEPUB removes the links in your webpage. Uncheck the Immersive mode setting to change the default behavior of the widget and copy the new code. Or modify the value of the widget’s
linksparameter from 0 to 1.
- 4. How can I include in the e-book the multimedia content originally embedded in the webpage?
- The auto-generated e-book will not include videos or audios, but can include images if you uncheck the Immersive mode setting (or change the value of the widget’s
linksparameter from 0 to 1).
- 5. How can I set the the e-book’ title?
- The dotEPUB widget will derive the title from the
<title>of your webpage or from a
<h1>, if there is one and it is unique. You can force a different title using an
idattribute with a value of
dotEPUBtitleon any element: the widget will use the content of that element as a title. Example:
<h3 id="dotEPUBtitle">The Title of This Story</h3>.
- 6. How can I set the e-book author’ name?
- The dotEPUB widget tries to derive the author in many ways (usual
classvalues, microformats, metatags...). You can force your own value using an
idattribute with a value of
dotEPUBauthoron any element: the widget will use the content of that element as the name of the author. Example:
Posted by <a id="dotEPUBauthor" href="/jsmith/">John Smith</a>.
- 7. How can I show a copyright notice?
- The dotEPUB widget shows a copyright notice in the cover of the e-book if it finds a copyright metatag. Example:
<meta name="copyright" content="Your copyright notice goes here" />.
- 8. How can I change the content of the e-book?
- The dotEPUB widget parses your webpage and tries to derive the main content. You can force the section of your page that must be considered the main content using a container with a
idattribute with a
<div class="dotEPUBcontent">This is the main content...</div>. See the next question for more information.
- 9. How can I remove content from the e-book?
- If the dotEPUB widget included a section of your webpage that you don’t want in the e-book, you can try to remove it adding a
idattribute to the containing element with a
<div class="dotEPUBremove">This is an ad that should not be included in the e-book.</div>. This won’t probably work if the element you are trying to remove is included in an element that was identified as a positive main content container, like, for example, an element with a
class="dotEPUBcontent"(see the previous question).
- 10. How can I fully customize the metadata and the content of the e-book?
- The dotEPUB widget is designed to parse your webpage and automatically extract relevant information to build an e-book. You don’t need special skills to install it. If you are a webmaster, you can improve the resulting e-book following tips 3 to 9. This customization should be enough for most users. If you need more, our API provides a fully customizable solution to developers.
This software is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.