Add "Body Markup Hints" ProtoXEP to inbox

This commit is contained in:
Florian Schmaus 2017-10-13 23:33:38 +02:00
parent 746cbc7f38
commit a19ea0591b
1 changed files with 165 additions and 0 deletions

inbox/bmh.xml Normal file
View File

@ -0,0 +1,165 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE xep SYSTEM 'xep.dtd' [
<!ENTITY % ents SYSTEM 'xep.ent'>
<?xml-stylesheet type='text/xsl' href='xep.xsl'?>
<title>Body Markup Hints</title>
<abstract>This document specifies hints about the markup language used in &BODY; elements.</abstract>
<type>Standards Track</type>
<spec>XMPP Core</spec>
<remark><p>First draft.</p></remark>
<section1 topic='Introduction' anchor='intro'>
<p>This document specifies hints about the markup language used in &BODY; elements found in
&MESSAGE; stanzas. It also specifies a mechanism to discover support of various markup
<section1 topic="Markup Languages" anchor='languages'>
<p>This list is not comprehensive and not meant to be.</p>
<table caption="Defined Markup Languages">
<th>Language Identifier</th>
<th>Specification Link</th>
<td><link url=''></link></td>
<td><link url=''></link></td>
<p>TODO: Shall we define your own subset of e.g. CommonMark, XMPPMark? :)</p>
<section1 topic='Exchanging messages with markup formatted bodies' anchor='exchanging'>
<p>If the &BODY; element contains text which is "formatted" with a markup language, then the
sending client MAY adds a &lt;body-markup-hint/&gt; element qualified by the ''
namespace with the 'language' attribute set to the Language Identifier of the used markup
<example caption='A message stanza with a body markup hint'><![CDATA[
<message from='' to=''>
1. Ingredients
- spaghetti
- marinara sauce
- salt
2. Cooking
Bring water to boil, add a pinch of salt and spaghetti. Cook until pasta is **tender**.
3. Serve
Drain the pasta on a plate. Add heated sauce.
> No man is lonely eating spaghetti; it requires so much attention.
*Bon appetit!*
<body-markup-hint xmlns=''
<section1 topic='Discovering Support' anchor='discovery'>
<p>It is RECOMMENDED that entities announce the supported body markup languages in its service
discovery information as specified in &xep0030;. Every markup language is announced as a
&lt;feature/&gt; element with the 'var' attribute set to the language identifier of the supported
<example caption='A service discovery information with the supported body markup languages'><![CDATA[
<iq from=''
<query xmlns=''>
<feature var='urn:xmpp:bmh:commonmark:0'/>
<section1 topic='Business Rules' anchor='rules'>
<p>There MUST be only one &lt;body-markup-hint/&gt; per &MESSAGE; stanza, and it applies to all
&BODY; elements within the same stanza.</p>
<section1 topic='Security Considerations' anchor='security'>
<p>TODO: Discuss.</p>
<section1 topic='IANA Considerations' anchor='iana'>
<p>This document requires no interaction with &IANA;.</p>
<section1 topic='XMPP Registrar Considerations' anchor='registrar'>
<p>TODO: Is it sensible to establish a registry for this?</p>
<section1 topic='XML Schema' anchor='schema'>
<p>TODO: Add after the XEP leaves the 'experimental' state.</p>
<section1 topic='Acknowledgements' anchor='acknowledgements'>
<p>Thanks to everyone who provided feedback.</p>
<!-- Local Variables: -->
<!-- fill-column: 100 -->
<!-- indent-tabs-mode: nil -->
<!-- End: -->