Heading Styles<\/h2>\nDONT<\/strong>: Style headings with Bold instead of Heading tags\n\nDO:<\/strong> Make sure headings in chapters are tagged <h2><\/code> or <h3><\/code> ... NOT <strong><\/code> or <b><\/code>\n\n... This causes all sorts of heartache, because in many cases your \"headings\" will look like very short, indented paragraphs, which happen to be bold.\n\nSo instead of getting (good!):\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:\u00a0the Force,\u00a0what his father was up to,\u00a0how to use a lightsaber.\u00a0All 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>\nYou might get (in certain outputs) (bad!):\n

\n

The Background<\/strong><\/p>\n

A 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:\u00a0the Force,\u00a0what his father was up to,\u00a0how to use a lightsaber.\u00a0All 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.<\/p>\n

The Update<\/strong><\/p>\n

Long after this fellow lived, a famous movie was made about his life. The movie was shot in Tunisia.<\/p>\n\n<\/div>\nUg! Make sure your headings are tagged properly with <h2>, <h3>, <h4><\/code>\u00a0etc.\n

Blockquotes \u00a0(and <cite>)<\/h2>\nFor things like letters, poems, long quotations etc.... they should \u00a0be wrapped in <blockquote>text text<\/blockquote><\/code>\n\nIf you want to get slightly fancy, you can wrap the quote source in a <cite><\/code> tag, so:\n

<blockquote>To be, or not to be\nThat is the question.\n<cite>Hamlet<\/cite>\n<\/blockquote><\/code><\/div>\nAnd this will give you something like:\n

\n

To be, or not to be\nThat is the question.\nHamlet<\/cite><\/blockquote>\n<\/div>\n

Non-indented Paragraphs<\/h2>\nPressbooks will automatically indent paragraphs correctly, and NOT indent them correctly as well (for instance, after Chapter Titles, and headings throughout a chapter).\n\nHowever, sometimes you want paragraphs that aren't indented... for instance ... if you were quoting Hamlet, you wouldn't want new paragraphs indented so you would have:\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>\nNOTES:\n

