【tools&tips】使用reStructuredText写博客

【tools&tips】使用reStructuredText写博客

博客的选择

国内IT博客的两个主要门户当属 CSDN博客园 了。

就影响力来说,CSDN略胜一筹,但是CSDN的编辑器堪称蛋疼。 且不说编辑半天,出来的效果不甚美观,就是单单一个保存,就常常因为网络问题直接丢失了。在线编辑的设计真是鸡肋。 而且对于样式,不能自定义CSS(貌似先前CSDN是支持的,但是后来不知道怎么的又不支持了),样子单调乏味的紧。

相比之下,博客园自定义样式和离线编辑就贴心的多了。但是CSDN的博客编辑并不是一无是处。至少有两个功能是博客园应该学习的:

  • 自动生成目录。这个功能对于长文的博客还是很贴心的。
  • 支持带样式粘贴。比如你可以直接复制博客园的博客,然后粘贴进CSDN中。发布出来的CSDN的博客样式将和博客园的基本一致。

两个博客当在伯仲之间,让人难以取舍。于是我选择同时维护两个博客。但是同时编辑两个博客,编辑成本不能不考虑。 综合权衡操作的便捷和编辑的方便,我的选择是使用restructedText撰写文章,然后生成HTML。 从HTML中复制出HTML代码,粘贴进博客园发布。


而后从博客园发布成的博客,直接复制


然后粘贴进CSDN中,发布完成。


插个广告

为什么用reStructuredText

好了,转回头来,我来说下为什么用reStructuredText。面对 latexmarkdown,甚而是 word 的包夹围堵, 我仍然选择用reStructuredText(在此之前我是用的word)。

  • 首先,reStructuredText是python的API官方撰写文档。现在我主要使用的语言是python,使用reStructuredText更接地气。
  • 其次,reStructuredText较之于latex,markdown,更贴合于 所见即所得 的理念。
  • sphinx生成出来的样式很漂亮。特别是代码。
  • 导出格式种类丰富,包括HTML,PDF等等。最大限度满足需求。

如何用reStructuredText

我比较推崇的博客写作理念是简单易用。这样能把更多的注意力集中在博客写作本身,而不是上传图片、编辑格式等琐碎的小事上。 因此我对于reStructuredText的使用,也停留在样板化的初级阶段。对于文档,常用的无非就是一二三级标题,列表,超链接等。 对于技术博客,图片和代码也是较为常见的。

我做成了个 模板,可以下载参考。

编辑reStructuredText文件,我一般使用Eclipse+reSt Editor。当然notepad++也是不错的工具。只是notepad++没有提供rst的语法高亮功能。 我编辑了一个 reStructuredText语言,可以再notepad++中的语言->自定义语言格式->导入中导入。

posted on 2014-04-15 18:33  晓论三国  阅读(1008)  评论(0编辑  收藏  举报