Explicit tab and if-neccessary-pagebreaks?

[Rock Lobster]

Hello,

I'm rather new to DocBook and I've got two little problems, I tried a search but didn't find anything, so I hope someone could help me :)

1) There's an explicit line break, <sbr/>, which is very useful, but is there also some explicit tab available? Or better spoken, an explicit indentation tag? I couldn't find anything like that; if it doesn't exist, is there some good workaround?

2) Is there any possibility to declare a certain textarea that should NOT be victim of a pagebreak, if possible? With other words, can an area be defined so that if a pagebreak would occur inside this area, the stylesheet would insert a pagebreak BEFORE that area, so that it's more likely that the area is completely on one page and not broken?

Thanks in advance!
Rock Lobster

[Bob Stayton]

Well, sbr isn't very useful outside of a command synopsis, which is the
only place where it is allowed by the DTD.  There is no general line break
element in DocBook, but you could use a literallayout element which
respects line breaks.

Tabstop is a feature that is not defined in the XSL-FO standard.  Tab
characters are converted
to white space, which is generally collapsed to a single space character
when there is more than one.

DocBook XML and XML in general are designed  to separate content from
formatting.  The formatting should be supplied by the stylesheet.  Indents
are formatting and would not normally be encoded in the DocBook XML  That
said, there are exceptions such as tables that let you specify column
widths and frame styles.  Perhaps an example of what you are trying to do
would help.

Regarding keeping something together, that is an XSL stylesheet feature,
using a property keep-together.within-page="always" on the fo:block
containing the material.  The DocBook stylesheet uses such a keep on formal
objects such as table, example, and figure.


Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@...


----- Original Message -----
From: "Rock Lobster" <email@...>
To: <docbook@...>
Sent: Tuesday, March 20, 2007 1:59 AM
Subject: [docbook] Explicit tab and if-neccessary-pagebreaks?

>
> Hello,
>
> I'm rather new to DocBook and I've got two little problems, I tried a
> search
> but didn't find anything, so I hope someone could help me :)
>
> 1) There's an explicit line break, <sbr/>, which is very useful, but is
> there also some explicit tab available? Or better spoken, an explicit
> indentation tag? I couldn't find anything like that; if it doesn't exist,
> is
> there some good workaround?
>
> 2) Is there any possibility to declare a certain textarea that should NOT
> be
> victim of a pagebreak, if possible? With other words, can an area be
> defined
> so that if a pagebreak would occur inside this area, the stylesheet would
> insert a pagebreak BEFORE that area, so that it's more likely that the
> area
> is completely on one page and not broken?
>
> Thanks in advance!
> Rock Lobster
> --
> View this message in context:
> http://www.nabble.com/Explicit-tab-and-if-neccessary-pagebreaks--tf3432655.html#a9569245
> Sent from the docbook General mailing list archive at Nabble.com.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@...
> For additional commands, e-mail: docbook-help@...
>
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...

[Rock Lobster]

Thanks for your answer!Well you're right, indenting is indeed a formatting thing, but on the other hand, it's also got to do with structuring, so it would be very helpful sometimes.In my case, I've got an itemizedlist, where every listitem has a filename and below a description of what the file does. But it doesn't look very good, I would like the description to be indented a little bit.This is of course a typical "the whole paragraph is indented except for the first line"-thing, but I don't know if the stylesheet could be configured to accomplish this.Another possibility would be to add another list for every listitem, but this would be totally abused and produce too much overhead, so I wouldn't want to use that.Thanks also for the keep-together, in my case they are code examples, so I'll use the example-tag!

[Rock Lobster]

Well I tried to adjust parameters in the docbook/xsl/param directory, but the problem is, they don't get used as it seems. I used af file monitor to watch every xml file that got processed, but none of the params was opened during transformation. What am I doing wrong here?

[Rowland, Larry]

Have you considered using a variable list (variablelist is the element
name).  The term element would be the file name and the listitem
contents describing it are indented under the file name.  The intent of
variable lists sounds very similar to what you are attempting to
represent.

Regards,

Larry Rowland

-----Original Message-----
From: Rock Lobster [mailto:email@...]
Sent: Friday, March 23, 2007 2:46 AM
To: docbook@...
Subject: Re: [docbook] Explicit tab and if-neccessary-pagebreaks?


Thanks for your answer!Well you're right, indenting is indeed a
formatting
thing, but on the other hand, it's also got to do with structuring, so
it
would be very helpful sometimes.In my case, I've got an itemizedlist,
where
every listitem has a filename and below a description of what the file
does.
But it doesn't look very good, I would like the description to be
indented a
little bit.This is of course a typical "the whole paragraph is indented
except for the first line"-thing, but I don't know if the stylesheet
could
be configured to accomplish this.Another possibility would be to add
another
list for every listitem, but this would be totally abused and produce
too
much overhead, so I wouldn't want to use that.Thanks also for the
keep-together, in my case they are code examples, so I'll use the
example-tag!
--
View this message in context:
http://www.nabble.com/Explicit-tab-and-if-neccessary-pagebreaks--tf34326
55.html#a9630460
Sent from the docbook General mailing list archive at Nabble.com.


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...


---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...

[Bob Stayton]

I know it isn't obvious, but the files in the params directory are the
source files used to build the param.xsl file in each output type (fo,
html, etc.), which is where the active parameter settings are.  You can
change parameter settings by creating a customization layer that imports
docbook.xsl, as described here:

http://www.sagehill.net/docbookxsl/CustomMethods.html#CustomizationLayer

Bob Stayton
Sagehill Enterprises
DocBook Consulting
bobs@...


----- Original Message -----
From: "Rock Lobster" <email@...>
To: <docbook@...>
Sent: Friday, March 23, 2007 1:08 AM
Subject: Re: [docbook] Explicit tab and if-neccessary-pagebreaks?

>
> Well I tried to adjust parameters in the docbook/xsl/param directory, but
> the
> problem is, they don't get used as it seems. I used af file monitor to
> watch
> every xml file that got processed, but none of the params was opened
> during
> transformation. What am I doing wrong here?
> --
> View this message in context:
> http://www.nabble.com/Explicit-tab-and-if-neccessary-pagebreaks--tf3432655.html#a9630469
> Sent from the docbook General mailing list archive at Nabble.com.
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-unsubscribe@...
> For additional commands, e-mail: docbook-help@...
>
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-unsubscribe@...
For additional commands, e-mail: docbook-help@...

[Rock Lobster]

Thank you,

I use it now and it works nicely ;)