=== PressBooks === |
| |
| Contributors: PressBooks <code@pressbooks.com> |
| Version: 2.2.0 |
| Tags: ebooks, publishing, webbooks |
| Requires at least: WordPress 3.5.2 |
| Tested up to: WordPress 3.5.2 |
| Stable tag: trunk |
| License: GPLv2 or later |
| License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| |
| == Description == |
| |
| PressBooks is an open source book publishing tool built on a WordPress multisite platform. PressBooks outputs books in |
| multiple formats, including PDF EPUB/MOBI, web, and a variety of XML flavours, using a theming/templating system, |
| driven by CSS. For more information, visit http://pressbooks.com. |
| |
| == Maintenance and Support == |
| |
| Contact us about maintenance and support contracts if you are installing PressBooks on your own servers, or if you would |
| like PressBooks to run a dedicated instance for you on our servers. You can reach us at: support@pressbooks.com. |
| |
| == Communication == |
| |
| Our main communication channels is [Google Groups](http://groups.google.com/group/pressbooks). |
| |
| == Contributors == |
| |
| All PressBooks code is copyright Book Oven Inc. Contributors are acknowledged in the “docs/contributors.txt” file, not |
| in source code headers. |
| |
| == Installation == |
| |
| IMPORTANT! |
| |
| * Do not install PressBooks on an existing WordPress blog — create a new WordPress install instead. |
| * PressBooks works with PHP 5.4.x and WordPress 3.5.2. Lower versions are not supported. |
| |
| *Part 1, WordPress generic:* |
| |
| 1. Install WordPress using the [Famous 5-Minute Install](http://codex.wordpress.org/Installing_WordPress). |
| |
| 2. [Create a Network](http://codex.wordpress.org/Create_A_Network) of WordPress sites, i.e.: |
| |
| 3. Edit the wp-config.php file and add the following: |
| |
| `define(‘WP_ALLOW_MULTISITE’, true);` |
| |
| 4. Login to the WordPress admin area. Navigate to Tools → Network Setup, click Install. |
| |
| 5. Complete the steps printed on the screen (i.e. edit your `wp-config.php` and `.htaccess files` with the information |
| provided.) |
| |
| *Part 2, PressBooks specific:* |
| |
| 1. Copy/move PressBooks plugin files to: __PATH_TO_YOUR_SITE__/wp-content/plugins/pressbooks/*. |
| |
| 2. Log out, log in, navigate to: My Sites → Network Admin → Dashboard. |
| |
| 3. Navigate to: Plugins → Installed Plugins. |
| |
| 4. Network Enable “PressBooks.” |
| |
| 5. Navigate to: Themes → Installed Themes. |
| |
| 6. Network Enable “Luther”, “Clarke”, “Donham”, “Fitzgerald”, “Austen”, “PressBooks Publisher One”, and any other |
| PressBooks theme you want to use. |
| |
| 7. Navigate to: Settings → Network Settings. |
| |
| 8. Pick the most appropriate Registration Setting: |
| + User accounts may be registered. (do not use this setting, since it will not allow users to create new books) |
| + Logged in users may register new sites. (if you are a publisher using PressBooks as a production tool, this is the |
| best setting: it allows network administrators to add new users, who can then create books/sites. However, |
| registration is not available to the public.) |
| + Both sites and user accounts can be registered. (use this setting if you intend on offering a publishing-platform |
| open to the public, such as PressBooks.com) |
| |
| 9. Navigate to: My Books → __YOUR_SITE__ → Dashboard |
| |
| 10. Navigate to: Appearance. Activate “PressBooks Publisher One” |
| |
| 11. Navigate to: My Books → Network Admin → Sites |
| |
| 12. Add a new site (this will be your first book). |
| |
| 13. Navigate to: My Books → __YOUR_FIRST_BOOK__ |
| |
| 14. Navigate to: Book Information. Make sure to fill out Title, Author and Publication Date. |
| |
| 15. Navigate to: Text → Organize. Make sure some content is selected for export. |
| |
| *Part 3, PressBooks dependencies:* |
| |
| * For PDF export install [Prince](http://pressbooks.com/prince) (note: this is not free software) – Version 9.0 |
| * For MOBI export install [KindleGen](http://www.amazon.com/gp/feature.html?docId=1000765211) – Version 2.9 |
| * For EPUB validation install [EpubCheck](http://code.google.com/p/epubcheck/) – Version 3.0.1 |
| * Form XML validation install [xmllint](http://xmlsoft.org/xmllint.html) – Version 20800 |
| |
| Unlisted versions are not supported. Upgrade/downgrade accordingly. |
| |
| Once installed, define the following wp-config.php variables. The defaults are: |
| |
| define( ‘PB_PRINCE_COMMAND’, ‘/usr/bin/prince’ ); |
| define( ‘PB_KINDLEGEN_COMMAND’, ‘/opt/kindlegen/kindlegen’ ); |
| define( ‘PB_EPUBCHECK_COMMAND’, ‘/usr/bin/java -jar /opt/epubcheck/epubcheck.jar’ ); |
| define( ‘PB_XMLLINT_COMMAND’, ‘/usr/bin/xmllint’ ); |
| |
| |
| Example config files for a dev site hosted at http://localhost/~dac514/textopress/ |
| |
| ### wp-config.php file [snippet]: ### |
| |
| /** |
| * For developers: WordPress debugging mode. |
| * |
| * Change this to true to enable the display of notices during development. |
| * It is strongly recommended that plugin and theme developers use WP_DEBUG |
| * in their development environments. |
| */ |
| define(‘WP_DEBUG’, true); |
| define(‘WP_DEBUG_LOG’, true); |
| |
| /** |
| * Multi-site support, Part 1 |
| */ |
| define(‘WP_ALLOW_MULTISITE’, true); |
| |
| /** |
| * Multi-site support, Part 2 |
| */ |
| define(‘MULTISITE’, true); |
| define(‘SUBDOMAIN_INSTALL’, false); |
| $base = ‘/~dac514/textopress/’; |
| define(‘DOMAIN_CURRENT_SITE’, ‘localhost’); |
| define(‘PATH_CURRENT_SITE’, ‘/~dac514/textopress/’); |
| define(‘SITE_ID_CURRENT_SITE’, 1); |
| define(‘BLOG_ID_CURRENT_SITE’, 1); |
| |
| /** |
| * PressBooks |
| */ |
| define( ‘PB_PRINCE_COMMAND’, ‘/usr/bin/prince’ ); |
| define( ‘PB_KINDLEGEN_COMMAND’, ‘/home/dac514/bin/kindlegen’ ); |
| define( ‘PB_EPUBCHECK_COMMAND’, ‘/usr/bin/java -jar /home/dac514/bin/epubcheck-3.0-RC-1/epubcheck-3.0-RC-1.jar’ ); |
| define( ‘PB_XMLLINT_COMMAND’, ‘/usr/bin/xmllint’ ); |
| |
| /** |
| * Optional definitions |
| */ |
| // define( ‘WP_POST_REVISIONS’, 5 ); // Limit post revisions: int or false |
| // define( ‘EMPTY_TRASH_DAYS’, 1 ); // Purge trash interval |
| // define( ‘AUTOSAVE_INTERVAL’, 60 ); // Autosave every N seconds |
| |
| /* That’s all, stop editing! Happy blogging. */ |
| |
| |
| ### .htaccess file: ### |
| |
| RewriteEngine On |
| RewriteBase /~dac514/textopress/ |
| RewriteRule ^index\.php$ – [L] |
| |
| # add a trailing slash to /wp-admin |
| RewriteRule ^([_0-9a-zA-Z-]+/)?wp-admin$ $1wp-admin/ [R=301,L] |
| |
| RewriteCond %{REQUEST_FILENAME} -f [OR] |
| RewriteCond %{REQUEST_FILENAME} -d |
| RewriteRule ^ – [L] |
| RewriteRule ^[_0-9a-zA-Z-]+/(wp-(content|admin|includes).*) $1 [L] |
| RewriteRule ^[_0-9a-zA-Z-]+/(.*\.php)$ $1 [L] |
| RewriteRule . index.php [L] |
| |
| == Frequently Asked Questions == |
| |
| TK. |
| |
| == Screenshots == |
| |
| 1. Your Book |
| 2. Book Information |
| 3. Themes |
| 4. Theme Options |
| 5. Export |
| 6. Catalog |
| |
| == Upgrade Notice == |
| |
| TK. |
| |
| == Changelog == |
| |
| See: https://github.com/pressbooks/pressbooks/commits/master |