Fix Common Formatting Problems

Pressbooks

Fix Common Formatting Problems

In providing support to Pressbooks users over the past several years, we’ve seen several formatting problems pop up repeatedly, frustring authors who just want their webbooks and export files to look “normal”. Very often, these problems are due to “bad” styling markup that has crept into the editing interface, often imported from MS Word.

Remove Unwanted Span Elements

Content imported into Pressbooks from external sources (like Microsoft Word) often includes extra markup or inline styles that might have been useful in the original context but which will produces unwanted styling in Pressbooks; for instance, changing the size or even color of certain text. Often this bad markup comes in the form of <span> tags. If you see strange behavior in your webbook or export files, we recommend reviewing the underlying HTML with the text editor to find and remove examples that look like this:

<span style="font-size: something; color: something else">

Any unwanted span tags and inline style declarations should be deleted (along with the closing </span> tag) unless you are sure you know what it is for and want it to be displayed in your book.

Heading Styles

Make sure that any headings you want to include in chapters are tagged correctly using <h1> or <h2> or <h3> tags, not <strong> or <b> 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 <cite>)

Things like letters, poems, long quotations should be wrapped in <blockquote>text text</blockquote>.

<blockquote>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.</blockquote>

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.^[1]

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:

<p class="no-indent">Hamlet. But what is your affair in Elsinore? ...</p>

<p class="no-indent">Horatio. My lord, I came to see your father's funeral.</p>

<p class="no-indent">Hamlet. I pray thee, do not mock me, fellow-student;

I think it was to see my mother's wedding.</p>

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

<ul>

<li>item 1</li>

<li>item 2</li>

</ul>

Which will give you:

item 1
item 2

Numbered/Ordered Lists

<ol>

<li>item 1</li>

<li>item 2</li>

</ol>