17 Tools

You can find Tools on the left sidebar menu of Pressbooks. In this chapter, we’ll explain how to use the following tools:

Import

Use the import tool to bring your book into Pressbooks in just a few clicks. You can import content from any of the following sources:

  • EPUB (.epub)
  • Word document (.docx)
  • OpenOffice (.odt)
  • Pressbooks/WordPress XML (.xml or .wxr)
  • Web page (.html or URL)

Follow these steps to import a file into Pressbooks:

  1. Navigate to Tools > Import from the left sidebar menu
  2. Select the type of file you’re importing from the “Import Type” menu
  3. Choose “Import Source” Upload File
  4. Click “Choose File” and select the file from your computer that you would like to import
  5. Click Begin ImportThe Import Tool page

You’ll be brought to page where overview the individual posts in the file you’ve chosen to import. You will need to select each chapter you’d like to import by checking the box in the left column of the table. Select all posts at once by clicking the checkbox in the top row of the table. The checkboxes on the left side of the import table

You can choose whether each post is imported as a front matter, chapter, part, back matter, or glossary post.

Select what type of post a section is imported as

Importing specific files may take additional steps. Consult the following chapters for further help:

Search & Replace

Search and Replace lets you search for a word, code, or phrase throughout your entire book. You can then choose to replace all instances of the searched content throughout your book at once. Please note that this feature is currently in beta and may not function perfectly.

The search and replace form

To use the Search & Replace tool, follow these steps:

  1. Navigate to Tools > Search & Replace from the left sidebar menu of your book’s dashboard
  2. Enter the word or phrase you wish to search for in the “Search For” input field
  3. Enter the word or phrase you wish to replace that content with in the “Replace With” textbox (NOTE: leaving this section blank is also an option if you’d like to simply delete the content)
  4. Click “Preview Replacements” to review where the searched content appears in your book
  5. Click “Replace & Save” to replace all instances of the searched content throughout your book
NOTE: ALL instances of the searched content will be replaced if you click “Replace & Save”. There is no instant way to undo a global search and replace. However, you can always revert to the most recent version of each chapter using the revision history.
Clicking “Preview Replacements” allows you to see a side-by-side presentation of the searched word or phrase and how it will look once it’s replaced.
An example of a search and replace preview

Tips

  • The search is case sensitive. This means that in order to ensure that you find every instance of a word, you may need to run a search and replace several times (once all lower case, once with the first letter capitalized and once in all caps).
  • Every instance of your search term will be found, even if it is part of another word. For example, searching for “he said” will also highlight part of “she said“, or searching for “book” would also highlight part of “Pressbooks” and change it just the same (see screenshot below).
  • If you’re searching for something that appears very frequently in your book, the Search & Replace tool may fail. In this case, we recommend copying the textual content into a text editor such as Word or Notepad++ to remove and change the text

License

Icon for the Creative Commons Attribution 4.0 International License

Pressbooks User Guide by Book Oven Inc. (Pressbooks.com) is licensed under a Creative Commons Attribution 4.0 International License, except where otherwise noted.