RE: [docbook-apps] How do I highlight inline text ?

2010-04-12 Thread Rowland, Larry 
Another thing to keep in mind is that DocBook already has a large
assortment (some people say too many, but others of us disagree) of
semantic elements available that describe many features of computers.
Before investing in time to create a new class of things by using a
role on emphasis, make sure that there is not already something
available in the elements provided by DocBook.  Some of them have 
numerous variations added through a class attribute (systemitem has
21 values enumerated for the class value).  One of the values of a 
semantic markup system is that there are already a number of semantic
bindings available in DocBook.  You can customize the CSS style that 
is associated with the semantic tags that are already available, too
(that's what the cascading part of cascading style sheet means) if
you want more or different formatting for the semantic you are trying 
to represent (not all elements in DocBook have a unique format
associated with them).

You can also extend the class attributes if you pick up a little of
the RelaxNG grammar (there are lots of tutorials about it online).
In using DocBook for a number of years here, we have tended to use
tags like systemitem and add class values rather than using the
role on emphasis, reserving emphasis for the more generic concept of
This is important rather than for semantic bindings.  Extending
things through role is simpler, but using class and other more
structured solutions provides better support for the authoring
process since syntax aware editors provide hints to the user for
enumerated values like class.

I think CSS is great fun and it has been well worth the time
invested in it to learn it (I spent an afternoon a few weeks ago
learning how to use DIV elements instead of tables for controlling
positions, which was quite a trip).  I also have found the time spent
learning DocBook by referencing The Definitive Guide worthwhile.
There are a lot of elements available, and I don't pretend to know
all of them, but I always look at the table of contents, which lists
the elements, before I set out to extend it.  I frequently find the
DocBook team has been there before me and that all I have to do is
tell the writers what element to use instead of inventing something.

Regards,
Larry Rowland

-Original Message-
From: Dave Pawson [mailto:da...@dpawson.co.uk] 
Sent: Sunday, April 11, 2010 4:44 AM
To: Robert Lucente
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] How do I highlight inline text ?

On Sun, 11 Apr 2010 06:22:18 -0400
Robert Lucente rluce...@pipeline.com wrote:

  a.. Create a cascading style sheet w/ a file name of key_words.css
  w/ the following entry
  
  .key_words { background: yellow; }
 
 Nit picking, use semantic names for the attribute?
 I may be wrong here. 
 
 [RL Start]
 
 Nathalie Sequeira on April 07, 2010 5:31 PM recommended the following
 
 emphasis role=semantic_function_of_the_emphasissome
 text/emphasis
 
 I thought that this was way cool. Then if I wanted to change the how
 the semantic was displayed, just change the CSS.
 
 Humm. What am I missing ?
 
 [RL End]

I guessed that 'keyword' wasn't semantic. Was I wrong?
If it does identify a keyword in your xml markup, my apologies. 



 [RL Start]
 
 I don't know anything about XSL. I will add it to the stuff to go
 learn.
 
 Is putting parameters in XSL just a best practice thing ?

I think so. puts all your 'styling' in one place?..
except it's two, one stylesheet importing another. 


 
 It makes sense. This way you have all your styling knobs in one spot
 as opposed to 2 different spots.
 
 Thanks for the help.


Welcome.




-- 

regards 

-- 
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org


-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

RE: [docbook-apps] How do I highlight inline text ?

2010-04-12 Thread Robert Lucente 
... DocBook ... elements ...

Is the following the official DocBook element reference ?

http://www.docbook.org/tdg/en/html/ref-elements.html

Before investing in time to create a new class of things by using a
role on emphasis, make sure that there is not already something
available in the elements provided by DocBook

Thanks for the suggestion.

I did the classic thing of looking through the docs and stopped looking as
soon as I found the first thing that could solve my problem.

tended to use
tags like systemitem and add class values rather than using the
role on emphasis, reserving emphasis for the more generic concept of
This is important rather than for semantic bindings

Thanks for trying to help me obtain the correct mindset.


-Original Message-
From: Rowland, Larry [mailto:larry.rowl...@hp.com]
Sent: Monday, April 12, 2010 11:44 AM
To: Dave Pawson; Robert Lucente
Cc: docbook-apps@lists.oasis-open.org
Subject: RE: [docbook-apps] How do I highlight inline text ?


