在服务器端为 ColdFusion 实现 Showdown.js markdown 解析器

这是一个“事实调查”问题，旨在了解使用以下命令创建 ColdFusion UDF 来解析服务器上的 markdown 有多困难：showdown.js 解析器。 http://attacklab.net/showdown/已经有一个利用 showdown.js 的 java 实现（请参阅本文末尾的代码），我想了解如何为 ColdFusion 实现它。我没有 Java 经验，我不会特别称自己为“程序员”，但我不希望这阻止我尝试。

Summary

我想跑步Shadow.js http://attacklab.net/showdown/服务器端以便将 Markdown 转换为 HTML。

Why?

保存用户条目的两个版本，一个采用 Markdown 格式，另一个采用 HTML 格式，这样我们就可以向最终用户显示原始 Markdown 版本，以防他们想要编辑其条目。

为什么不使用服务器端解析器？

有两个原因：

1. 截至目前，还没有用于此特定目的的 ColdFusion markdown 解析器
2. 在客户端使用 Showdown.js，然后在服务器端使用不同的解析器将导致显示给客户端的预览与数据库中存储的版本之间的标记不一致。鉴于 markdown 的定义很松散，大多数解析器实现都会有细微的差异。

有一个非常好的博客条目 http://briancarper.net/blog/415/clojure-and-markdown-and-javascript-and-java-and讨论这个问题。

为什么不在客户端进行所有解析并发布两个版本？

我认为这不是一个安全的解决方案。我还认为用户可能会发布带有不匹配 HTML 的 Markdown。

有现成的实现吗？

有一种名为 CFShowdown 的实现 http://blog.adampresley.com/software-development/cfshowdown-a-markdown-library-for-coldfusion/comment-page-1/#comment-8029，但它不是为了这个特定目的。相反，它用于处理页面上的输出。评论区的上述博客 http://briancarper.net/blog/415/clojure-and-markdown-and-javascript-and-java-and具有由名为 David 的用户编写的纯 Java 实现：

ScriptEngineManager manager = new ScriptEngineManager();
ScriptEngine jsEngine = manager.getEngineByName("js");
try
{
    jsEngine.eval(new InputStreamReader(getClass().getResourceAsStream("showdown.js")));
    showdownConverter = jsEngine.eval("new Showdown.converter()");
}
catch (Exception e)
{
    log.error("could not create showdown converter", e);
}

try
{
    return ((Invocable) jsEngine).invokeMethod(
        showdownConverter, 
        "makeHtml", 
        markdownString
    ) + "";
}
catch (Exception e)
{
    log.error("error while converting markdown to html", e);
    return "[could not convert input]";
}

客观的

创建一个 java 类，允许我们将此实现与 ColdFusion UDF 或组件内的自定义标记一起使用，类似于<cfset html = getMarkdown(string)>

由于我没有 Java 经验，因此我希望从用户那里获得一些关于从哪里以及如何开始执行此任务的建议和意见。我创建了一个

有文件对决.js http://attacklab.net/showdown/showdown-v0.9.zip和同一目录中的文件 markdown.txt （如下示例）。

摊牌.cfm

<cfscript>
manager = createObject("java", "javax.script.ScriptEngineManager").init();
jsEngine = manager.getEngineByName("js");

showdownJS = fileRead('#getDirectoryFromPath(getCurrentTemplatePath())#/showdown.js');

jsEngine.eval(showdownJS);
showdownConverter = jsEngine.eval("new Showdown.converter()");

markdownString = fileRead("#getDirectoryFromPath(getCurrentTemplatePath())#/markdown.txt");

args = [markdownString];

result = jsEngine.invokeMethod(
    showdownConverter,
    "makeHtml",
    args
) & "";
</cfscript>

降价.txt

Showdown Demo
-------------

You can try out Showdown on this page:

  - Type some [Markdown] text on the left side.
  - See the corresponding HTML on the right.

For a Markdown cheat-sheet, switch the right-hand window from *Preview* to *Syntax Guide*.

Showdown is a JavaScript port of the original Perl version of Markdown.  You can get the full [source code] by clicking on the version number at the bottom of the page.

Also check out [WMD, the Wysiwym Markdown Editor][wmd].  It'll be open source soon; email me at the address below if you'd like to help me test the standalone version.

**Start with a [blank page] or edit this document in the left window.**

  [Markdown]: http://daringfireball.net/projects/markdown/
  [source code]: http://attacklab.net/showdown/showdown-v0.9.zip
  [wmd]: http://wmd-editor.com/
  [blank page]: ?blank=1 "Clear all text"

Update

这是一个需要的版本Adam Presley 在 Java 中的工作 https://stackoverflow.com/questions/4600535/implementating-showdown-js-markdown-parser-on-the-server-side-for-coldfusion/4605963#4605963并在 CFC 中完成这一切。请注意，我采用了他在 showdown.js 末尾添加的一点点魔法，并将其放入一个 CFC 函数中，该函数附加了返回值（即showdownAdapterJS()).

CFC

<cfcomponent output="false" accessors="true">
    <cffunction name="init" output="false" access="public" returntype="Showdown" hint="Constructor">
        <cfset variables.manager = createObject("java", "javax.script.ScriptEngineManager").init()>
        <cfset variables.engine = manager.getEngineByName("javascript")>
        <cfreturn this/>
    </cffunction>

    <cffunction name="toHTML" output="false" access="public" returntype="any" hint="">
        <cfargument name="markdownText" type="string" required="true"/>
        <cfset var local = structNew()/>
        <cfset var bindings = variables.engine.createBindings()>
        <cfset var result = "">

        <cftry>
            <cfset bindings.put("markdownText", arguments.markdownText)>
            <cfset variables.engine.setBindings(bindings, createObject("java", "javax.script.ScriptContext").ENGINE_SCOPE)>
            <cfset var showdownJS = fileRead('#getDirectoryFromPath(getCurrentTemplatePath())#/showdown.js')>
            <cfset showdownJS &= showdownAdapterJS()>
            <cfset result = engine.eval(showdownJS)>
            <cfcatch type="javax.script.ScriptException">
                <cfset result = "The script had an error: " & cfcatch.Message>
            </cfcatch>
        </cftry>

        <cfreturn result>
    </cffunction>

    <cffunction name="showdownAdapterJS" output="false" access="private" returntype="string" hint="">
        <cfset var local = structNew()/>
<cfsavecontent variable="local.javascript">
<cfoutput>#chr(13)##chr(10)#var __converter = new Showdown.converter();
__converter.makeHtml(markdownText);</cfoutput>
</cfsavecontent>
        <cfreturn local.javascript>
    </cffunction>
</cfcomponent>

Usage

<cfset showdown = createObject("component", "Showdown").init()>
<cfset markdownString = fileRead("#getDirectoryFromPath(getCurrentTemplatePath())#/markdown.txt")>
<cfoutput>#showdown.toHTML(markdownString)#</cfoutput>