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

List:       fedora-docs-list
Subject:    Re: Semantic Tagging in AsciiDoc
From:       sumedh deshpande <sumedhdeshpande123 () gmail ! com>
Date:       2016-09-08 1:29:27
Message-ID: CA+H3q6WJpHdQUn8pO9v4rpPHgK3JrAYA8qXaAK7naqNw60bs5A () mail ! gmail ! com
[Download RAW message or body]

[Attachment #2 (multipart/alternative)]


I don't know about XML doctype & what I have to do right now . please
explain it in simple way and my work at all

On Sep 8, 2016 1:38 AM, "Brian Exelbierd" <bex@pobox.com> 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
>
> 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

[Attachment #5 (text/html)]

<p dir="ltr">I don&#39;t know about XML doctype &amp; what I have to do right now . \
please explain it in simple way and my work at all<br> </p>
<div class="gmail_extra"><br><div class="gmail_quote">On Sep 8, 2016 1:38 AM, \
&quot;Brian Exelbierd&quot; &lt;<a href="mailto:bex@pobox.com">bex@pobox.com</a>&gt; \
wrote:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 \
.8ex;border-left:1px #ccc solid;padding-left:1ex">Hi All,<br> <br>
A chance conversation today led me to thinking about semantic markup and<br>
AsciiDoc.   AsciiDoc is easier to write because it has fewer tags.   It is<br>
also easier because it has fewer keystrokes.   However, it doesn&#39;t offer<br>
a lot of options for marking up elements to:<br>
<br>
* ensure consistency of localization by passing element information to<br>
the localizer<br>
* ensure consistency of formatting by ensuring all of the same elements,<br>
for example command names, are marked up the same way<br>
* allow for future automated testing with a project like `emender`<br>
<br>
I went through the Installation Guide and found 97 DocBook XML tags.<br>
I&#39;ve put them in the table on this wiki page:<br>
<br>
<a href="https://fedoraproject.org/wiki/Docs_Tag_Discussion" rel="noreferrer" \
target="_blank">https://fedoraproject.org/<wbr>wiki/Docs_Tag_Discussion</a><br> <br>
Please visit the page and edit it to weigh in on preferences about the<br>
tags.<br>
<br>
I believe this will help us complete our AsciiDoc style guide and do the<br>
conversions more rapidly and effectively.<br>
<br>
Today, if you want to discuss implementation of these tags in AsciiDoc,<br>
please start a separate email thread.<br>
<br>
Thank you.<br>
<br>
regards,<br>
<br>
bex<br>
--<br>
docs mailing list<br>
<a href="mailto:docs@lists.fedoraproject.org">docs@lists.fedoraproject.org</a><br>
To unsubscribe:<br>
<a href="https://lists.fedoraproject.org/admin/lists/docs@lists.fedoraproject.org" \
rel="noreferrer" target="_blank">https://lists.fedoraproject.<wbr>org/admin/lists/docs@lists.<wbr>fedoraproject.org</a></blockquote></div></div>



[Attachment #6 (text/plain)]

--
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]