Discovery RelaxedJS - 用前端技术制作漂亮的 PDF 朋友让我帮忙找制作文档站以及生成 PDF 文档的方案，最好能实现一个源文件既可以生成 HTML 版本的手册页面，又可以生成比较美观的 PDF 文档。 对于这种需求，我了解方案是使用 Shpinx-Doc ，源文件是 reStructuredText 格式（rst）。配置妥当，终端跑一个命令就能把文档生成专业稳重的手册页面。 但 Shpinx-Doc 的问题在于很适合生成手册页面，但在生成 PDF 文档的方面总会因为中文字体的原因导致生成的 PDF 文档排版很奇怪。 经过一番搜索，找到了 RelaxedJS，一款采用前端技术（HTML 或 Pug）
NodeJS docsify 一款实时文档站生成器 昨天发现了一款有趣的文档站生成器 docsify ，与 Gitbook 等文档生成器不同，docsify 不需要先将 markdown 文档在本地转换成 html，直接运行一个 HTTP 服务器，docsify 就能将 markdown 文档实时的解析成网页。 安装 $ npm i docsify-cli -g 使用 初始化一个新文档项目 $ mkdir docs $ docsify init ./docs 运行本地服务器 $ cd docs $ docsify
NPM NPM 使用国内镜像 NPM 安装包的速度出奇的慢，因为会直接访问官方海外仓库。伟大的淘宝对官方包仓库做了镜像，每10分钟同步一次，可以说非常及时了。 淘宝NPM镜像 建议使用他们封装的 cnpm 工具，但我个人不喜欢。理想的方式是保持 npm 命令，从国内镜像下载包。 实现方法很简单，只要一条命令。 $ npm set registry https://registry.npm.taobao.org npm 会把这条记录写入到 ~/.npmrc 配置文件，配置成果如下。 $ npm config list