Another thing to keep in mind is that DocBook already has a large
assortment (some people say too many, but others of us disagree) of
semantic elements available that describe many features of computers.
Before investing in time to create a new class of things by using a
role on emphasis, make sure that there is not already something
available in the elements provided by DocBook.  Some of them have
numerous variations added through a class attribute (systemitem has
21 values enumerated for the class value).  One of the values of a
semantic markup system is that there are already a number of semantic
bindings available in DocBook.  You can customize the CSS style that
is associated with the semantic tags that are already available, too
(that's what the cascading part of cascading style sheet means) if
you want more or different formatting for the semantic you are trying
to represent (not all elements in DocBook have a unique format
associated with them).

You can also extend the class attributes if you pick up a little of
the RelaxNG grammar (there are lots of tutorials about it online).
In using DocBook for a number of years here, we have tended to use
tags like systemitem and add class values rather than using the
role on emphasis, reserving emphasis for the more generic concept of
This is important rather than for semantic bindings.  Extending
things through role is simpler, but using class and other more
structured solutions provides better support for the authoring
process since syntax aware editors provide hints to the user for
enumerated values like class.

I think CSS is great fun and it has been well worth the time
invested in it to learn it (I spent an afternoon a few weeks ago
learning how to use DIV elements instead of tables for controlling
positions, which was quite a trip).  I also have found the time spent
learning DocBook by referencing The Definitive Guide worthwhile.
There are a lot of elements available, and I don't pretend to know
all of them, but I always look at the table of contents, which lists
the elements, before I set out to extend it.  I frequently find the
DocBook team has been there before me and that all I have to do is
tell the writers what element to use instead of inventing something.

Regards,
Larry Rowland

-Original Message-
From: Dave Pawson [mailto:da...@dpawson.co.uk]
Sent: Sunday, April 11, 2010 4:44 AM
To: Robert Lucente
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] How do I highlight inline text ?

On Sun, 11 Apr 2010 06:22:18 -0400
Robert Lucente rluce...@pipeline.com wrote:

  a.. Create a cascading style sheet w/ a file name of key_words.css
  w/ the following entry
 
  .key_words { background: yellow; }

 Nit picking, use semantic names for the attribute?
 I may be wrong here.

 [RL Start]

 Nathalie Sequeira on April 07, 2010 5:31 PM recommended the following

 emphasis role=semantic_function_of_the_emphasissome
 text/emphasis

 I thought that this was way cool. Then if I wanted to change the how
 the semantic was displayed, just change the CSS.

 Humm. What am I missing ?

 [RL End]

I guessed that 'keyword' wasn't semantic. Was I wrong?
If it does identify a keyword in your xml markup, my apologies.



 [RL Start]

 I don't know anything about XSL. I will add it to the stuff to go
 learn.

 Is putting parameters in XSL just a best practice thing ?

I think so. puts all your 'styling' in one place?..
except it's two, one stylesheet importing another.



 It makes sense. This way you have all your styling knobs in one spot
 as opposed to 2 different spots.

 Thanks for the help.


Welcome.




--

regards

--
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

Re: [docbook-apps] How do I highlight inline text ?

2010-04-11 Thread Dave Pawson 
Just one comment. 


On Sat, 10 Apr 2010 19:29:20 -0400
Robert Lucente rluce...@pipeline.com wrote:


 a.. Create a cascading style sheet w/ a file name of key_words.css w/
 the following entry
 
 .key_words { background: yellow; }

Nit picking, use semantic names for the attribute?
I may be wrong here. 



a.. Create a DOS batch file setting the following parameters
 
   1.. emphasis.propagates.style: 1
 
   2.. html.stylesheet: file://localhost/C:\ypl\doc_book\key_words.css
 
 a.. The DOS batch file name was using_role_as_class_name.bat and it
 contained the following contents
 
 REM
 REM Set the classpath
 REM
 set classpath=.;
 REM
 REM
 REM Output contents of environment variables
 REM
 set
 REM
 REM
 REM Generate HTML from DocBook XML
 REM
 C:\Program Files\Java\jre1.5.0_22\bin\java ^
   -cp C:\ypl\java\xalan.jar;C:\ypl\java\serializer.jar
 org.apache.xalan.xslt.Process ^
   -v ^
   -xsl C:\ypl\doc_book\xsl_1.75.2\html\chunk.xsl ^
   -in using_role_as_class_name.doc_book_xml ^


