How to deal with definition lists?

Jump to: navigation, search
Revision as of 9 July 2015 at 07:53.
The highlighted comment was created in this revision.

Hi, I have been using definition lists for listing off functionality in menus.

Definition lists, as you may know, kinda look like this:

Definition
Description

in wiki terms that's this:

;Definition :Description

And then mediawiki generates the html definition list, as officially described(http://www.w3schools.com/tags/tag_dl.asp):

<dl> <dt>definition</dt> <dd>description</dd> </dl>

Now, apparently, and this is not uncommon with html, people have abused ':' for indenting. Which is why I am supposed to remove them. Which in turn screws up the definition lists, and that makes for wonky html, which is sad.

If indenting is the problem, is there a way I can convince you to just remove the indent-styling from <dd> marked paragraphs? Or at the least give an official typography entry for handling definition lists?

    13:32, 5 July 2015

    I am not quite sure what you are referring to here: Off the top of my head I would think, that making description lists the way you describe is perfectly ok. Mind you, we do have a lot of detailed "rules" that have evolved over time, mostly to ensure that the the pages can be translated properly.

    Could you provide a link to the page you are working on - it is often easier to comment on formatting problems in the actual context.

      10:52, 6 July 2015

      I use it all over the Krita manual, but here's a good example: https://userbase.kde.org/Krita/Manual/ColorManagement

      This is the page that tells me not to use them: https://userbase.kde.org/Edit_Markup , it's the last bullit point of 'correcting old markup'.

        17:41, 8 July 2015

        I had completely forgotten about that particuar issue. I don't think this was ever meant to refer to definition lists - only to colons used on their own; or maybe it was solved with the neverland theme that we use now.

        I had a look at your page. I looks fine in my browsers, so there is no reason not to continue using this markup. I'll try to find a better formulation on the Edit_Markup page to clarify (or maybe just remove the offending bullet). Thanks for pointing this out.

          07:53, 9 July 2015