hexo-renderer-pandoc

简介

pandoc是什么?

pandoc是一个标记语言(也可以说排版语言)转换器。可以将一种标记语言(如markdown、textile、tex、latex、html、epub等)转换到另一种标记语言。

常见的markdown引擎有

  • markdown_strict (original unextended markdown) 原生markdown
  • pandoc’s extended markdown
  • markdown_phpextra (PHP Markdown Extra extended markdown)
  • markdown_github (github extended markdown) 即GFW(Github Flavored Markdown)
  • markdown_mmd (MultiMarkdown)。

hexo markdown渲染引擎和mathjax冲突问题,因此安装hexo-renderer-pandoc。这会替换掉hexo自带的markdown引擎。

这个插件依赖pandoc

1
pandoc -s -o output.html source/_posts/demo/test.md

其他类似插件

hexo-math和hexo-renderer-mathjax来实现,

常见错误

1.

1
2
3
$ pandoc -s -o output.html OSM-export-plain-text.txt
pandoc: YAML header is not an object "source" (line 130, column 1)
pandoc: YAML header is not an object "source" (line 17, column 1)

原因是文档内部有---,会与front matter的符号混淆。应该跟插件无关,是pandoc的原因。

参考:https://github.com/olivierkes/manuskript/issues/124

##

做一个实时talk平台,

dao voice

基于微信公众号,很烂

gitter.im

  • 需要join room。这是个群聊的聊天室。

依赖现有的移动端im app,比如微信。

gitter很牛逼啊,tensor2tensor就采用的gitter聊天室

https://gitter.im/tensor2tensor/Lobby

gittalk

这是评论插件,不是实时聊天

TODO

可以基于git issue做一个群聊 聊天室。

借鉴git comment

评论组件

  • Hypercomments 是国外的一个第三方评论平台
  • 多说 在2017年06月01日就关闭评论服务了
  • 网易云跟贴 2017年08月01日也停止服务了
  • 来必力 (韩国人弄的)总是乱码
  • DISQUS 外国的,加载慢,被墙

基于github issue的评论系统。

Gitment

存在的问题:

  1. 每次发布文章时需要登录下自己的github账号去初始化一下评论,评论功能才能使用,否则会提示“未开放评论”

解决办法:添加第一条评论时自动初始化

  • 更改文章title,会找不到对应的issue。解决办法:采用href作为id。目前确实采用的href作为id,但是不会改title

2.

登入 button:

Gitalk

Gitalk 是一个基于 GitHub Issue 和 Preact 开发的评论插件

Gitalk,样式也挺漂亮的,于是打算尝试一下移植到Next主题上。
https://newdee.cf/posts/4da30c7/

demo: https://gitalk.github.io/

做一个基于git issue的在线编辑博客。。
做一个基于git 仓库的在线编辑博客。。

##