WordPress.org

Plugin Directory

Pressbooks

Simple Book Production

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 4.3. Lower versions are not supported.

Part 1, WordPress generic:

  1. Install WordPress using the Famous 5-Minute Install.

  2. 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 (note: this is not free software) - Version 9.0
  • For PDF export via mPDF ensure that the following folders have write access and/or they are owned by the appropriate user.See http://codex.wordpress.org/Changing_File_Permissions for more details on adjusting file permissions.
    • wp-content/plugins/pressbooks/symbionts/mpdf/ttfontdata
    • wp-content/plugins/pressbooks/symbionts/mpdf/tmp
    • wp-content/plugins/pressbooks/symbionts/mpdf/graph_cache
  • For MOBI export install KindleGen - Version 2.9
  • For EPUB validation install EpubCheck - Version 3.0.1
  • For XML validation install xmllint - Version 20800
  • Certain Linux installations do not ship with the php5-xsl library enabled by default. If you attempt to export an ePub and get a either a white screen with minimal text, or a "Fatal error: Class 'XSLTProcessor' not found" error, you may need to run a command like "apt-get install php5-xsl"

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]

Requires: 4.3 or higher
Compatible up to: 4.3
Last Updated: 2015-9-2
Active Installs: 90+

Ratings

5 out of 5 stars

Support

1 of 1 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,1,1
0,1,0 100,1,1