Tuesday, October 25, 2005

OUR DAILY O'REIILLY I: Abbreviations/Acronyms

DAILY O'REILLY STYLESHEET EXCERPTS BEGINING AS OF NOW:

DAY ONE:
Abbreviations/Acronyms

Acronyms should generally be spelled out the first time, as in: GROSS RENTAL INCOME (GRI). Thereafter only the acronym should be used.

Acronyms should be defined once per unit of publication, i.e. once in a book, once for a website, once for an essay.

Please use either A.M. and P.M. or a.m. and p.m., consistency is cool.
[12:00 am is always midnight, 12:00 pm is always noon. GS]

K = 1024; k = 1000. So a 56 kbps modem is equal to 56,000 bps, while 64K of memory is equal to 65,536.

NEXT: Bibliographical Entries

DAILY O'REILLY II: Bibliographical Entries

DAILY O'REILLY STYLESHEET EXCERPTS DAY TWO:

Bibliographical Entries

In general, when referencing another book within a book's text paragraphs, note only

the name of the book and the publisher.

It isn't necessary to list the author names.


For other information regarding bibliographical entries, see The Chicago Manual of Style, 14th Edition.

Gisela Strauss
Technical Translation, Adaptation

DAILY O'REILLY III : Cross-References

DAILY O'REILLY STYLESHEET EXCERPTS DAY THREE:
DAILY O'REILLY: Cross-References


An example of a chapter cross-reference: see Chapter 27.

An example of a section cross-reference: see "Treatment" later in this chapter.

An example of a section cross-reference in another chapter: see "Acceptable Gifts" in Chapter 29.

DAILY O'REILLY IV: Dates and Numbers

DAILY O'REILLY STYLESHEET EXCERPTS DAY FOUR:
DAILY O'REILLY: Dates and Numbers

# Spell out numbers under 10, unless the same object appears in a sentence with an object 10 or over (five apples; 5 apples and 100 oranges).

# Use numerals for versions (Version 5 or v5).

# Use a numeral if it's an actual value.

# 32-bit.

# 1980s.

# Phone numbers can appear in the format (xxx) xxx-xxxx, or in the format xxx-xxx-xxxx. Pick a format and be consistent.

DAILY O'REILLY V: Figures, Tables, and Examples

DAILY O'REILLY STYLESHEET EXCERPTS DAY FIVE:
DAILY O'REILLY: Figures, Tables, and Examples

Every figure, table, and example should be mentioned and identified in the text before (for example: see Figure 99-1; Example 1-99 shows; Table 1-1 lists, etc.). Figures, tables, and examples should not be introduced with colons or phrases like "in the following figure," or "as shown in this table." Since figures float, lack of specific in-text references may cause incorrect placement of figures.

Any word groupings within a figure should have an initial cap on the first word only, with the exception of proper nouns. Generally, we don't use periods at the end of these word groupings.

Figure, table, and example numbers should be numbered as follows: 1-2 (note hyphen, not en-dash between numbers). The first number is the chapter number. This will be soft-coded in production if not during the writing process.

* Figure 1-1. Figure captions are initial-capped on first word only, with the exception of proper nouns. There is no period after figure captions.

* Table 1-1. Column heads & table titles are initial-capped on the first word only, with the exception of proper nouns. There is no period after table titles.

* Example 1-1. Example titles are initial-capped on the first word only, with the exception of proper nouns. There is no period after example titles.

Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 2.0 Germany License.