BookReader is a plugin for Omeka that adds Internet Archive BookReader. The IA BookReader is used to view books from the Internet Archive online and can also be used to view other books.
So you can create online flip book from image files constituting an item or from files listed in a gDoc spreadsheet.
See demo of the embedded version of Mines ParisTech or in fullscreen mode with highlighted results of a search in the OCR text (Université Rennes 2).
For the spreasheet use, see gDoc explanation. The javascript included comes from BookReader spreadsheet via Dušan Ranđelović fork. Main benefit is that item doesn't need to have all pages/images uploaded to Omeka and that there is no need for composit PDF, so presentation is completely parted from metadata.
BookReader_Creator_Default)If you want to change more options, copy the file views/public/viewer/show.php
in the subdirectory book-reader/viewer/of your theme and update it.
See below the notes for more info.
The viewer is always available at http://www.example.com/items/viewer/{item id}.
Furthermore, it is automatically embedded in items/show page. This can be
disabled in the config of the plugin.
The url for the default page items/viewer/:id can be replaced by the old one
viewer/show/:id or any other url via the file routes.ini.
To embed the BookReader with more control, three mechanisms are provided. So,
according to your needs, you may add this code in the items/show.php file of
your theme or anywhere else, as long as the item is defined (as variable or as
current record 'item').
echo $this->getBookReader();[bookreader].<?php echo $this->shortcodes('[bookreader]'); ?> <?php
echo $this->shortcodes('[bookreader item=1 page=0 embed_functions=0 mode_page=1]');
?> <?php
echo get_specific_plugin_hook_output('BookReader', 'public_items_show', array(
'direct' => true,
'view' => $this,
'item' => $item,
'page' => '0',
'embed_functions' => false,
'mode_page' => 1,
));
?>All options are optional. If one is not defined, the parameters set in the config page will be used. The image number starts from '0' with default functions.
Warning
PHP should be installed with the extension "exif" in order to get the size of images. This is the case for all major distributions and providers.
If technical metadata are missing for some images, in particular when the extension "exif" is not installed or when images are not fully compliant with the standards, they should be rebuilt. A notice is added in the error log. A form in the batch edit can be used to process them automatically: check the items in the "admin/items/browse" view, then click the button "Edit", then the checkbox "Rebuild metadata when missing". The viewer will work without these metadata, but the display will be slower.
There are several ways to store data about items in Omeka, so the BookReader can
be customized via a class that extends BookReader_Creator.
BookReader uses several arrays to get images and infos about them. Take a document of twelve pages as an example. In Javascript, we have these arrays:
With the default files of BookReader, all images of an item are displayed, so the leafMap indexes are always a simple list of numbers like above (starting from 0 when the first page is a right page, else from 1). Page numbers and/or page labels can be empty, so in that case the index is used. When the user leafs through the document, the viewer sends a request with index + 1 as image parameter. So the controller can send the index - 1 to select image in the ordered list of images files.
Some functions of php are used to make relation with this index and to provide
images. They are used in the beginning and via Ajax. During creation of the
viewer, php should provide mapping, numbers and labels via BookReader custom
functions (getPageIndexes(), getPageNumbers() and getPageLabels()). These
functions use one main method, getLeaves(), that provides the ordered
list of all images that should be displayed as leaves (saved by default as a
static variable in php). This list is used too to get the selected image when
needed via the index. The getNonLeaves() method is used to get links to other
files to share. So,The list of leaves files is a simple array as [File 1, File 2, File 3, File 4...].
In case of a non-digitalized blank or forgotten page, in order to keep the
left/right succession of leafs, the mapping and the page numbers and labels
should be the same, and the list of leaves files should be [File 1, null, File 3, File 4...].
The transparent.png image will be displayed if an image is missing, with the
width and the height of the first page.
In case of multiple files for the same page, for example with a pop-up or with and without a tracing paper, the mapping can be: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 9, 12, 11]. Other arrays should be set in accordance: number of pages as [,, "i", "ii", "iii", "iv", 1, 2, 3, 4, 5, 4, 5,], labels as ["Cover", "Blank",,,,, "Page 1 (unnumbered)",,,, "Page 5 with tracing paper", "Back cover"] and files as [File 1, null, File 3, File 4..., File 10, File 11a, File 10, File 11b, File 12]. Any other arrangements can be used.
To avoid to calculate these data each time an item is displayed, it's
recommanded to save them either in a xml file, or in the database. It's
specially important for widths and heights data, as all of them should be got
before first display.
A batch can be launched in the admin/items/show page if needed. The function
saveData() should be customized to your needs. Of course, other functions
should check if these data are available and use them. This function can be used
too the first time a viewer is displayed for an item.
To test it, create an item with this value in Dublin Core : Relation:
https://spreadsheets.google.com/feeds/list/0Ag7PrlWT3aWadDdVODJLVUs0a1AtUVlUWlhnXzdwcGc/od6/public/values.
This is the public Atom feed of a Google Spreadsheet with five columns. These
columns are image, height, width,num and label. Only the first one,
that is the url to the image, is required. See gDoc explanation for more info.
Then go to http://example.org/items/view/{item id}.
Remarks:
The extract ocr and pdfToc plugins are highly recommended.
See online issues on the plugin issues page on GitHub.
This plugin is published under GNU/GPL.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
See developer documentation on Internet Archive BookReader and source of IA BookReader on GitHub.
Current maintainers:
First version has been built by Julien Sicot for Université Rennes 2. The upgrade for Omeka 2.0 has been built for Mines ParisTech.
The source code of Internet Archive BookReader is licensed under AGPL v3, as described in the LICENSE file.
BookReader Omeka plugin:
BookReader Spreadsheet: