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

Spaced Out Rides

(This is the kind of thing I'd have sent into Pyramid   back in the day, but that's not an option now, so here we are.)   The GURPS Action series is the gift that keeps on giving for a lot of modern-and-later gaming. GURPS Action 2: Exploits has rules for sneaking around, running away, and all kinds of other activities which can be easily transplanted to cyberpunk and other high-tech settings. GURPS Action 6: Tricked-Out Rides provides more of the same for its topic, giving an easy framework for describing and even designing common types of vehicles without all the math and paralysis-by-analysis of GURPS Vehicles. Pick a standardized vehicle type (van, compact car, etc.) and apply modifiers (rugged, tinted windows). But, of course, it’s limited. It’s just ten pages, after all, so it’s great for common passenger vehicles for the modern(ish) era. But higher-tech vehic...
Post a Comment
Read more

G$ --> DND GP

A GURPS $ is worth 1.27 D&D 5e SP, which is interesting because in GURPS Dungeon Fantasy, the typical $1 coin is a silver piece. And a D&D GP is worth about $7.87 in GURPS. So, where does that come from? A while back, I cautioned someone considering using (among other things) GURPS Renaissance Venice: Merchants of Venice  in a non-GURPS game that prices listed in the extensive lists of trade goods were expressed in GURPS $, which might not have obvious conversions into other game systems. But if one wanted to convert GURPS prices into D&D or vice versa, how would that work? It crossed my mind to take a "basket of goods" approach. Economists measure inflation not by picking a single commodity, like the price of gold or oil or wheat, and seeing how that changes over time, but by taking the combined value of a set of common commodities. This provides a more comprehensive picture of the cost of living. Perhaps gas becomes less expensive while the price of whe...
Post a Comment
Read more

2020 GURPS Challenge PDFs: Incense Trail prices

Over on the forum, somebody asked me how much frankincense and myrrh cost in antiquity. Well, we don't know. We never get as much price information as we like out of history. There's the occasional mention of this or that product being worth its weight in silver or gold, but we can reasonably believe that those are descriptions written by political, cultural, or philosophical commentators trying to give an idea of how expensive things are, not people who have actually done an economic analysis and discovered that the material in question is, by coincidence, exactly the same value as silver or gold and not, say, one and a half times the price of silver or three quarters of the price of gold. We know it was valuable, but not how valuable on the level of individual purchases. But for the convenience of the GM, we can use those comparisons to establish some ballpark figures. Mind you, this is based largely on GURPS rather than historical sources, so it's not something I would h...
7 comments
Read more