User:CateranLlama

Formatting

In which the Llama places lots of examples of murky-guideline'd formatting. Please don't use this as a series of hard and fast rules, this is all murky enough that your PP probably ought to be contacted before you use it!

/##/ nested in /**/

Not usually the most effective way of dealing with a problem page (at least not without PP/PM approval) because Guiguts will ignore everything inside the /**/ when rewrapping, including anything in the /##/.

/**/ nested in /##/

CHAPTER XV

THE PLACE OF DEPARTED SPIRITS

/#
Every man carries his skull under his face, but
God alone knows the marks on it.

/*
<i>Indian Proverb</i>
*/
#/


For a man moved, silent and furtive ...

Nested /##/

Will create a section of greater indent inside a section of indent.

A) Met <i>n</i> achter de toonlooze <i>e</i> worden geschreven

/#
<i>a</i>) al de woorden, bedoeld in nº. 1 (§ 188);

<i>b</i>) van de woorden, bedoeld in nº 3:

/#
[Greek: a]) de samenstellingen, wier eerste lid een één- of
tweelettergrepige persoonsnaam is; alsmede de
woorden op <i>-in</i> of <i>-inne</i>, <i>-es</i> of <i>esse</i>[**-esse], die meerlettergrepig
zijn; b. v. <i>boerendochter</i>, <i>heldendaad</i>,
<i>vrouwenkleed</i>, <i>koninginnenmantel</i> (§ 193);

[Greek: b]) de samenstellingen, wier eerste lid een manlijke
diernaam is, die geene composita met <i>s</i>
vormt; b. v. <i>apengezicht</i>, <i>berenklauw</i> (§ 194);

[Greek: g]) botanische benamingen, wier eerste lid een
diernaam is, onverschillig manlijk, vrouwelijk of
onzijdig, wanneer de samenstelling geen lichaamsdeel
aanduidt, maar op de geheele diersoort ziet;
b. v. <i>duivenkervel</i>, <i>slangenkruid</i> (§ 195).
#/
#/

B) Zonder <i>n</i> achter de toonlooze <i>e</i> worden geschreven

/#
<i>a</i>) al de woorden, bedoeld in nº2, tenzij de <i>n</i> door
Regel IV voor de welluidendheid gevorderd wordt
(§ 190);

/**/ and [Footnote: ]*

indicate the particular points deserving your study in
each engraving.[A] Be sure, therefore, that your selection

[Footnote A: The plates marked with a star are peculiarly desirable. See note at
the end of Appendix I. The letters mean as follows:--

/*
<i>a</i> stands for architecture, including distant grouping of towns, cottages, etc.
<i>c</i> clouds, including mist and aerial effects.
<i>f</i> foliage.
<i>g</i> ground, including low hills, when not rocky.
<i>l</i> effects of light.
*/
]* 

Note that the opening /* or /# must have a blank line before it, even inside another tag. Which occasionally leads to

[Illustration:

/#
Text of the caption
     that is in hanging
     indented paragraph. 
#/

Footnote within a Footnote

I don't have the image, but the text was posted as ...

1 The English were famed in the Middle Ages for their preference
for good bread. They would eat no bread

"That beans in come,
But of cocket [*] or clerematyn [*] or else of clean wheat."

-<i>Piers Plowman,</i> A. vii. 292.

2  Walter of Henley, p. 29.

* Better kinds of bread, but not the best (wastel).

[Footnote 1: The English were famed in the Middle Ages for their preference
for good bread. They would eat no bread

/*
"That beans in come,
But of cocket[A] or clerematyn[A] or else of clean wheat."

--<i>Piers Plowman,</i> A. vii. 292.
*/

[Footnote A: Better kinds of bread, but not the best (wastel).] ]

[Footnote 2: Walter of Henley, p. 29.] 

Continued Footnote Starting With New Paragraph

§ 672. The chief reason against the naturalization of metres
of the sort in question (over and above the practical one of
our having another kind in use already), lies in the fact of
their being perplexing to the readers who have <i>not</i> been

*[Footnote:[**Continued Footnote starts with new paragraph.]
1. Monosyllables, not enclitic; as [Greek: sphô´n, pa´s, chthô´n, dmô´s, nô´n, ny´n], &c.

2. Circumflex futures; as [Greek: nemô´, temô´], &c.

3. Words abbreviated by apocope; in which case the penultimate is converted
into a final syllable; [Greek: dô´m', pheides´th' kentei´t', egô´g'], &c.

Now the fact of a syllable with an arsis being, in Greek, rarely final, taken
along with that of the sixth syllable requiring, in the senarius, an arsis, gives]*

Sidenotes and /##/

[17:01:24] <CateranLlama> Can a sidenote that's noting /##/ text go inside the /##/ or does it need to go outside the /##/, at the beginning of the block? Or should one close and open the /##/ around the [Sidenote: ]? [17:01:45] <acunning40> It can go within the /##/.

Sidenotes and [Illustration: ] tags

