Almanac

<p>Posts used as references, typically for how a feature works.</p>

Complex Tables

Homebrewery allows for an extended Markdown-like syntax for more complex tables which is helpful when building something like D&D class tables. In Basic Tables the regular syntax for simple Markdown tables was covered. Simple tables will likely cover most of your use cases, and everything starts from there, so be sure you have read that Complex Tables

Basic Tables

I’ve covered tables in the past, but with the new little live editor it’s worth taking a second swing for the Almanac. Many brews will use tables for things like class tables, roll tables, lists of loot, monster stat blocks and more. All of these tables can have different layouts and don’t necessarily just follow Basic Tables

Description Lists

A description list is a pattern where a term is followed by a description. HTML supports this pattern with three tags: dl, dt, and dd, respectively. The description list (dl) wraps around the term and description, or multiple pairs like an ordered or unordered list (ol, ul) wraps around list items (li). In the above Description Lists

Table of Contents

What is the best way to work with a Table of Contents in the Homebrewery? Homebrewery’s Table of Contents snippet generally works by collecting all of the headers used in your brew and the manipulates them into a list of links. It only does this at the initial generation of your ToC. This means two Table of Contents

Simple Styling

Tables are a common target for custom styling, but due to their HTML structure they can be a little tricky. Let’s look at just some quick and easy changes that you can do in this article. First, here is the HTML structure of a simple 2 column table: HTML tables can be roughly summarized as: Simple Styling

Variables

Homebrewery’s Variables is a feature that really takes a minute to commit to memory. I’ve long avoided writing about it, mostly because I haven’t found a strong reason to use it. However, it seems like more features are likely to built on top of it going forward. And, because I hardly actually use the Homebrewery Variables

Lists

Creating lists in Homebrewery, using Markdown, is quite intuitive, and styling it isn’t half bad either. Homebrewery doesn’t add any special syntax for regular lists, but it does for definition lists (article to come soon). Markup Lists should contain content that is actually a list of related items, and there are basically two types of Lists

Injectors

Injectors are the third and final type of “curly brace” syntax that is unique to the Homebrewery, and they are used to “inject” the preceding element with it’s own attribute contents. It is a custom extension of Markdown, and thus it can be difficult to find any information about how to use it when doing Injectors

Divs

A <div> element in HTML is a basic, generic container for content on a website, similar to a <span> element, except that rather than being “inline” it is a “block” element. In Homebrewery terms, things like the “note” or a “stat block” are pieces of content wrapped in a div. Like a span, a div Divs

Spans

Applying some sort of modification to a span of text on a website would typically require a bit of HTML, specifically a <span> tag with a class or id attribute so it could be targeted with CSS. Homebrewery simplifies this with a special extended Markdown syntax that utilizes “curly” or “mustache” braces for both spans Spans

Links

In your homebrew document you may want to add some links, either to external sites like your own website or to another brew, or some internal links to specific pages or headings so your audience can navigate via a Table of Contents. Adding links can be done with Markdown, saving a lot of effort over Links

Italic

Italicizing text in the Homebrewery is very easy via Markdown syntax, and works in much the same as “bolding” text, with the same caveat that there is a difference between “italicizing” and “emphasizing” text. Where “bold” is to “strong”, “italic” is to “emphasis”. But first, the markup: Markup Using Markdown in the Brew Editor, you Italic

Bold

To add visual weight to a portion of text, you can set the text to be marked as “bold” in the markup. Traditionally, this increases the font weight so it stands out from the surrounding text. This doesn’t always have to be the case, as shown later. Markup Setting text to bold in a Homebrewery Bold

Headings

Markup You can add headings to your homebrew document using the # symbol in the Brew Editor: When you are writing at length, you’ll likely want to have different levels of headings to give your brew some hierarchical structure– first you’ll have a top-level header (or “Header 1”), and then nested under that several more Headings