← Back to team overview

documentation-packages team mailing list archive

[Bug 1649554] Re: Default Mallard <list> element translated incorrectly

 

On 2016-12-14 14:18, Chris Perry wrote:
> The fix does seem to have exposed some problems. Eg the procedure 
> "Check with Disk Usage Analyzer" on disk-capacity.page was wrongly 
> marked up as a <list> and it's now lost its numbering, which is 
> incorrect.

Please note that this is another example of previous inconsistency. It
has been bullets when using yelp for a long time. (But I agree that
numbers is better in a step-by-step list.)

On 2016-12-14 17:15, Doug Smythies wrote:
> @Chris: Note that it might not always be a bug if the html display 
> differs from the Mallard specification. The whole purpose of the 
> ubuntu.xsl file is to provide overrides to the defaults, in addition
> to adding some functionality.

While that is true, I suppose it has never been the intention to use
different list style types in the HTML version compared to the yelp
version.

-- 
You received this bug notification because you are a member of
Documentation Packages, which is subscribed to ubuntu-docs in Ubuntu.
https://bugs.launchpad.net/bugs/1649554

Title:
  Default Mallard <list> element translated incorrectly

Status in ubuntu-docs package in Ubuntu:
  Fix Committed

Bug description:
  When "type" is not specified in a Mallard <list> element the Mallard
  spec says it should display as a bulleted (unordered) list. This is
  true when the .page file is displayed using yelp but not when the
  .page file is translated into HTML (where you get a numbered list).
  This is a bug. The HTML should be displayed as specified by the
  Mallard spec.

  Here's an example <list> element without "type" specified.

  <list>
    <item><p><code>GTK_MESSAGE_INFO</code></p></item>
    <item><p><code>GTK_MESSAGE_WARNING</code></p></item>
    <item><p><code>GTK_MESSAGE_QUESTION</code></p></item>
    <item><p><code>GTK_MESSAGE_ERROR</code></p></item>
    <item><p><code>GTK_MESSAGE_OTHER</code></p></item>
  </list>

  Here's the link to the relevant page of the Mallard spec:

  http://projectmallard.org/1.0/mal_block_list

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs/+bug/1649554/+subscriptions


References