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

Albert Astals Cid aacid at kde.org
Tue May 7 17:08:47 UTC 2013


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? Then probably doesn't make much sense, no?

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

Cheers,
  Albert



More information about the kde-doc-english mailing list