Style Guide

Before adapting an existing book, or creating a new one, it’s important to establish a road map that will guide the style of the work. Creating an editorial Style Sheet is recommended to keep your formatting consistent across your book.

A Style Sheet template and Style Guide Content to include in a style sheet with recommended formatting choices to consider is provided below.

Style Sheet

A style sheet should be a separate document that you use for your own formatting purposes or that you share with other authors and contributors. It is recommended that your style sheet is in a format that is easily shareable with others (e.g, a Google document). Below is an example of a style sheet template and the types of content it might include. Links to suggested considerations are provided in this example, but you may change yours however best suits your text.

Style Item Notes
Citation Style
Captions
Spelling
Punctuation
Other style points
Layout
Pedagogical Features Placement Notes
Learning objectives
Key takeaways
Key terms/glossary
Exercises
Reference list
Suggested readings
Attributions
Appendices

Style Guide Content

The elements listed in the Style Guide are not exhaustive. Feel free to use the examples here or adapt them to fit your preferences.

Citation Style

Select the citation style to be used for referencing material in your book and note this on your Style Sheet. If you are writing for a specific discipline, select the citation style appropriate for your area. If you are adapting an existing book, use the citation style chosen by the original author.

Use the citation style you’ve selected to set out rules for your book and record them in your Style Sheet to ensure consistency. Some basic questions to ask yourself:

  1. What will in-text citations look like?
  2. When paraphrasing, is a page number required?
  3. How will you list multiple authors for an in-text citation or entry in a reference list?
  4. Where will the reference list be located?
  5. Will you use footnotes instead of a reference list?
  6. How will you ensure that all in-text citations are noted in full in the reference list?

If you are adapting a work and remove an in-text citation, remember to remove this reference from the reference list at the end of the chapter.

Pay close attention to the punctuation used for the citation style you’ve chose, such as:

  1. How periods are used
  2. Use of italics
  3. Use of brackets
  4. Use of quotation marks
  5. Use of spaces

Note: No periods should be used after URLs when they end a reference list entry.

Captions

See Images: Captions, Citations and Attributions. The same principles outlined in this chapter can apply to other types of content, including tables, audio and video.

Spelling

In general, Canadian spellings should be used. Consult Canadian Spellings for first-choice spelling preferences. List any exceptions in your Style Sheet.

Punctuation

Consider how punctuation will be handled in your book. Below is one standard to use as a model. If you choose one or more different styles, enter these on your Style Sheet.

  1. Use a serial comma, i.e., a comma placed immediately before the coordinating conjunctive (and, or, nor) in a series of three or more terms.
    1. Serial comma: There were cows, horses, and pigs in the barn.
    2. No serial comma: There were cows, horses and pigs in the barn.
  2. Use commas in numerals over 999 (e.g., 1,000; 45,000)
  3. In displayed lists, always start items with a capital letter. Use end punctuation, such as a period, with full sentences only.
  4. Do NOT capitalize the first letter of the first word after a colon unless the colon introduces two or more sentences.
  5. With em dashes (inserted in Pressbooks by adding two hyphens side-by-side), insert a space on either side.
  6. Use the North American system for quotation marks: periods and commas always go inside quotation marks; semicolons and colons go outside.
  7. Use double quotes for all quoted matters. Single quotation marks should be reserved to enclose quotes within quotes. (e.g., Mark exclaimed, “You have driven a stake into my heart! Now I truly understand Caesar’s words, ‘Et tu Brute?’ How could you treat me so?”)
  8. Place footnote numbers outside punctuation (usually a comma or period).
  9. Do not use periods in abbreviations, acronyms, and initialisms, except as noted in spelling list (e.g., et al., etc., i.e. are the most common that retain the periods).
  10. Do not hyphenate Latin phrases used adjectivally: ad hoc proposal, post hoc analysis.
  11. For hanging hyphen constructions (15- to 19-year-olds), do not hyphenate after “to.”
  12. Do not use quotes with so-called (e.g., Her so-called friend left her standing in the rain.)

