[kde-doc-english] <gui...> markup in title elements

Burkhard Lück lueck at hube-lueck.de
Tue May 7 20:31:34 UTC 2013


Am Dienstag, 7. Mai 2013, 19:08:47 schrieb Albert Astals Cid:
> El Dilluns, 6 de maig de 2013, a les 21:27:46, Burkhard Lück va escriure:
> > Am Montag, 6. Mai 2013, 20:05:34 schrieb Albert Astals Cid:
> > > El Dilluns, 6 de maig de 2013, a les 20:43:27, Yuri Chornoivan va
> 
> escriure:
> > > > написане Mon, 06 May 2013 19:43:37 +0300, Burkhard Lück
> > > > 
> > > > <lueck at hube-lueck.de>:
> > > > > Hi,
> > > > > 
> > > > > the kde docbooks often have <gui...> markup in title elements of a
> > > > > section.
> > > > > 
> > > > > This lead to the following issues, illustrated with the KMahJongg
> > > > > handbook:
> > > > > 
> > > > > 1) First page - Table of Content
> > > > > Some word with a grey background due to <gui...> markup in a title.
> > > > > For me it looks strange and confusing (why some words and some not?)
> > > > > and
> > > > > to
> > > > > mark some words as gui element does not make sense in the table of
> > > > > content
> > > > > 
> > > > > 2) E. g. the Page "The Move Menu"
> > > > > In the page header "Move" has a grey background due to <gui...>
> > > > > markup
> > > > > in the
> > > > > title element of an sect1. That looks really ugly.
> > > > > 
> > > > > Title elements of a section already have a different font than the
> > > > > normal text,
> > > > > so you can distinguish title + text easily.
> > > > > 
> > > > > I'd like to get rid of the gui markup in title elements, what do you
> > > > > think?
> > > > 
> > > > Hi,
> > > > 
> > > > I completely agree that guimenu and guilabel make titles look ugly and
> > > > should be avoided/removed.
> > > 
> > > Maybe we should "just" improve the CSS?
> > > 
> > > I mean does guimenu/guilabel make sense from the content point of view
> > > and
> > > is looks the only problem?
> > 
> > I am not sure if it realy make sense to have a gui... markup in a title
> > from a content point of view, the ugly/strange look was only the reason
> > to think about gui in title elements.
> 
> Ah, so it's inside the title?

Exactly that's my point, gui markup inside title markup

> Then probably doesn't make much sense, no?
> 
Right.

> Do we have any docbook "teoricist" in the list?

-- 
Burkhard Lück



More information about the kde-doc-english mailing list