[docbook-apps] Side-by-side images

2012-02-22 Thread David Goss
Hello,

What is the proper way to display two images side-by-side?

The way I do this now is to put two  into a .
The HTML output is two images side-by-side aligned to the left. Playing
with the align attribute in the  tags results in text for the
proceeding paragraphs to creep up in the space between them, since they
are inline. Using the  would separate the images onto two
different lines.













 

I feel like I'm tagging these images wrong.  doesn't
really describe the content here since they're not *really* inline.

Is there a "right" way to accomplish this (other than combining two
images into one)? My goal is to get two images side-by-side, center
aligned, though a solution that would work for more than 2 images
side-by-side would be ideal.

Thanks,

DAVID GOSS | Technical Writer
P 1.800.876.9218 x 345 | F 1.800.588.9866
dg...@mueller-inc.com
http://www.MuellerReports.com


-
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] Side-by-side images

2012-02-22 Thread David Goss
This does get the desired result, though this is similar to my current
solution. The content isn't *really* a table, so  doesn't
accurately describe what it is. 

 

Logically, I would think that  with 2 s would
make the most sense, but when I transformed that into HTML, only the 1st
image displayed. The description of  in TDG5 does state
that it can contain "one or more..." for objects, but perhaps that means
one or more different objects, not two objects that are the same.

 

See

http://docbook.org/tdg5/en/html/mediaobject.html

 

-David

 

From: Roland Burda [mailto:burda.rol...@gmail.com] 
Sent: Wednesday, February 22, 2012 1:25 PM
To: David Goss
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Side-by-side images

 

David!

 

I use tables to get two images side-by-side.

 

This is my workaround for the issue:

 













 


 


 


 


 










 


 


 


 


 














 

Cheers,

Roland

 

2012/2/22 David Goss 

Hello,

What is the proper way to display two images side-by-side?

The way I do this now is to put two  into a .
The HTML output is two images side-by-side aligned to the left. Playing
with the align attribute in the  tags results in text for the
proceeding paragraphs to creep up in the space between them, since they
are inline. Using the  would separate the images onto two
different lines.


   
   
   
   
   
   
   
   
   
   



I feel like I'm tagging these images wrong.  doesn't
really describe the content here since they're not *really* inline.

Is there a "right" way to accomplish this (other than combining two
images into one)? My goal is to get two images side-by-side, center
aligned, though a solution that would work for more than 2 images
side-by-side would be ideal.

Thanks,

DAVID GOSS | Technical Writer
P 1.800.876.9218 x 345 | F 1.800.588.9866
dg...@mueller-inc.com
http://www.MuellerReports.com


-
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] Assigning an ID and a class to HTML output

2012-03-06 Thread David Goss
I would like to use a Javascript fancyzoom() with images in a Docbook
HTML output. Basically, all the images would float right and be of equal
width, and could be clicked to zoom.

My problem is that setting xml:id='theimagename' and role='thumbnail' in
mediaobject (or imageobject and imagedata) doesn't seem to add an id or
a class to the HTML output. Is there some way I can explicitly tell the
transformation sheet that I want the id and class in the output?


DAVID GOSS | Technical Writer
P 1.800.876.9218 x 345 | F 1.800.588.9866
dg...@mueller-inc.com
http://www.MuellerReports.com



-
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] xsltproc, glossary.collection, and xinclude - glossary is not found

2012-03-16 Thread David Goss
Hello, I'm having a bit of a problem using the glossary.collection
parameter with xincluded files. My project directory looks something
like this:

   /
   /doc/glossary.docbook
   /doc/article1.docbook
   /doc/article1/sect1.docbook
   /xsl/stylesheet.xsl

Doc/Article1.docbook contains an xinclude element for
doc/article1/sect1.docbook. At the bottom of doc/article1.docbook is
; within doc/article1/sect1.docbook I have
http://www.MuellerReports.com


-
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] xsltproc, glossary.collection, and xinclude - glossary is not found

2012-03-19 Thread David Goss
Bob,

Thank you very much for the information! I could see that it was taking
the path relative to the included files, but ../glossary.docbook still
results in the file not being found (same problem with the full path--I
blame path issues on using cygwin). Setting glossterm.auto.link to 0,
however, builds the HTML successfully, though albeit without links.

-Original Message-
From: Bob Stayton [mailto:b...@sagehill.net] 
Sent: Saturday, March 17, 2012 5:11 PM
To: David Goss; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] xsltproc, glossary.collection, and xinclude
- glossary is not found

Hi David,
It seems the documentation about glossary.collection fails to mention
how a relative path to the collection file is interpreted. The short
answer is:

a.  If you have glossterm.auto.link set to zero, the path is taken as
relative to the file containing the empty  element.

b.  If you have glossterm.auto.link set to non-zero, the path is taken
as relative to the file containing the *first* inline glossterm or
firstterm in the document, in document order.

In your case, I think you must have glossterm.auto.link set to 1, and
the firstterm in your xincluded file is the first instance.  So for your
particular case, setting the param this way should work:

--stringparam glossary.collection ../glossary.docbook


If you want to see why it works this way, read on.

Note that the XSL stylesheet does not know from what directory you
issued your processing command.  Your shell interpreter resolves the
path to only the document and stylesheet files, but has no effect on
parameter settings.  The XSL processor itself does not normally have
your location information, and so does not know that
"doc/docbook.glossary" means relative to CWD.

In the stylesheet, the instruction that opens the glossary collection
looks like this:

  

The first argument of the document() function specifies the file to
open, but the 
second argument can specify a base URI that is prepended to the
filename.   Here, the 
second argument of the document() function is . which represents the
current node in the document (not the stylesheet).  In this function,
the XSL processor interprets that . to mean the base dir for the file
containing the current document element.

If the second argument is omitted, then the first argument path is
interpreted as relative to the stylesheet file.  Since most people keep
their collection file with the doc files, using . usually makes sense.

So what is the current document element?  In the case where
$glossterm.auto.link is set to zero, the collection file is not opened
until the  element is processed.  In that case,
the collection path is relative to the file containing that empty
glossary element.

In the case where $glossterm.auto.link is non-zero, the first instance
of an inline glossterm or firstterm will trigger opening the collection
file.  That's because it must have the information from the database to
form the link.  Once the collection has been opened, the processor keeps
it in memory and does not need to open it again.  So any subsequent
references, and the glossary element itself, will reuse that already
opened collection.

Obviously this arrangement may not suit everyone.  In your case, the
first instance happens to be in an Xincluded file in a subdirectory, so
the glossary.collection path would have to be relative to that
subdirectory.  In other cases, you might have a collection file shared
by documents in many locations, which requires setting the
glossary.collection parameter according to where the glossary element
resides, which can be inconvenient.  In such cases, you could specify a
full path in the glossary.collection param, or you could specify a phony
path and reinterpret it with an XML catalog file.  See this reference
for details on the latter option:

http://www.sagehill.net/docbookxsl/GlossDatabase.html#GlossaryCatalogEnt
ry

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


- Original Message -----
From: "David Goss" 
To: 
Sent: Friday, March 16, 2012 12:14 PM
Subject: [docbook-apps] xsltproc, glossary.collection, and xinclude -
glossary is not found


