<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body dir="auto"><div>How about some of the verbs used by libraries as a method on a class instance: "render" or "convert". Of course we want the nouns: "renderer" or "converter". They are very similar to "translator", but unlike translator are actually used by the existing implementations.</div><div><br>Waylan Limberg</div><div><br>On Sep 7, 2014, at 2:31 PM, Andrei Fangli <<a href="mailto:andrei_fangli@hotmail.com">andrei_fangli@hotmail.com</a>> wrote:<br><br></div><blockquote type="cite"><div>


<meta name="generator" content="Windows Mail 17.5.9600.20573">
<style><!--
.EmailQuote {
margin-left:1pt;
padding-left:4pt;
border-left:#800000 2px solid;
}
--></style><style data-externalstyle="true"><!--
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph {
margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.5in;
margin-bottom:.0001pt;
}
p.MsoNormal, li.MsoNormal, div.MsoNormal {
margin:0in;
margin-bottom:.0001pt;
}
p.MsoListParagraphCxSpFirst, li.MsoListParagraphCxSpFirst, div.MsoListParagraphCxSpFirst, 
p.MsoListParagraphCxSpMiddle, li.MsoListParagraphCxSpMiddle, div.MsoListParagraphCxSpMiddle, 
p.MsoListParagraphCxSpLast, li.MsoListParagraphCxSpLast, div.MsoListParagraphCxSpLast {
margin-top:0in;
margin-right:0in;
margin-bottom:0in;
margin-left:.5in;
margin-bottom:.0001pt;
line-height:115%;
}
--></style>

<div data-externalstyle="false" dir="ltr" style="font-family: 'Calibri', 'Segoe UI', 'Meiryo', 'Microsoft YaHei UI', 'Microsoft JhengHei UI', 'Malgun Gothic', 'sans-serif';font-size:12pt;">