Other Style Points

Use of boldface

Boldface is reserved for key terms within the text body. It should not be used for emphasizing a word or phrase.

Use of italics

  1. Use italics for words used as words (e.g., The term vocal cords is often misspelled. What do you mean by nexus?)
  2. The titles of movies, TV shows, and radio programs are italicized (e.g., The Grey Fox, Definitely Not the Opera). The names of bands and music channels are regular font not italic (e.g., Bob’s Your Uncle, MuchMusic).
  3. See Italics and Foreign Words.

Dashes

Em dashes ( — )
  1. The em dash is the standard for breaking a sentence or setting off parenthetical statements.
  2. With em dashes, insert a space on either side.
  3. In Pressbooks, the em dash is created by using two hyphens. In the Book view, two hyphens will look like one long (em) dash.
En dashes (-)
  1. Use an en dash when expressing a range of years such as birth to death, e,g., 1955-2001.
  2. There should be no space on either side of the en dash.
  3. In Pressbooks, use one hyphen to indicate an one short (en) dash.

Spacing

Use only one space after a period (i.e., between sentences) and after a colon (:).

Italics and Foreign Words

Often foreign words are italicized in a textbook.  However, if you’re not sure whether to use italics or not, consider the following:

  1. If the word is not italicized in the dictionary, then italics shouldn’t be used
  2. “Common” foreign words do not take italics (e.g. ad hoc, vis-a-vis)
  3. In Canadian English, many French words are not italicized.

If you’re not sure whether to use italics or not, do your best. Any errors will be picked up during the copy editing and proofing process.

Emphasizing Words with Punctuation

Sometimes an author will want to stress or emphasis a word or phrase. While acceptable, this practice should be kept to a minimum. In most cases, the word(s) should be written in a way that the stress or importance of a word or term is clear in context. Follow these guidelines:

  1. Do NOT use boldface or quotation marks for emphasis. Boldface is reserved for key terms within the text body.
  2. Use italics for words used as words (e.g., The term vocal cords is often misspelled. What do you mean by nexus?)
  3. Words that are meant to alert the reader that a term or word is used in nonstandard, ironic, or other special sense should be marked off with quotation marks (e.g., “Child protection” sometimes fails to protect).
  4. Words that are common expressions and figures of speech should NOT be set off in any way (and in this text, sometimes they are).

Measurements

Metric measurements should be used, i.e., km not miles; mm, cm and metres, not inches, feet or yards; kg not lbs; Celsius (C) not Fahrenheit (F).

If an existing book is being revised, convert imperial measurements to metric and round off the result. For example, 10 inches equals 25.4 cm. Record this as 25 cm.

Numbers

  1. Spell out numbers from one to nine and use arabic numerals for numbers greater than nine, except as indicated in the checklist below.
  2. For ordinals, spell out first through ninth unless they are part of an array that includes a higher ordinal. Ordinals greater than ninth are expressed as numerals unless they occur at the beginning of a sentence (…in the 12th century but Twelfth-century monks…). Acceptable suffixes are 21st, 32nd, 43rd, 54th.
  3. Spell out fractions in running text with a hyphen (e.g., two-thirds).
  4. Use commas in numbers greater than 999.
  5. For percentages, use arabic numbers and the % symbol, closed up. The symbol should be repeated with each number in a range or series (the incidence varied from 1% to 4%; 6% to 7% of cases). If a sentence begins with a percent value, spell out both number and percent.
  6. For temperatures, use arabic numerals and the degree symbol (37.8°C).
  7. For times of day, use a colon only when a fraction of an hour is indicated (9:05 a.m.; otherwise 2 p.m.). With 12 o’clock, specify noon or midnight.
  8. For number ranges in text, use “to” (50 to 100 mg) except for years (1998–99, 1999–2013) and pages (213–223), which take en-dashes.
  9. For number ranges in tables and parentheses, use an en-dash (50–100 mg).
  10. Always use numerals with school grades (e.g., Grade 6).
  11. Use digits and abbreviations in measurements (e.g., puzzle boxes were 50 cm long, 38 cm wide, and 30 cm tall).