This is my disagreement with how you have done it.

   -param emphasis.propagates.style 1 ^
   -param html.stylesheet
 file://localhost/C:\ypl\doc_book\key_words.css ^ -param base.dir
 html/ EXIT

I do it differently is the best way I can say this.
1. I didn't know I could set parameters on the command line :-)
2. I always use an 'import' method to set my parameters


Create a normal stylesheet
First statement inside xsl:stylesheet
xsl:import href='ypl/doc_book/xsl_1.75.2/html\chunk.xsl'

the set your parameters
xsl:param name='emphasis.propagates.style' select='1'/
xsl:param name='html.stylesheet'
select='/ypl/doc_book/key_words.css'/

/xsl:stylesheet


Note the quoted css file
Note the forward / not \

HTH


-- 

regards 

-- 
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

RE: [docbook-apps] How do I highlight inline text ?

2010-04-11 Thread Robert Lucente 
Comments below start w/ [RL]

-Original Message-
From: Dave Pawson [mailto:da...@dpawson.co.uk]
Sent: Sunday, April 11, 2010 2:42 AM
To: Robert Lucente
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] How do I highlight inline text ?


Just one comment. 


On Sat, 10 Apr 2010 19:29:20 -0400
Robert Lucente rluce...@pipeline.com wrote:


 a.. Create a cascading style sheet w/ a file name of key_words.css w/
 the following entry
 
 .key_words { background: yellow; }

Nit picking, use semantic names for the attribute?
I may be wrong here. 

[RL Start]

Nathalie Sequeira on April 07, 2010 5:31 PM recommended the following

emphasis role=semantic_function_of_the_emphasissome text/emphasis

I thought that this was way cool. Then if I wanted to change the how the
semantic was displayed, just change the CSS.

Humm. What am I missing ?

[RL End]

a.. Create a DOS batch file setting the following parameters
 
   1.. emphasis.propagates.style: 1
 
   2.. html.stylesheet: file://localhost/C:\ypl\doc_book\key_words.css
 
 a.. The DOS batch file name was using_role_as_class_name.bat and it
 contained the following contents
 
 REM
 REM Set the classpath
 REM
 set classpath=.;
 REM
 REM
 REM Output contents of environment variables
 REM
 set
 REM
 REM
 REM Generate HTML from DocBook XML
 REM
 C:\Program Files\Java\jre1.5.0_22\bin\java ^
   -cp C:\ypl\java\xalan.jar;C:\ypl\java\serializer.jar
 org.apache.xalan.xslt.Process ^
   -v ^
   -xsl C:\ypl\doc_book\xsl_1.75.2\html\chunk.xsl ^
   -in using_role_as_class_name.doc_book_xml ^


This is my disagreement with how you have done it.

   -param emphasis.propagates.style 1 ^
   -param html.stylesheet
 file://localhost/C:\ypl\doc_book\key_words.css ^ -param base.dir
 html/ EXIT

I do it differently is the best way I can say this.
1. I didn't know I could set parameters on the command line :-)
2. I always use an 'import' method to set my parameters


Create a normal stylesheet
First statement inside xsl:stylesheet
xsl:import href='ypl/doc_book/xsl_1.75.2/html\chunk.xsl'

the set your parameters
xsl:param name='emphasis.propagates.style' select='1'/
xsl:param name='html.stylesheet'
select='/ypl/doc_book/key_words.css'/

/xsl:stylesheet


Note the quoted css file
Note the forward / not \

[RL Start]

I don't know anything about XSL. I will add it to the stuff to go learn.

Is putting parameters in XSL just a best practice thing ?

It makes sense. This way you have all your styling knobs in one spot
as opposed to 2 different spots.

Thanks for the help.

[RL End]

HTH


-- 

regards 

-- 
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

Re: [docbook-apps] How do I highlight inline text ?

