无缝撰写精美博客,文档和帖子的指南

撰写各种主题博客文章而又不致动手的资源清单。

该帖子应包含个人和公众的学习链接,使用链接以及进一步参考的链接。

为什么写?

博客有助于使世界了解您的最新动态。 编写书籍来分发知识,这样人们就可以在不重新发明轮子的情况下为人类取得坚定的进步。

为什么要使用其中任何一个来写?

通常,我注意到写作需要自由的思想流,而编写代码则需要建设性的思想流。 但是,编程需要分析性思维流程。
思想流中断免费写作。

问题:

布局 :我发现编写文章并围绕HTML编写文章非常耗时且令人沮丧。 编写普通文章似乎缺乏布局和格式设置所具有的才能和光泽,但是同时编写代码会阻碍您的思考过程。

对于像我这样的人来说, 版本控制是一个救命稻草,他们往往会忘记什么而不是为什么。

可移植性至关重要。
可以用大量HTML编写帖子。
用JSON编写帖子以导入基于Angular的博客要好一些。
有必要以一种可用于创建PDF,Epubs,HTML,rst和LaTeX的格式编写帖子,并使用正确的格式和布局渲染。

解决方案
具有版本控制功能的便携式标准,可让您轻松导出到PDF,Epubs,HTML,rst和LaTeX等。

版本控制:Github
渲染:通过github页面获取HTML
可移植性:以.rst或markdown导出形式编写的Sphinx

使用git作为版本控制来编写博客,文章和书籍。
如果需要,请使用私有存储库。
在Readthedocs.io中使用Jekyll或Sphinx

  “没有比在你心中讲出不为人知的故事更大的痛苦了。” 
  -Maya Angelou 

参考文献:

  1. 阅读thedocs.io
  2. ReST语法和Sphinx备忘单
  3. .rst女修道院
  4. 试用编辑
  5. Sphinx文档
  6. 狮身人面像介绍视频
  7. Jekyll Docs Post

希望这篇文章对您有所帮助。

我是Prahalad Belavadi,可以在Belavadi.com上找到我的大部分工作

谢谢。