If a sidenote clearly talks about an illustration, move the sidenote to the beginning of the illustration tag, no matter where the paragraph breaks make you move the illustration tag.

the delivery, he will not follow it far, since there is
still another feature of this service to contend
with in the unnatural bound, or "break" from the
ground. The side spin that makes the ball bend in
going through the air has a different effect when
it strikes the ground.

[Sidenote: <i>Diagrams
Show the
Curves of
the Ball</i>]

[Illustration: AMERICAN TWIST

REVERSE TWIST]

[Sidenote: <i>Side Spin
Makes the
Erratic Bound</i>]

Spinning sharply from right to left, the ball's
rotation is the same as that of a billiard ball with

A few notes about PPing

In order to open GG on a Mac, open X11 and type

cd /dp/guiguts
perl guiguts.pl &

When the line-length checker is acting up, you can regex search for this: ^.{75,} to catch long lines.

\n searches for a newline in GG (it's a regex) but you have to search for \n\n\n\n\n\n to search for five blank lines. (it counts the line break above as well)

Front Matter

• No matter what the F rounds offer you, it's almost certainly wrong. (Or at least, not how you want it handled.)
• Too much "formatting" clutter can be more confusing than it's worth.

Indexes

• Indexes are a pain.
• Alignment doesn't matter (except for the rare occasion when it does).
• You can't link stuff up in this version, but keep in mind the HTML will need lots of links here, keep it clean!

ToCs

• TOCs are easier to PP than format.
• Very similar to short indexes, but more likely to have elements that need special alignment.
• "paragraph" ToCs are MUCH easier to PP than format. Just mess with the indents some.
• Indent regular ToCs two spaces.

Tables, poetry and other no-wrap things need to be indented two spaces to save them from later rewrapping.

Transcriber's Notes

• [Transcriber's Notes: ]
• Always in third person

Anything you don't want to have rewrapped needs to be set in two spaces. (Tables, menus etc.)

[OE]'s (when they're not used a lot) can be represented by [OE], Oe or cause for a different encoding version, but whatever you do, talk about it in the the TN.

No CR? errors in Gutcheck

Frau Sma says: I do it in TextWrangler, which has a GUI and a very easy way of fixing things. If you don't have it yet, you can download it from this page—it's free and a great text editor. You just open the file in TextWrangler, and at the very bottom of the screen it has drop-down boxes. One of them can read either “Windows (CRLF)”, “Mac (CR)” or “UNIX (LF)”. It will read “UNIX” on Guiguts-saved files. You just change this option to “Windows” and save the file—and voilà, the WhiteWashers will be happy!

Dani says to open a terminal window, cd to the proper directory and type one of these. (Though he doesn't know if recode comes standard on all OSXs.)

recode ../CRLF filename    (unix to dos)
recode /CRLF../CR filename      (dos to mac)
recode /CR../CRLF filename     (mac to dos)

In reference to GG auto-html making the <hr 's one thing in the header, then manually making every <hr 's in the text 65% across, I was told...

[12:34:38] <acunning40> give me a few minutes and I could help I think :) [12:38:59] <acunning40> okay, it's pretty easy to edit the GG file to do this [12:39:40] <acunning40> what you'd need to do is open the guiguts.pl file, which is inside the guiguts folder. You need to open it in a text editor, not just double-click on it. [12:40:12] <acunning40> Then search for 65%, which only occurs once in the file. [12:40:15] <cateranllama> Should I not have GG open to be doing this? [12:40:27] <acunning40> probably best to close it, yes [12:40:58] <acunning40> searching for 65% will locate a line of text which contains the hr code: <.hr style=\"width: 65%;\" /> [12:41:15] <acunning40> so you could change that to plain <.hr /> and save the file :) [12:41:39] <cateranllama> Oh. Even I should be able to manage that. Thank you! :D

header.txt doesn't always show the text in TextEdit, but it opens in TextWrangler just fine. So if it looks blank when you double-click, try a different editor. Replace the text there with what you want to see when you auto-html. Save. No more retyping the thing every time!

Etiquette for txt and html versions I can't find records of elsewhere

(Gleaned from many long notes from patient PPVs)

For the title (the part in the <title></title> tags), usually the format for that is Title, by Author. As a PM, I can tell you that a lot of these old books have titles that end with periods and it means absolutely nothing. I think authors thought it made their books seem more authorative or something.

At DP, for the HTML version, you want to use the Latin-1 or HTML versions of fractions if possible. (See this for codes)

Also, PG tends to frown on scaling down images in the HTML (i.e., assigning them a percentage width in the CSS), plus it can be a pain for people on dial-up, as when you scale an image, the image loads at full-size first, and then scales.

When you know you are finished with the html look at the CSS and remove any unused classes

GG messes up page numbers most of the time. Most often, this involves putting them places the validator doesn't like them, but it also includes putting the first number in any given chapter in the previous chapter and occasionally offsetting the numbers by some odd amount. Check them all before uploading!