命令行创建和发布 MarkDown 到 WordPress
skywind3000 skywind3000 2019-05-13 17:21:57 +08:00 3997 次点击这是一个创建于 2395 天前的主题，其中的信息可能已经有所发展或是发生改变。
全球有 10% 的网站是用 WordPress 搭建的，虽然有很多 Hugo/Hexo 这类静态页面生成工具，但是功能比起 WordPress 弱太多了。之前用 WordPress 唯一的不爽就是没法离线在编辑器里用 MarkDown 写文章，然后一键发布，所以我写了一个小工具：
https://github.com/skywind3000/markpress
是用很简单，先创建一个 ~/.config/markpress/config.ini 文件：
[default] tabsize=4 [0] url=http://your-wordpress.com/ user=USERNAME passwd=PASSWORD 然后用 markpress 命令创建一篇新文章：
markpress -n mypost.md markpress 会链接 wordpress 服务器，请求一个唯一的文章编号 uuid，并且为你生成文件头部内容，比如：
--- uuid: 1234 title: status: draft categories: tags: --- 然后用你喜欢的编辑器编辑 mypost.md 文件，比如填充一些内容：
--- uuid: 1234 title: How to use asyncio in python ? status: publish categories: Development tags: python, server --- # Why you need asyncio ? - reason 1 - reason 2 - reason 3 # Principle behind the asyncio ... 现在上面信息栏填写了标题，分类和标签，然后把 status 从 draft 改为 publish，然后填写 markdown 的正文，当您编辑好了以后，一行命令就可以更新到 wordpress：
markpress -u mypost.md 成功的话，你会看到输出：
post uuid=1234 updated: mypost.md https://www.xxxx.com/blog/?p=1234 用最后一行的 url 就可以访问你的日志了。
那么 markpress + wordpress 写日志比 hugo/hexo 强在哪里呢？
漂亮的语法高亮：
使用 highlight.js 插件，支持 185 种语言的高亮，可以选择 89 种主题，是目前最强的代码高亮解决方案。
页面细节基本尊崇 Github 规范：
- 连接会被自动识别，只需要直写 URL，就会自动识别出来加上
<a>标签。 - 比如双波浪线包围的内容
~~测试~~会被划掉显示为：测试（有一条删除横线，此处没法显示）。 - 比如 Github Emoji，直接写 :smile: 的 shortcode，就会变成
此外还有很多比 Github 规范强的功能：
支持内嵌公式：
被 $ 符号包围的文字会被按照 latex 公式解析，输入：
$z=\sqrt{x^2 + \sqrt{y^2}}$ 得到：
支持内嵌 GraphViz 图表：
使用三个反引号和 ```viz-{引擎名称} 开头的代码块，能够被提前渲染成 SVG，并将 SVG 的 XML 内容直接嵌入到 Markdown 生成的 html 里面，无需额外保存图片，也没有中间文件，比如，Markdown 里面的代码块：
```viz-dot digraph G { A -> B B -> C B -> D } ``` 会被解析成 SVG 适量：
Viz 后面的 dot 对应的是 GraphViz 的 dot 引擎，还有其他好几个可用引擎，比如 circo：
```viz-circo digraph st2 { rankdir=TB; node [fOntname= "Verdana", fOntsize= 10, color="skyblue", shape="record"]; edge [fOntname= "Verdana", fOntsize= 10, color="crimson", style="solid"]; st_hash_type [label="{<head>st_hash_type|(*compare)|(*hash)}"]; st_table_entry [label="{<head>st_table_entry|hash|key|record|<next>next}"]; st_table [label="{st_table|<type>type|num_bins|num_entries|<bins>bins}"]; st_table:bins -> st_table_entry:head; st_table:type -> st_hash_type:head; st_table_entry:next -> st_table_entry:head [style="dashed", color="forestgreen"]; } ``` 上面代码块使用了 circo 引擎，得到图形如下：
GraphViz 是非常流行的描述语言绘制矢量图的工具，它有很多例子：Gallery
实际效果演示见我的博客文章： www.skywind.me
---
有了这个命令行工具，可以配置在 Vim/VSCode 里面，比如 vscode tasks.json 里面配置下 markpress，就可以在编辑 markdown 的时候按 CTRL+SHIFT+B 一键调用 markpress 发布到 wordpress 上了，十分顺手。
目前尚无回复
Select Language