RE: [docbook-apps] Python to PDF via XSL-FO

2012-05-13 Thread Robert Lucente
I am a newbie to DocBook and so take my comments w/ a grain of salt.

Check out

http://www.reportlab.com/software/opensource/rl-toolkit/

Why not go from Python to PDF directly?

-Original Message-
From: John W. Shipman [mailto:j...@nmt.edu]
Sent: Monday, May 07, 2012 1:54 PM
To: docbook-apps mailing list
Cc: John Shipman
Subject: [docbook-apps] Python to PDF via XSL-FO


As much as I love XSLT (half-kidding here), I have several
applications to generate PDFs from databases, and from other
sources that XSLT can't reach directly.

Since I discovered SQLAlchemy (http://www.sqlalchemy.org), life
is much nicer: In Python, I can pull data from SQL databases
without getting any actual SQL on my paws.

These applications use Python and its wonderful lxml module to
produce XSL-FO files, which I can then run through XEP or FOP.

I've built a little Python module to assist in the generation of
XSL-FO:

 http://www.nmt.edu/tcc/projects/fohelpers

If anyone finds this module useful, or if you have feedback on its
usefulness, I would be delighted to hear from you.

Are there other mailing lists that might reach potential users?

Best regards,
John Shipman (j...@nmt.edu), Applications Specialist, NM Tech Computer
Center,
Speare 146, Socorro, NM 87801, (575) 835-5735, http://www.nmt.edu/~john
   ``Let's go outside and commiserate with nature.''  --Dave Farber

-
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



[docbook-apps] My eContent Wish List - A TOC Webcast

2010-12-07 Thread Robert Lucente
I think that the O'Reilly webinar might be of interest to members of this
mailing list.

Please note that I receive no direct or indirect compensation from O'Reilly.

-Original Message-
From: O'Reilly Webcasts [mailto:webc...@oreilly.com]
Sent: Tuesday, December 07, 2010 2:42 PM
To: rluce...@pipeline.com
Subject: My eContent Wish List - A TOC Webcast


If you would like to view this information in your browser, click here:
http://post.oreilly.com/rd/9z1zrrnfvdv6oppd8n8dn45o55a7pa6e9hhk2nghqag

Join us for this free, live webcast:

My eContent Wish List - A TOC Webcast
Presented by: Joe Wikert, General Manager and Publisher for O'Reilly Media

Despite the recent surge in ebook sales we're still very much in the early
stages of this new platform. In this webcast Joe Wikert of O'Reilly will
talk about the current state of the econtent world and present more than 10
different improvements and enhancements he would like to see. Some of them
are minor while others will require changes to ereader apps and distribution
models. All of them will make econtent more appealing to a broader consumer
audience.

===
Attendance is limited, so register now. We'll send you a reminder before the
webcast. And please feel free to share this invitation with others.

Date: Thursday, December 16 at 10 am PT
Price: Free
Duration: Approximately 60 minutes
To register:
http://post.oreilly.com/rd/9z1zd7in1l0j72cmm8m8b8ini6ekq2j9r2qhd4g4reg

Questions? Please send email to webc...@oreilly.com

===
Joe Wikert is General Manager  Publisher at O'Reilly Media, Inc., where he
manages the sales and editorial groups. He's the author of the Publishing
2020 blog where he's provided industry insights for the past 4+ years. Joe
is also a Kindle owner and blogger; you can find his thoughts about this
device on Kindleville. Prior to joining O'Reilly Joe was Vice President and
Executive Publisher at John Wiley  Sons, Inc., in their P/T division.

===
About O'Reilly
O'Reilly Media spreads the knowledge of innovators through its books, online
services, magazines, and conferences. Since 1978, O'Reilly Media has been a
chronicler and catalyst of cutting-edge development, homing in on the
technology trends that really matter and spurring their adoption by
amplifying faint signals from the alpha geeks who are creating the future.
An active participant in the technology community, the company has a long
history of advocacy, meme-making, and evangelism.

# # #

O'Reilly is a registered trademark of O'Reilly Media, Inc. All other
trademarks are property of their respective owners.

===
You are receiving this message because you expressed interest in hearing
about O'Reilly Webcasts. Forward this invitation to a friend:
http://post.oreilly.com/f2f/9z1z1j4fpssmtql13dq3j4ub4act08tgn98a33jhoi0

For assistance, or if you no longer wish to receive notifications about
O'Reilly Webcasts, send an email to webc...@oreilly.com.



O'Reilly Media, Inc. 1005 Gravenstein Highway North, Sebastopol, CA 95472
(707) 827-7000







-
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] JavaHelp index