Hello, I'm having a bit of a problem using the glossary.collection
parameter with xincluded files. My project directory looks something
like this:

   /
   /doc/glossary.docbook
   /doc/article1.docbook
   /doc/article1/sect1.docbook
   /xsl/stylesheet.xsl

Doc/Article1.docbook contains an xinclude element for
doc/article1/sect1.docbook. At the bottom of doc/article1.docbook is
; within doc/article1/sect1.docbook I have
http://www.MuellerReports.com


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

[docbook-apps] Applying a processing instruction by default in a stylesheet

2012-03-21 Thread David Goss
Per the instructions in Bob Stayton's excellent XSL Guide for
 [http://www.sagehill.net/docbookxsl/Variablelists.html],
I've found that I want to use a number of processing instructions in
every variablelist in a set of documents. Something along the lines of:







Rather than copying/pasting these into every , it would
make sense to make this the default behavior for each instance. Is there
a way to activate the applicable instructions in my customization layers
for print and html for all variablelists? I've searched through the
stylesheets, but with my limited understanding of XSL, I'm not sure how
exactly the instruction is set during processing and how I can set it
manually in the stylesheet instead of the document.

DAVID GOSS | Technical Writer
P 1.800.876.9218 x 345 | F 1.800.588.9866
dg...@mueller-inc.com
http://www.MuellerReports.com



-
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] Assigning an ID and a class to HTML output

2012-03-28 Thread David Goss
Sorry for the slow response time. I never quite got this working using 
fancyzoom(), so I just used a bit of Jquery. Not being a programmer myself, I'm 
sure this could be greatly improved.

$("body").append('');
$("#zoomed").hide();

$("div.thumbnail").click(function(){
$("#zoomed").empty();
$("#zoomed").html($(this).html());
var newtop = $(window).scrollTop() + 
($(window).height()/2 -$("#zoomed").height()/2);
$("#zoomed").css("top", newtop);
$("#zoomed").fadeIn("fast");
});

$("#zoomed").click(function(){
$(this).fadeOut("fast");
});

Bob's Stayton's method for matching  with role='thumbnail' works 
perfectly.





Everything else is done by tweaking the CSS for #zoomed and div.thumbnail. I 
have the thumbnails all sized about 200px and floating to the right. This has 
really helped clean up some HTML docs that are very image heavy.

-----Original Message-
From: Fekete Robert [mailto:frob...@balabit.hu] 
Sent: Tuesday, March 13, 2012 8:43 AM
To: docbook-apps@lists.oasis-open.org; David Goss
Subject: Re: [docbook-apps] Assigning an ID and a class to  HTML 
output

Hi David, in case you managed to get it working, would you share your 
results/experiences with us? I'd love to try something similar on our docs.

Regards,

Robert

On 03/06/2012 07:35 PM, David Goss wrote:

> I would like to use a Javascript fancyzoom() with images in a Docbook 
> HTML output. Basically, all the images would float right and be of 
> equal width, and could be clicked to zoom.
>
> My problem is that setting xml:id='theimagename' and role='thumbnail' 
> in mediaobject (or imageobject and imagedata) doesn't seem to add an 
> id or a class to the HTML output. Is there some way I can explicitly 
> tell the transformation sheet that I want the id and class in the output?
>
>
> DAVID GOSS | Technical Writer
> P 1.800.876.9218 x 345 | F 1.800.588.9866 dg...@mueller-inc.com 
> http://www.MuellerReports.com
>
>
>
> -
> 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] Setting a fixed height for within

2012-04-06 Thread David Goss
I'm having difficulty setting the default height for images that appear
in . The source for these images is not always the same size,
so I just want to scale them to the line height in my customization
layer (instead of doing this in every image in the XML source). I've
tried something like this (and probably a hundred variables):













Which is at least preventing the image from pushing the text up, but the
image itself is not scaling.  


DAVID GOSS | Technical Writer
P 1.800.876.9218 x 345 | F 1.800.588.9866
dg...@mueller-inc.com
http://www.MuellerReports.com


-
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] Making PDFs in Windows

2012-04-18 Thread David Goss
Take a look at this chapter from the Docbook XSL Guide:

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

 

That guide, along with the Docbook Definitive Guide are indispensible.
98% of problems I've had are addressed in one of those these two books.

http://docbook.org/tdg5/en/html/docbook.html

 

Personally, I use Cygwin, xsltproc, FOP, and a makefile for processing.
(I'd kill to have a Unixy box at work instead of XP, but that's really
another matter).

 

-David



 

From: deannel...@aol.com [mailto:deannel...@aol.com] 
Sent: Wednesday, April 18, 2012 9:59 AM
To: yoursurrogate...@gmail.com; docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Making PDFs in Windows

 

Its not necessary to use Cygwin or MinGW.

 

I use a batch file that calls XSLTPROC and FOP to generate PDFs under
Windows. 

 

Check our Bob Stayton's book for more info.

 

Regards,

Dean Nelson

 

In a message dated 4/18/2012 6:51:52 A.M. Pacific Daylight Time,
yoursurrogate...@gmail.com writes:

Hi guys, have you ever used Docbook to generate PDFs in Windows?
Did you use Cygwin?  If not, would you recommend anything else?



RE: [docbook-apps] nested lists being displayed incorrectly

2012-04-24 Thread David Goss
Hi,

The nested list needs to have a  as a parent, not the top
level list, like this:


It declares the document to be XML by indicating a
version and an encoding.
It defines the root element for our document (book)
and the following additional elements

The default namespace;  the default
type of document we are using (docbook) along with its namespace
address
The namespace for xlink (used to
create hyperlinks) with its namespace address
The version of Docbook we are
using
The default language for the
document


The structure for the rest of the document: title for
the book, author information and a sample chapter for us to work
with 
I just tested and it works fine fine.

(Yay! I was finally able to *give* help on this list! :) )

-David


-Original Message-
From: Carlos Araya [mailto:carlos.ar...@gmail.com] 
Sent: Tuesday, April 24, 2012 4:15 PM
To: docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] nested lists being displayed incorrectly

I am working with the following nested lists 


It declares the document to be XML by indicating a
version and an encoding.
It defines the root element for our document (book)
and the following additional elements

The default namespace;  the default
type of document we are using (docbook) along with its namespace
address
The namespace for xlink (used to
create hyperlinks) with its namespace address
The version of Docbook we are
using
The default language for the
document

The structure for the rest of the document: title for
the book, author information and a sample chapter for us to work
with 

Is the syntax correct?


When transforming the file to XHTML and FO it is swapping the order of
the lists in the resulting document. Below is the result in HTML using
the 1.76 styelsheets downloaded late last week

The skeleton of the file does a few things for us:




The default
namespace; the default type of document we are using (docbook) along
with its namespace address
The
namespace for xlink (used to create hyperlinks) with its namespace
address
The version
of Docbook we are using
The default
language for the document



It declares the
document to be XML by indicating a version and an encoding.

It defines the root
element for our document (book) and the following additional elements

The structure for
the rest of the document: title for the book, author information and a
sample chapter for us to work with




I get the same result if I use the snapshot stylesheets when building
epub3 and if I change the orderedlist to an itemizedlist. . 

-
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] output in PDF

2012-05-08 Thread David Goss
In your customization layer, try something like this:







