Shorewall devel - Dec 2003 - White space being removed from "Programlisting" elements

Good Morning Mike,

I''m finding that when I load a document, XXE is blindly removing all 
"superfluous" white space from "programlisting" elements.
This of course is
leading to a real mess (check out the FAQ on the web site :-( ).

What can I do to avoid this?

-Tom
-- 
Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://shorewall.net
Washington USA  \ teastep@shorewall.net

On Sun, 2003-12-14 at 09:43, Tom Eastep wrote:
> Good Morning Mike,
> 
> I''m finding that when I load a document, XXE is blindly removing
all
> "superfluous" white space from "programlisting"
elements. This of course is
> leading to a real mess (check out the FAQ on the web site :-( ).
> 
> What can I do to avoid this?
Tom,
It looks like someone tried <literallayout>. That doesn''t respect
white
space. I''ll fix the FAQ later today.

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On 14 Dec 2003, Mike Noyes wrote:
> On Sun, 2003-12-14 at 09:43, Tom Eastep wrote:
> > Good Morning Mike,
> > 
> > I''m finding that when I load a document, XXE is blindly
removing all
> > "superfluous" white space from "programlisting"
elements. This of course is
> > leading to a real mess (check out the FAQ on the web site :-( ).
> > 
> > What can I do to avoid this?
> 
> Tom,
> It looks like someone tried <literallayout>. That doesn''t
respect white
> space. I''ll fix the FAQ later today.
> 
Never mind -- the problem is in my Mandrake XXE/XML setup somewhere -- 
I''ve been able to correct the problem using XXE on my laptop.

-Tom
-- 
Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://shorewall.net
Washington USA  \ teastep@shorewall.net

On Sun, 2003-12-14 at 10:24, Tom Eastep wrote:
> On 14 Dec 2003, Mike Noyes wrote:
> > It looks like someone tried <literallayout>. That
doesn''t respect white
> > space. I''ll fix the FAQ later today.
> > 
> 
> Never mind -- the problem is in my Mandrake XXE/XML setup somewhere -- 
> I''ve been able to correct the problem using XXE on my laptop.
Tom,
You just barely beat me. I almost had it corrected also. :-)

Can you reproduce the bug on Mandrake? If so, you may want to post
something in the XMLMind XXE forum about the problem. That''s not a nice
bug. :-(

Anyway, time for some football. :-)

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On 14 Dec 2003, Mike Noyes wrote:
> 
> Can you reproduce the bug on Mandrake? If so, you may want to post
> something in the XMLMind XXE forum about the problem. That''s not a
nice
> bug. :-(
I''ll have to restore the default Mandrake setup and see if
it''s
reproducable; I suspect local admin error :-\
 
> Anyway, time for some football. :-)
I just tuned in the Hawks/Rams game in time to see the Hawks go behind :-| 

-Tom
-- 
Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://shorewall.net
Washington USA  \ teastep@shorewall.net

On Sun, 2003-12-14 at 10:41, Mike Noyes wrote:
> Can you reproduce the bug on Mandrake? If so, you may want to post
> something in the XMLMind XXE forum about the problem. That''s not a
nice
> bug. :-(
Tom,
XXE has a page concerning <programlisting> here:

http://www.xmlmind.com/xmleditor/_distrib/docs/user/userguide5.html

It looks like they messed with the DocBook DTD. :-(

Note: I''m using standard version 2.3. The difference in our versions
may
have caused the problem. I''ll update ASAP.

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

Mike,

This explains the problem -- On my Mandrake box, I''m using the DTD
distributed with Mandrake (with the mod to allow ''target'' on
''ulink'').

I''ll correct here...

-Tom
PS -- please excuse the top post; using OE while watching the Hawks get
creamed...

Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://www.shorewall.net
Washington USA  \ teastep@shorewall.net

----- Original Message ----- 
From: "Mike Noyes" <mhnoyes@users.sourceforge.net>
To: <shorewall-devel@lists.shorewall.net>
Sent: Sunday, December 14, 2003 10:49 AM
Subject: Re: [Shorewall-devel] Re: White space being removedfrom
"Programlisting" elements

> On Sun, 2003-12-14 at 10:41, Mike Noyes wrote:
> > Can you reproduce the bug on Mandrake? If so, you may want to post
> > something in the XMLMind XXE forum about the problem. That''s
not a nice
> > bug. :-(
>
> Tom,
> XXE has a page concerning <programlisting> here:
>
> http://www.xmlmind.com/xmleditor/_distrib/docs/user/userguide5.html
>
> It looks like they messed with the DocBook DTD. :-(
>
> Note: I''m using standard version 2.3. The difference in our
versions may
> have caused the problem. I''ll update ASAP.
>
> -- 
> Mike Noyes <mhnoyes at users.sourceforge.net>
> http://sourceforge.net/users/mhnoyes/
> SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs
>
> _______________________________________________
> Shorewall-devel mailing list
> Shorewall-devel@lists.shorewall.net
> https://lists.shorewall.net/mailman/listinfo/shorewall-devel
>

On Sun, 2003-12-14 at 10:49, Mike Noyes wrote:
> XXE has a page concerning <programlisting> here:
> 
> http://www.xmlmind.com/xmleditor/_distrib/docs/user/userguide5.html
> 
> It looks like they messed with the DocBook DTD. :-(
> 
> Note: I''m using standard version 2.3. The difference in our
versions may
> have caused the problem. I''ll update ASAP.
Tom,
This FAQ should help you fix the problem.

http://www.xmlmind.com/xmleditor/user_faq.html#docbookpreservespace
    Q:  If I insert a programlisting element in a DocBook document and
    type a few lines of text in it, saving the document and re-opening
    it removes all newline characters from the programlisting element
    (which after that, contains a single, very long, line of text). Is
    there a workaround for this problem?

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On Sunday 14 December 2003 10:52 am, Tom Eastep wrote:
> Mike,
>
> This explains the problem -- On my Mandrake box, I''m using the DTD
> distributed with Mandrake (with the mod to allow ''target''
on ''ulink'').
>
> I''ll correct here...
>
> 
I''ve restored my V2.5 XXE config and XXE on Mandrake is now working
properly.

I have modified the XXE V4.2 dbpoolx.mod file with the attached patch (V4.1.2 
is modified similarly). These files are in .../xxe/config/docbook/dtd/Vx.x
This patch provides a pulldown for the ''ulink.target''
attribute. This is
important since FTP links in frames need target="_top" to work
correctly with
Internet Explorer.

-Tom
-- 
Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://shorewall.net
Washington USA  \ teastep@shorewall.net

-------------- next part --------------
A non-text attachment was scrubbed...
Name: dbpoolx.patch
Type: text/x-diff
Size: 309 bytes
Desc: not available
Url :
http://lists.shorewall.net/pipermail/shorewall-devel/attachments/20031214/f00d9049/dbpoolx.bin

On Sun, 2003-12-14 at 11:05, Tom Eastep wrote:
> I''ve restored my V2.5 XXE config and XXE on Mandrake is now
working properly.
> 
> I have modified the XXE V4.2 dbpoolx.mod file with the attached patch
(V4.1.2
> is modified similarly). These files are in .../xxe/config/docbook/dtd/Vx.x
> This patch provides a pulldown for the ''ulink.target''
attribute. This is
> important since FTP links in frames need target="_top" to work
correctly with
> Internet Explorer.
Tom,
Great. Another IE "feature" from MS. ~:-(

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On Sun, 2003-12-14 at 11:05, Tom Eastep wrote:
> I have modified the XXE V4.2 dbpoolx.mod file with the attached patch
(V4.1.2
> is modified similarly). These files are in .../xxe/config/docbook/dtd/Vx.x
> This patch provides a pulldown for the ''ulink.target''
attribute. This is
> important since FTP links in frames need target="_top" to work
correctly with
> Internet Explorer.
Tom,
I thought target="_top" is the default for XSLT to HTML?

DocBook XSL Stylesheet Reference Documentation
HTML Parameter Reference
http://docbook.sourceforge.net/release/xsl/current/doc/html/ulink.target.html

Other types of links:  link, olink, and xref.
http://www.docbook.org/tdg/en/html/docbook.html

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On 14 Dec 2003, Mike Noyes wrote:
> On Sun, 2003-12-14 at 11:05, Tom Eastep wrote:
> > I have modified the XXE V4.2 dbpoolx.mod file with the attached patch
(V4.1.2
> > is modified similarly). These files are in
.../xxe/config/docbook/dtd/Vx.x
> > This patch provides a pulldown for the
''ulink.target'' attribute. This is
> > important since FTP links in frames need target="_top" to
work correctly with
> > Internet Explorer.
>
> I thought target="_top" is the default for XSLT to HTML?
> 
Given that the Shorewall website uses Frames, target="_top" is an 
inappropriate default. I''m therefore using a custom params file to make
the default target="_self".

The alternative is to modify the DTD again to apply that default there -- 
either way:

a) Most links must be specified (or default to) _self.
b) We need a non-standard DTD (and possibly a Stylesheet with custom 
params).

-Tom
-- 
Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://shorewall.net
Washington USA  \ teastep@shorewall.net

On Sun, 2003-12-14 at 12:33, Tom Eastep wrote:
> On 14 Dec 2003, Mike Noyes wrote:
> > I thought target="_top" is the default for XSLT to HTML?
> 
> Given that the Shorewall website uses Frames, target="_top" is an
> inappropriate default. I''m therefore using a custom params file to
make
> the default target="_self".
Tom,
I think I see. You want the linked page to open within your frame.

Example:
    <!-- The Shorewall documentation is inside a frameset and we want to
    keep the frameset even when the use clicks a link "outside" the
    documentation.  -->
    
    <xsl:param name="ulink.target">_self</xsl:param>

> The alternative is to modify the DTD again to apply that default there -- 
> either way:
Modifying the XSL is the proper way to make a change. I''d like to avoid
DTD changes if possible.

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On Sun, 2003-12-14 at 11:05, Tom Eastep wrote:
> On Sunday 14 December 2003 10:52 am, Tom Eastep wrote:
> I have modified the XXE V4.2 dbpoolx.mod file with the attached patch
(V4.1.2
> is modified similarly). These files are in .../xxe/config/docbook/dtd/Vx.x
> This patch provides a pulldown for the ''ulink.target''
attribute. This is
> important since FTP links in frames need target="_top" to work
correctly with
> Internet Explorer.
Tom,
This is what I feared. The DTD modification is causing validation
errors. :-(

$ xmllint --valid --noout shorewall_prerequisites.xml 
shorewall_prerequisites.xml:50: validity error: No declaration for
attribute target on element ulink
       
url="ftp://ftp.inr.ac.ru/ip-routing">ftp://ftp.inr.ac.ru/ip-routing</ul
                                            ^

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On Monday 15 December 2003 10:58 am, you wrote:
> On Sun, 2003-12-14 at 11:05, Tom Eastep wrote:
> > On Sunday 14 December 2003 10:52 am, Tom Eastep wrote:
> > I have modified the XXE V4.2 dbpoolx.mod file with the attached patch
> > (V4.1.2 is modified similarly). These files are in
> > .../xxe/config/docbook/dtd/Vx.x This patch provides a pulldown for the
> > ''ulink.target'' attribute. This is important since
FTP links in frames
> > need target="_top" to work correctly with Internet Explorer.
>
> Tom,
> This is what I feared. The DTD modification is causing validation
> errors. :-(
>
> $ xmllint --valid --noout shorewall_prerequisites.xml
> shorewall_prerequisites.xml:50: validity error: No declaration for
> attribute target on element ulink
>
>
url="ftp://ftp.inr.ac.ru/ip-routing">ftp://ftp.inr.ac.ru/ip-routing</ul
>                                             ^
Yep -- OTOH, I''ve already done shorewall_prerequisites.xml, quotes.xml,
and
Shorewall_Doesnt.xml; you may want to "cvs update"...

I may have to hack up an awk script to post-process our HTML to get ftp links 
to work properly :=(

-Tom
-- 
Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://shorewall.net
Washington USA  \ teastep@shorewall.net

On Mon, 2003-12-15 at 11:07, Tom Eastep wrote:
> On Monday 15 December 2003 10:58 am, you wrote:
> > This is what I feared. The DTD modification is causing validation
> > errors. :-(
> >
> > $ xmllint --valid --noout shorewall_prerequisites.xml
> > shorewall_prerequisites.xml:50: validity error: No declaration for
> > attribute target on element ulink
> >
> >
url="ftp://ftp.inr.ac.ru/ip-routing">ftp://ftp.inr.ac.ru/ip-routing</ul
> >                                             ^
> 
> Yep -- OTOH, I''ve already done shorewall_prerequisites.xml,
quotes.xml, and
> Shorewall_Doesnt.xml; you may want to "cvs update"...
Tom,
I do a cvs up -dP before every commit, and once at the start of every
work session. I noted your updates.

I corrected your xxe template use of sect1 tags. Recursive section tags
are the preferred method, as numbered tags cause problems.

    Did you get my post on this topic?
    
    Date: 15 Dec 2003 08:36:30 -0800
    Message-Id: <1071506333.28702.104.camel@galileo.carola.lan>
> I may have to hack up an awk script to post-process our HTML to get ftp
links
> to work properly :=(
I''ll look into this problem. There must be a way to address it.

External links should be _top.
Local links should be _self.

Another option is moving away from the Extensible HTML version 1.0
Frameset DTD.

http://www.w3.org/TR/xhtml1/dtds.html#a_dtd_XHTML-1.0-Frameset
    PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN"
    SYSTEM "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd"

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On Mon, 2003-12-15 at 11:23, Mike Noyes wrote:
> External links should be _top.
> Local links should be _self.
Tom,
I think we can use the DTD ulink "type" attribute for customizing the
target through stylesheets.

Re: Chunked documents inside frames
http://sources.redhat.com/ml/docbook-apps/2002-q1/msg00665.html

Chapter 10. HTML customizations: HTML frameset
http://www.sagehill.net/docbookxsl/HtmlFrames.html

Note: It appears that <a> attribute target was removed in XHTML Strict.
I wonder what they''re using to replace it.

http://www.sagehill.net/docbookxsl/OtherOutputForms.html#StrictXhtmlValid
Chapter 21. Other output forms: Strict XHTML guidelines
    Set parameter ulink.target to null because the target attribute is
    not permitted on a anchor elements.

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On Monday 15 December 2003 11:23 am, Mike Noyes wrote:
>
> Tom,
> I do a cvs up -dP before every commit, and once at the start of every
> work session. I noted your updates.
>
> I corrected your xxe template use of sect1 tags. Recursive section tags
> are the preferred method, as numbered tags cause problems.
>
>     Did you get my post on this topic?
>
>     Date: 15 Dec 2003 08:36:30 -0800
>     Message-Id: <1071506333.28702.104.camel@galileo.carola.lan>
Don''t see it...
>
> > I may have to hack up an awk script to post-process our HTML to get
ftp
> > links to work properly :=(
>
> I''ll look into this problem. There must be a way to address it.
>
> External links should be _top.
> Local links should be _self.
>
That''s not the way that the site works currently but it''s
better than getting
a dozen messages a day from people who can''t access FTP links.

-Tom
-- 
Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://shorewall.net
Washington USA  \ teastep@shorewall.net

On Mon, 2003-12-15 at 11:49, Tom Eastep wrote:
> On Monday 15 December 2003 11:23 am, Mike Noyes wrote:
> >     Did you get my post on this topic?
> >
> >     Date: 15 Dec 2003 08:36:30 -0800
> >     Message-Id: <1071506333.28702.104.camel@galileo.carola.lan>
> 
> Don''t see it...
Tom,
Resent off-list.

> > > I may have to hack up an awk script to post-process our HTML to
get ftp
> > > links to work properly :=(
> >
> > I''ll look into this problem. There must be a way to address
it.
> >
> > External links should be _top.
> > Local links should be _self.
> >
> 
> That''s not the way that the site works currently but it''s
better than getting
> a dozen messages a day from people who can''t access FTP links.
Oh. I thought you were loading all external links with target="_top".
I
see that''s only the case in certain instances like:

http://shorewall.net/shorewall_prerequisites.htm
    ftp://ftp.inr.ac.ru/ip-routing  <-- target="_top"

We should be able to use the ulink "type" attribute to customize the
output. I suggest "local" and "remote", or
"frameset" and "standard" for
the type settings.

See: Cross-linking in the GNOME 1.4 Help System
http://developer.gnome.org/projects/gdp/changes/crosslinks.html

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On Monday 15 December 2003 12:13 pm, Mike Noyes wrote:
>
> Oh. I thought you were loading all external links with
target="_top". I
> see that''s only the case in certain instances like:
>
> http://shorewall.net/shorewall_prerequisites.htm
>     ftp://ftp.inr.ac.ru/ip-routing  <-- target="_top"
Yes -- I use "_top" for:

a) Links to mirrors (to avoid the "endless mirror" effect).
b) Links to FTP sites (IE problem with FTP in a frame).
>
> We should be able to use the ulink "type" attribute to customize
the
> output. I suggest "local" and "remote", or
"frameset" and "standard" for
> the type settings.
>
> See: Cross-linking in the GNOME 1.4 Help System
> http://developer.gnome.org/projects/gdp/changes/crosslinks.html
This looks fine -- "local" and "remote" are Ok with me.

I assume that you can hack up a change to the stylesheet faster than I can....

-Tom
-- 
Tom Eastep    \ Nothing is foolproof to a sufficiently talented fool
Shoreline,     \ http://shorewall.net
Washington USA  \ teastep@shorewall.net

On Mon, 2003-12-15 at 12:14, Tom Eastep wrote:
> On Monday 15 December 2003 12:13 pm, Mike Noyes wrote:
> > We should be able to use the ulink "type" attribute to
customize the
> > output. I suggest "local" and "remote", or
"frameset" and "standard" for
> > the type settings.
> >
> > See: Cross-linking in the GNOME 1.4 Help System
> > http://developer.gnome.org/projects/gdp/changes/crosslinks.html
> 
> This looks fine -- "local" and "remote" are Ok with me.
> 
> I assume that you can hack up a change to the stylesheet faster than I
can....
Tom,
It''s probably closer than you think. I''m still learning XSL.
:-(

I''ll start working on the problem.

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On Mon, 2003-12-15 at 12:33, Mike Noyes wrote:
> I''ll start working on the problem.
Tom,
I think I''ve located the section that needs modification.

docbook/xsl-x.xx.x/xhtml/xref.xsl

<xsl:template match="ulink" name="ulink">
  <xsl:variable name="link">
    <a xmlns="http://www.w3.org/1999/xhtml">
<snip>
    </xsl:otherwise>
  </xsl:choose>
</xsl:template>

Now the hard part. Figuring out how to make the change.

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs

On Sun, 2003-12-14 at 11:05, Tom Eastep wrote:
> I have modified the XXE V4.2 dbpoolx.mod file with the attached patch
(V4.1.2
> is modified similarly). These files are in .../xxe/config/docbook/dtd/Vx.x
> This patch provides a pulldown for the ''ulink.target''
attribute. This is
> important since FTP links in frames need target="_top" to work
correctly with
> Internet Explorer.
Tom,
I just upgraded to XXE 2.5, and remembered another customization you may
want to make.

In xxe-std-25/config/docbook/template change all the <sec1> tags to
<section>, and the <refsec1> tags to <refsection>.

-- 
Mike Noyes <mhnoyes at users.sourceforge.net>
http://sourceforge.net/users/mhnoyes/
SF.net Projects: ffl, leaf, phpwebsite, phpwebsite-comm, sitedocs