After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 330371 - blockquote element not displayed properly
blockquote element not displayed properly
Status: RESOLVED NOTABUG
Product: yelp
Classification: Applications
Component: DocBook
2.12.x
Other Linux
: Normal normal
: ---
Assigned To: Yelp maintainers
Yelp maintainers
Depends on:
Blocks:
 
 
Reported: 2006-02-08 09:30 UTC by Joachim Noreiko
Modified: 2006-02-17 13:11 UTC
See Also:
GNOME target: ---
GNOME version: ---


Attachments
Test case based on the app template. (6.44 KB, application/xml)
2006-02-08 09:31 UTC, Joachim Noreiko
Details

Description Joachim Noreiko 2006-02-08 09:30:31 UTC
Test file attached. The text of the link element inside the blockquote is shown, but nothing else.
Comment 1 Joachim Noreiko 2006-02-08 09:31:17 UTC
Created attachment 58908 [details]
Test case based on the app template.
Comment 2 Don Scorgie 2006-02-08 13:40:03 UTC
Try adding <para> tags in the blockquotes:

<blockquote><para>An example of a <link linkend="docbook-extip">tip</link> was given.</para></blockquote>

Not sure whether this is actually a bug or whether its a docbook thing ;) - can someone clarify?
Comment 3 Joachim Noreiko 2006-02-08 15:50:49 UTC
Perhaps I'm trying to use blockquote in a place it shouldn't be used.

The context of this problem is the file gnome-docu/gdp/gdp-handbook/docbook.xml
In the section 'Links and References', there are examples of DocBook markup and the text they produce.
The example markup is a programlisting element, within the para.
The example result was inline text, which I sought to separate from the body text.

blockquote is perhaps wrong for this, but screen produces a box with horizontal scroll, and computeroutput doesn't do anything at all.
Comment 4 Shaun McCance 2006-02-08 19:26:15 UTC
If you're showing block-level examples of DocBook markup, you should be using programlisting.  The name "programlisting" is unfortunate, seemingly indicating that it's only useful for "programs".  And hey, maybe that's how some DocBook consumers treat it.  But my stance is that you should use programlisting for any block of text following some syntax.

So the blockquote thing isn't actually a bug, now that I've double-checked.  The blockquote element is supposed to hold other block-level stuff.  Typically, you'll just put a para element inside it.  What's causing the behavior you see is a line like this:

select="*[name(.) != 'title' and name(.) != 'attribution']"

That won't select text nodes.  And to be fair, text nodes shouldn't be there.  But I do have a general stance of being lenient in the stylesheets, so we could easily change this to

select="node()[name(.) != 'title' and name(.) != 'attribution']"

That will select text nodes.
Comment 5 Joachim Noreiko 2006-02-09 18:40:58 UTC
(In reply to comment #4)
> If you're showing block-level examples of DocBook markup, you should be using
> programlisting.  The name "programlisting" is unfortunate, seemingly indicating
> that it's only useful for "programs".  And hey, maybe that's how some DocBook
> consumers treat it.  But my stance is that you should use programlisting for
> any block of text following some syntax.

The bit in question is output rather than input, so it's not actually following syntax. It's just display text, what you might see on the screen. It's also not wrapping, which makes it scroll horizontally and looks odd. There's 'computeroutput' in DocBook, but yelp does nothing with it. And that would probably not wrap either.

But I'm going off-topic a bit here, and I agree that the original report is not a bug.
Comment 6 Don Scorgie 2006-02-17 13:11:50 UTC
Colsing as NOTABUG then.