\n \t
• you don't need <p> tags around regular paragraphs...<\/li>\n \t
• you can do the above in the VISUAL editor by selecting the paragraphs you want not indented, then using the Styles Dropdown.<\/li>\n \t
• this will be styled as: no indent, with a space between paragraphs.<\/li>\n<\/ul>\n

  Lists (Bulleted and Numbered)<\/h2>\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

  \n \t
  • item 1<\/li>\n \t
  • item 2<\/li>\n<\/ul>\n<\/div>\n

    Numbered\/Ordered Lists<\/h3>\n

    <ol>\n<li>item 1<\/li>\n<li>item 2<\/li>\n<\/ol><\/code><\/div>\nWhich will give you:\n

    \n

    \n \t
    1. item 1<\/li>\n \t
    2. item 2<\/li>\n<\/ol>\n<\/div>\nNOTE: this can be done with the VISUAL editor -- just a good idea to check the TEXT editor for strange bullet characters from Word.\n

       Remove Those <spans>!!!!!<\/h2>\nMicrosoft Word has a very bad habit of bringing in a whole lot of crappy markup that styles your document for MS Word but does terrible things in ebooks and Pressbooks PDFs--for instance, making your fonts too small or too big or the wrong color etc.\n\nOften this bad markup comes in the form of <span><\/code> tags.\n\nSo, it's a good idea to review your book using the TEXT editor, and see if you see anything that looks like:\n

       <span style=\"font-size:\u00a0something; color: something else\"><\/code><\/div>\nThis should be deleted... along with the closing\u00a0<\/span><\/code>\u00a0tag....\n\n... unless<\/b> you are very sure you know what it is for. There are very few ebooks hurt by deleting spans.","rendered":"

       There are a number of problems that pop up consistently with Pressbooks users, where outputs just don’t look as people expect. Very often, these problems are due to “bad” styling markup that has crept into the editing interface, often imported from MS Word, or from the user just doing a few things wrong.<\/p>\n

       Here is a quick list of common problems, and how to fix them:<\/p>\n

       \n
       • Styling headings with Bold instead of Heading tags<\/li>\n
       • Not using blockquotes for letters, quotes etc.<\/li>\n
       • Forcing certain kinds of paragraphs not to indent<\/li>\n
       • Not using correct list formatting (for bullets & numbers)<\/li>\n
       • The dreaded MS Word <span><\/code> tag<\/li>\n
       • Funky spacing<\/li>\n
       • Paragraphs not being separated properly<\/li>\n<\/ul>\n

         Heading Styles<\/h2>\n

         DONT<\/strong>: Style headings with Bold instead of Heading tags<\/p>\n

         DO:<\/strong> Make sure headings in chapters are tagged <h2><\/code> or <h3><\/code> … NOT <strong><\/code> or <b><\/code><\/p>\n

         … This causes all sorts of heartache, because in many cases your “headings” will look like very short, indented paragraphs, which happen to be bold.<\/p>\n

         So instead of getting (good!):<\/p>\n

         \n

         The Background<\/h3>\n

         A 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:\u00a0the Force,\u00a0what his father was up to,\u00a0how to use a lightsaber.\u00a0All 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.<\/p>\n

         The Update<\/h3>\n

         Long after this fellow lived, a famous movie was made about his life. The movie was shot in Tunisia.<\/p>\n<\/div>\n

         You might get (in certain outputs) (bad!):<\/p>\n

         \n

         The Background<\/strong><\/p>\n

         A 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:\u00a0the Force,\u00a0what his father was up to,\u00a0how to use a lightsaber.\u00a0All 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.<\/p>\n

         The Update<\/strong><\/p>\n

         Long after this fellow lived, a famous movie was made about his life. The movie was shot in Tunisia.<\/p>\n<\/div>\n

         Ug! Make sure your headings are tagged properly with <h2>, <h3>, <h4><\/code>\u00a0etc.<\/p>\n

         Blockquotes \u00a0(and <cite>)<\/h2>\n

         For things like letters, poems, long quotations etc…. they should \u00a0be wrapped in <blockquote>text text<\/blockquote><\/code><\/p>\n

         If you want to get slightly fancy, you can wrap the quote source in a <cite><\/code> tag, so:<\/p>\n

         <blockquote>To be, or not to be
         \nThat is the question.
         \n<cite>Hamlet<\/cite>
         \n<\/blockquote><\/code><\/div>\n

         And this will give you something like:<\/p>\n

         \n

         To be, or not to be
         \nThat is the question.
         \nHamlet<\/cite><\/p><\/blockquote>\n<\/div>\n

         Non-indented Paragraphs<\/h2>\n

         Pressbooks will automatically indent paragraphs correctly, and NOT indent them correctly as well (for instance, after Chapter Titles, and headings throughout a chapter).<\/p>\n

         However, sometimes you want paragraphs that aren’t indented… for instance … if you were quoting Hamlet, you wouldn’t want new paragraphs indented so you would have:<\/p>\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>\n

         NOTES:<\/p>\n

         \n
         • you don’t need <p> tags around regular paragraphs…<\/li>\n
         • you can do the above in the VISUAL editor by selecting the paragraphs you want not indented, then using the Styles Dropdown.<\/li>\n
         • this will be styled as: no indent, with a space between paragraphs.<\/li>\n<\/ul>\n

           Lists (Bulleted and Numbered)<\/h2>\n

           Make sure lists are proper lists, so …<\/p>\n

           Bullet\/Unordered Lists<\/h3>\n

           <ul>
           \n<li>item 1<\/li>
           \n<li>item 2<\/li>
           \n<\/ul><\/code><\/div>\n

           Which will give you:<\/p>\n

           \n

           \n
           • item 1<\/li>\n
           • item 2<\/li>\n<\/ul>\n<\/div>\n

             Numbered\/Ordered Lists<\/h3>\n

             <ol>
             \n<li>item 1<\/li>
             \n<li>item 2<\/li>
             \n<\/ol><\/code><\/div>\n

             Which will give you:<\/p>\n

             \n

             \n
             1. item 1<\/li>\n
             2. item 2<\/li>\n<\/ol>\n<\/div>\n

                NOTE: this can be done with the VISUAL editor — just a good idea to check the TEXT editor for strange bullet characters from Word.<\/p>\n

                Remove Those <spans>!!!!!<\/h2>\n

                Microsoft Word has a very bad habit of bringing in a whole lot of crappy markup that styles your document for MS Word but does terrible things in ebooks and Pressbooks PDFs–for instance, making your fonts too small or too big or the wrong color etc.<\/p>\n

                Often this bad markup comes in the form of <span><\/code> tags.<\/p>\n

                So, it’s a good idea to review your book using the TEXT editor, and see if you see anything that looks like:<\/p>\n

                <span style=\"font-size:\u00a0something; color: something else\"><\/code><\/div>\n

                This should be deleted… along with the closing\u00a0<\/span><\/code>\u00a0tag….<\/p>\n

                … unless<\/b> you are very sure you know what it is for. There are very few ebooks hurt by deleting spans.<\/p>\n","protected":false},"author":1,"menu_order":8,"template":"","meta":{"pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":"cc-by"},"chapter-type":[],"contributor":[],"license":[50],"part":118,"_links":{"self":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/146"}],"collection":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/users\/1"}],"version-history":[{"count":1,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/146\/revisions"}],"predecessor-version":[{"id":147,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/146\/revisions\/147"}],"part":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/parts\/118"}],"metadata":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapters\/146\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/media?parent=146"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/pressbooks\/v2\/chapter-type?post=146"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/contributor?post=146"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/pb.malartu.org\/pbuserguide\/wp-json\/wp\/v2\/license?post=146"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}