Monday, June 4, 2012

Publishing #6: What is Good Layout?

Good layouts combine good visual design with good arrangement of the content. The previous article (Visual Design Tidbits) is as much as I feel comfortable saying about the design aspect of good layout. This article covers the second aspect of good layout: Ideal physical arrangement of the content. That is, how you should and – more importantly – shouldn't chop up related bits of text, illustrations, and other content in order to fit the product onto pages.

In order to help understand good layout, let's examine some examples of poor layout...

Unfortunate Page Flip

Here's a not-so-good layout example from Labyrinth Lord. The charm monster spell description (see the green boxes in the picture) spans pages 27-28, so it's impossible to see the whole description at a glance when you're holding the physical book:

Labyrinth Lord's charm monster spell description requires a page flip.

In and of itself, having to flip pages to read the entirety of a spell description isn't horrible, though it's certainly not ideal. This particular example is notably problematic because the spell header itself (spell name, level, duration, range) is split across two pages.

In general, avoid breaking a spell description across a flipped page. But if you absolutely must do it, keep the spell header all together on one page, plus at least a few lines of the rest of the description.

Content that's Difficult to Notice

These are special cases of unfortunate page flips, with more troublesome consequences. Here's an example from Barrowmaze, showing the 2-page spread for pages 12-13 as it would be in the physical book. The description for area 30 (in the green box) looks complete, with a description of the area & occupants that clearly terminates the paragraph.

The area 30 description looks complete...

You can run area 30 with all that's shown here. And in fact, when I ran that area (my AD&D group is currently exploring Barrowmaze), that's exactly what I used. No more, no less.

But some time later, while adjudicating area 33, I happened to notice something peculiar at the top of page 14 on the next spread. Check out the green box:

... but there's more to area 30, practically hidden on page 14.

The description for area 30 continues onto the next spread, and I didn't discover it until too late. In the grand scheme of things, the unused content is no big deal; the hard-to-notice details for area 30 aren't critical for enjoying the module.

But the problem isn't this room description. The problem is lack of predictability. One or two unfortunate cases don't just impact play for those areas; they train the reader to expect problems, thus forcing time-wasting double-checks on all the other cases that are actually just fine.

In general, avoid breaking room descriptions across two different spreads. But if you must do so, at least break the description so the reader can clearly see that a page flip is necessary. In this particular case, a "(cont'd...)" notice at the very bottom would have been useful.

Stats after a Page Flip
(and PDFs have Higher Standards)

Here's another special case of an unfortunate page flip, from The Monastery of the Order of Crimson Monks (PDF available free on Dragonsfoot). At the end of page 2, the description for area 1A makes it clear that a spider is present in the room ...


... but the spider's stats aren't shown until the top of page 3:


As much as possible, creature stats ought to be kept together with their room description. Hopefully you're sensing the trend.

But this example teaches a more important lesson: PDFs sometimes have stricter standards regarding breaking elements across multiple pages!

Unlike the two earlier examples, this example doesn't show a two-page spread. That's because two-page spreads (and the resulting less-strict layout demands) are only applicable for documents printed in book / booklet format. As a free PDF with no print-on-demand option, if this particular Dragonsfoot module gets printed, it's most likely going to be a set of single-sided individual pages. So every page is its own spread (a one-page spread) and represents a potential for an unfortunate flip situation.

Detached Heads ... uh ... Headers

RC Pinnell must have known I was working on these articles, and decided to include some less-than-ideal layout in the G4 Anniversary Edition (free on Dragonsfoot) just so I could save time looking for examples! (Sorry, Rob!) Take a look at these two separate examples:

"The Sanctum" – a section header without its section

"Rockfist Rockheart" – stats ascendant, but head alone on the ground.

In both of these cases, the section header is the last line in a column, and the rest of the description starts at the top of the next column. It's ugly, jarring, and easy to avoid. Don't do it. For these purposes, section headers can be many things: Room/area names, NPC names, subsection titles, table names, and so on. In all cases, these should be in the same column as the first part of their corresponding descriptive text.

Blank Lines at the Tops of Columns

