Style Guide

How to Edit this Textbook

  • You can make minor wording tweaks very easily, with no technical skills.
    • 1. Go to the page you want to edit. 2. Log in. 3. Click “Edit Post” in the very top WordPress toolbar. Use the “Visual” (not the “Text”) tab of the page-editing tool. 4. Click the big “Update” button when you are done.
  • To add a new unit, use the “Category” tools in the WordPress dashboard. Be sure to set the “slug” for the category so that it will sort alphabetically in your desired position relative to other units.
  • To add a new section within a unit, add a new “Post,” and assign it to the relevant “Category.” Also be sure to set the “Published on” date of the section so that it sorts in your desired position relative to other sections within this unit.
  • To make more advanced formatting changes to a page, you really need some HTML and CSS literacy, so that you can work in the “Text” tab of the WordPress page-editing tool.
    • Familiarize yourself first with the custom styles defined for this textbook in the child theme’s “style.css” file. Use those styles!
  • Two optional features of the “UW-Madison Textbook Child Theme”:
    • Place the automatically generated listing of “Recent Changes” on any page or post you like by typing “[lastupdated-posts]” into your text (without the quotation marks).
    • To add a page which automatically compiles the entire textbook on one page for printing purposes, simply add a new page and choose the “Print Entire Book” page template. Whatever content you write (if any) will appear above the compiled textbook copy.

How this WordPress Site Is Built

  • There are no core WordPress customizations. You should assume that you can safely install future WordPress upgrades without losing the customizations that make this textbook work.
  • It uses a custom “child theme” called “UW-Madison Textbook Child Theme” whose required parent theme is the official UW-Madison WordPress theme available from University Communications. You should assume that you can safely install updates for the parent UW theme without losing the customizations that make this child theme work.
    • To modify this child theme, make changes to files in the “wp-content/themes/uwmadison-textbook” folder.
  • It strongly relies on the Collapsing Categories free plugin for the right-hand navigation menu widget throughout the textbook. Set the following non-default plugin settings:
    • Sort Categories by: category Slug (Ascending)
    • Sort Posts by: post Date (Ascending)
    • Style: Twenty Ten
  • In case your book includes more than 10 sections per chapter/unit, make sure to use your WordPress Dashboard menu item Settings > Reading > “Blog pages show at most” setting to allow your maximum number of sections to fit into a single chapter’s print-friendly summary.
  • It weakly relies on the Custom Meta free plugin for the right-hand menu “For Co-Authors” throughout the textbook.

One thought on “Style Guide

  1. Pingback: UW-Branded Open Textbook Publishing Platform | Teaching Academy