Use numerals rather than words

  1. In addresses (Suite 2, 400 West Hastings)
  2. For dates (17 May 1948)
  3. As designators (day 8, chapter 10, page 9, protocol 5)
  4. In figure and table designations (Figure 3, Table 6)
  5. For money ($14, $9.97, 6 cents, US$200)
  6. For temperatures (20°C)
  7. For time of day (11 p.m., 2:45 a.m., 07:30–13:00 )
  8. With units of measure (2 m, 7.2 kg)
  9. With percent symbols (0.02%, 99%)
  10. With “million” and “billion” ($1 million, 9.4 billion units)

Layout

Book Outline

When you first begin working on your book, it’s recommended to create an outline. This outline should include a list of all chapters and their topics, as well as any front matter (introduction, preface) and back matter (appendices, glossary). Determining the outline, or layout, of the book helps to organize the subject matter and create a project timeline so the book can be appropriately managed.

Chapters and Boxes

Once you’ve created a book outline, consider the framework for each chapter and what is needed to address pedagogical concerns. The following items can be identified for your Style Sheet.

Use the boxes features only as labelled:
  1. Learning Objectives
  2. Key Takeaways (can be relabelled as Key Terms)
  3. Exercises (or related items such as Answers, Questions)
For other items, such as References, Further Research, Case History, use:
  1. Heading 2 title
  2. You can also highlight this information with a Text box (shaded or plain), found under Text boxes

Learning Objectives

The Learning Objectives function is found at the top of the editing page in the Text boxes drop down menu.

This is what the Learning Objectives box looks like:

Learning Objectives

Type your learning objectives here.

  • First
  • Second

Key Takeaways

The Key Takeaways function is found at the top of the editing page in the Textboxes drop down menu.

This is what the Key Takeaways box looks like:

Key Takeaways

Type your key takeaways here.

  • First
  • Second

Key Terms (Glossary)

Typically, key terms are highlighted as bold or italicized in the text body and then added to the Key Takeaways box. The term is set as bold in the KT box; the definition is in plain text.

The Key Takeaways box function can be used to list Key Terms.  Just relabel the box as so:

Key Terms

Type your definition here.

 

Exercises

The Exercises function is found at the top of the editing page, also in the Text boxes drop down menu. The “Exercises” label for this box can be renamed using other synonyms for exercises that are descriptive of the type of exercises included such as “Short Answers”, “Exercises and Critical Thinking”, “Essays”.

This is what the Exercises box looks like:

Exercises

Type your exercises here.

  1. First
  2. Second

Headings

Pressbooks provides a variety of heading levels beginning with Heading 1 (the most prominent and largest) down to Heading 6.

  1. The default setting in Pressbooks defines the chapter title as H1, therefore all subsequent headings within a chapter should begin with H2.
  2. Create a hierarchy for the sections in your chapters and note which headings you’ve assigned to each in your Style Sheet.
  3. Decide how words in headings will be capitalized and record this decision in your Style Sheet as well.

Headings are important for accessibility, which we will explore more in the Accessibility Toolkit section of this guide.

This is what the six different headings look like:

Heading 1

Heading 2

Heading 3

Heading 4

Heading 5
Heading 6
Content adapted from “Style Guide” in the B.C. Open Textbook Authoring Guide (archived version) by Lauri Aesoph and Amanda Coolidge licensed under CC-BY 4.0.

 

License

Icon for the Creative Commons Attribution 4.0 International License

MacEwan Open Textbook Authoring Guide by MacEwan University Library is licensed under a Creative Commons Attribution 4.0 International License, except where otherwise noted.

Share This Book