2010-04-11 Thread Dave Pawson 
On Sun, 11 Apr 2010 06:22:18 -0400
Robert Lucente rluce...@pipeline.com wrote:

  a.. Create a cascading style sheet w/ a file name of key_words.css
  w/ the following entry
  
  .key_words { background: yellow; }
 
 Nit picking, use semantic names for the attribute?
 I may be wrong here. 
 
 [RL Start]
 
 Nathalie Sequeira on April 07, 2010 5:31 PM recommended the following
 
 emphasis role=semantic_function_of_the_emphasissome
 text/emphasis
 
 I thought that this was way cool. Then if I wanted to change the how
 the semantic was displayed, just change the CSS.
 
 Humm. What am I missing ?
 
 [RL End]

I guessed that 'keyword' wasn't semantic. Was I wrong?
If it does identify a keyword in your xml markup, my apologies. 



 [RL Start]
 
 I don't know anything about XSL. I will add it to the stuff to go
 learn.
 
 Is putting parameters in XSL just a best practice thing ?

I think so. puts all your 'styling' in one place?..
except it's two, one stylesheet importing another. 


 
 It makes sense. This way you have all your styling knobs in one spot
 as opposed to 2 different spots.
 
 Thanks for the help.


Welcome.




-- 

regards 

-- 
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

RE: [docbook-apps] How do I highlight inline text ?

2010-04-10 Thread Robert Lucente 
Hi guys,

Thanks for all your help. I got it to work.

Request a quick review to make sure that I did not do something silly.

In case the email below is hard to read, please go to

http://www.ypl.com//build_windows_machines/install_applications/doc_book_to_
html/html_deep/ch09s03.html

a.. Create a cascading style sheet w/ a file name of key_words.css w/ the
following entry

.key_words { background: yellow; }a.. Create a file containing DocBook xml
tags w/ a file name of using_role_as_class_name.doc_book_xml w/ the
following entries

!DOCTYPE book SYSTEM
file://localhost/C:\ypl\doc_book\dtd_xml_4.5b1\docbookx.dtd

book

title
Some Book Title
/title

chapter

title
Some Chapter Title
/title

para
First sentence with no highlighting.
/para

para
Second sentence with highlighting which emphasis role=key_wordsstarts
here and goes until here/emphasis but does not highlight entire sentence.
/para

/chapter

/booka.. Create a DOS batch file setting the following paramters

  1.. emphasis.propagates.style: 1

  2.. html.stylesheet: file://localhost/C:\ypl\doc_book\key_words.css

a.. The DOS batch file name was using_role_as_class_name.bat and it
contained the following contents

REM
REM Set the classpath
REM
set classpath=.;
REM
REM
REM Output contents of environment variables
REM
set
REM
REM
REM Generate HTML from DocBook XML
REM
C:\Program Files\Java\jre1.5.0_22\bin\java ^
-cp C:\ypl\java\xalan.jar;C:\ypl\java\serializer.jar
org.apache.xalan.xslt.Process ^
-v ^
-xsl C:\ypl\doc_book\xsl_1.75.2\html\chunk.xsl ^
-in using_role_as_class_name.doc_book_xml ^
-param emphasis.propagates.style 1 ^
-param html.stylesheet 
file://localhost/C:\ypl\doc_book\key_words.css ^
-param base.dir html/
EXIT

-Original Message-
From: Dave Pawson [mailto:da...@dpawson.co.uk]
Sent: Thursday, April 08, 2010 6:50 AM
To: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] How do I highlight inline text ?


On Thu, 8 Apr 2010 06:13:09 -0400
Robert Lucente rluce...@pipeline.com wrote:

 Thanks for reminding me about color blind people and the link to the
 colors.

 Since I am interested in Highlight text (text with a background
 color), I should really be using the CSS background-color property.
 My bad.

No, not bad. My favourite quote. Everyone needs the idiot sheet
at least once.

I certainly did. I'm now a confirmed  CSS convert. Just
irritated that it hasn't kept pace with other developments,
or at least not in the browsers.
  Its nearly brilliant. It's certainly good.

regards

--

regards

--
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

Re: [docbook-apps] How do I highlight inline text ? - OT

2010-04-08 Thread Nathalie Sequeira 

Hi Robert,