For more information, see the section on customization layers in Bob Sayton's 
Docbook XSL Guide:
http://www.sagehill.net/docbookxsl/CustomMethods.html#WriteCustomization

-David



-Original Message-
From: Lars Vogel [mailto:lars.vo...@googlemail.com] 
Sent: Tuesday, May 08, 2012 3:37 PM
To: DocBook Apps
Subject: [docbook-apps]  output in PDF

Hi,

I started using  in my Docbook sources but it seems that the PDF 
output is just normal text. Is their a way to change it, e.g. to Italic?

Best regards, Lars

--
Lars
http://www.vogella.com - Eclipse, Android and Java Tutorials 
http://www.twitter.com/vogella - Lars on Twitter

-
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] Problems customizing an article titlepage

2012-05-22 Thread David Goss
I'm trying to create a PDF title page for my docbooks and I'm running
into two issues. I'm having difficult figuring out what is wrong, partly
because I'm using the article class instead of the book class for my
documents. I'm also using a 2 column layout

1.) Despite having column.count.titlepage set to 1, I'm still getting 2
columns on the titlepage.

2.) I want to remove the headers and footers (and corresponding rulers)
from the titlepage. From what I've read, the titlepage is supposed to
have blank headers/footers already, so I'm not sure how to remove them.

I suspect both of these are part of the behavior of the article class.
Any advice that could point me in the write direction would be greatly
appreciated (mostly likely it's in Bob's book and I just haven't spotted
the solutions yet).

Thank you,

DAVID GOSS | Technical Writer
P 1.800.876.9218 x 345 | F 1.800.588.9866
dg...@mueller-inc.com
http://www.MuellerReports.com



-
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] Automatic glossaries and seealso

2012-05-25 Thread David Goss
I'm using  to generate a glossary for multiple
documents from the same source.

 

This works great, unless I use a glossterm in the document that contains
a  element. When this happens, I get the "See also"
reference in the generated glossary, but if the glossterm was not used
in the document, the reference term isn't in the glossary.

 

Example:

My document contains:

heating

My glossary has cooling

So when I run the stylesheets, I get "See also, cooling" under the entry
for heating, even though "cooling" isn't in the generated glossary.

 

I would either like to automatically add the term to the generated
glossary or remove the seealso reference for terms that are not used.

 

(Could this also be a bug? It doesn't seem like expected behavior.)

 

DAVID GOSS | Technical Writer

P 1.800.876.9218 x 345 | F 1.800.588.9866

dg...@mueller-inc.com

http://www.MuellerReports.com <http://www.muellerreports.com/> 

 



[docbook-apps] Customizing the process.image template

2012-06-08 Thread David Goss
Hi,

I'm using the [Lazy Load](http://www.appelsiini.net/projects/lazyload)
JQuery plugin to help out on some image-heavy docbook articles. I
basically just copy/pasted the process.image template to my
customization later and made these changes ("data-original" was "src"
and the last two attributes are my additions):

 
   
 
   
 
   

  

../img/common/placeholder.png
lazy

It works just fine, that's not the problem. I want to make it degrade
gracefully (without JavaScript, only the placeholder image is
displayed). The way the plugin author recommends to do so is the place
an alternative in a  tag after the image, like this:




My question is where/how in the process.image template should this
redundant image be added? (Perhaps I need to call process.image twice in
the imagedata template, then have some sort of condition in
process.image to determine whether to swap "src" and "data-original"?)


DAVID GOSS | Technical Writer
P 1.800.876.9218 x 345 | F 1.800.588.9866
dg...@mueller-inc.com
http://www.MuellerReports.com



-
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] Customizing the process.image template

2012-06-08 Thread David Goss
Thank you Bob, that was the exact place I need to add the code I wanted.
It works perfectly now.

-David


-Original Message-
From: Bob Stayton [mailto:b...@sagehill.net] 
Sent: Friday, June 08, 2012 1:00 PM
To: David Goss; DocBook Apps
Subject: Re: [docbook-apps] Customizing the process.image template

Hi David,
No need to call 'process.image' again.  Since you have already copied it
to your customization layer, you can just add the extra element there.
Put it after these
lines:


  

  

which is just before the  element would be output for an imagemap,
or at the very end of the template.

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


- Original Message -----
From: "David Goss" 
To: "DocBook Apps" 
Sent: Friday, June 08, 2012 8:42 AM
Subject: [docbook-apps] Customizing the process.image template


Hi,

I'm using the [Lazy Load](http://www.appelsiini.net/projects/lazyload)
JQuery plugin to help out on some image-heavy docbook articles. I
basically just copy/pasted the process.image template to my
customization later and made these changes ("data-original" was "src"
and the last two attributes are my additions):

 
   
 
   
 
   

  

../img/common/placeholder.png
lazy

It works just fine, that's not the problem. I want to make it degrade
gracefully (without JavaScript, only the placeholder image is
displayed). The way the plugin author recommends to do so is the place
an alternative in a  tag after the image, like this:




My question is where/how in the process.image template should this
redundant image be added? (Perhaps I need to call process.image twice in
the imagedata template, then have some sort of condition in
process.image to determine whether to swap "src" and "data-original"?)


DAVID GOSS | Technical Writer
P 1.800.876.9218 x 345 | F 1.800.588.9866
dg...@mueller-inc.com
http://www.MuellerReports.com



-
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] Using DiffMk with Docbook

2012-07-11 Thread David Goss
Hi,

I hope this question is within the scope of this list.

I'm trying to use [DiffMk](http://sourceforge.net/projects/diffmk/) to
compare two version of a file checked out from SVN, and I'm having all
sorts of problems getting it to work in Cygwin. I'm following [Bob's
directions in the XSL
Guide](http://www.sagehill.net/docbookxsl/Changebars.html#d0e50355), but
there are a few problems

  + I'm plagued by "Could not find or load main class" errors
  + There is no diffmk.xml (or config/) in the DiffMk distribution

Does anyone have this program working in Cygwin and might be able to
offer some advice, or know of an alternative that might work better?
Being able to generate revisionflags between versions would be more
useful than sliced bread is for sandwich making.

DAVID GOSS | Technical Writer
P 1.800.876.9218 x 345 | F 1.800.588.9866
dg...@mueller-inc.com
http://www.MuellerReports.com


-
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] Possible (brief?) {www.}docbook.org and wiki.docbook.org downtime

2012-07-26 Thread David Goss
Hi,

I'm encountering an error, "Element caption in namespace
'http://docbook.org/ns/docbook' encountered in figure, but no template
matches" whenever I try to build documents that previously built without
a hitch. Could this problem be caused by docbook.org server changes?

-David


-Original Message-
From: Norman Walsh [mailto:n...@nwalsh.com] 
Sent: Thursday, July 26, 2012 9:10 AM
To: docb...@lists.oasis-open.org; docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] Possible (brief?) {www.}docbook.org and
wiki.docbook.org downtime

Hi folks,

I'm moving the DNS for {www.}docbook.org and wiki.docbook.org around
today.
There may be some short period of downtime. Or not. Hard for me to say.
In theory, if you get the current DNS entries, you'll go to the current
sites and as the new DNS entries propagate, you'll go to the new sites.
So, with luck, you'll never notice.

But if you do, well, it's me again :-)

