Thursday, February 12, 2009

How to mark Stuff in Doc as new...

There was a question posed on Techwr-L that asked about how to specify that text is new.
Rick Stone started out the following idea by proposing creating styles. To flesh that out a bit more, here's a simple example.
I have Body-Text defined as this in my CSS file:
p.Body-Text
{
font-size: 1em;
font-family: arial, helvetica, sans-serif;
margin: 1.5em 6.5em;
}
I would create Body-Text_release_whatever and define it as:
p.Body-Text_release_whatever
{
font-size: 1em;
font-family: arial, helvetica, sans-serif;
margin: 1.5em 6.5em;
color: yellow; <== replace "yellow" with whatever color you want. } For a brand new paragraph, you'd have: [p class="Body-Text_release_whatever"]Blah blah blah.[/p]
And then assign all the changed text that style.
If you need text within a paragraph, do something like this:

.release_whatever
{
color: yellow; <== replace "yellow" with whatever color you want. }
So, for a paragraph with changed text, you'd have:
[p class="Body-Text "]Blah blah blah [span class="release_whatever"]this is new info[/span] and that's why the Earth is flat.[/p]

You may have to define something for each of your CSS styles, but as long as you're religiously applying styles for each change in text, you can manage it.
Then, after "release whatever" is cut, you'd edit your CSS file to 'up' the version and do a find and replace, looking for "release_whatever" and apply your regular styles. OR, totally removing the tags.
An additional option would be to NOT get rid of the "release_whatever" style. You would go to your CSS file and make two simple changes.
First, for your p style, you would remove the color from the style definition.
p.Body-Text_release_whatever
{
font-size: 1em;
font-family: arial, helvetica, sans-serif;
margin: 1.5em 6.5em;
color: yellow; <== remove this }
Second, you would change your span style to not be yellow.

.release_whatever{color: yellow; <== replace "yellow" with whatever color your other text normally is }
Doing things this way would mean that you could easily come up with a list of changes that were made for a specific release. When the specific release was no longer "new," you would remove the color attribute that made it stand out and it would look exactly like your other text.

No comments: