[prev in list] [next in list] [prev in thread] [next in thread] 

List:       fedora-docs-list
Subject:    Re: Semantic Tagging in AsciiDoc
From:       Shaun McCance <shaunm () gnome ! org>
Date:       2016-09-09 15:40:06
Message-ID: 1473435606.21811.145.camel () gnome ! org
[Download RAW message or body]

On Wed, 2016-09-07 at 22:08 +0200, Brian Exelbierd wrote:
> Hi All,
> 
> A chance conversation today led me to thinking about semantic markup
> and
> AsciiDoc.  AsciiDoc is easier to write because it has fewer tags.  It
> is
> also easier because it has fewer keystrokes.  However, it doesn't
> offer
> a lot of options for marking up elements to:
> 
> * ensure consistency of localization by passing element information
> to
> the localizer
> * ensure consistency of formatting by ensuring all of the same
> elements,
> for example command names, are marked up the same way
> * allow for future automated testing with a project like `emender`
> 
> I went through the Installation Guide and found 97 DocBook XML tags. 
> I've put them in the table on this wiki page:
> 
> https://fedoraproject.org/wiki/Docs_Tag_Discussion

A long, long time ago (2015!), I went through a similar process for
GNOME. For the curious, here's a couple blog posts, including a shell
script that will give you tag counts. (You'll need to change the path
where it looks for files.)

https://blogs.gnome.org/shaunm/2005/10/21/how-much-docbook/
https://blogs.gnome.org/shaunm/2005/10/22/how-much-docbook-internals/


> 
> Please visit the page and edit it to weigh in on preferences about
> the
> tags.
> 
> I believe this will help us complete our AsciiDoc style guide and do
> the
> conversions more rapidly and effectively.
> 
> Today, if you want to discuss implementation of these tags in
> AsciiDoc,
> please start a separate email thread.
> 
> Thank you.
> 
> regards,
> 
> bex
> --
> docs mailing list
> docs@lists.fedoraproject.org
> To unsubscribe:
> https://lists.fedoraproject.org/admin/lists/docs@lists.fedoraproject.
> org
--
docs mailing list
docs@lists.fedoraproject.org
To unsubscribe:
https://lists.fedoraproject.org/admin/lists/docs@lists.fedoraproject.org
[prev in list] [next in list] [prev in thread] [next in thread]