Be seeing you,
  norm

-- 
Norman Walsh   | Nothing ever gets anywhere. The
http://www.oasis-open.org/docbook/ | earth keeps turning round and gets
Chair, DocBook Technical Committee | nowhere. The moment is the only
   | thing that counts.--Jean Cocteau

-
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] Possible (brief?) {www.}docbook.org and wiki.docbook.org downtime

2012-07-27 Thread David Goss
No, I haven't changed my customizations in awhile.

I've been using the stock sheets that come with Cygwin. I looked and
notice that those files had been modified in the past few days (must
have been updated and I didn't notice). I downloaded the stylesheets
from the Sourceforge site.

It looks like I'm encountering this problem with the 1.77.x sheets but
1.76.1 works fine. I tried pull out all of my customizations out and
just using the stock 1.77.1 sheets and still encountered this error. I
have figure/caption/para, which looks to be valid, so maybe this is a
stylesheet bug?

-David



-Original Message-
From: Norman Walsh [mailto:n...@nwalsh.com] 
Sent: Thursday, July 26, 2012 8:21 PM
To: David Goss
Cc: docbook-apps@lists.oasis-open.org
Subject: Re: [docbook-apps] Possible (brief?) {www.}docbook.org and
wiki.docbook.org downtime

"David Goss"  writes:
> I'm encountering an error, "Element caption in namespace 
> 'http://docbook.org/ns/docbook' encountered in figure, but no template

> matches" whenever I try to build documents that previously built 
> without a hitch. Could this problem be caused by docbook.org server
changes?

I *really* don't think so. That sounds like a stylesheet problem. Did
you change your stylesheets recently?

Be seeing you,
  norm

-- 
Norman Walsh   | He who will not reason is a bigot;
http://www.oasis-open.org/docbook/ | he who cannot is a fool; and he
Chair, DocBook Technical Committee | who dares not is a slave.--Sir
   | William Drummond

-
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] export from MS Excel to DocBook?

2012-08-16 Thread David Goss
I did something like this recently to take some spreadsheets (or rather 
tab-delimited data from them) and format it in LaTeX. I'm not a programmer, so 
my skills doing something like this are pretty crude. I used this bit of Lua 
code to pull data from a tab-delimited text file produced by Excel and read it 
into a Lua table. In your case, you could use the LuaXML library to write data 
from the table to a Docbook file as you see fit.

function string:split( inSplitPattern, outResults )
if not outResults then
outResults = { }
end
local theStart = 1
local theSplitStart, theSplitEnd = string.find( self, 
inSplitPattern, theStart )
while theSplitStart do
table.insert( outResults, string.sub( self, theStart, 
theSplitStart-1 ) )
theStart = theSplitEnd + 1
theSplitStart, theSplitEnd = string.find( self, 
inSplitPattern, theStart )
end
table.insert( outResults, string.sub( self, theStart ) )
return outResults
end

-- table to hold data
local data = {}

local file = assert(io.open(arg[2], "r"), "Error error reading file")
line = file:read("*line")

repeat
table.insert(data, line:split("\t"))
line = file:read("*line")
until line==nil
file:flush()
file:close()

Again, not elegant, but it worked out for me.

-David


-Original Message-
From: robert.buer...@bmw.de [mailto:robert.buer...@bmw.de] 
Sent: Thursday, August 16, 2012 3:24 AM
To: docbook-apps@lists.oasis-open.org
Subject: [docbook-apps] export from MS Excel to DocBook?

Hi all,

I've got a large number of text paragraphs in a Excel spreadsheet.

I think about to convert the entries of the spreadsheet cells to a docbook file 
using the XML capabilities of the newer Excel versions.

My Excel looks like this:

Heading 1   |   |   |   |
| Text a|   |   |
| Text b|   |   |
|   | Heading 2 |   |   
|   |   | Text c|
|   |   | Text d|

This should go in something like this:



 Heading 1
  Text a
  Text b
 
  Heading 2
   Text a
   Text b
 


Has anybody any experience with this? Any pointers?

Best regards

Robert Bürgel

-
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] Custom css with webhelp

2013-04-16 Thread David Goss
I want to use a custom CSS file with webhelp output. I'm using Oxygen. I set 
the html.stylesheet parameter and pointed it to a custom CSS file. 

In my output, however, the CSS is not linked. I only see one  for css in 
the output, which is for tocWDiv.css.

Does the html.stylesheet parameter not work the way I'm expecting it to with 
webhelp?

--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 


-
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] Ajax HTML format wanted

2013-04-25 Thread David Goss
Personally, I think docbook's HTML output can be very aesthetically pleasing, 
and so well designed that the sky is the limit with CSS. It's also 
technologically pleasing, displaying well in my browser of choice (elinks). In 
my antiquated opinion, web pages are documents, not applications. For our 
audiences, functionality is more important. Some of the clients we work with 
are in developing countries and are using very old hardware and slow, 
unreliable internet access. Even on a fast internet connection, a user can 
still hit CTRL+F faster than they can scroll around, clicking menus and pecking 
around to find the "hidden" text they're looking for.

That said, I have experimented specifically with some of the things you're 
talking about. We tried working in things like thumbnails that float off to the 
side and expand when clicked, glossary entries that open in fancy-pants popups, 
etc. One of the most useful things we worked out was implementing the JQuery 
Lazy Load plugin, which waits to load images until you scroll down to them. 
It's possible to implement some of these things while still keeping pages 
accessible, sitting on top of docbook's output and degrading gracefully when 
the user doesn't want it.

We don't have anything like that in our production documentation though because 
it breaks the accessibility and easy-of-use. I can dig around and see what I 
can pull up. There are a lot of possibilities with CSS and JQuery using 
Docbook, because the DOM in Docbook's output is so well structured.

-David



--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 


- Original Message -
From: "Edwin Aldridge" 
To: docbook-apps@lists.oasis-open.org
Sent: Thursday, April 25, 2013 5:56:31 AM
Subject: [docbook-apps] Ajax HTML format wanted


I am writing a set of docbook articles which I would like presented on the web 
but I find the HTML and XHTML formats really clunky. Aesthetics asice, they 
certainly do not take advantage of the medium's capabilities and am looking for 
something a bit smarter. 


Does anyone know of, or would anyone be interested in developing, stylesheet 
variant which does something like the following: 


* present chapters down one side - just one level, definitely no tree 
structures dancing before your eyes 
* present first level sections as tabs across the top 
* present lower level sections as headings (writing to a limit of two levels is 
a useful discipline) 
* present sidebars on the side (like the FO transforms) but say as accordians 
* present foot notes and glossary terms as pinable popups onclick or mouseover 


This could also make use of the much wider screens now commonly available, e.g. 
giving lots of display room for sidebars. It would make better use of internal 
links and non-serial reading approaches (which readers often don#'t do with 
dead tree media and never do with the web). 



There are a few practical challenges - like making the doc display correctly 
when someone links to an internal URL, but I am sure this is not beyond the wit 
of someone with good JQuery skills (or similar). 


Does anyone know if there is anything out there like that? Or would anyone be 
interested enough to do something like this? 


Regards 
Edwin Aldridge 


-
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] Problem with "\" in WebHelp Search

2013-06-05 Thread David Goss
Hi Morgan, 

