这里是总结了一下,用的工具或者平台:readthedocs、github 、sphinx。 使用这三个工具即可轻松创建高效的文档管理库,可以用来翻译,水平再高一点可以写书。 readthedocs 文档托管的平台,能够和常用的GIT阵营的github,HG阵营 ...
.效果预览 https: how to use sphinx write.readthedocs.io zh CN latest .安装 . 准备 安装之前假设你已经安装好了python sphinx版本: . 以下以Linux命令为主,window可以手动创建目录,然后在cmd执行pip和初始化即可. 在执行命令sphinx quickstart的时候,会让你输入配置,除了以下几个个性化配置外 ...
2020-12-29 17:19 2 806 推荐指数:
这里是总结了一下,用的工具或者平台:readthedocs、github 、sphinx。 使用这三个工具即可轻松创建高效的文档管理库,可以用来翻译,水平再高一点可以写书。 readthedocs 文档托管的平台,能够和常用的GIT阵营的github,HG阵营 ...
readthedocs 是由社区驱动的开源sphinx doc 托管服务,我们可以用来方便的构建以及发布文档 这是一个简单的demo 项目,使用了用的比较多的sphinx_rtd_theme 主题,主要是试用 注册账户 sphinx 文档需要让readthedocs 托管,我们需要 ...
0 前言 写文档是开发人员日常工作中的一项重要内容,除了word之外,我更偏爱使用标记语言(Markup Language)。使用标记语言,可以利用简单、免费的文本编辑器(记事本,vim, emacs...)编写文档并设置格式,再生成html或pdf等格式,或者直接把编辑好的文件传到github ...
Read the Docs是一个在线文档托管服务, 你可以从各种版本控制系统中导入文档。一般来讲,这个非常适合写软件文档以及编写一些教程、电子书之类。 Sphinx Sphinx 是一个基于 Python 的文档生成项目,最早只是用来生成 Python 官方文档,随着工具的完善, 越来越多 ...
首先安装vscode工具,具体的使用可以参考之前的博文:《Visual Studio Code教程:基础使用和自定义设置》 VScode已经默认集成markdown文档编辑插件。可以新建一个.md文件Visual Studio Code 原生就支持高亮Markdown的语法,想要一边编辑 ...
首先安装vscode工具,具体的使用可以参考之前的博文:《Visual Studio Code教程:基础使用和自定义设置》 VScode已经默认集成markdown文档编辑插件。可以新建一个.md文件Visual Studio Code 原生就支持高亮Markdown的语法,想要一边编辑一遍预览 ...
我写博客的初衷是为了系统的构建自己的知识体系,目前使用的平台有微信公众号,CSDN,博客园,GitHub Pages和Gitee Pages,他们都各有优缺点,整理的笔记多了之后发现这些平台不是很方便,比如公众号,CSDN和博客园,每次写完文章后,还需要再平台上进行编辑再发布,比较麻烦 ...
ReadtheDocs Read the Docs非常适合写软件文档以及编写一些教程、电子书之类。对于一些一两篇文章就能写清楚的可以记笔记或写博客, 但是如果要写成一个系列的,不如写成一本书的形式,更美观,也更系统。 Read the Docs是一个在线文档托管系统 ...