2010-08-22 Thread Robert Lucente
Why not just use JavaDoc ? What is the value add to use JavaHelp ?

http://www.oracle.com/technetwork/java/javase/documentation/index-jsp-135444
.html

-Original Message-
From: Jean-Christophe Helary [mailto:jean.christophe.hel...@gmail.com]
Sent: Sunday, August 22, 2010 5:52 PM
To: DocBook Apps
Subject: Re: [docbook-apps] JavaHelp index



On 23 août 10, at 02:30, Mauritz Jeanson wrote:

 By the way, my impression is that interest in JavaHelp is waning. Nothing
 much seems to happen with the technology and discussion forum activity is
 low. But perhaps you have another opinion?

Is there any other way to simply create a help system for Java applications
?

Jean-Christophe Helary

fun: http://mac4translators.blogspot.com
work: http://www.doublet.jp (ja/en  fr)
tweets: http://twitter.com/brandelune


-
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] blogging using DocBook articles or so ...

2010-07-18 Thread Robert Lucente
We have to be very conscious of who is the intended audiance.

Warning pontification: You can't be everything to everybody.

Creating DocBook XML and then getting the processing chain to work to
convert XML to HTML and then screwing around to get something to look
exactly the way you want it to in order to create a blog seems like way
overkill.

If something is not long or if the aesthetics are very critical, perhaps
DocBook is not the tool ?

I am not trying to start a flame war, just trying to look at things from
everybody's perspective.

-Original Message-
From: jochen+oasis-o...@hayek.name [mailto:jochen+oasis-o...@hayek.name]
Sent: Sunday, July 18, 2010 9:43 AM
To: docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] blogging using DocBook articles or so ...


So far I have been blogging on a couple of blogger.com blogs of mine,
and I got quite used to the capabilities there,
I mean WYSIWYG is not that disgusting, even for an open-minded emacs guy as
me,
but then …

… maybe there has already been an attempt to use DocBook for blogging?

I mean, *what* *is* a *blog* *really*???

A time-consecutive list of articles,
together with a commenting facility (but that's not most important, I
think),
and automatically supplied RSS and/or atom feeds.

Would be exciting to use DocBook also for that.

Kind regars,
J.
--
As nice as you guys here are,
pls usually only reply to my post right on this mailing list.
I honestly do follow this list.
Of course, if you want to tell me, how silly I am,
then let's keep that private ;-)
but usually it's only my Bad Simple English, not my ideas.

-
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] Re: blogging using DocBook articles or so ...

2010-07-18 Thread Robert Lucente
And IMHO DocBook output *is* nice.
Ooops. Did not mean to imply otherwise.

O'Reilly books (all/some/a few?!?) are written in DocBook
Yes, I am aware. Please note that O'Reilly focuses on the tech market.

Maybe blogging  sharing would get far more often done, if the means were
easier.
Please name the one specific thing that you would like to be easier.

glues separate documents together
I am confused. If we are talking about a simple blogg, why are we talking
about glueing documents together ?

Please note that I am a newbie and trying to figure out where the various
tool sets fit in. So, if I am making silly comments or asking silly
questions, request your patience.

-Original Message-
From: jochen+oasis-o...@hayek.name [mailto:jochen+oasis-o...@hayek.name]
Sent: Sunday, July 18, 2010 10:16 AM
To: docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] Re: blogging using DocBook articles or so ...


 Robert Lucente writes:

 We have to be very conscious of who is the intended audiance.
 Warning pontification: You can't be everything to everybody.

 Creating DocBook XML and then getting the processing chain to work to
 convert XML to HTML
 and then screwing around to get something
 to look exactly the way you want it to
 in order to create a blog seems like way overkill.

My standards a lower there.
Aesthetics are important but not prio 1.
And IMHO DocBook output *is* nice.

And you do know, that O'Reilly books (all/some/a few?!?) are written in
DocBook nowadays, don't you?

Maybe bloggingsharing would get far more often done, if the means were
easier.

My current experience is DocBook Website,
which glues separate documents together using a layout.xml,
which serves quite a few different purposes including customization.

I would even regard it as acceptable to maintain something like the source
of the RSS/atom feeds,
which could be the corresponding thing to that layout.xml.

 If something is not long or if the aesthetics are very critical,
 perhaps DocBook is not the tool ?

 I am not trying to start a flame war,
 just trying to look at things from everybody's perspective.

Fair enough.
Thanks for your contribution.

I just wanted to ask around and maybe suggest and idea.
Sometimes it take a spark, you know, in order to start projects, tiny ones
and big ones.