What browser does this happen in? I'm not able to reproduce this issue using 
the 1.78.1 stylesheets. I tried in IE9 and FireFox 18. 




--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 

- Original Message -

From: "Morgan Hayward"  
To: docbook-apps@lists.oasis-open.org 
Sent: Wednesday, June 5, 2013 12:30:33 PM 
Subject: [docbook-apps] Problem with "\" in WebHelp Search 



Hi all, 

We recently started using the DocBook WebHelp templates to create an HTML 
version of our manuals that includes a search function. So far, the search 
function works great, but we noticed the sidebar disappears if your search 
query includes a backslash (\). You also can’t get the sidebar back unless you 
clear your browser cache completely and restart the browser. Has anyone 
encountered this problem before and, hopefully, fixed the issue? 

We’re using DocBook 1.78.0. Please let me know if you need any more 
information. 

Regards, 
Morgan 



[docbook-apps] body.start.indent with mixed one and two column layout

2013-06-07 Thread David Goss
Hi, 

I'm using the column.count.back property to change the layout for the index, 
glossary, etc for our manual to 2 columns. The problem is, this is inheriting 
the indent (body.start.indent, I assume) from the rest of the document. This 
creates a weird look where the back matter columns are intented. I know I can 
just do body.start.intent=0 to fix that, but I want to keep the indent 
elsewhere. I'm not sure what sure what template and/or parameters to customize 
so that body.start.indent=0 only if the current section is 2 columns, otherwise 
it is 4pc. 

Regards, 
David 



--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 



Re: [docbook-apps] body.start.indent with mixed one and two column layout

2013-06-07 Thread David Goss
Thank you so much, Bob. That's exactly what I was looking for. 

In going back to my original output, you were right about the index. I was just 
seeing my other appendixes being indented awkwardly. 




--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 

- Original Message -

From: "Bob Stayton"  
To: "David Goss" , docbook-apps@lists.oasis-open.org 
Sent: Friday, June 7, 2013 11:52:29 AM 
Subject: Re: [docbook-apps] body.start.indent with mixed one and two column 
layout 


Hi David, 
You will need to customize the template named 'set.flow.properties' from 
fo/pagesetup.xsl. There is an xsl:choose statement in there that decides how to 
add that property to the fo:flow of each page-sequence. You can modify it to 
handle the elements or pageclasses you want to control. You'll notice that 
pageclass="index" is omitted, so you should not be getting indents in the index 
already. 

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




From: David Goss 
Sent: Friday, June 07, 2013 8:14 AM 
To: docbook-apps@lists.oasis-open.org 
Subject: [docbook-apps] body.start.indent with mixed one and two column layout 


Hi, 

I'm using the column.count.back property to change the layout for the index, 
glossary, etc for our manual to 2 columns. The problem is, this is inheriting 
the indent (body.start.indent, I assume) from the rest of the document. This 
creates a weird look where the back matter columns are intented. I know I can 
just do body.start.intent=0 to fix that, but I want to keep the indent 
elsewhere. I'm not sure what sure what template and/or parameters to customize 
so that body.start.indent=0 only if the current section is 2 columns, otherwise 
it is 4pc. 

Regards, 
David 



--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 




[docbook-apps] Formatting section titles in an appendix

2013-08-19 Thread David Goss
I'm running into a bit of difficulty formatting section titles within an 
appendix, without breaking titles in chapters. I'm attempting to format  
and  children of an appendix to be different than those in chapters. 
Specifically 

+ Section titles in an appendix shouldn't be numbered (but the Appendix itself 
*should* be numbered; basically, appendixes need a different numbering depth) 
+ Section titles in an appendix need different font sizes and margins than 
those in chapters (i.e. different attribute set). 

I'm not sure where to actually customize these things in my customization 
and/or titlepage spec. Assistance pointing me in the right direction (or the 
applicable section in the XSL guide) would be greatly appreciated. 



--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 



Re: [docbook-apps] Formatting section titles in an appendix

2013-08-19 Thread David Goss
I hadn't thought of that approach, but simplesect actually should meet our 
needs. That's probably a lot easier than working out the necessary 
customizations. Simpleset is living up to its name! 
-David 




--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 

- Original Message -

From: "Pc Thoms"  
To: "David Goss" , docbook-apps@lists.oasis-open.org 
Sent: Monday, August 19, 2013 2:24:04 PM 
Subject: Re: [docbook-apps] Formatting section titles in an appendix 



Hi David 

Would  meet your requirements? 
http://docbook.org/tdg51/en/html/simplesect.html 






On Mon, Aug 19, 2013 at 3:16 PM, David Goss < g...@fstrf.org > wrote: 




I'm running into a bit of difficulty formatting section titles within an 
appendix, without breaking titles in chapters. I'm attempting to format  
and  children of an appendix to be different than those in chapters. 
Specifically 

+ Section titles in an appendix shouldn't be numbered (but the Appendix itself 
*should* be numbered; basically, appendixes need a different numbering depth) 
+ Section titles in an appendix need different font sizes and margins than 
those in chapters (i.e. different attribute set). 

I'm not sure where to actually customize these things in my customization 
and/or titlepage spec. Assistance pointing me in the right direction (or the 
applicable section in the XSL guide) would be greatly appreciated. 



--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 







[docbook-apps] Info element & title

2013-08-19 Thread David Goss
I've noticed that the title element, when present in an info element does not 
always appear. For example: 

 
 
My Title 
 
 

Is fine, but the same scenario with a procedure instead of a chapter will not 
display the title in FO output. Moving the title to be a direct child of the 
procedure will display the title in the output as expected. 

I'm more or less curious if this behavior is intentional in docbook's design, 
and how, for elements where d:info/d:title is not displayed, is the appropriate 
way to display it in output. 




--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 



[docbook-apps] Alt text not appearing in inlinemediaobject

2013-10-29 Thread David Goss
I have the the following docbook 5 markup: 
Click the 
Execute button. 

It is outputting the following HTML : 
Click the  button. 

I'm not sure why the alt text is not carrying over. Am I using the alt tag 
incorrectly or is this a bug? I'm using webhelp docbook-xsl-ns-1.78.1 . 

I did see this page in the XSL Guide: 
http://www.sagehill.net/docbookxsl/AltText.html 
But it looks to be for Docbook4. 




--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 



Re: [docbook-apps] Alt text not appearing in inlinemediaobject

