New versions of the template, template how-to, and Writing OO Guides
have been proofed for "Tip" capitalization, plus minor proofreading, and
uploaded. I believe that this completes the cleanup of our "internal"
documents. Writers' Guide chapters forthcoming, slowly.
Lessons learned: when changing formatting, it is probably wise to
change the setting of Tools > Options > Writer > Changes Change
Attributes list box. By default, it adds bolding to the changed area;
if you're changing font attributes, this can be very confusing. I
selected "background color", but other choices (like double-underline)
are also easier to work with. This might be worth a tip somewhere in
the OOWG.
Query: is there a use for the three old (pre-publication) versions of
documents that were already in the Contributor Resources Feedback
folder? If not, could somebody remove them?
Jean Hollis Weber wrote:
TJ and Gary,
The words "Tip", "Note" and "Caution" should have the paragraph style
"OOoTip/Note/Caution". This paragraph style has existed in the template
for some time and is applied to the Tip/Note/Caution paragraphs in the
template.
Quite right (I was wrong). No action was required beyond changing the
actual capitalization.
snip
Thanks to both Gary and TJ for their work on this chapter.
TJ, thank you for your offer to clean up the other chapters. I accept
with enthusiasm!
I plan to let these chapters straggle in over several weeks. By all
means let me know if you need them faster. The actual cap change is one
Find & Replace operation, so I can turn them around very quickly, at
need. /tj
--Jean
Gary Schnabl wrote:
Be advised that the three OOoAuthors "notes" in the "template" are
1-row, 2-column tables. Table text can carry its own formatting
styles. In the last edit, when I overwrote those several instances of
"IP" in "TIP" with "ip", the formatted style should not have changed.
It should still be the same table text style that was previously used.
Pardon my ignorance about this, but without my checking again, I am
not sure just what particular styles are used for the body text in the
"notes".
Whoever proofs the recent edits can commit whatever edits that seem
appropriate in preparation for its being republished. Also delete the
inappropriate graphic in the section concerning the ruler because it
doesn't reflect reality. A correct graphic can be added later.
However, do these on a different file that I will upload in a bit
because there are two cases whose character styles I missed applying
and there is a typo in a comment note (no biggie, I guess...).
Gary
T. J. Frazier wrote:
Jean and Gary,
I will volunteer to do some or all of the cleanup involved (as
previously outlined), if you like. I rather enjoy wielding a dustpan
and broom, and you two can spend your time doing things I can't do
(yet or ever). /tj
Jean Hollis Weber wrote:
I have been intending for some time to change "TIP" to "Tip"
everywhere in the books, so I'm glad TJ brought this up. The
inconsistencies he noted are almost surely due to me changing this
in some places but not in all, and not in the template.
Gary, I encourage you to change the template. Then as the chapters
get revised for other reasons, we can progressingly change them to
suit.
Regards, Jean
Gary Schnabl wrote:
Changing "TIP" to "Tip" puts that "note" in line with the other two
in that all three will then be using the same font effect, instead
of "TIP" being the "lone man out" in All-Caps. Besides, OOoAuthors
uses "sentence" style capitalization for headings and such, instead
of the "headline" style used in the documentation of some others.
Having "Tip" is also more in line with that concept.
Notice that the latest edit of Chapter 3 is not published yet. So
this edit was a trial balloon for this anticipated change. If
adopted, all that is needed is a simple change in the "template"for
future work and a simple change for the older versions.
Gary
T. J. Frazier wrote:
Gary Schnabl wrote:
Chapter 3 of the Writer Guide was proofread on 15 Dec 2006 with
some subsequent edits (1 Jan 2007). (snip)
My thanks to Gary for showing a newbie, by example, how to do it.
Working with Text - WG Chapter 3
<http://oooauthors.org/en/authors/userguide2/writer/feedback/0203WG-WorkingwithText_15Dec06_JHW_TJ_GS.odt/file_view?portal_status_message=File%20changes%20saved.>
(snip)
There is a string of problems associated with the capitalization
change
of the tip feature, from "TIP" to "Tip".
1) The source of the problem is the chapter template, which shows
"TIP"
in the "things to be copied" section. This needs changing. The
"Template How-to" should reflect this change, as well.
2) The recommended procedure is to copy these examples into the
AutoText
mechanism. That means that current authors must be warned to
re-copy
the corrected examples.
The following Item #3 is just plain wrong. Sorry. /tj
3) The bold formatting in the template (for tip, note, and
caution) is
locally applied. This is probably a bad example for our authors. The
OOoStrongEmphasis style can't be used, because of the different font
specifications. I suggest that we need another character style for
this. (What we actually need is an option to "use existing font"
on the
Font page of the Character Style dialog, so that the style only
applies
the font effect; but that's a code matter.)
If we decide to change "TIP" to "Tip", I will include that in my
on-going proof-reading of the published chapters. /tj
--
TJFrazier