glad that helped you find a good perspective on docBook :)


So, is it as easy as adding the following entry ?
.key_words {color: yellow}


I am attempting to be lazy and avoid working my way through
http://www.w3.org/Style/CSS
  

Yes that would work, whereby best practice would be
.key_words {color: yellow;}
i.e., ending each statement with a semicolon.

CSS really is very easy.
Don't start with the specs though - you can find a quick introduction at
http://w3schools.com/css/default.asp

You'll find a more solid and in-depth introduction at
http://westciv.com/style_master/house/index.html
There are lots of resources there, including a hands on tutorial and a 
more theoretical CSS guide (with detailed descriptions of the types of 
CSS selectors and properties).


And another, perhaps more actively maintained reference: 
http://reference.sitepoint.com/css


Have fun exploring :)
Nathalie Sequeira

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

Re: [docbook-apps] How do I highlight inline text ?

2010-04-08 Thread Dave Pawson 
On Wed, 7 Apr 2010 19:46:52 -0400
Robert Lucente rluce...@pipeline.com wrote:
[lazily :-)]

 It was big help.
 
 The generic explanation followed by the specific example of wanting to
 change from yellow to blue really hit the point home.

don't forget the 3 of your readers who are color blind. 

The rest is a CSS question IMHO


 How do I go about figuring out the magic words for the CSS stylesheet
 entry ?


 And now a worked example: p {color: blue; font-size: 120%; }
 
 So, is it as easy as adding the following entry ?
 
 .key_words {color: yellow}

Yes, but a little effort will produce very good results?
CSS is great for instant reward.
I use the O'Reilly CSS The definitive guide.
Again and again and again. 

p.emphasis {
font-weight: bold;
color: yellow;
}
As each property is added, finish it with the semi-colon.
Get the colors from http://html-color-codes.info/#HTML_Color_Picker
or google CSS color chart

 
 
 I am attempting to be lazy and avoid working my way through
 
 http://www.w3.org/Style/CSS


I generally find a book easier than the rec, they are
written for implementers, not users.

HTH

-- 

regards 

-- 
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

RE: [docbook-apps] How do I highlight inline text ? - OT

2010-04-08 Thread Robert Lucente 
i.e., ending each statement with a semicolon.

Thanks for the very meticulous review.

Let me work through some of the references that you provided to get an idea
of what CSS is all about.

-Original Message-
From: Nathalie Sequeira [mailto:n...@n-faktor.net]
Sent: Thursday, April 08, 2010 2:46 AM
To: Robert Lucente
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] How do I highlight inline text ? - OT


Hi Robert,

glad that helped you find a good perspective on docBook :)

 So, is it as easy as adding the following entry ?
 .key_words {color: yellow}


 I am attempting to be lazy and avoid working my way through
 http://www.w3.org/Style/CSS

Yes that would work, whereby best practice would be
.key_words {color: yellow;}
i.e., ending each statement with a semicolon.

CSS really is very easy.
Don't start with the specs though - you can find a quick introduction at
http://w3schools.com/css/default.asp

You'll find a more solid and in-depth introduction at
http://westciv.com/style_master/house/index.html
There are lots of resources there, including a hands on tutorial and a
more theoretical CSS guide (with detailed descriptions of the types of
CSS selectors and properties).

And another, perhaps more actively maintained reference:
http://reference.sitepoint.com/css

Have fun exploring :)
Nathalie Sequeira


-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

RE: [docbook-apps] How do I highlight inline text ?

2010-04-08 Thread Robert Lucente 
Thanks for reminding me about color blind people and the link to the colors.

Since I am interested in Highlight text (text with a background color), I
should really be using the CSS background-color property. My bad.

-Original Message-
From: Dave Pawson [mailto:da...@dpawson.co.uk]
Sent: Thursday, April 08, 2010 3:06 AM
To: Robert Lucente
Cc: n...@n-faktor.net; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] How do I highlight inline text ?


On Wed, 7 Apr 2010 19:46:52 -0400
Robert Lucente rluce...@pipeline.com wrote:
[lazily :-)]

 It was big help.

 The generic explanation followed by the specific example of wanting to
 change from yellow to blue really hit the point home.

don't forget the 3 of your readers who are color blind.