2013-10-29 Thread David Goss
Thanks Thomas. I tried that solution, but I'm still not seeing the alt 
attribute in the output. Below is what I added to my customization (I marked 
the change from the original stylesheet--it's just 3 additional lines). 

 
 
 
 
 
 

 
 
http://www.w3.org/1998/Math/MathML";> 
 
 

http://www.w3.org/2000/svg";> 
 
 

 
 
 
 
 
 
 
 
 
 
 
 
No insertfile extension available. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

 

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

 
 
 
 
 
 
 
 




--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 

- Original Message -

From: "Thomas Schraitle"  
To: docbook-apps@lists.oasis-open.org 
Sent: Tuesday, October 29, 2013 12:20:08 PM 
Subject: Re: [docbook-apps] Alt text not appearing in inlinemediaobject 

Hi David, 

Am Dienstag, 29. Oktober 2013, 11:52:20 schrieb David Goss: 
> I have the the following docbook 5 markup: 
> Click the 
> Execute fileref="img/ldms/ldms_button_execute.png" 
> depth="1em"/> button. 
> 
> It is outputting the following HTML : 
> Click the  src="img/ldms/ldms_button_execute.png" height="13"> 
> button. 
> 
> I'm not sure why the alt text is not carrying over. Am I using the alt tag 
> incorrectly or is this a bug? I'm using webhelp docbook-xsl-ns-1.78.1 . 

Your DocBook markup is perfectly correct. But it seems, there is a deficiancy 
about the handling of inlinemediaobject in the DocBook stylesheets. 

I suspect the html/graphics.xsl file in the "imagedata" template (lines 1250 - 
1331). In this template rule, the "process.image" template is called and the 
"alt" parameter is passed. However, it is not checked against an 
inlinemediaobject with a possible alt element. 

I would propose this change: 

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 


If you would like to give it a try, do the following: 

1. Create a customization layer if you haven't done yet. If you don't know 
how, read one of the following URLs: 
http://www.sagehill.net/docbookxsl/CustomMethods.html#CustomizationLayer 
http://doccookbook.sf.net/html/en/dbc.common.dbcustomize.html 

2. Copy the "imagedata" template from the original html/graphics.xsl template 
into your customization layer. 

3. Search for the xsl:call-template line and apply the above "patch" (add the 
2nd xsl:when test). 

4. Transform your DocBook document and use your customization layer. 


> I did see this page in the XSL Guide: 
> http://www.sagehill.net/docbookxsl/AltText.html 
> But it looks to be for Docbook4. 

You can use this also in DocBook 5 as long as it is valid. 


-- 
Gruß/Regards 
Thomas Schraitle 


- 
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] Alt text not appearing in inlinemediaobject

2013-10-29 Thread David Goss
It looks like xsl/graphics.xsl was also missing this: 

 
 
 

Adding this, along with Thomas's suggestion fixed this problem. Thanks again 
for your help! 




--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 

- Original Message -

From: "David Goss"  
To: "Thomas Schraitle"  
Cc: docbook-apps@lists.oasis-open.org 
Sent: Tuesday, October 29, 2013 12:47:41 PM 
Subject: Re: [docbook-apps] Alt text not appearing in inlinemediaobject 


Thanks Thomas. I tried that solution, but I'm still not seeing the alt 
attribute in the output. Below is what I added to my customization (I marked 
the change from the original stylesheet--it's just 3 additional lines). 

 
 
 
 
 
 

 
 
http://www.w3.org/1998/Math/MathML";> 
 
 

http://www.w3.org/2000/svg";> 
 
 

 
 
 
 
 
 
 
 
 
 
 
 
No insertfile extension available. 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

 

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

 
 
 
 
 
 
 
 




--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 

- Original Message -

From: "Thomas Schraitle"  
To: docbook-apps@lists.oasis-open.org 
Sent: Tuesday, October 29, 2013 12:20:08 PM 
Subject: Re: [docbook-apps] Alt text not appearing in inlinemediaobject 

Hi David, 

Am Dienstag, 29. Oktober 2013, 11:52:20 schrieb David Goss: 
> I have the the following docbook 5 markup: 
> Click the 
> Execute fileref="img/ldms/ldms_button_execute.png" 
> depth="1em"/> button. 
> 
> It is outputting the following HTML : 
> Click the  src="img/ldms/ldms_button_execute.png" height="13"> 
> button. 
> 
> I'm not sure why the alt text is not carrying over. Am I using the alt tag 
> incorrectly or is this a bug? I'm using webhelp docbook-xsl-ns-1.78.1 . 

Your DocBook markup is perfectly correct. But it seems, there is a deficiancy 
about the handling of inlinemediaobject in the DocBook stylesheets. 

I suspect the html/graphics.xsl file in the "imagedata" template (lines 1250 - 
1331). In this template rule, the "process.image" template is called and the 
"alt" parameter is passed. However, it is not checked against an 
inlinemediaobject with a possible alt element. 

I would propose this change: 

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 


If you would like to give it a try, do the following: 

1. Create a customization layer if you haven't done yet. If you don't know 
how, read one of the following URLs: 
http://www.sagehill.net/docbookxsl/CustomMethods.html#CustomizationLayer 
http://doccookbook.sf.net/html/en/dbc.common.dbcustomize.html 

2. Copy the "imagedata" template from the original html/graphics.xsl template 
into your customization layer. 

3. Search for the xsl:call-template line and apply the above "patch" (add the 
2nd xsl:when test). 

4. Transform your DocBook document and use your customization layer. 


> I did see this page in the XSL Guide: 
> http://www.sagehill.net/docbookxsl/AltText.html 
> But it looks to be for Docbook4. 

You can use this also in DocBook 5 as long as it is valid. 


-- 
Gruß/Regards 
Thomas Schraitle 


- 
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] Adding an additional "section" between a sect1 and a sect2

2013-12-02 Thread David Goss
I just wanted to point out the renderas ("render as") attribute, which actually 
might be closer to what you're looking for. This would let you use section 
levels correctly, but you could select individual ones to be formatted 
differently, e.g. 

 
Application Basics 
 
Setting Up a Project 
 
 
How to Setup a Project 
... 


See http://www.sagehill.net/docbookxsl/Typography.html#UsingRenderas 

--- 
David Goss, M.A. 
Technical Writer, Laboratory Division 
Frontier Science & Technology Research Foundation 
4033 Maple Road 
Amherst, NY 14226 
(716) 834-0900 x7218 

- Original Message -

From: "Jen"  
To: docbook-apps@lists.oasis-open.org 
Sent: Thursday, November 28, 2013 5:32:43 AM 
Subject: [docbook-apps] Adding an additional "section" between a sect1 and a 
sect2 


Hi, 


I'm trying to convert an existing document to DocBook and I'm struggling with a 
structure that is not (I think!) supported in DocBook (H3 between H1 and H2). 


Right now, the layout of this section is (in HTML) something like: 


Application Basics -> chapter name 
Description of application. 
Setting Up a Project 

Short description of project setup, plus links to relevant topics. 

Setting Up A Task 
Short description of task setup, plus links to relevant topics. 
How to Set Up a Project -> first "true" section 

Procedure for setting up a project. 


Now, I don't think this can work in DocBook, since you can't have 
sect1>sect3>sect2... but I'd like to maintain the smaller headings in the 
chapter introduction. Is there a tag that I can use for this? Worst case 
scenario, I'll just have an , but I'd prefer to use a 
dedicated tag so I could also change the font size and so on. 


Thanks in advance, 
Jen 


[docbook-apps] Turning off admonition graphics

2014-02-26 Thread David Goss
I would like for admonition graphics to not be displayed in both HTML and PDF 
output. Based on the documentation, this seems to be a trivial thing to 
accomplish. I simply set the following in my customization layers: 

 

And yet, the admonition graphics are still appearing in both HTML and FO 
output. Is this a bug in the 1.78.1 stylesheets? I actually thought the 
stylesheets were supposed to default to *not* displaying the admonition 
graphics? 



-- 
David Goss , Technical Writer 
Frontier Science | www.fstrf.org 
4033 Maple Rd, Amherst, NY 14226 
(716) 834-0900 extension 7218 









