OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [docbook-apps] Zero-width space as line-wrapping workaround?

Hi Thomas,

Thanks for advising, and for the hyphenate-url.xsl template! Minor question below.

On Mon, 26 Nov 2012 15:09:24 +0100
Stefan Hinz <stefan.hinz@oracle.com> wrote:

Does anyone have experience using &#8203; -- the Unicode "zero-width
space" character (see

Yes. :)

I presume the idea is to have a character that has no visible effect
within a keyword, but allows it to be split across lines anyway.

Personally, I don't like invisible things like this that could get in
the way of grepping through the source.

Any other pros and cons? Maybe other/better ways to work around the

I had the same concerns with grepping through the sources.

For URLs, the solution is very easy. Use the following two parameters:

* $ulink.hyphenate
   Set it to the ZERO WIDTH SPACE character (&#x200B; or &#8203;). By
   default, it is empty.

* $ulink.hyphenate.chars
   Defines which characters are considered to contain the ZWS after
   that character. By default, it's "/", but you could extend it with
   other characters like "_", "-", "&", ...

These two parameters are used in the "hyphenate-url" template. This
template goes through the string and checks each character, if it's in
the set of $ulink.hyphenate.chars. You could use this template as a
base for your <option> template.

Any experience with performance impacts? I'm asking because we have quite a few options that would get parsed:

~/svn/mysqldoc> grep -R "<option" | wc -l

You can find an example of my modification of hyphenate-url in the daps
repository. I needed a finer control which characters should contain the
ZWS before or after that character. You can find the code here:


Hope this helps. :)

Sure, thanks again!


Stefan Hinz <stefan.hinz@oracle.com>, MySQL Documentation Manager

Phone: +49-30-82702940, Fax: +49-30-82702941, http://dev.mysql.com/doc

ORACLE Deutschland B.V.&  Co. KG
Registered Office: Riesstr. 25, 80992 Muenchen, Germany
Commercial Register: Local Court Of Munich, HRA 95603
Managing Director: Jürgen Kunz

General Partner: ORACLE Deutschland Verwaltung B.V.
Hertogswetering 163/167, 3543 AS Utrecht, Niederlande
Register Of Chamber Of Commerce: Midden-Niederlande, No. 30143697
Managing Directors: Alexander van der Ven, Astrid Kepper, Val Maher

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]