Skip to main content

Doctor GURPS Author, Or How I Learned To Stop Worrying And Love The WYSIWYG Template

Something I see over at the forum from time to time is people saying that they're interested in writing for Pyramid or GURPS but are instantly driven off by the size and complexity of the style guide and the WYSIWYG template. And they can be intimidating documents. They're long and there are some really specific guidelines for certain kinds of material.

And that's necessary. Despite working almost entirely in the realm of the imagination, Steve Jackson Games is a technical publisher. They need to organize information in regular, predictable formats. It's like Safety Data Sheets, just of their own design.

But the thing I've noticed in several years of writing GURPS material is that you won't need most of it.

So if you want to write an article for Pyramid, here's what you do: Once you've gotten a thumb-up from Steven on your proposal, get the template, create a new document based on it (Don't use Microsoft Word? Me neither. I use LibreOffice. The template works fine there, and it should work in OpenOffice as well.), and start writing. Use what you need, ignore the rest. And how do you know what you need? Here's how it breaks down:

  • 90% of what you write will be in TEXT. If you're writing a paragraph, put it in TEXT. There are exceptions, but we'll come to those.
  • A-HEAD through D-HEAD are section headings. You do need to think hierarchically when writing your text, but if you can do that, the headings will follow naturally. Start your article or chapter with an A-HEAD. Subsections under that A-HEAD are B-HEADs. Subsections of the Bs are Cs and subsections of the Cs are Ds. This is just an implementation of the outlines you did when writing essays in high school.
  • Text boxes have a sort of subset of that, with special box-related styles (C-BOXHEAD for long boxes, two paragraphs or more, D-BOXHEAD for short boxes, and TEXT-BOX for the main text. And, yeah, you need to throw in the START-END markers to signal the boundaries of the box.
  • Tables are a pain, yes, but you don't have to compose using the table styles. I construct my tables using actual tables in the document. When it comes time to submit the manuscript, I convert the table to text, mark the body with TABLE and header row with TABLEHD. Done. 
  • Specific kinds of material can have very elaborate formatting: spells, monsters, NPCs, etc. This is why the good lord gave us copy and paste. I don't think I've ever tried to write up anything in those complicated categories from scratch. I always copy over the template example and fill in my own text.  
  • And if you want something that doesn't fit or you don't quite get, the good lord has given us Steven Marsh. If you've successfully run a proposal past him, he's there to help. For example, the template and style guide may be missing something. When I last checked the style guide didn't have the format for organization stat blocks from Boardroom and Cura. Want to write an article with organization stats? Don't try to figure it out on your own; ask Steven. Need a format for something new? Try something, or just ask. The table format for Treasure Tables didn't exist until it needed to be worked out, nor did the Boardroom and Cura stat block. Certainly, you'll make a good-faith effort to figure out things on your own, but the answer to some of your questions may be "this isn't in the template/style guide."
  • And put a halfline between style changes that don't have a HEAD or START-END style on one side or another.

So, TEXT under hierarchically arranged HEADs, with occasional use of other styles for special purposes, most of which you can copy-and-paste in. That's not so bad, is it?

Labels:

Comments

Christopher R. Rice said…
Using OO or LO wipes the styleguide options when opening said document in Word. The formatting remains sometimes, but not always. Most of the rest of this is pretty accurate.
August 23, 2017 at 10:47 PM
Post a Comment

Popular posts from this blog

More Nattering About Writing Historical RPGs

omeone made the mistake of asking me to expand on some things I'd said about writing historical rpg material, so you all must suffer for it. I write a lot of historical rpg stuff as well as entirely fictional setting material. So why make historically themed games rather than just making stuff up? Well, because it's an effective way of achieving the purpose of writing settings and adventures in general. The purpose of settings and adventures, I would aver, is to give players things to do in a convincing context. Convincing context doesn't necessarily mean realism. Players have different levels of understanding of what's "realistic" in different situations and are more or less sensitive to how closely those situations adhere to reality. For example, I'm a history and culture guy. Put me in SF campaigns (which happens with some regularity) and the specifics of how reaction drives, orbital mechanics, and subatomic physics work entirely escape me. I don't,
Post a Comment
Read more

Stuff I Wouldn't Do With Purchased Minis

One of the great things about the advent of 3d printing, when it comes to gaming, is that it allows me to take more risks and try stuff I wouldn't do otherwise. Take, for example, experimenting with painting techniques. Maybe I want to see what an unusual color scheme would look like or try doing an odd way of achieving an effect. Factory-made miniatures are expensive. Too expensive for me to risk it. Which, as someone who's not very good at painting minis and needs lots of practice, is one reason I've never gotten into them. I don't feel like I can afford the implied expense of getting better. Enter 3d printing. With the right files, I can print as many minis as I can like and mess around with them to my heart's content. Mess one up? That's fine. Resin isn't cheap , but it doesn't cost nearly as much as pre-made molded plastic. I can take it as a learning experience and move on. Which brings me to messing around with some Car Wars minis. I'd been m
Post a Comment
Read more

Ferrous Metal Food Fighting Guy!

(This is something I wrote up some years back. I'm putting it here so I can find it more easily when I want to. Though it's rather silly, it's also where I came up with the idea of high-quality materials which don't provide a bonus to the craftsman's skill, but do add to the margin of success, a mechanism which later appeared in the crafting rules in GURPS Low-Tech Companion 3 .) One of the things not to be found in GURPS 4e is extensive rules for competitive cooking. If two cooks of steely resolve rise up to face one another across a cooking coliseum, the GM can only fall back on hand-waving and contests of skill. This article fills that much-needed gap. GURPS chefs can now stage furious contests wherein they construct fanciful dishes, the more elaborate the better, and prove whose cooking rules the day. To the kitchen! Procedure These rules provide guidance for attempting to cook complex dishes and comparing their quality when the cooking is done. A che
1 comment
Read more