[docbook-apps] Re: Turning off admonition graphics

2014-02-26 Thread David Goss
Silly me, I've answered my own question. The issue was not with the stylesheets 
or my customization layer, but rather with oXygen. 

Apparently oXygen set up some parameters in the transformation scenarios that 
were overriding my own stylesheets. After removing those parameters, this 
problem (and a few other oddities) were fixed. 





------ 
David Goss , Technical Writer 
Frontier Science | www.fstrf.org 
4033 Maple Rd, Amherst, NY 14226 
(716) 834-0900 extension 7218 







- Original Message -

From: "David Goss"  
To: docbook-apps@lists.oasis-open.org 
Sent: Wednesday, February 26, 2014 11:48:51 AM 
Subject: Turning off admonition graphics 

I would like for admonition graphics to not be displayed in both HTML and PDF 
output. Based on the documentation, this seems to be a trivial thing to 
accomplish. I simply set the following in my customization layers: 

 

And yet, the admonition graphics are still appearing in both HTML and FO 
output. Is this a bug in the 1.78.1 stylesheets? I actually thought the 
stylesheets were supposed to default to *not* displaying the admonition 
graphics? 



------ 
David Goss , Technical Writer 
Frontier Science | www.fstrf.org 
4033 Maple Rd, Amherst, NY 14226 
(716) 834-0900 extension 7218 










Re: [docbook-apps] FO index title formatting

2014-02-26 Thread David Goss
I think what you want is this: 

   all 
 
For any sections that are multiple columns, this will put the span all property 
in the outer fo:block, causing the title to span all columns. I think this is 
what you want. 

For more, see http://www.sagehill.net/docbookxsl/MultiColumns.html 




-- 
David Goss , Technical Writer 
Frontier Science | www.fstrf.org 
4033 Maple Rd, Amherst, NY 14226 
(716) 834-0900 extension 7218 







- Original Message -

From: "Gábor Kövesdán"  
To: docbook-apps@lists.oasis-open.org 
Sent: Wednesday, February 26, 2014 12:08:08 PM 
Subject: [docbook-apps] FO index title formatting 

Hi, 

I'm using a two-column setup but I want the second column to start below 
the title, in line with the first column. In other words, I want to 
typeset the title in a single column and have a two-column section 
below. As far as I see, the column count can only be set up by region in 
the page master and both the title and the actual index is part of 
region-body. Is there any way to render it in this way? 

Thanks, 
Gabor Kovesdan 

- 
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] Redundant end tags been removed

2014-07-23 Thread David Goss
Hi Barton,

For an explanation of why self-closing tags can be an issue with browsers see 
this question on stack exchange:

http://stackoverflow.com/questions/69913/why-dont-self-closing-script-tags-work



-- 
David Goss , Technical Writer 
Frontier Science | www.fstrf.org 
4033 Maple Rd, Amherst, NY 14226 
(716) 834-0900 extension 7204 

- Original Message -
From: "Barton Wright" 
To: "Peter Fleck" 
Cc: "apps docbook" 
Sent: Wednesday, July 23, 2014 2:22:08 PM
Subject: Re: [docbook-apps] Redundant end tags been removed

Hello Peter,

I’m confused why the version without the closing  is a problem on any 
modern OS or browser. It’s a completely valid construction.

Nevertheless, perhaps the addthis.com site is expecting some content inside the 
 pair. You could place a space or even a non-breaking space 
character (  or its Unicode equivalent) just before the  to see 
if that preserves the closing . 

Let us know what worked when you figure it out!


> Hi guys,
> 
> I'm trying to add the below to each chunked html page.
> 
>  src="//s7.addthis.com/js/300/addthis_widget.js#pubid=XXX">
> 
> 
> What happens is that the 

Re: [docbook-apps] fop and embedding fonts

2014-12-12 Thread David Goss
Do you have your conf file to set to look for system fonts: 

 
C:\Windows\Fonts 
 
 

If so, and if you have DroidSans available as a system font, it might be trying 
to pull the system version (which might an open type font, which FOP wouldn't 
support). 

I've always had bad luck with FOP's font configuration. The only success I've 
ever had is just installing the ttf version of the font on the system. 






-- 
David Goss , Technical Writer 
Frontier Science | www.fstrf.org 
4033 Maple Rd, Amherst, NY 14226 
(716) 834-0900 extension 7204 


From: "Tim Arnold"  
To: "docbook-apps"  
Sent: Friday, December 12, 2014 10:44:42 AM 
Subject: [docbook-apps] fop and embedding fonts 

Hi, 
I'm attempting font-embedding with Apache FOP 1.1 with difficulties. Is there a 
tutorial on setting this up? 

In my xsl customization layer I set "body.font.family" to 'Droid'. 
Droid 

In my fo configuration file, I specify the TrueType font: 

 
 
 

specified in the renderer for application/pdf. When I compile the document, I 
don't see any errors or warnings, but Droid is not listed in the fonts, let 
alone being embedded. 

But the settings have some effect though, since the body text in the pdf has 
'#' for each character that is supposed to be in the body font. 

I am reading the fop fonts doc (with 1.1 the metrics are optional it says). 
http://xmlgraphics.apache.org/fop/1.1/fonts.html 

and the DocBook XSL Guide on fonts: 
http://www.sagehill.net/docbookxsl/AddFont.html 

Anyone see what I'm doing wrong? 
thanks, 
--Tim 



Re: [docbook-apps] docbook -> docx

2015-01-23 Thread David Goss
There is also the roundtrip stylesheets in the Docbook XSL distribution. These 
require that you use a subset of docbook elements. 

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

I haven't personally tried the roundtrip stuff. Whenever a non-technical person 
has asked for an "editable" version of a docbook file, I usually just 
copy/paste the HTML into Word, and explain the caveat that they should just 
ignore the formatting. 



------ 
David Goss , Technical Writer 
Frontier Science | www.fstrf.org 
4033 Maple Rd, Amherst, NY 14226 
(716) 834-0900 extension 7204 


From: "Peter Lavin"  
To: "Fredrik Unger"  
Cc: "docbook-apps"  
Sent: Friday, January 23, 2015 9:03:12 AM 
Subject: Re: [docbook-apps] docbook -> docx 

Hi Fredrik, 
pandoc does a decent job of converting DocBook to .docx. 

See: 

http://johnmacfarlane.net/pandoc/ and for a detailed review, 

http://www.objectorientedphp.com/articles/pandoc.html 

Peter 

On 23 January 2015 at 08:45, Fredrik Unger < f...@tree.se > wrote: 


Hi, 

I am looking into generating reports that has to be Word 2010. 

Now I am able to get reasonable results with a simple test file using 
python-docx, currently just writing the report in python. 

My plan would be : 
- Generate/write docbook file 
- Create docx file with styles as template in Word 2010 
- Translate docbook -> docx using python-docx building a 
small python library 

This gives me the freedom to generate the reports in docbook xml using 
the tools in python, xml, templates etc. 

My current document contains, text, tables, images which all are supported in 
python-docx. 

Are there any better alternatives to this approach ? 


Thanks, 

Fredrik Unger 

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










Re: [docbook-apps] Note Box