The rest is a CSS question IMHO


 How do I go about figuring out the magic words for the CSS stylesheet
 entry ?


 And now a worked example: p {color: blue; font-size: 120%; }

 So, is it as easy as adding the following entry ?

 .key_words {color: yellow}

Yes, but a little effort will produce very good results?
CSS is great for instant reward.
I use the O'Reilly CSS The definitive guide.
Again and again and again.

p.emphasis {
font-weight: bold;
color: yellow;
}
As each property is added, finish it with the semi-colon.
Get the colors from http://html-color-codes.info/#HTML_Color_Picker
or google CSS color chart



 I am attempting to be lazy and avoid working my way through

 http://www.w3.org/Style/CSS


I generally find a book easier than the rec, they are
written for implementers, not users.

HTH

--

regards

--
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk


-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

Re: [docbook-apps] How do I highlight inline text ?

2010-04-08 Thread Dave Pawson 
On Thu, 8 Apr 2010 06:13:09 -0400
Robert Lucente rluce...@pipeline.com wrote:

 Thanks for reminding me about color blind people and the link to the
 colors.
 
 Since I am interested in Highlight text (text with a background
 color), I should really be using the CSS background-color property.
 My bad.

No, not bad. My favourite quote. Everyone needs the idiot sheet
at least once. 

I certainly did. I'm now a confirmed  CSS convert. Just
irritated that it hasn't kept pace with other developments,
or at least not in the browsers.
  Its nearly brilliant. It's certainly good. 

regards

-- 

regards 

-- 
Dave Pawson
XSLT XSL-FO FAQ.
http://www.dpawson.co.uk

-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

[docbook-apps] How do I highlight inline text ?

2010-04-07 Thread Robert Lucente 
Hi,

I am a newbie in getting DocBook XML to generate HTML. I have it working and
documented what the processing elements are at a high level as well as
detailed steps for installation in Windows for newbies at

http://www.ypl.com//build_windows_machines/install_applications/doc_book_to_
html/html_deep/index.html

Perhaps this exists somewhere already and I just did not find it ?

Request help in figuring out how to highlight inline text.

It seems that the way to go is to use something like emphasis
role=yellowsome text/emphasis. I got the idea from

1) The sql syntax example at

http://www.sagehill.net/docbookxsl/UsingCSS.html

2) The following email from the docbook-apps mailing list

Subject: Re: [docbook-apps] Coloring body text portions - May 18, 2004
3:54:58 pm

For HTML output, it is easier to export a class attribute on some HTML
element and then write a CSS stylesheet to apply styles such as color. A few
elements like phrase and emphasis can export their role attribute value
as a class attribute if you set the right stylesheet parameter.

If the way to go is to follow the example in sagehill.net, then request help
w/

Question: What should be the CSS stylesheet entry ?

Question: What should I add to the stylesheet customization layer ?

Question: Perhaps the above entire approach is inappropriate and another
approach should be used


Pontification type of question: It seems like highlighting text w/ color
should be a standard feature ? Since its not, I am missing the mind set
associated w/ DocBook. What is the mind set w/ which to approach DocBook and
its processing chain such that it makes sense that color highlighting is not
built in ?


If the above does not make sense, I have attempted to be more elaborate at

http://www.ypl.com//build_windows_machines/install_applications/doc_book_to_
html/html_deep/ch08.html


If I have violated some of the mailing list norms, please let me know so
that I can correct them.


-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

Re: [docbook-apps] How do I highlight inline text ?

2010-04-07 Thread Nathalie Sequeira 

Hi Robert,


Request help in figuring out how to highlight inline text.

It seems that the way to go is to use something like emphasis
role=yellowsome text/emphasis. 

I think the way to go would rather be

emphasis role=semantic_function_of_the_emphasissome text/emphasis

while your example actually is going

emphasis role=how_the_emphasis_should_looksome text/emphasis


Pontification type of question: It seems like highlighting text w/ color
should be a standard feature ? Since its not, I am missing the mind set
associated w/ DocBook. What is the mind set w/ which to approach DocBook and
its processing chain such that it makes sense that color highlighting is not
built in ?
  

Yes, I'd say mind-set issue indeed :)