This final layout glitch is a continuation of "The Sanctum" example. Here's the following page, with the start of the Sanctum description. Note the blank line (highlighted by the green box) at the very start of the description:

The blank line makes the column tops look uneven.

Blank lines like these cause the page to look uneven, but more importantly they use up vertical space that might be preferable to use for additional content at the bottom of the column.

This problem typically happens when the layout uses actual empty lines (i.e., presses of the return key) to add whitespace between paragraphs.

Instead of using empty lines, use paragraph spacing. Most word processors and layout programs allow you to specify a gap (usually in points) that should come before and/or after paragraphs; the software wisely chooses not to apply that gap to paragraphs that start at the top of columns.

Now let's change gears and look at ...

Examples of Good Layout

The Dungeons & Dragons Basic and Expert rulebooks from 1981 (the Moldvay and Cook/Marsh edits) won't win any awards for flashy visual design, but they are exemplary models of good layout arrangement for gaming content. Both rulebooks do a great job avoiding unfortunate breaks across columns, pages, and spreads. They're not 100% perfect, but layout perfection is hard to achieve, and their few arrangement flaws are generally pretty minor.

The following series of pages from the Basic rulebook contains absolutely nothing that breaks across page boundaries. Every section and/or subsection fits precisely onto the relevant page/column.

In this first Basic spread, the top text spans both columns on each page, which allows the rest of the text to fit precisely into natural and equal column lengths, without breaking a paragraph across those columns. Also note how the indentation within part of the cleric class description precisely enables that column to be exactly the same physical height as the dwarves/elves column. Someone intentionally chose the specific amount of indentation in order to equalize the column heights.


In this second Basic spread, the precisely-chosen illustration heights allow each page's worth of text to exactly fill the page without breaking a paragraph across two columns. On the left page (p. 10), someone added a little bit of extra whitespace above "Magic-Users" and "Thieves" so that the bottom of that column rested flush with the bottom of the illustration.


The third Basic spread's weapon illustration allows for perfectly even column bottoms. On the right page, the box around, and the particular indentation amounts with the Example allow it to exactly fill the rest of the page. It's also likely that the Example wording itself was tweaked in order to fit precisely.


And now, take a look at a series of equally-impressive spreads from the Expert rulebook. This first Expert spread shows how it avoids breaking spell descriptions across pages. Note how the two illustrations fill exactly the right amount of space to allow optimum fit. There are no page-broken spells at all within the eight-page spell chapter.


This second Expert spread shows the last page from the spells chapter. Note how the precise illustration size allows the spells chapter to end on an even page boundary, which in turn allows chapter 4 to begin at the top of a fresh page.


This final Expert spread comes from the monsters chapter. Although the monsters chapter has a few spots of rough layout arrangement, this particular spread is pretty great. No monster descriptions are broken across pages, only one monster is broken across columns, and the quantity and sizes of the illustrations allow all the column tops & bottoms to align nicely.


Some people believe these Basic / Expert rulebooks are the most elegant rulebooks produced by TSR. Its fans rave about the elegance of the rules, the clear verbiage and the good organization – all three attributes are built upon the foundation of a good layout arrangement!

Keep Stuff Together &
Avoid Unfortunate Breaks

Some general principles of ideal layout arrangement:

