这里是总结了一下,用的工具或者平台:readthedocs.github .sphinx. 使用这三个工具即可轻松创建高效的文档管理库,可以用来翻译,水平再高一点可以写书. readthedocs 文档托管的平台,能够和常用的GIT阵营的github,HG阵营的Bitbucket,关于这两个平台的讨论比较文章可以参考. github 代码托管 sphinx 文档书写利器,使用的是reStructuredText格式,reStructuredText简明教程. 下面说说书写方法及托管流程 在这里注…

IIS6(Win2003) 使用.net framework 4.0 后,默认文档失效解决方案. 用.net framework 4.0 开发的WEB项目,但放到iis6 中无法使用默认文档,状况如下:地址栏输入:http://xxx.xxx.xxx.xxx/    提示找不到文件输入全称:http://xxx.xxx.xxx.xxx/default.aspx 正常显示. 本人解决方案如下. 1. 先新建一个文本文件,然后把以下文本COPY到这个文件中,保存为 1.reg ,然后直接导入.Win…

Atitit 数据库表文档生成解决方案 1.1. Sql dml文件结构法 最快速1 1.2. Sql法+sp存储过程 (表格式样)1 1.3. Navicate uml法 (uml格式)2 1.4. H5 报表法图表法(可视化好看与实用性结合)2 1.5. Meta api法3 1.6. 获取表列表 数据库包含哪些表.视图等..3 1.1. Sql dml文件结构法 最快速 CREATE TABLE `l_laundry` ( `id` int(11) unsigned NOT NULL AU…

转载自 http://zzstudy.offcn.com/archives/6159 如何解决IIS7多域名绑定同一物理目录,设置不同的默认文档的问题? 因为在一个物理目录下只有一个web.config,并且IIS7把默认文档设置写在这里,导致所有域名的默认文档设置共享,很多人对此束手无策,甚至有人说这是IIS7的bug.其实IIS7不会比IIS6落后的,这个问题也很好解决,下面是解决方案: 1.进入%windir%\system32\inetsrv\config目录(%windir%即wind…

周末两天玩了下号称西湖区东半球最牛逼的react文档站点生成工具dumi,顺带结合github pages生成了react-uni-comps文档站, 一套弄下来,感觉真香,现在还只是浅尝,高级的特性还没玩完,文档还需继续打磨完整,不知道是不是东半球最牛逼,西湖全区应该无与伦比了 ,下面是当前文档站移动端和pc端预览截图(整套弄下来花了半天时间!) 桌面端效果(手机界面模拟/桌面端效果/自动根据ts生成的API表格文档) 手机效果(支持light/dark主题) 文档站点制作步骤如下: 安装 d…

前几天有个老项目找到我,有多老呢?比我工作年限都长,见到这个项目我还得叫一声前辈. 这个项目目前使用非常稳定,十多年了没怎么更新过,现在客户想加一个小功能:在线预览Word文档. 首先想到的是用第三方的服务,例如WPS的开放平台. 刚看完文档,客户来了句,要一次性的哦,后续再付费的通通不要. 得嘞,换其他方案吧. 项目特点 Asp.Net不带Core,.NET Framework 4.0,部署在Windows平台上. 解决方案 大致思路:先将Word文档转换Html,再预览Html. 1.Wor…

readthedocs 是由社区驱动的开源sphinx doc 托管服务,我们可以用来方便的构建以及发布文档 这是一个简单的demo 项目,使用了用的比较多的sphinx_rtd_theme 主题,主要是试用 注册账户 sphinx 文档需要让readthedocs 托管,我们需要一个账户,注册地址 https://readthedocs.org/ ,注册很简单,我们同时需要进行邮件验证 简单demo 项目 我们可以使用sphinx-quickstart 帮助我们生成简单的测试doc sphin…

文档生成工具: 自带的pydoc,比较差 建议使用sphinx 安装: pip install sphinx 安装主题: 由各种主题,我选择常用的sphinx_rtd_theme pip install sphinx_rtd_theme 使用方法: 1.创建文件夹doc:mkdir doc:cd doc:执行sphinx-quickstart,进入引导,根据需要选择yes或者no 2.执行sphinx-quickstart引导程序只会生成一个index.rst 3.在doc目录下执行sphinx…

ReadtheDocs Read the Docs非常适合写软件文档以及编写一些教程.电子书之类.对于一些一两篇文章就能写清楚的可以记笔记或写博客, 但是如果要写成一个系列的,不如写成一本书的形式,更美观,也更系统. Read the Docs是一个在线文档托管系统, 你可以从各种版本控制系统中导入文档,如果你使用webhooks, 那么每次提交代码后可以自动构建并上传至readthedocs网站,非常方便. 现有的写电子书的方式,有以下几个解决方案,优劣势也很明显: 写博客,跟散文堆在一起,不…

cakephp的文档是用一个叫sphinx程序生成的 这个程序是python写的,所以我们要用sphinx本机必须先装python. 编译过程在Ubuntu下进行,默认Ubuntu已经安装了python, 命令行下依次执行 sudo apt-get install python-setuptools sudo apt-get install easy_install easy_install sphinx easy_install sphinxcontrib-phpdomain 最后把cakep…