From kde-doc-english  Mon Sep 08 06:14:22 2014
From: Luigi Toscano <luigi.toscano () tiscali ! it>
Date: Mon, 08 Sep 2014 06:14:22 +0000
To: kde-doc-english
Subject: Re: [kde-doc-english] checkXML vs meinproc4
Message-Id: <6a95383a-719d-41d5-adae-316ff9206414 () email ! android ! com>
X-MARC-Message: https://marc.info/?l=kde-doc-english&m=141015688030020

On 08 settembre 2014 04:28:36 CEST, "T.C. Hollingsworth" <tchollingsworth@gmail.com> wrote:
> On Sun, Sep 7, 2014 at 6:22 PM, Jack <ostroffjh@sbcglobal.net> wrote:
> > Thanks for pointing out where the lines actually come from. 
> However, I
> > think we now have several separate issues.
> >
> > 1) I would consider that type of outlined area an improvement over
> <hr> for
> > a true <screenshot> where it does make sense to set it the image off
> from
> > the text.  I would probably even leave that for most of the images
> in the
> > kmymoney manual.  Whether it is switched for all of kde or made an
> option -
> > could the choice end up being an attribute of the <screenshot> tag?
> >
> > 2) However, for many images, I consider that they fit within the
> flow of the
> > text, thus my attempt to use some type of inline tag - avoiding any
> boxes,
> > lines, or other set-offs.  However, I do understand it should be
> done in a
> > way that does not burden the translation process and teams.  Thus my
> > previous question about isolating the image tags in their own para
> with no
> > other text components.
> 
> What we could do is style <screenshot> and not style plain ol'
> <mediaobject>.  This way, you'd use
> <screenshot>...<mediaobject>...</mediaobject></screenshot> for the
> grey box and just <mediaobject>...</mediaobject> for no style.
> 
> In fact, semantically I think this makes a lot of sense.  It seems
> rather intuitive to use <informalfigure>, <screenshot>, et. al. when
> you want some styling around your image, and just to use a plain
> unwrapped <mediaobject> when you do not.  So I'd totally support this
> (and patch kdoctools accordingly) if others agree.

Thanks (and welcome back), it makes sense; could you please send a review against kdelibs (KDE/4.14, last branch)? We can then forward-port to kdoctools/kf5.


-- 
Luigi
_______________________________________________
kde-doc-english mailing list
kde-doc-english@kde.org
https://mail.kde.org/mailman/listinfo/kde-doc-english