Gswiki talk:Style guide

The official GemStone IV encyclopedia.
Revision as of 14:45, 9 February 2017 by ZHOUY1 (talk | contribs) (Common style for verb pages?)
Jump to navigation Jump to search

Has anything been decided on this? I think most current editors prefer writing things that are current in current tense. VANKRASN39 (talk) 11:26, 8 January 2015 (CST)

I have removed the H from IUHPOV so that articles are officially acceptable in present tense if something still exists, like Wehnimer's Landing. Thanks to Scribes for his input. VANKRASN39 (talk) 13:45, 15 June 2015 (CDT)

It would be good to have a guideline for whether category and article section headings should use the same style as article titles. Personally I feel it would be more consistent that way going forward as it matches native wiki style better (though it's not necessary to retroactively change existing categories, which are split half and half at the moment). ZHOUY1 (talk) 16:14, 19 August 2015 (CDT)

Verbs

After the Sylvanfair verb list was preserved for historical reasons (let's not revisit that debate here) there hasn't been a good up-to-date master resource on verbs. With labeled section transclusion we should be able to make an improved version. It would involve some preparation work in giving the verb pages a uniform format and marking off "usage" and "info" sections to be transcluded into a master list.

Here's a possible common style based on in-game help files. Any additional information about the verb can go below this and would not be transcluded.

BRISTLE

Usage

<section begin=usage />

  • BRISTLE SELF - Bristle at yourself.
  • BRISTLE {option} - Bristle with the following options.
  • BRISTLE {target} - Bristle at someone or something.

Where {option} is one of the following:

ANXIOUS EXCITED HAPPY IMPATIENT NERVOUS PROUD SATISFIED SLEEPY SMUG

<section end />

Information

<section begin=info />

No target:

STANDARD - Vanah tries to bristle, but only succeeds in grimacing.

Self target:

HALF-KROLVIN - Vanah turns her head slightly and tenses up, bristling.

Styles (Half-Krolvin only):

ANXIOUS - Vanah glances around, bristling with anxiety.
EXCITED - Vanah bristles with excitement!

<section end />

Math section

Proposed text for a section on math formatting before we introduce too many different styles— ZHOUY1 (talk) 14:36, 19 September 2016 (CDT)

Non-inline formulas should be indented or wrapped in a box:

:<math> ... </math> or {{Equation box|<math> ... </math>}}

Multi-letter variables should be wrapped in a mathrm or mathit tag:

  • \mathrm{SkillRanks}
  • \mathit{SkillRanks}

For truncation/ceiling operators, use \lfloor ... \rfloor and \lceil ... \rceil. To wrap a multi-line expression (such as a fraction), use \left \lfloor{...} \right \rfloor.

For multiplication, use a dot \cdot () where necessary to avoid ambiguity. For purely arithmetic expressions, \times is also acceptable (), but prefer using a dot in algebraic expressions to avoid confusion with the letter x.

For division, use a slash / or fraction notation: \frac{...}{...}

With the Redux page I went to the pages with your math contributions and tried to copy whatever you did, so this is good for me. I'd prefer everything to be in Roman instead of mixed with italics. VANKRASN39 (talk) 15:04, 19 September 2016 (CDT)
Any examples where you'd want a slash over a negative exponent or a \textstyle fraction? PFLATS (talk) 18:21, 19 September 2016 (CDT)
I feel it's easier to understand slash than negative exponents, and inline \textstyle or \tfrac can be hard to read. (See also: http://jmlr.csail.mit.edu/reviewing-papers/knuth_mathematical_writing.pdf#page=21) ZHOUY1 (talk) 18:53, 19 September 2016 (CDT)
pssh, what does this knuth guy know about typesetting? PFLATS (talk) 19:45, 19 September 2016 (CDT)