Just my $0.05.

-
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] Re: blogging using DocBook articles or so ...

2010-07-18 Thread Robert Lucente
I think that the various perspectives have been adequately presented and
each user must decide for themselves what is the appropriate tool to use.

-Original Message-
From: jochen+oasis-o...@hayek.name [mailto:jochen+oasis-o...@hayek.name]
Sent: Sunday, July 18, 2010 11:51 AM
To: docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] Re: blogging using DocBook articles or so ...


 Robert Lucente writes:

 And IMHO DocBook output *is* nice.

 Ooops. Did not mean to imply otherwise.

 O'Reilly books (all/some/a few?!?) are written in DocBook

 Yes, I am aware. Please note that O'Reilly focuses on the tech market.

That's O'Reilly, not necessarily you and me.

*** THIS IS NOT A FLAME, HONEST ***

What makes DocBook unsuited for others than the tech market?

Is is it the same with LaTex?

Because you can write math. formulas with it,
you can't write prose with it?

Alright… people writing prose might not want to get bothered with something
as profane as XML tags resp. LaTeX markup?

I used to use troff Memorandum Macros,
and not just for the job.

Do you think the addressees bothered, whether my letters were written in
that incredible markup language?

 Maybe blogging  sharing would get far more often done,
 if the means were easier.

 Please name the one specific thing that you would like to be easier.

I hate to edit text outside the emacs universe.
I hate it to edit text in a web browser.
I hate it to not be able to use Control-S to save my text every couple of
seconds, w/o even being really aware, that I have done it again.

Too much hatred, I know.
Again: this is not a flame.

I am just not a WYSIWYG guy.
Yes, occasionally I like using formatted e-mail in Google Mail,
yes, it is a serious temptation.
Yes, I am Google Buzzing a lot.
But there again: I use old-fashioned markup there, too.

I prefer focussing on content, and *marking* *up* my text, yes with some
kind of eagerness for perfection.
Your mileage may vary, they say.

With your preferred editor – do you actually type the end tag or does your
editor achieve that for you?
My editor does it for me, so I don't bother.
I think end tags do help.
But than I am also one of the guys out there (with Ada being my 5th
programming language or so),
who loves end if, end case, and that sort of stuff,
and with perl and ruby and whatever I add it myself as a comment.

 glues separate documents together

 I am confused. If we are talking about a simple blogg, why are we talking
 about glueing documents together ?

To keep things simple,
one approach may be to regard every blog article a document of its own.
Alright?
But if the blog is sort of DocBook Blog,
then what keeps the articles together?

I assume you are familiar with blog subscription features, like adding the
blog's RSS resp. atom feed to your preferred feed reader.

What creates the RSS resp. atom feed in the case of DocBook Blog?

Well in the case of DocBook Website there is a meta-document called
layout.xml, which is not really DocBookish but (at least) XML with a
defined DTD/schema.

Maybe there will be sort of layout.xml for DocBook Blog as well.

I am sorry, you must be bored by this, as I keep reusing my own words.

 Please note that I am a newbie
 and trying to figure out where the various tool sets fit in.
 So, if I am making silly comments or asking silly questions,
 request your patience.

If I am not patient enough: pls forgive me!
And see: I am still here :-)

Maybe DocBook Blog is serious enough for a student's thesis an whatever
level.
No idea.
Just suggesting…




Another approach may well be
to regard the entire blog as a book,
with the articles being sections of level 1.

But then: as the blog grows article by article the generation process for
the whole will more and more degrade.
And I just thought, that's not a good idea.
And why start there, if we know that from the very beginning.


 Just my $0.05.

Sic.

-
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] Compact DocBook ?

2010-07-13 Thread Robert Lucente
On topic though, so why not!

Thanks for the help on what is appropriate etiquette.


By the looks of it, Leo is GUI ?

Leo is a GUI in the sense that it displays nodes hierarchically just like
Windows explorer displays folders/directories hierarchically.

I am a novice at DocBook, Leo, literate programming and the like. The best
thing would be to look at the Leo doco Chapter 6: Leo and Literate
Programming at

http://webpages.charter.net/edreamleo/design.html#chapter-6-leo-and-literate
-programming

-Original Message-
From: Dave Pawson [mailto:da...@dpawson.co.uk]
Sent: Monday, July 12, 2010 7:38 AM
To: Robert Lucente
Subject: Re: [docbook-apps] Compact DocBook ?