2015-01-26 Thread David Goss
Hi,

Docbook's default output is plain HTML, without styling. To add borders to 
notes (and other style changes) for HTML output, you need to use a CSS 
stylesheet. For notes, for example, you'd want to do something like:

div.note {
   border: 1px solid black;
}

For more, see:

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

------ 
David Goss , Technical Writer 
Frontier Science | www.fstrf.org 
4033 Maple Rd, Amherst, NY 14226 
(716) 834-0900 extension 7204

- Original Message -
From: "Joydeep Chakrabarty" 
To: "docbook-apps" 
Sent: Sunday, January 25, 2015 10:29:58 AM
Subject: [docbook-apps] Note Box

Hello all,

I have been trying to write a docbook file. I am using  element.
But I cannot see the note box (or borders) in my output html file. What 
am I missing here? Here
is my code.


http://www.oasis-open.org/docbook/xml/4.5/
docbookx.dtd">

My first DocBook document

  
TEST DOCBOOK

This is Note
This is test.
  
  


Thanks.


-
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] ANNOUNCE: new solar book produced using Docbook

2015-07-09 Thread David Goss
Hi Bob, 

Where there any elements in particular in the InDesign mock-ups that your 
designer provided that were difficult to implement in XSL for the PDF? Was 
there anything in particular that required some "creative" stylesheet 
workarounds? 



------ 
David Goss , Technical Writer 
Frontier Science | www.fstrf.org 
4033 Maple Rd, Amherst, NY 14226 
(716) 834-0900 extension 7204 


From: "Bob Stayton"  
To: "docbook-apps"  
Sent: Tuesday, July 7, 2015 5:16:46 PM 
Subject: [docbook-apps] ANNOUNCE: new solar book produced using Docbook 

You know me as the author of DocBook XSL: The Complete Guide . Now I have 
written another book on a completely different topic: solar energy. Since I 
produced my new book using DocBook, I'm taking this opportunity to tell the 
DocBook community about it, and I describe how I produced it at the end of this 
message. Replies about the DocBook process can go to the whole list if you 
think it's appropriate. If you want to reply about the book's content, please 
reply just to me so we don't burden the mailing list. 


I'm pleased to announce that my book Power Shift: From Fossil Energy to Dynamic 
Solar Power has been unleashed from its long development and is now available 
to the world. If you have any interest in solar energy, then you should read 
this book. 



Climate change researchers sometimes paint a bleak picture of our current 
global-warming crisis, but rarely explain how we got into this predicament in 
the first place and how we get out of it. Now, for the first time, my new book 
does just that. Power Shift retells human history through the lens of energy, 
explains the science behind the crisis--in clear, succinct language that anyone 
can understand—and provides a detailed blueprint for the future, from 
governmental, commercial, and individual perspectives. 

Wondering if the book is any good? Here is what others are saying: 

"Solar is surging all of a sudden, and if you read this comprehensive 
book you’ll understand why!" -- Bill McKibben, author of The End of Nature 

"An energy book that is a pleasure to read" -- Kirkus Reviews 

"visionary and brilliant" -- NASA Researcher Joe Jordan 

"Exceptionally well written" -- Midwest Book Review 

"lucid, convincing" -- Denis Hayes, organizer of the first Earth Day 

"points the way to a clean energy future" -- California Secretary of Natural 
Resources John Laird 

or check out the reader reviews on Amazon 


After teaching solar energy for many years, I spent over 15 years researching 
and writing this book, all while living the life in the off-grid solar home we 
built. This is my lifework. 

It has been a long road to publication. I handed out the first draft in January 
2000, and many things have changed since then. Now I get to report on solar 
energy's success instead of just wishing for it. I'm self publishing the book, 
because as an unknown author I could not interest a publishing company, and 
because they don't offer much in the way of marketing for new authors anyway. 
So I started my own publishing company, Sandstone Publishing ( 
www.sandstonepublishing.com ) , whose catalog contains exactly one book. 

Now I get to market my book, an activity for which I am totally unsuited. My 
low-budget marketing plan consists of getting good reviews, and word of mouth. 
So if you read the book and like it, please write a review on Amazon or 
Goodreads, and tell your friends and family about it. Even climate skeptics can 
get something out of this book. 

The book is available in paperback and Kindle at Amazon , in paperback and Nook 
Book at Barnes & Noble , in iBooks at the Apple iTunes Store and in Kobo from 
Kobo Books . And if you can't afford one, convince me and I'll give you an 
Ebook copy. 8^) 

By the way, although you know me as Bob Stayton, I'm publishing the book under 
my full name Robert Arthur Stayton as a gesture to honor my father Chester 
Arthur Stayton, Jr. and my grandfather Chester Arthur Stayton, Sr., with whom I 
share my middle name. 

Producing Power Shift with DocBook 

I wrote the book in DocBook 5 using XMetal 7. I started off writing it in 
modular fashion, but found that it got in the way of continuity. This isn't 
technical documentation, after all. 8^) So I merged all the files into one big 
book file and finished the book that way. That allowed me to easily find 
something for cross referencing and to keep the narrative flow moving. Searches 
for indexterms were much easier in a single file, and I used XMetal macros to 
assist with inserting indexterms. 

I hired a book designer for the interior and implemented the specs from the 
InDesign file she gave me in DocBook XSL. From that I could generate the PDF 
for the book's interior. I had hoped to be able to show you the page design by 
referring to the Look Inside

Re: [docbook-apps] Pure JS WebHelp

2017-04-17 Thread David Goss
It'd be great if you added this to Github.

I'm especially interested to see if this could be adapted to provide features 
(search, side navigation, etc) to other tools that can only output HTML out of 
box.

--------
David Goss, Business Analyst
Frontier Science (www.frontierscience.org)
LDMS (www.ldms.org)

- Original Message -
From: "Barton Wright" 
To: "Jan Tosovsky" 
Cc: "docbook-apps" 
Sent: Sunday, April 16, 2017 11:47:50 AM
Subject: Re: [docbook-apps] Pure JS WebHelp

Hi Jan,

Thank you a thousand times for posting this work. 

I vote for an initial upload to GitHub.

I notice you're using . Have you tried your XSL with  
structuring?

Thanks!


On Apr 16, 2017, at 10:46 AM, Jan Tosovsky  wrote:

Dear All,

as promised, I've published a demo output
https://www.bilyujezd.cz/beta/strucna-historie.html

Core changes against the current WebHelp:
- responsive design (Mobile First)
- breadcrumb 
- improved ToC processing (ToC is linked, not embedded in every HTML file)
- enhanced search related code (cleaning up the code for better maintenance)
- enhanced translation support (all messages are stored in standard l10n XML
files)
- storing client state even on file system or localhost (utilizing HTML5
Local Storage)
- removing jQuery and jQueryUI dependency

Further features:
- ability to enlarge downsized images (aka lightbox, especially useful for
SVG images)
- ability to copy links to specific anchors
- SASS styling (interpreted into CSS)

Weaknesses:
- only modern browsers are supported (Chrome, FF, Edge, IE10+)
- no custom params to override current bahavior
- no out-of-the-box scripts for copying dependencies to the target
destination


Should I put related XSL files and resources to my GitHub account or
directly to some DocBook sandbox?

Thanks,

Jan


-
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





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