<div style="color: rgb(0, 0, 0);">Sean wrote:</div><div style="color: rgb(0, 0, 0);">> I am trying to use uniform terms. An implementation that converts</div><div style="color: rgb(0, 0, 0);">Markdown content to another format--most typically HTML--is called...a</div><div style="color: rgb(0, 0, 0);">Markdown processor, right?<br></div><div style="color: rgb(0, 0, 0);"><br></div><div style="color: rgb(0, 0, 0);">I was focusing on naming the software that takes text in format A and outputs it in format B (yep, just that use case). The XML specifications define that a XML Processor is something that recognizes the structure of a XML Document, validates it and offers access to its content (e.g.: by tree traversal since XML is hierarchical in nature). A software that simply translates from format A to B only recognizes, validates the structure of the text in format A and outputs the content in format B. If we were to apply an analogous definition for a Markdown Processor then the access to content is lost because the initial document as a whole is outputted in format B without having the chance to peak at its content. In that case we cannot name that software a processor, it may use one internally to get the job done.</div><div style="color: rgb(0, 0, 0);"><br></div><div style="color: rgb(0, 0, 0);">In the case of a software that allows visualisation of Markdown documents prior to translation/export, eventually allowing editing, indexing, word count, page count etc., I agree, that no longer can be called a translator because it does much more. That software falls well in the terms of a word processor (specialized for Markdown in this case) as pointed out, however I’m not sure that’s what Sean was asking.</div><div style="color: rgb(0, 0, 0);"><br></div><div style="color: rgb(0, 0, 0);">This discussion is turning out quite interesting as parsers require a grammar in a formal language (e.g.: BNF) while a processor can be implemented from a description.</div><div style="color: rgb(0, 0, 0);"><br></div><div style="color: rgb(0, 0, 0);" data-signatureblock="true"><div style="color: rgb(0, 0, 0);">Andrei Fangli</div><div style="color: rgb(0, 0, 0);"><br></div></div><div style="padding-top: 5px; border-top-color: rgb(229, 229, 229); border-top-width: 1px; border-top-style: solid;"><div><font face=" 'Calibri', 'Segoe UI', 'Meiryo', 'Microsoft YaHei UI', 'Microsoft JhengHei UI', 'Malgun Gothic', 'sans-serif'" style="line-height: 15pt; letter-spacing: 0.02em; font-family: "Calibri", "Segoe UI", "Meiryo", "Microsoft YaHei UI", "Microsoft JhengHei UI", "Malgun Gothic", "sans-serif"; font-size: 12pt;"><b>From:</b> <a href="mailto:pagaltzis@gmx.de" target="_parent">Aristotle Pagaltzis</a><br><b>Sent:</b> ‎Sunday‎, ‎7‎ ‎September‎ ‎2014 ‎20‎:‎53<br><b>To:</b> <a href="mailto:markdown-discuss@six.pairlist.net" target="_parent">markdown-discuss@six.pairlist.net</a></font></div></div><div><br></div><div dir="">
<div class="PlainText">* Andrei Fangli <<a href="mailto:andrei_fangli@hotmail.com">andrei_fangli@hotmail.com</a>> [2014-09-07 10:45]:<br>
> When I hear Markdown processor I think of a specialized word/text<br>
> processor<br>
<br>
That is not what it generally mean in RFCs. The XML specs speak of an<br>
XML processor, the Atom RFCs speak of an Atom processor, etc. So I think<br>
the terminology here is correct for an RFC.<br>
<br>
(To me what you refer to is a “Markdown word processor”, esp considering<br>
that a word processor is called a *word* processor rather than, say, an<br>
RTF processor or a DOC processor.)<br>
<br>
I’ll also defend the term on grounds of its meaning later, but let me<br>
first address the proposed alternatives:<br>
<br>
> For me, Markdown implementation sounds a bit odd. Markdown is not<br>
> standardized nor is its specification clear enough<br>
<br>
Agree.<br>
<br>
> I’d simply name the specification (or flavour) and append “Translator”<br>
> at the end (e.g.: Github flavoured Markdown Translator, Common<br>
> Markdown Translator etc.).<br>
<br>
That is specific to a use case. E.g. multiple MacOS X QuickLook plugins<br>
for Markdown preview exist; these are not translators, all they can do<br>
is display the document (or a portion of it). Internally they may use<br>
a translator, as most probably do, but they may just as well be written<br>
on top of a Markdown parser that merely creates an AST rather than any<br>
kind of output; either way it’s an implementation detail.<br>
<br>
* Andrei Fangli <<a href="mailto:andrei_fangli@hotmail.com">andrei_fangli@hotmail.com</a>> [2014-09-07 17:00]:<br>
> Parsing is all about syntactic analysis, a parser may well just return<br>
> true and false depending on whether the input is syntactically correct<br>
> or not.<br>
<br>
Yes, agree: “parser” is not the right term.<br>
<br>
It’s also not the right term because a translator need not necessarily<br>
parse the document. Markdown.pl doesn’t. So actually, “Markdown parser”<br>
in fact excludes the canonical Markdown… processor.<br>
<br>
> I’m not very comfortable about calling them libraries if they are<br>
> actually executables or scripts.<br>
<br>
Agree here also.<br>
<br>
So…<br>
<br>
Ultimately, to come back to the beginning of my mail, what you want to<br>
express is “a piece of software that will take Markdown and do something<br>
with it in some Markdown-rules-informed way”. You want to cover any kind<br>
of doing something, be it translating to another format or displaying<br>
the document or extracting something from it (e.g. indexing or counting<br>
words or whatever) or anything else. You want to cover any form in which<br>
software comes, be that a library, an executable, or just an incidental<br>
part of some larger library or application. And you want to allow for it<br>
implementing any fraction of the total Markdown rules (e.g. a Markdown<br>
word counter could ignore most inline formatting as punctuation without<br>
it making a difference in the result), and in whichever form it chooses<br>
(it could use parsing, or not).<br>
<br>
I would argue that the only sufficiently generic term that will apply to<br>
software in all of these cases is, in fact, “processor”.<br>
<br>
Regards,<br>
-- <br>
Aristotle Pagaltzis // <<a href="http://plasmasturm.org/" target="_parent">http://plasmasturm.org/</a>><br>
_______________________________________________<br>
Markdown-Discuss mailing list<br>
<a href="mailto:Markdown-Discuss@six.pairlist.net">Markdown-Discuss@six.pairlist.net</a><br>
<a href="http://six.pairlist.net/mailman/listinfo/markdown-discuss" target="_parent">http://six.pairlist.net/mailman/listinfo/markdown-discuss</a><br>
</div>


</div>








</div>


</div></blockquote><blockquote type="cite"><div><span>_______________________________________________</span><br><span>Markdown-Discuss mailing list</span><br><span><a href="mailto:Markdown-Discuss@six.pairlist.net">Markdown-Discuss@six.pairlist.net</a></span><br><span><a href="http://six.pairlist.net/mailman/listinfo/markdown-discuss">http://six.pairlist.net/mailman/listinfo/markdown-discuss</a></span><br></div></blockquote></body></html>