"

Contents

    1. Why Use Pressbooks?
    2. About This Guide
    1. Create Your Book
    2. Add Your Book Information
    3. Add and Organize Your Text
    4. Choose Your Book Theme
    5. Export Your Book
  1. Manage Your Account
      1. Register Your Account
      2. Register Your First Book
      1. Subscribe to Your Book
      2. What’s Included in Your Subscription
      3. Premium Support
      4. Update Payment Information
      5. Cancel a Subscription
      1. Changing Your Password When You Can’t Log In
      2. Changing Your Password When You’re Already Logged In
      1. Personal Options
      2. Name
      3. Contact Info
      4. About Yourself
      5. Account Management
      1. Navigating the Organize Menu
      2. Adding a new section
      3. Editing, Viewing, and Reordering Sections
      4. Book Privacy and Exporting
      5. Related Chapters
      1. General Book Information
      2. Cover Image
      3. Subject
      4. Copyright
      5. About the Book
      6. Additional Catalog Information
      7. Book-level Contributors
      1. Selecting Your Book Theme
      2. Theme Options
      3. elements) will be added as chapter subsections in the webbook’s table of contents. [caption id="attachment_83" align="alignnone" width="931"] A sample two-level Table of Contents. Each of the sub-sections corresponds to a top-level heading element inside of a chapter.[/caption] About the Author: When selected, an ‘About the Author’ section will be displayed at the end of the content for all front/back matter or chapters which have authors assigned in Chapter Metadata. This section will display the ‘Contributor Information’ for each of author in the webbook and export files. Learn more about displaying chapter-level contributors. Media Attributions: Display media attributions at the end of any chapter that contains media with attribution metadata. This setting is helpful for users who are including openly licensed images in their projects. [caption id="attachment_83" align="alignnone" width="745"] A sample media attribution for a photograph from Unsplash[/caption] Language & Script Support: Add support for additional languages and scripts which use non-Latin characters. Click here for a list of supported scripts. Chapter Licenses: Choose whether to display chapter licenses on the table of contents, at the end of a chapter, or not at all. Note that this will only affect export formats, and only if the book contains chapters with separate licenses than the overall book license. Click here to learn more about chapter licenses. Education-themed Textboxes: Customize the header color, header background color, and textbox background color for education-themed textboxes, including Examples, Key Takeaways, Learning Objectives, and Exercises.  Web Options Web Options are settings that will only affect the display of your webbook. Below are the current Web Options available on updated themes. Header Font: Change the theme’s default header font to one from an available list of open-source typefaces. Both serif and sans serif fonts are available. Body Font: Change the theme’s default body font to one from an available list of open-source typefaces. Both serif and sans serif fonts are available. Social Media Options: Include an X (formerly Twitter), LinkedIn, and/or email icon to your webbook’s homepage and each chapter to allow readers to quickly and easily share a link to your book through X, LinkedIn, or in an email. Webbook Width: Choose the default column width of your webbook. Options include Narrow, Standard, and Wide. Paragraph Separation: Decide whether paragraphs in the webbook are indented or separated by skipped lines. Webbooks default to the “skip lines” paragraph separation setting for optimal digital reading, but can be changed. Display Part Title: Add the Part Title to the Chapter Title at the top of each chapter. Collapse Sections: Create collapsed sections in individual webbook chapters to make long chapters easier to navigate. When active, all top-level headings (Heading 1 or elements) will become collapsible and explandable subsections in your webbook. Enable Image Lightbox: Allow readers to view linked images more easily by turning on the Lightbox feature. When enabled, all linked images will be displayed within an unobtrusive lightbox when opened. PDF Options PDF Options will affect your print and digital PDF exports and include the following: Header Font: Change the theme’s default header font to one from an available list of open-source typefaces. Both serif and sans serif fonts are available. Body Font: Change the theme’s default body font to one from an available list of open-source typefaces. Both serif and sans serif fonts are available. Body Font Size: Choose the size of the body text in your print book as a point value. Most other elements in your book are proportional to the body font size and will change accordingly. The default font size may differ depending on the theme you have chosen. Body Line Height: Choose the line height as an em value. Line height is the amount of space between lines of text in a paragraph. The default line height may differ depending on the theme you have chosen, but is generally around 1.4em. Page Size: Choose from an array of available default sizes for your print book, or select your own size by choosing “Custom” from the Page Size dropdown menu. Once you select “Custom,” Page Height and Width options will appear, and you can insert your custom page size, expressed in a CSS-compatible unit (like inches or centimeters). The default page size is Digest, or 5.5″ by 8.5″. Margins: Set the size of your top, bottom, inside, and outside margins. Choose a value that’s expressed in a CSS-compatible units (like inches or centimeters). (NOTE: Print-on-demand services generally require that margins are at least 2 cm on all sides). The default size of all margins is 2 cm. Hyphens: Enable or disable hyphenation of words at the end of lines throughout your book. If you choose to disable hyphenation, justified text may include larger gaps or spaces between words, especially in books with shorter line lengths. Paragraph Separation: Decide whether paragraphs in exported PDF files are indented or separated by skipped lines. PDFs default to the “indented paragraphs” separation setting. Section Openings: Choose what side of your book a chapter will open on, with options including left or right page section openings, right page section openings only, and no blank pages. Note that if the right page section opening options is chosen, then the preceding page will be blank if there is not enough content from the previous chapter to fill it. Table of Contents: Choose to disable the automatically generated table of contents in your print book. The table of contents cannot be disabled in digital PDF exports, because a Table of Contents is needed for accessibility and navigation purposes in digital documents. Crop Marks: If your print distributor requires that your interior files contain crop marks, enable the crop mark setting. Footnote Style: Choose whether footnotes display at the bottom of the page the footnote appears on or at the end of the chapter as endnotes in your PDF exports. Widows and Orphans: Choose how many lines isolated at the top of the page constitute a [pb_glossary id="416"]widow[/pb_glossary], and how many lines at the bottom of a paragraph constitute an [pb_glossary id="415"]orphan[/pb_glossary]. Pressbooks will attempt to adjust the flow of your content to avoid creating widows and orphans based on your specifications. Running Heads and Feet: Running heads and feet are the content that appear in the top or bottom margins of every page in the book. You can choose the specific running content for the left and right page of the following sections of your book: front matter, introduction, part, chapter, and back matter. You can choose from various options that are already in your book’s metadata, including: book title, book subtitle, book author, part number, part title, section title, section author, section subtitle, blank, or custom. If you choose “custom”, whatever text you insert into the text cell will appear in the running content for the correlating section. Ebook Options Header Font: Change the theme’s default header font to any one of a variety of open-source serif and sans serif typefaces. Body Font: Change the theme’s body header font to any one of a variety of open-source serif and sans serif typefaces. Ebook Start Point: Choose a page that your ebook will open to for readers. By default, the ebook opens to the title page. Note that not all e-reader platforms will respect this start point. Paragraph Separation: Decide whether paragraphs in exported EPUB files are indented or separated by skipped lines. Ebooks default to the “indented paragraphs” separation setting to mimic the traditional design of a print book, but can be changed. Compress Images: Reduce the size and quality of images in your ebook. Generally those who enable this setting are creating a print book and ebook simultaneously and have uploaded large, high-resolution images for their print books. Reducing the quality and size of media for your ebook exports will reduce the overall file size of your EPUB files and may reduce your publication costs as some ebook distributors change additional fees for distributing larger ebook files. Custom Styles If you want to change your book’s appearance in ways that aren’t included in existing theme options, you can use the Custom Styles feature to apply CSS (Cascading Style Sheet) rules to your webbook, ebook, and/or PDF exports. You can view and edit the Custom CSS applied to your book by clicking Appearance > Custom Styles in your book dashboard menu. Custom styles allows you to edit three separate stylesheets for your book: Web, Ebook, and PDF. Select the stylesheet that you would like to edit from the dropdown menu at the top of the page. The first section of the page includes a scrolling box that contains the entire stylesheet from your active theme for that format. Beneath this section is a input box where you can enter any desired additions to the stylesheet for that particular format (web, ebook, or PDF). Any CSS added in this section will override existing styles for your theme. You can restore an previously saved version of your Custom CSS by clicking the hyperlinked time stamp in the Revisions section. For more information on custom styles, see our chapter on Custom Styles.
      4. elements) will become collapsible and explandable subsections in your webbook. Enable Image Lightbox: Allow readers to view linked images more easily by turning on the Lightbox feature. When enabled, all linked images will be displayed within an unobtrusive lightbox when opened. PDF Options PDF Options will affect your print and digital PDF exports and include the following: Header Font: Change the theme’s default header font to one from an available list of open-source typefaces. Both serif and sans serif fonts are available. Body Font: Change the theme’s default body font to one from an available list of open-source typefaces. Both serif and sans serif fonts are available. Body Font Size: Choose the size of the body text in your print book as a point value. Most other elements in your book are proportional to the body font size and will change accordingly. The default font size may differ depending on the theme you have chosen. Body Line Height: Choose the line height as an em value. Line height is the amount of space between lines of text in a paragraph. The default line height may differ depending on the theme you have chosen, but is generally around 1.4em. Page Size: Choose from an array of available default sizes for your print book, or select your own size by choosing “Custom” from the Page Size dropdown menu. Once you select “Custom,” Page Height and Width options will appear, and you can insert your custom page size, expressed in a CSS-compatible unit (like inches or centimeters). The default page size is Digest, or 5.5″ by 8.5″. Margins: Set the size of your top, bottom, inside, and outside margins. Choose a value that’s expressed in a CSS-compatible units (like inches or centimeters). (NOTE: Print-on-demand services generally require that margins are at least 2 cm on all sides). The default size of all margins is 2 cm. Hyphens: Enable or disable hyphenation of words at the end of lines throughout your book. If you choose to disable hyphenation, justified text may include larger gaps or spaces between words, especially in books with shorter line lengths. Paragraph Separation: Decide whether paragraphs in exported PDF files are indented or separated by skipped lines. PDFs default to the “indented paragraphs” separation setting. Section Openings: Choose what side of your book a chapter will open on, with options including left or right page section openings, right page section openings only, and no blank pages. Note that if the right page section opening options is chosen, then the preceding page will be blank if there is not enough content from the previous chapter to fill it. Table of Contents: Choose to disable the automatically generated table of contents in your print book. The table of contents cannot be disabled in digital PDF exports, because a Table of Contents is needed for accessibility and navigation purposes in digital documents. Crop Marks: If your print distributor requires that your interior files contain crop marks, enable the crop mark setting. Footnote Style: Choose whether footnotes display at the bottom of the page the footnote appears on or at the end of the chapter as endnotes in your PDF exports. Widows and Orphans: Choose how many lines isolated at the top of the page constitute a [pb_glossary id="416"]widow[/pb_glossary], and how many lines at the bottom of a paragraph constitute an [pb_glossary id="415"]orphan[/pb_glossary]. Pressbooks will attempt to adjust the flow of your content to avoid creating widows and orphans based on your specifications. Running Heads and Feet: Running heads and feet are the content that appear in the top or bottom margins of every page in the book. You can choose the specific running content for the left and right page of the following sections of your book: front matter, introduction, part, chapter, and back matter. You can choose from various options that are already in your book’s metadata, including: book title, book subtitle, book author, part number, part title, section title, section author, section subtitle, blank, or custom. If you choose “custom”, whatever text you insert into the text cell will appear in the running content for the correlating section. Ebook Options Header Font: Change the theme’s default header font to any one of a variety of open-source serif and sans serif typefaces. Body Font: Change the theme’s body header font to any one of a variety of open-source serif and sans serif typefaces. Ebook Start Point: Choose a page that your ebook will open to for readers. By default, the ebook opens to the title page. Note that not all e-reader platforms will respect this start point. Paragraph Separation: Decide whether paragraphs in exported EPUB files are indented or separated by skipped lines. Ebooks default to the “indented paragraphs” separation setting to mimic the traditional design of a print book, but can be changed. Compress Images: Reduce the size and quality of images in your ebook. Generally those who enable this setting are creating a print book and ebook simultaneously and have uploaded large, high-resolution images for their print books. Reducing the quality and size of media for your ebook exports will reduce the overall file size of your EPUB files and may reduce your publication costs as some ebook distributors change additional fees for distributing larger ebook files. Custom Styles If you want to change your book’s appearance in ways that aren’t included in existing theme options, you can use the Custom Styles feature to apply CSS (Cascading Style Sheet) rules to your webbook, ebook, and/or PDF exports. You can view and edit the Custom CSS applied to your book by clicking Appearance > Custom Styles in your book dashboard menu. Custom styles allows you to edit three separate stylesheets for your book: Web, Ebook, and PDF. Select the stylesheet that you would like to edit from the dropdown menu at the top of the page. The first section of the page includes a scrolling box that contains the entire stylesheet from your active theme for that format. Beneath this section is a input box where you can enter any desired additions to the stylesheet for that particular format (web, ebook, or PDF). Any CSS added in this section will override existing styles for your theme. You can restore an previously saved version of your Custom CSS by clicking the hyperlinked time stamp in the Revisions section. For more information on custom styles, see our chapter on Custom Styles.
      5. Custom Styles
      1. Select Content for Export
      2. Export Your Book Files
      3. Export your Book as as Pressbooks XML file
      4. Export Your Book as a Common Cartridge File
      5. Viewing Your Latest Exports
      6. Distributing Your Exported Files on the Web
      1. View your Book’s Media
      2. Add Media to your Media Library
      3. Add Details to your Media
      4. Edit an Image
      5. Delete media
      1. Adding Users and Assigning Permissions
      2. Managing Users and Changing Permissions
      3. User Roles in Pressbooks
      1. Change the Visibility of Your Book
      2. Change the Visibility of Private Content
      3. Enable Comments
      4. Share Latest Export Files
      5. Pressbooks Directory
      6. Export
      7. File Settings
      8. Hypothesis
      9. H5P
      10. MathJax or QuickLaTeX
      11. Akismet Anti-Spam
      1. What is the Catalog?
      2. Using the Catalog
      3. Customizing your Catalog Profile
  2. Make Your Book
      1. How a Webbook is Made
      2. The Webbook Homepage
      3. The Pressbooks Reading Interface
      4. Webbook Interactivity – Pressbooks
      5. Why Create a Webbook?
      1. Write Your Book Directly in Pressbooks
      2. Copy and Paste from Another Source
      3. Import from a Word Document
      4. Import from a Pressbooks XML file
      1. Search the Directory
      2. Filter Directory Results
      3. Book Cards
      1. Clone a Book
      2. Understand Cloning Error Messages
      3. What Content is Cloned
      1. Add New Front Matter
      2. Delete Front Matter
      3. Edit Front Matter
      4. Apply Front Matter Types
      5. Understand Front Matter Order in Exports
      1. Add a New Part
      2. Delete a Part
      3. Edit or Rename a Part
      4. Make a Part ‘Invisible’
      5. Changing the Part Label
      1. Add a Chapter
      2. Delete a Chapter
      3. Edit a Chapter:
      4. Chapter Types
      5. Status & Visibility Settings
      6. Using the Visual and Text Editors
      7. View, Compare, and Restore Revisions
      8. Chapter Metadata
      9. Owners
      10. Edit Chapter URL
      11. Discussion and Comments
      12. Changing the Chapter Label
      1. Add New Back Matter
      2. Delete Back Matter
      3. Edit Back Matter
      4. Back Matter Types
      5. Understand Display Order in Export Files
      6. Indexes and Notes
      1. Global Privacy Settings
      2. Chapter-level Privacy Settings
      1. Display Uploaded Media in Your Book
      2. Embed Content via oEmbed
      3. Embed iframes
      4. Insert H5P Activities
      5. Embedded Media in Exports
      1. Edit Image Details
      2. Crop, Rotate, or Scale an Image
      3. Replace an Image in One Location
      4. Replace an Image Globally
      1. Accessing the Contributors page
      2. Creating a New Contributor
      3. Contributor List
      4. Displaying Contributor Information
      1. Create a New Glossary Term
      2. Link to an Existing Term
      3. Create a Glossary List
      1. Add Footnotes
      2. Choose Where To Display Footnotes in PDF Exports
      3. Convert Footnotes from Imported Documents
      1. Enable Hypothesis in Your Book
      1. Activate H5P for your Book
      2. Create H5P Activities
      3. Import H5P Activities
      4. Add H5P Activities to a Chapter
      5. View All H5P Activities in Your Book
      6. Watch a Video
      1. Headings and subheadings
      2. Code
      3. Email
      4. Equation/Latex
      5. Blockquote
      6. Footnote
      7. Anchor
      8. Textbox
      9. Columns
      10. Media
      11. Captions
      12. Apply Custom Classes
      13. Nesting Shortcodes
      1. Publish Accessible Content
      2. Use Accessibility Features Provided By Pressbooks
      3. Help Translate Pressbooks
      1. Remove Unwanted Span Elements
      2. Heading Styles
      3. or  or tags, not or tags. Headings should be nested as subsections to reflect the organization of the content of the page. Good: The Background A long, long time ago, in a galaxy far, far away, there lived a fine young man unaware of various things about his past, including: the Force, what his father was up to, how to use a lightsaber. All that, however, was about to change. Three things were about to happen: he would discover the Force, he would learn how to use a lightsaber, and he would meet his father. The Update Long after this fellow lived, a famous movie was made about his life. The movie was shot in Tunisia. Bad: The Background A long, long time ago, in a galaxy far, far away, there lived a fine young man unaware of various things about his past, including: the Force, what his father was up to, how to use a lightsaber. All that, however, was about to change. Three things were about to happen: he would discover the Force, he would learn how to use a lightsaber, and he would meet his father. The Update Long after this fellow lived, a famous movie was made about his life. The movie was shot in Tunisia. Blockquotes  (and ) Things like letters, poems, long quotations should be wrapped in text text. Visionary feminism is a wise and loving politics. It is rooted in the love of male and female being, refusing to privilege one over the other. The soul of feminist politics is the commitment to ending patriarchal domination of women and men, girls and boys. Love cannot exist in any relationship that is based on domination and coercion. This will give you something like: Visionary feminism is a wise and loving politics. It is rooted in the love of male and female being, refusing to privilege one over the other. The soul of feminist politics is the commitment to ending patriarchal domination of women and men, girls and boys. Love cannot exist in any relationship that is based on domination and coercion.[footnote]From bell hooks' The Will to Change: Men, Masculinity and Love[/footnote] Non-indented Paragraphs Pressbooks will automatically indent paragraphs correctly, and NOT indent them correctly as well (for instance, after Chapter Titles, and headings throughout a chapter). Sometimes you want to explicitly specify that certain paragraphs should not be indented, as in the example below: Hamlet. But what is your affair in Elsinore? … Horatio. My lord, I came to see your father’s funeral. Hamlet. I pray thee, do not mock me, fellow-student; I think it was to see my mother’s wedding. You can do the above in the VISUAL editor by selecting the paragraphs you want not indented, then selecting No Indent from the ‘Formats’ dropdown. Lists (Bulleted and Numbered) Make sure lists are proper lists, so … Bullet/Unordered Lists item 1 item 2 Which will give you: item 1 item 2 Numbered/Ordered Lists item 1 item 2 Which will give you: item 1 item 2
      4. Blockquotes  (and )
      5. Non-indented Paragraphs
      6. Lists (Bulleted and Numbered)
      1. Improving Directory Metadata
      1. Set Your Book’s Language
      2. Add Language & Script Support
      1. To restore Trashed Content
      2. To Permanently Delete Content
      1. Use the Visual Editor
      2. Use the Text Editor
      3. HTML Basics
      4. , , … Here is an extended version of the text from above with more HTML tags: The Background A long, long time ago, in a galaxy far, far away, there lived a fine young man unaware of various things about his past, including: the Force what his father was up to how to use a lightsaber. All that, however, was about to change. Three things were about to happen: he would discover the Force he would learn how to use a lightsaber, and he would meet his father. The Update Long after this fellow lived, a famous movie was made about his life. The movie was shot in Tunisia. Here is that text with markup: The Background A long, long time ago, in a galaxy far, far away, there lived a fine young man unaware of various things about his past, including: the Force what his father was up to how to use a lightsaber. All that, however, was about to change.  Three things were about to happen: he would discover the Force he would learn how to use a lightsaber, and he would meet his father. The Update Long after this fellow lived, a famous movie was made about his life. The movie was shot in Tunisia. Write in Markdown ⚠️ We strongly recommend saving changes to existing content before enabling the Markdown editor, as unsupported elements will be removed when converting existing HTML content to Markdown. Users who prefer to write using Markdown can do so by activating the Parsedown Party plugin in their book. In networks where this plugin is installed and book admins are able to activate plugins, you can do so by completing two steps: Activate the Parsedown Party Plugin In your book’s dashboard, click Plugins In the Parsedown Party section, click Activate  Enable Markdown in Your Book Chapter Open the chapter in the Visual editor In the Status & Visibility section, click Enable next to Markdown The visual/text editor interface will now be replaced by a simple Markdown-based editor. You can revert the default visual/text editor interface by clicking the Disable button next to the Markdown option in the Status & Visibility menu. Note: The Parsedown Party plugin is not available on the Pressbooks.pub network. Please contact your network manager if you are creating your book on another Pressbooks network and do not see the plugin menu or the Parsedown Party plugin in your book,
      5. Write in Markdown
      1. Create a Table
      2. Add or Remove Rows and Columns
      3. Change the Table’s Appearance
      4. Make Your Table Accessible
      5. Delete a Table
      6. Create Interactive Tables with TablePress
      1. Add Textboxes to Your Book
      2. Customize Your Textbox Colors
      1. Display Math with MathJax
      2. Render LaTeX with WP QuickLaTeX
      3. Render LaTeX in H5P Activities
      4. Use Math in TablePress
  3. Produce Exports
      1. Title Page 
      2. Title
      3. Half-Title Page
      4. Copyright Notice
      5. Table of Contents
      6. Numeration and Running Content
      1. Add Custom Styles
      2. What Changes are Possible
      3. View and Restore Previous Revisions
      4. Pressbooks Custom CSS Theme
      1. Set Custom Indentation Rules for Selected Paragraphs
      2. Insert a Soft Return
      3. Disable Hyphenation for Specific Passages
      4. Change Tracking for a Selected Passage
      5. Create Section and Page Breaks in PDF Exports
      6. Change List Display
      7. Insert Pullquotes
      8. Add Dropcaps
      1. Change Your Webbook Cover
      2. Create a Marketing Cover for your Ebook Exports
      3. Create a Print-on-demand Book Cover
      4. Use the Pressbooks Cover Generator
      1. Select Your Ebook Theme Options
      2. Make and Download EPUB Exports
      1. Export Your Book as a PDF
      2. Preview your PDF Export
      3. Covers for Print PDFs
      4. Configure PDF Export Options
      1. Email Yourself Validation Logs
      2. Interpret EPUB Validation Logs
      3. Interpret PDF Validation Logs
      4. SASS Error Validation Logs
      1. Lock Your Theme
      1. Ready Your Files for Distribution
      2. Submit Your Book to an Ebook Marketplace or Printing Service
      3. Add ‘Buy’ Links to Your Book’s Home Page
      1. Choose Activity Types
      2. Choose the Right Activity Settings
      3. Update H5P Libraries
      4. Video Guide
      1. Make Sure your Chapter Is Ready
      2. Include H5P Activities for Scoring
      3. Select a Grading Scheme
      4. Improve Student Experience
      5. Video Guide
      1. Canvas
      2. Moodle
      3. Blackboard
      4. D2L Brightspace
      5. Video Guide
      1. Add the Pressbooks Results Viewer to an LMS course
      2. View Results
      3. Understand Displayed Scores
      4. See Submitted Responses
      5. Report Grading Issue
      6. Test as a Student
      7. Video Guide
      1. Allowing all third-party cookies
      2. Allowing selected third-party cookies
      1. Get support
    1. OER Repositories and Directories
    2. Resources for OER