{"id":98,"date":"2014-03-13T15:40:57","date_gmt":"2014-03-13T15:40:57","guid":{"rendered":"https:\/\/openbook.ums.edu.my\/userguide\/chapter\/fix-common-formatting-problems\/"},"modified":"2024-09-19T04:19:25","modified_gmt":"2024-09-19T04:19:25","slug":"fix-common-formatting-problems","status":"publish","type":"chapter","link":"https:\/\/openbook.ums.edu.my\/userguide\/chapter\/fix-common-formatting-problems\/","title":{"raw":"Fix Common Formatting Problems","rendered":"Fix Common Formatting Problems"},"content":{"raw":"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.\n

Remove Unwanted Span Elements<\/h1>\nContent 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><\/code> 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:\n
<span style=\"font-size:\u00a0something; color: something else\"><\/code><\/div>\nAny unwanted span tags and inline style declarations should be deleted (along with the closing <\/span><\/code> tag) unless you are sure you know what it is for and want it to be displayed in your book.\n

Heading Styles<\/h1>\nMake sure that any headings you want to include in chapters are tagged correctly using <h1><\/code> or <h2>\u00a0<\/code>or <h3><\/code> tags, not <strong><\/code> or <b><\/code> tags. Headings should be nested as subsections to reflect the organization of the content of the page.\n\nGood:\n
\n

The Background<\/h3>\nA long, long<\/em> time ago, in a galaxy far, far away, there lived a fine young man unaware<\/strong> 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.\n

The Update<\/h3>\nLong after this fellow lived, a famous movie was made about his life. The movie was shot in Tunisia.\n\n<\/div>\nBad:\n
The Background<\/strong>\nA long, long<\/em> time ago, in a galaxy far, far away, there lived a fine young man unaware<\/strong> 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.\nThe Update<\/strong>\nLong after this fellow lived, a famous movie was made about his life. The movie was shot in Tunisia.<\/div>\n

Blockquotes \u00a0(and <cite>)<\/h1>\nThings like letters, poems, long quotations should be wrapped in <blockquote>text text<\/blockquote><\/code>.\n
<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><\/code><\/div>\nThis will give you something like:\n
\n
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<\/em>[\/footnote]<\/blockquote>\n<\/div>\n

Non-indented Paragraphs<\/h1>\nPressbooks 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:\n
<p class=\"no-indent\">Hamlet. But what is your affair in Elsinore? ...<\/p>\n<p class=\"no-indent\">Horatio. My lord, I came to see your father's funeral.<\/p>\n<p class=\"no-indent\">Hamlet. I pray thee, do not mock me, fellow-student;\nI think it was to see my mother's wedding.<\/p><\/code><\/div>\nYou can do the above in the VISUAL editor by selecting the paragraphs you want not indented, then selecting No Indent <\/strong>from the 'Formats' dropdown.\n\"\"\n

Lists (Bulleted and Numbered)<\/h1>\nMake sure lists are proper lists, so ...\n

Bullet\/Unordered Lists<\/h3>\n
<ul>\n<li>item 1<\/li>\n<li>item 2<\/li>\n<\/ul><\/code><\/div>\nWhich will give you:\n
\n