docBook handles information - the basic information plus the functions 
single pieces of the information have within the whole (is this text a 
title, for example, is it a list...or is it to be emphasized.).
Then come the docBook stylesheets, that will transform the docBook into 
HTML for you (you can tweak how the result will be via customization layer).

And finally, colors and other aspects pertaining to styling are set in CSS.

The beauty of this is that (for example):
-  in a few years, you may get tired of all those yellow texts and may 
want to make them blue or orange or purple instead. If you defined the 
specific color via CSS, all you need to change is one single class, and 
you're set up (instead of having to go through your docBook file and 
edit all the instances of, say, yellow -- It's the same principle as 
in separating content and form in plain old HTML  CSS).


- all texts you assign a certain role to (the name itself says it all - 
role, what is the role these words play in the text?) will be styled 
in the same way,


- you can output your docBook-Information for different media, and can 
use the SAME source for them all, defining how they should look 
individually and OUTSIDE the docBook information itself.


http://opensource.bureau-cornavin.com/crash-course/en/your-world-view.html
also discusses the issue :)

Hoping that helps a bit,
Nathalie Sequeira


-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org

RE: [docbook-apps] How do I highlight inline text ?

2010-04-07 Thread Robert Lucente 
It was big help.

The generic explanation followed by the specific example of wanting to
change from yellow to blue really hit the point home.

To follow your example, what I really want is

emphasis role=key_wordssome text/emphasis

In Using CSS to style HTML in

http://www.sagehill.net/docbookxsl/UsingCSS.html

it states to create a CSS stylesheet entry

.sqlsyntax {font-variant: small-caps;}

How do I go about figuring out the magic words for the CSS stylesheet entry
?

I am totally new to this stuff. I Googled around and found

http://www.yourhtmlsource.com/stylesheets/introduction.html

selector {property: value; property: value; property: value; }

And now a worked example: p {color: blue; font-size: 120%; }

So, is it as easy as adding the following entry ?

.key_words {color: yellow}


I am attempting to be lazy and avoid working my way through

http://www.w3.org/Style/CSS



-Original Message-
From: Nathalie Sequeira [mailto:n...@n-faktor.net]
Sent: Wednesday, April 07, 2010 5:31 PM
To: Robert Lucente
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] How do I highlight inline text ?


Hi Robert,

 Request help in figuring out how to highlight inline text.

 It seems that the way to go is to use something like emphasis
 role=yellowsome text/emphasis.
I think the way to go would rather be

emphasis role=semantic_function_of_the_emphasissome text/emphasis

while your example actually is going

emphasis role=how_the_emphasis_should_looksome text/emphasis

 Pontification type of question: It seems like highlighting text w/ color
 should be a standard feature ? Since its not, I am missing the mind set
 associated w/ DocBook. What is the mind set w/ which to approach DocBook
and
 its processing chain such that it makes sense that color highlighting is
not
 built in ?

Yes, I'd say mind-set issue indeed :)

docBook handles information - the basic information plus the functions
single pieces of the information have within the whole (is this text a
title, for example, is it a list...or is it to be emphasized.).
Then come the docBook stylesheets, that will transform the docBook into
HTML for you (you can tweak how the result will be via customization layer).
And finally, colors and other aspects pertaining to styling are set in CSS.

The beauty of this is that (for example):
-  in a few years, you may get tired of all those yellow texts and may
want to make them blue or orange or purple instead. If you defined the
specific color via CSS, all you need to change is one single class, and
you're set up (instead of having to go through your docBook file and
edit all the instances of, say, yellow -- It's the same principle as
in separating content and form in plain old HTML  CSS).

- all texts you assign a certain role to (the name itself says it all -
role, what is the role these words play in the text?) will be styled
in the same way,

- you can output your docBook-Information for different media, and can
use the SAME source for them all, defining how they should look
individually and OUTSIDE the docBook information itself.

http://opensource.bureau-cornavin.com/crash-course/en/your-world-view.html
also discusses the issue :)

Hoping that helps a bit,
Nathalie Sequeira


-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org


-
To unsubscribe, e-mail: docbook-apps-unsubscr...@lists.oasis-open.org
For additional commands, e-mail: docbook-apps-h...@lists.oasis-open.org