Import a Homebrewery brew
If you’ve written a brew in Homebrewery, you don’t have to type it out again. Import a brew reads it — its chapters, notes, read-aloud boxes, monster blocks, tables and pictures — and makes a document of it, laid out in Page Studio in a look you can change. Importing is free.
Import a brew
Section titled “Import a brew”- Open Documents and click Import a brew.
- Give it the brew, one of two ways:
- Its share link — in Homebrewery, open the brew’s Share menu and copy
its link (
homebrewery.naturalcrit.com/share/…). Only Homebrewery’s links work here, and the brew has to be shared. Its edit link won’t do: that one is for its author alone. - Paste the brew — copy everything in Homebrewery’s editor (the left-hand pane) and paste it in. If the brew has a Style tab, paste that into the box below it, so its colours and fonts come across too.
- Its share link — in Homebrewery, open the brew’s Share menu and copy
its link (
- The brew is read straight away. You see what was found — its title, its pages, its style and how many pictures it has — the import report, and how it will look.
- Click Import as a document. Its pictures are copied into your library, and the document opens in Design mode.
How it comes across
Section titled “How it comes across”| In your brew | In the document |
|---|---|
Each # heading |
A chapter |
| A part cover page | A part, its title and picture on the part’s opening page |
{{note}} |
A sidebar |
{{descriptive}} |
A read-aloud box |
{{monster}} |
A real 5e stat block (or, when it doesn’t read cleanly, a sidebar with its table) |
{{wide}} |
Blocks that span both columns |
{{toc}} |
The document’s own contents page, built from your headings |
| The front cover | The look’s cover, with your title, subtitle, author and cover picture |
| The inside cover | A title page |
| The back cover | A back cover, with its words |
{{artist}} |
The credit on the pictures on its page |
| Tables, lists, quotes and code | Tables, lists, quotes and code |
A picture placed by position (position:absolute) |
A picture pinned to its page, behind the text, in the same place |
| Any other picture | A picture in the text, its width as its size |
Words that sat on a cover with no place of their own are kept on the title page, so nothing you wrote is left behind.
Pictures
Section titled “Pictures”Pictures are copied into your library from the sites brews usually use: imgur, GitHub, Homebrewery, Discord and Google’s picture links. Each one can be up to 20 MB, and they count toward your storage like any upload. One import copies up to 60.
A picture from anywhere else, or one that couldn’t be fetched, is listed in the report under Left out, with where it was in the brew. Upload it to the document after import. Homebrewery’s own art — its logo and decorations — is never copied.
Some pictures can’t come across even from those sites. In some regions imgur won’t show a picture and sends a “not viewable in your region” picture instead: PostRoll leaves that out and lists the picture under Left out, so you can download it where imgur shows it and upload it to your document. Tracking pixels and spacers — pictures only a few pixels across — are left out too.
The look
Section titled “The look”The brew’s style becomes the nearest PostRoll look — the 5e book style becomes The Long Walk, for example — on the same paper (Letter, or A4 if the brew’s Style tab sets it). The colours and fonts in the Style tab come across where PostRoll has a match; a colour that would make the text hard to read is left out, and the look’s own is kept. Everything else in the Style tab is left out — the report says how many rules.
Change the look, colours and fonts in the Look tab afterwards, as with any document.
Page and column breaks
Section titled “Page and column breaks”A Homebrewery page is a fixed box, so brews break their pages and columns by
hand. In PostRoll pages flow on their own, and the look’s type is a different
size, so each \page and \column is kept as a break before the block that
followed it — a hint you can keep or clear. Select the block and set its
Break before in the Block tab.
What’s left out
Section titled “What’s left out”- Page-number and footer snippets — the look numbers its pages and prints its own running heads.
- Spacing lines (
:) and style snippets ({color:red}) — the words are kept, the styling isn’t. - Stains, flourishes and picture masks — the pictures in a mask are kept.
The report lists each of these, so you can check the document against your brew.