• 欢迎 游客 您的光临,下载之前请先阅读 积分规则(暂行) 。任何技术问题请在论坛提问,本站定制插件、模板主题售前、售后问题请联系QQ:5916171

模板修改 [功能扩展] 通过Showdown实现对Xenforo的Markdown外部识别转换

YYT

UID
18
注册
2017/10/06
消息
78
反馈评分
332
黄金
10,058.3G
    Windows 10 Chrome 92.0.4515.159
  • #1
Markdown是什么?
Markdown是一种轻量级标记语言。 它允许人们使用易读易写的纯文本格式编写文档,然后转换成有效的XHTML(或者HTML)文档。
由于Markdown的轻量化、易读易写特性,并且对于图片,图表、数学式都有支持,许多网站都广泛使用markdown来撰写帮助文档或是用于论坛上发表消息。 如GitHubRedditDiasporaStack ExchangeOpenStreetMapSourceForge简书等,甚至还能被使用来撰写电子书
相较于BBCode和直接的html标签,markdown是一种更简易更便捷的纯文本标记语言,可以让用户更专注于内容的编写而不是排版。

我为什么需要Markdown?
因为MineBBS的主要用户群体是开发者,他们一般都会使用github,因此也养成了markdown的编写习惯,所以xenforo上自带的可视化编辑器和BBCode编辑器并不能很好的满足他们的编写需求。也方便他们进行文档描述的搬运,而不需要重新排版。而Xenforo自带的markdown转换又是一个残次品,故产生了这个项目。
我们不提倡普通的社区使用该功能,因为大多数用户并不具备markdown的编写习惯和技巧。也没有必要性。

与站长的项目有何区别?

站长正在研究的,是将编辑器中的“代码编辑”从BBCode更换成Markdown,更彻底、可回退:https://www.cnxfans.com/threads/1624/
而我们的方式则是直接识别一个BBCode标签并将其内部的Markdown内容进行转换,不影响任何原编辑器的功能和此前输入的任何内容,就像是给一段文本加上一个加粗一样简单,但是如果转换服务失效,[MD]标签中的内容都会显示为普通文本,所以需要保持本服务有效。当然,还有一个优点,不要钱)

怎么实现?
本教程基于MineBBS管理团队@Subilan研究实现,利用Showdown的转换库实现外部转换
Github链接:https://github.com/McShare/xenforo-markdown
MineBBS公告:https://www.minebbs.com/threads/markdown.7586/
废话有点多,开始实操 ↓

实操教程:

至此,脚本将自动加载并识别转换文本中[MD][/MD]标签内的markdown标记
如果有任何建议和问题,都欢迎去Github提issue,本贴也可以回答和提一些简单的问题
注:请确保网站有jquery,使用之前也请仔细阅读github的readme文件
 
最后编辑:
购买收费内容用户:
打赏用户:
死了算了
顶部 底部