Booki User Guide

Importing a Book

Books can be imported from several sources, Archive.org, WikiBooks, FLOSS Manuals and epub files. In this chapter we go through each of these scenarios.

Note: When importing text into Booki from it's respective locations and formats it is important to note that the document structure may not be a part of the source file. This would leave the entire text in a single chapter which will need to be broken up into its individual chapters and Sections once in Booki.

Note: If you try to create a book with the same title as a book that has already exists then Booki will add '-1' to the end of the title and try again, then if the new title also already exists it will try '-2'... '-3'... and so on, until it finds a title that has not yet been created.

Archive.org

The Internet Archive (http://www.archive.org) is a a non-profit digital library storing digitised collections of websites, music, moving images, software and books. With its stated mission of "universal access to all knowledge.", its purposes include offering permanent access for researchers, historians, scholars, people with disabilities, and the general public to historical collections that exist in digital format.

On your My Books page under Import select Import Archive.org book from the drop-down list, enter the Archive.org ID and press Import. The Archive id can be found in the Identifier field under the Selected metadata section at the bottom of the text's page on Archive.org.

The text is now imported from Archive.org using Espri and converted into a Booki-zip file (this may take a while). Once the process has finished the imported book will be added to the list of books on your My Books page and My Profile page.

Wikibooks

Wikibooks (http://www.wikibooks.org) is a collection of open-content textbooks covering almost any subject. Wikibooks is hosted by the Wikimedia Foundation and as such its textbooks can be contributed to by anyone.

To import from Wikibooks, navigate to your My Books page, select Import Wikibook from the Import drop-down list, then enter the URL for the Wikibook you want to import into Booki. For example 'http://en.wikibooks.org/wiki/Book_Name_Goes_Here'

Once again the text is now imported using Espri and converted into a Booki-zip file (this may take a while). Once the process has finished the imported book will be added to the list of books on your My Books page and My Profile page.

Notes:

  • Be careful of book titles that contain a colon ":" as they are often used in pages to group several books together and the import will fail.
The following notes are due to bugs currently in the importing script, eventually they will be seen to but are not currently on the urgent list.
  • At the moment when importing Wikibooks, the chapters will end up arranged in alphabetical order in Booki so you will need to re-order them after the import.
  • Links to other chapters within the text of the book point to the wrong URL, the hyperlink will need to be manually adjusted or removed.
  • Currently the chapter title generator used during import includes the Book title in every chapter title, this can end up looking cumbersome especially if the book has a very long title, once again this will need to be adjusted manually after import.

ePub document

ePub, short for Electronic Publication is an open standard e-book format, that has the ability to optimise the text display for whichever device is viewing the book. ePub documents can be ready by several different devices, including the Kindle, iPhone, iPad and any Computer with ePub reading Software installed. Booki has the ability to import any document in ePub format.

NOTE: although ePub is an open format, not all books available in ePub format have open licences. Therefore, care needs to be taken when choosing to import an ePub document to ensure that it contains a permissive copyright.

  • Project Gutenberg (http://www.gutenberg.org/) is a good place to start looking for openly licensed books in ePub format. It is an organisation dedicated to making books freely available in forms the vast majority of users, hardware and software can easily read, use, quote and search.

To import an ePub document, first you need to get the url for the ePub book, then copy it's location. Then on your My Books page select Import epub from the Select Import Type drop-down list. Paste the ePub URL into the enter epub URL text box and click on Import.

The text is now imported using Espri and converted into a Booki-zip file (this may take a while). Once the process has finished the imported book will be added to the list of books on your My Books and My Profile pages.

Some Use Cases

Archive.org

You have recently joined the Organic Gardening group and have gone in search for already compiled texts that could be used to bolster the number books available under Organic Gardening. Searching through Archive.org you find a book on gardening from 1847, entitled "The Family Kitchen Gardener" by Robert Buist. Due to it's age, you have a suspicion that it may pre-date all the chemical methods employed by modern conventional gardening and therefore contain natural organic methods for growing edible plants. A brief read confirms this suspicion and also reveals that there are areas of the text that could do with tidying up as well as some updating for the 21st Century, cementing it as a great candidate for importing to Booki.

  1. You navigate to The Family Kitchen Gardener's page on Archive.org (http://www.archive.org/details/RobertBuiststheFamilyKitchenGardener1847);

  2. You scroll down to the bottom of the page where you find the section called Selected metadata.
  3. Here you can see that the Identifier is: RobertBuiststheFamilyKitchenGardener1847. You copy the Identifier and then go to your My Books page on Booki.

  4. Under Import Book, you select Import Archive.org book from the Select Import Type drop-down list and then paste the Identifier into the enter Archive.org ID text box before clicking on Import.

  5. Booki takes a couple of minutes importing the book and when it is finished you see The Family Kitchen Gardener added to the Books list on your My Books page and My Profile page.
  6. You can now click on it's title in the Books list to start reading.

ePub document

After importing The Family Kitchen Gardener you have been looking through Project Gutenberg (www.gutenberg.org) and have found a book entitled "Culinary Herbs: Their Cultivation Harvesting Curing and Uses" by M. G. Kains Originally published in 1912 it contains a lot of information not only around growing herbs, but also ways to treat, store and use them and provides a fantastic base for a book on organically growing herbs.

  1. After loading your My Books page in Booki, you open a new tab or window in your web browser.
  2. In the new Tab/Window you navigate to the home page for Culinary Herbs: Their Cultivation Harvesting Curing and Uses (http://www.gutenberg.org/ebooks/21414)
  3. Once there you scroll down to the Download this ebook for free section of the page. Under the Computer-generated files list you see two epub versions of the book one with pictures and one that is plain text.
  4. Thinking that it would be easier to remove any unneeded or unwanted pictures than to add new ones later on, you decide to import the version with pictures. You right-click on the main site link in the EPUB with images row of the list and click on copy link location (firefox, ...) or... (ie, ...), or... (safari, ...).
  5. Going back to the tab/window containing the My Books page you select Import epub from the Select Import Type drop-down list and paste the copied link into the enter epub URL textbox before clicking on Import .
  6. Booki takes a couple of minutes importing the book and when it is finished you see Culinary Herbs: Their Cultivation Harvesting Curing and Uses listed under Books on you My Books and My Profile pages.
  7. You can now click on the edit link next to it's title in the Books list to start editing the newly imported book.

Wikibooks

Finally while browsing through Wikibooks you spot the Horticulture Textbook. While this book is not specific to organic gardening, organic practices and techniques are presented alongside conventional gardening methods. With some modification this could be a really good overview to organic gardening as a whole and you decide to import the textbook.

  1. You navigate to Wikibooks (http://en.wikibooks.org) type Horticulture into the search box and click on Search. This takes you directly to the home page for the Horticulture textbook.
  2. You select the entire URL for the Horticulture textbook in the Address Bar and copy it. In the case the URL is http://en.wikibooks.org/wiki/Horticulture.
  3. You now login to Booki and navigate to your My Books page.
  4. At the bottom of the page under Import Book you click on the drop-down arrow next to Select Import Type and select Import Wikibook.
  5. Now you paste the copied URL into the enter Wikibooks URL text box and click on Create.
  6. Booki takes several minutes importing the textbook and when it finishes, Horticulture is added to the list of books on your My Books page.
  7. You can now click on its title to read through the newly imported book or click on the edit link at the end of the title to start making changes to the book.