On Mon, 12 Jul 2010 06:11:46 -0400
Robert Lucente rluce...@pipeline.com wrote:

 Think of it the other way round?
 Embed java code in Docbook?
 Nice !

 Tangle and weave are the ideas,
 Literate Programming the background.

 At one point, I started using Leo to do literate programming. The
 thing that I like about Leo is that it is an outliner w/ hoist and
 node cloning. The downside is that it has a steep learning curve.

 http://webpages.charter.net/edreamleo/front.html

 I still use an old versio of Leo but don't do full Literate
 programming. So far, the price of the learning curve is not worth it.

 I did not post this in the docbook group because it did not seem
 appropriate. If I am wrong, please correct me.


Some are interested in literate programming in general, so there may
be some interest, but I guess it's low.

On topic though, so why not!

By the looks of it, Leo is GUI? I'm not sure how that helps
for litprog?
I use emacs, or (a java environment, then paste/include into emacs
for the Docbook)


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] An interesting article about DocBook in WebWorkerDaily

2010-05-18 Thread Robert Lucente
http://webworkerdaily.com/2010/05/18/defining-and-finding-truly-great-tools/

The part that got my interest was

Later, I was introduced to DocBook, an XML schema that allows the
identification of pieces of content as small as individual letters. Here,
for me, was an actual revolution in the way I worked. DocBook represented a
new way of thinking about my content and suited my thought patterns much
better than did the blank page of a word processing file, implying as it did
a linear flow and a single voice.

The fact that this tool suited my brain better than did word processing
tools allowed me to think about information and communication differently:
instead of battling (albeit subconsciously) with the restrictions of my
tools, I was free to approach content in a way that really suited me, and
was shown a completely new perspective on my work at the same time.

Where content management tools made my life easier and improved my product,
DocBook effectively allowed me to evolve my practice.


-
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] Annotating program listings - Callouts - Chapter 27. Program listings - minor / nit typo ?

2010-04-25 Thread Robert Lucente
Yesterday I asked a C language guru and he said that amp; has nothing to do
w/ C.

I think that there are 2 possibilities

1) The amp; has not been properly escaped from the DocBook perspective.
This is a possibility because the program listing is not in CDATA

2) It could be an HTML thing

http://htmlhelp.com/reference/html40/entities/special.html

Perhaps there are other possibilities ?


 -Original Message-
From: Bob Stayton [mailto:b...@sagehill.net]
Sent: Saturday, April 24, 2010 4:40 PM
To: Robert Lucente; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Annotating program listings - Callouts - Chapter
27. Program listings - minor / nit typo ?


  Hi Robert,
  Thanks for taking the time to comment.  No, it isn't a typo.  The
programlisting is not in a CDATA section, so any XML characters like  must
be escaped as character entities.  That character is intended to be a
literal ampersand in the program listing.

  If you are asking me if the code itself makes sense with an ampersand, I
can't answer that.  I just cut and pasted it from somewhere.  8^)

  Bob Stayton
  Sagehill Enterprises
  b...@sagehill.net


- Original Message -
From: Robert Lucente
To: docbook-apps@lists.oasis-open.org
Sent: Saturday, April 24, 2010 12:25 PM
Subject: [docbook-apps] Annotating program listings - Callouts - Chapter
27. Program listings - minor / nit typo ?


url: http://www.sagehill.net/docbookxsl/AnnotateListing.html#Callouts

The program listing has

virtual int  parse(MyFetch amp;fetcher) = 0;

I think that amp is a typo in the above line of code ?

This has probably already been found but just in case.


RE: [docbook-apps] Annotating program listings - Callouts - Chapter 27. Program listings - minor / nit typo ?

2010-04-25 Thread Robert Lucente
Thanks.

I guess I have demonstrated my newbie status in C++. :-)

-Original Message-
From: Stefan Seefeld [mailto:seef...@sympatico.ca]
Sent: Sunday, April 25, 2010 10:06 AM
To: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Annotating program listings - Callouts -
Chapter 27. Program listings - minor / nit typo ?


On 04/25/2010 08:47 AM, Robert Lucente wrote:
 Yesterday I asked a C language guru and he said that *amp;* has 
 nothing to do w/ C.

The code snippet is not C but C++. And as such it is perfectly fine.

 Stefan

-- 

   ...ich hab' noch einen Koffer in Berlin...


-
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



[docbook-apps] Annotating program listings - Callouts - Chapter 27. Program listings - minor / nit typo ?

2010-04-24 Thread Robert Lucente
url: http://www.sagehill.net/docbookxsl/AnnotateListing.html#Callouts

The program listing has

virtual int  parse(MyFetch amp;fetcher) = 0;

I think that amp is a typo in the above line of code ? 

This has probably already been found but just in case.


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 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-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 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



[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 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