Know your spread size. For books / booklets, spreads span two pages, with an even-numbered page on the left and an odd-numbered page on the right. (The first page of the book stands alone, as does the last page if it's even-numbered.) For PDFs where you expect the reader to print them at home as individual single-sided pages, spreads are really just single pages.

Start major sections on even boundaries, generally at the top of a page or column.

Keep tops and bottoms of columns flush. Use artwork, spacing adjustments and other tweaks to keep the layout visibly even. This will be covered in more detail in another article.

Don't split critical information across multiple columns, pages, or spreads. This includes stat blocks and spell headers.

Avoid Widows, Orphans, and Beheaded Headers. Keep section headers (including room names and spell names) in the same column as at least several lines of the corresponding description. More generally, try not to leave one line of a longer paragraph all by itself at the top or bottom of a column. Wikipedia has more info.

Keep each item entirely within a single column. Try to fit the entirety of room/area descriptions on one column, including any associated monster stats. Ditto for spell descriptions, magic item descriptions, monster write-ups, NPC capsules, class descriptions, and similar. This won't always be possible (sometimes the text for an item is just too long), so do your best to keep each item entirely on a single page.

Keep related items on the same spread. For example, when two rooms are strongly associated, and likely to be referenced in play at the same time (perhaps because the occupants respond as help for one another), make sure they are visible at the same glance, generally by keeping them on the same page or spread.

Avoid breaking tables across columns whenever possible, and especially across pages and spreads.

In a nutshell, some elements should never be split across multiple columns. For other elements, it's okay to split them across multiple columns, as long as you don't split them across multiple pages. And for longer elements, splitting across pages is okay, but try not to split them across spreads unless they're very long.

This all comes back to the earlier articles' points about making choices that allow you to fit a great deal of content on each page: Appropriate language brevity, font size, margins, etc. The more content a page can potentially hold, the more content a column can hold, and thus the less likely any given element will need to break across a column, page, or spread in a jarring way.

Sunday, June 3, 2012

Publishing #5: Visual Design Tidbits & Stat Block Advice


Please take the following advice with a big grain of salt, partly because I have no formal training in visual design, but mostly because visual design for neo-old-school products can be more art than science. Don't get me wrong; there are solid rules/guidelines for visual design, but some neo-old-school products intentionally eschew good visual design concepts in order to evoke a "classic" look & feel. So do what feels best, but don't completely abandon ease-of-use.

Design Elements to Consider

Before laying out your product, you need to figure out how you want it to look. The previous article's discussion of font size and margins is only part of the story; you can also consider details like:

Fonts: Do you want more than one font? Different fonts are good for different purposes: Body text vs. headers, or even one font for plain text and another separate font for italics (or other forms of emphasis), all in the same body paragraph. Do you have a license for embedding fonts in pdfs, or will you have to purchase one, and will this budgetary factor inform your font choices?

Section Headers: Should they be bigger? Bolder? How much do you want them to stand out? Can white space before/after help? (i.e., blank lines, more or less) Do you want all sections to fall at the start of new pages? Will you need several levels of section headers? (Section headers & subsection headers)

Room Numbers & Names: Should these details be on separate lines from the room descriptions? Should they be more noticeable (e.g., bolded or underlined)? Should each room name be preceded by some white space, to help the room name stand out?

Start of Paragraph Style: Do you want blank lines between paragraphs, or would you prefer indenting at the start of paragraphs? What about both?

Columns: One, two or three columns? Or maybe something different, such as a main column spanning two-thirds of the page, with one third of the page reserved for notes or sidebars.

Headers & Footers: Should every page have top and/or bottom elements that identify the current section or display other important details?

Page Numbers: Where should they go? Bottom? Top? Centered? Outside edge?

Tables: How do you want to format xp charts, spell progressions charts, wandering monster tables, or similar? Will you need additional software or graphics assistance to get the look right? How should the columns be justified? What's the ideal column order? Should you repeat the table headers (column titles) if the table spans multiple pages? Do you need alternating row colors to help guide the eye across rows?

Boxed Text: Think about the ideal line thickness for the box, the amount of whitespace within the box (between all sides of the box and the contained text), as well as the amount of whitespace after the box. Think about how you want to handle cases where one piece of boxed text needs to span multiple columns or pages. Also, some people absolutely loathe boxed text, so consider whether inclusion of boxed text is worth losing potential readers or sales.

… and so on. And that's only for minimalist TSR-like layouts! Elegant / elaborate designs require another whole set of considerations beyond the basics. Think about what you want, and what your product needs. Look at various products – ideally ones you've used in play – and take note of what works well and what doesn't.

Now, let's take a look at some design tidbits in more detail.

Fonts: Serif vs. Sans-serif

If you're not familiar with these terms, Wikipedia describes the difference between serif fonts and sans-serif fonts.

For neo-old-school products, it's hard to fight the allure of classic sans-serif fonts like Futura / Twentieth Century (reminiscent of the DMG) and Avante Garde / Century Gothic (reminiscent of B2 The Keep on the Borderlands). And they look pretty good onscreen.

But serif fonts sometimes look better than sans-serif fonts when printed, especially at smaller sizes.

Even if your goal is to evoke a "TSR feel", keep in mind that TSR moved on to other fonts for their main body text pretty quickly, switching to Souvenir (serif) and Helvetica (sans-serif) for B/X & AD&D modules, respectively, around 1980 (see B3 and S4 examples below), and then to something like Book Antiqua (serif) for almost all modules after 1983 (see T1-4 example below). Perhaps TSR's typographers moved the company to serif fonts for a good reason.

If you don't care about evoking the feel of the classic TSR products, the serif vs. sans-serif choice is less of an issue. Just pick fonts that include all the glyphs and font features you care about, and that look good at the sizes you plan to use. Test them at a variety of sizes and with a variety of styles (bold, italic, etc.). There are plenty of great serif and sans-serif fonts that look good both onscreen and printed.

How Many Columns?

For 8.5" x 11", use two or three columns. Both are fine choices. Only using one column that spans the whole width of the page is, according to some sources, harder to read because they eye makes more mistakes when moving a longer distance to get from the end of one line to the start of the next line.

Two columns is somewhat easier to lay out than three columns, mainly because equivalent blocks of text take up less vertical space, which translates to a higher chance of fitting entirely on one column, or within the remaining space in a column. (This will become clearer in the upcoming article on the mechanics of layout.)

Three columns allows for more variety in illustration size, by spanning one, two, or all three columns. Three columns also allows for more words per page, mostly because it nicely complements smaller fonts.

For digest size products, one or two columns works best.

Full Justification vs. Left Justification

This article uses left justification; the right edge of the column of text appears somewhat ragged, because each line is a different length. By contrast, full justification would make both sides flush with the column edge. See Wikipedia for more info.

Full justification generally gives products a more polished feel, and is probably the best default choice. But if your columns are narrow and you can't realistically decrease your font size, then full justification may lead to visual oddities (what Wikipedia refers to as a loose line). This sometimes occurs when trying to wrap text around a picture, and the shortest lines of text have  b  i  g    g  a  p  s  between letters. In these cases, consider using left or right justification instead. In some cases, you can reduce the occurrences of big gaps by allowing your word processor (or layout software) to automatically hyphenate; you usually need to manually turn on auto-hyphenation in preferences or in the document settings.

And there's another situation where you might choose to use left justification …

Separated Stat Blocks

This style of stat block comes in one or more standalone paragraphs, often at the end of the keyed area description. Here are a couple examples, from T1-4 The Temple of Elemental Evil and F3 Many Gates of the Gann, respectively:



Separated stat blocks are easier to find during play. Or rather, because separated stat blocks are their own paragraphs, you can lay them out differently in order to make them easy to spot during play. The top example improves noticeability by indenting every line after the first in the Ghouls' stats. The second example does it by bolding the creature name, and also by using left justification.

By using left justification, the second example avoids the  b  i  g    g  a  p  s  problem that would have been caused by the use of non-breaking spaces to keep stat names (e.g., "THAC0") on the same line as the stat value (e.g., "20*"). The non-breaking spaces technique is described a little further below.

Separated stat blocks scale to long lengths very well, such as when a particular creature/NPC has many spells, and/or a list of important gear.

They also provide more room for the referee to make notes about the creature during play.

Inline Stat Blocks

This style of stat block lists a creature's stats directly within the rest of the keyed area description. Here are a couple examples, from B4 The Lost City and S4 The Lost Caverns of Tsojcanth, respectively:



Short inline stat blocks work much better than long inline stat blocks. In the second example, notice how far your eye needs to track downward in order to resume reading the area description, whereas the first example's jump is much smaller. The second example is too long to be inline; it should have been a separated stat block.

Inline stat blocks are best when they don't interrupt the sentence flow. The first example is better in this regard because the stat block comes at the end of the sentence.

The second example does offer one key advantage, however: The bold creature name improves the reader's ability to quickly find the start of the stat block. This increases in importance when a paragraph contains multiple stat blocks.

But ultimately, avoid inline stat blocks unless they're short. Anecdotally, it looks like vintage publications pretty much stopped using inline stat blocks after 1983 or so. Even TSR's Basic/Expert modules, with stats as short as those in the B3 example, were done as separated stat blocks. Much more vintage content was produced with separated stat blocks than with inline stat blocks. Perhaps the vintage publishers ultimately settled on the best of the two formats.

Non-breaking Spaces in Stats, Treasure and similar

A non-breaking space is just like a normal space between two words, except it doesn't allow those two words to be separated by line wrapping. The non-breaking space sort of glues the two words together, though still with a space between them, so they'll always be on the same line together. Wikipedia has a more comprehensive definition, including a list showing how to insert a non-breaking space in a variety of operating systems and apps. (It's easy in some operating systems, and harder in others.)

Non-breaking spaces are especially useful in stats. Consider these stat blocks from T1-4 The Temple of Elemental Evil:


Those examples don't use non-breaking spaces. So if you want to look up the gelatinous cube's hit points, first you need to find the "hp," and then your eye needs to track back across the column to the start of the next line to get the value. Ditto for the brigands' MV score and the gnolls' damage. That's inefficient. Because of how we visually look for stats – usually by looking for the stat name – it's best if the stat value is always right next to the name, and not on a separate line.

Non-breaking spaces in the relevant places (e.g., between MV and 12") would have made these stat blocks easier to use.

Tangent: Another unfortunate situation is the brigands' short bow damage. The line wraps in the middle of the damage range "1-6". That's just ... ugly. You can use a non-breaking hyphen character to solve that, but ideally the whole damage phrase "D 1-6/1-6" ought to be kept together, and I don't know whether there's a non-breaking slash character.

There is a cost to using non-breaking spaces in stat blocks: Occasionally a stat block will end up being one line longer than it would if you used normal spaces. And you might see the "big gaps" problem, but only if you insist on using full justification for your stat blocks. (You won't have the problem with left justification.)

Finally, non-breaking spaces can be used to prevent "100 gp" from being wrapped onto two lines. Ditto for "60 feet," and a handful of other common situations that are best treated as one word by your software's line wrapping mechanism. As you lay out, look for places where you ought to glue two words together.

Avoid Bolding Every Magical Item and Spell

Bold draws attention. If you bold the wrong things, attention is drawn to the wrong things, making it harder to find the right things. Consider the following example from A1 Slave Pits of the Undercity:


Do we really need to be drawn so strongly to the stuff that's bolded? Probably not. The bolded magic items detract from our ability to find the rest of the details in the cleric's stat block, and the bolded spells make it hard to spot the fighters' stat block.

And although it's nice to make spells easy to find, they would have stood out well enough simply through their different layout.

Thankfully, TSR largely moved away from all this bold after about 1983 or so, and began using italics for spells and magic items instead. Pretty much only TSR overused bold in this way, until many of us started doing it again in neo-old-school products. We really ought to stop; just bold the things that the reader is likely to need to find at a glance.

Visual Design for PDF-only

Finally, consider some some hair-brained thoughts on PDF-only visual design. I don't have any experience doing PDF-only design. My experience has been designing and laying out for print, or for print & PDF hybrid. So trust what follows no further than you can throw it...

If your goal is to produce a PDF file not for printing – that is, you intend for it to be viewed only on a computer, iPad, Kindle, or some other electronic device – don't try to format it using typical page-like metaphors.

Perhaps the notion of "pages" doesn't even make sense for your target audience; perhaps web-like formatting is a better idea, with a single stream from top-to-bottom.

If pages make sense, choose your font sizes & other details based on the physical size you expect the result to be used at. If you're designing for the iPad, choose an appropriate font for when the content is displayed at 5.8 x 7.8 (or whatever the iPad physical screen size actually is). For margins … well, you don't need any … or at least you only need very minimal ones. Why would you need 1/2" margins in a PDF intended for screen viewing only?

Heck, maybe these ramblings give insight into hybrid PDF & print design. For hybrid solutions should we design for, and generate printed versions at, a smaller format, like digest, A5, or trade paperback? I'm not sure, but I may try it on a future product.

Part 6 covers key qualities of good layout.