简介 安装 我的配置 Chocolatey 简介 - Windows的包管理器 官方网址 安装 注意事项 Python 简介 安装 Pip 简介-Python的包管理器 升级 MkDocs的安装 使用Pip安装MkDocs 检查是否安装正确 MkDocs的使用 初步试用根据官方文档的步骤创建和使用MkDocs 常用命令 My Test 注意事项 简介 类别:项目文档生成器,生成静态站点,管理MarkDown文档. 官方网址:http://www.mkdocs.org/ 中文文档:http://m

简介 Sphinx 是一个 文档生成器 ,您也可以把它看成一种工具,它可以将一组纯文本源文件转换成各种输出格式,并且自动生成交叉引用.索引等.也就是说,如果您的目录包含一堆 reStructuredText 或 Markdown 文档,那么 Sphinx 就能生成一系列HTML文件,PDF文件(通过LaTeX),手册页等. 安装 pip install sphinx 查看是否安装成功 sphinx-build --version 显示对应的版本号即代表安装成功 sphinx-build 5.0.

一.软件介绍       Sandcastle是一个管理类库的文档编译器,是用于编译发布组件(Assembly)信息的一个工具,这个工具通过反射和Xslt技术,可以从dll文件及其xml注释(命令行编译时加/doc参数或vs2005设置项目属性得到)得到一个完整的帮助文档,格式可以是Html或CHM甚至是任何自定义的格式. Sandcastle与.NET Framework 2.0和.NET Compact Framework组合使用.Sandcastle支持本地化,并提供一个基本的命令行编译器

django-rest-framework,即drf的api文档,包括自带的文档和其他三方文档,比如swagger.DRF Docs等 https://www.django-rest-framework.org/topics/documenting-your-api/#drf-autodocs 可以直接使用本地部署 阿里妈妈前端团队出品的开源接口管理工具RAP第二代 :https://github.com/thx/rap2-delos:第一代已经不维护了:https://github.com/t

目录 PHP文档生成器(PHPDoc)的基本用法 PHPDoc概述 安装 PHPDoc注释规范 页面级别的注释 代码级别的注释 生成API文档 额外软件 PHP文档生成器(PHPDoc)的基本用法 PHPDoc概述 PHPDoc是一种注释PHP代码的正式标准,一般是通过外部文档生成器phpDocumentor生成API文档.同事支持面向过程和面向对象的代码风格,而且很多高级IDE如PHPStorm对其有很好的支持.灵活使用PHPDoc生成API文档可以有效提高开发效率,本文主要是记录PHPDoc

当今大多数的团队都实现了前.后端分支.前端与后端的沟通都是通过接口来实现的(一般情况下都是webapi接口).这种情况你肯定需要一个接口查询的帮助文档,这个当然用swagger都可以实现.但做为前端开发的我们是否也应该考虑把自己写的组件以帮助文档的方式公开都团队其他人员使用.就像iview,easyui等UI组件都有自己的帮助文档.今天我们都介绍一套工具(其中某些组件经过本人的改造) 一.需要的组件 1. Hexo:静态博客生成器 2. Hexo-theme-doc:基于Hexo实现的帮助文档类

http://apidocjs.com/ 例子:myapp目录下的MyCode.java /** * * @api {get} /company/list 获取公司信息 * @apiName 获取公司列表 * @apiGroup All * @apiVersion 0.1.0 * @apiDescription 接口详细描述 * * @apiParam {int} pageNum分页大小 * * @apiSuccess {String} code 结果码 * @apiSuccess {Strin

是否在关闭office文档模板时提示拼写错误语法检查太多而导致失败?如果是提示这个错误的话,可以将拼写检查和语法检查关掉即可.下附相关链接:http://support.microsoft.com/kb/937422/zh-cn

主要用途:生成API的文档 源码链接:https://github.com/tmcw/docbox 最近刚好在看:Trending in open source,在JS语言中,slate一直在周排行上高居榜首,至少在我看的这一周当中,一直排行第一~ 有点好奇的点进去看了,原来是一款用于生成API文档的东东.本来打算clone下来到本地运行一下,结果ruby那边版本一一直报错,现在都没有解决了,于是乎,看到一个跟跟slate很像的玩意儿,Docbox,为什么要选择它呢? 1.基于Node环境,不需

Django的admindocs应用可以从模型.视图.模板标签等地方获得文档内容. 一.概览 要激活admindocs,请按下面的步骤操作: 在INSTALLED_APPS内添加django.contrib.admindocs 在urlpatterns内添加url(r'^admin/doc/',include('django.contrib.admindocs.urls')).确保它处于r'^admin/'条目之前,原因你懂的. 安装Python的docutils模块(http://docuti

在开发接口的过程中,需要向外发布相应的接口文档.开始的时候使用word来写文档,时间长了发现有几个问题. 1. 编写不方便.每次新增借口的时候都要复制上一个接口,然后再进行修改,一些相同的部分无法复用,接口多了文档会变的很长,还经常需要调整格式. 2. 发布不方便.文档更新时,需要发给需要的小伙伴.即使用git来进行管理,虽然拉取比较方便,但由于文件格式的问题,也不方便比较两次提交的差异. 由于有这些问题,决定寻找一种更优雅有效的方式来编写文档.经过比较,发现了apidoc,可以比较好的解决上面

Django的admindocs应用可以从模型.视图.模板标签等地方获得文档内容. 一.概览 要激活admindocs,请按下面的步骤操作: 在INSTALLED_APPS内添加django.contrib.admindocs 在urlpatterns内添加url(r'^admin/doc/',include('django.contrib.admindocs.urls')).确保它处于r'^admin/'条目之前,原因你懂的. 安装Python的docutils模块(http://docuti

参考博客:http://www.liujiangblog.com/course/django/160

mkdocs是Python的一个对 Markdown 友好的文档生成器.,小巧精美. MkDocs is a fast, simple and downright gorgeous static site generator that's geared towards building project documentation. Documentation source files are written in Markdown, and configured with a single YA

之前用了很多Markdown 文档生成工具,发现有几个挺好用的,现在整理出来,方便大家快速学习. loppo: 非常简单的静态站点生成器 idoc:简单的文档生成工具 gitbook:大名鼎鼎的文档协作工具 docsify:一个神奇的文档站点生成器,简单轻巧,无需静态构建html 教程版: http://me.52fhy.com/learn-markdown-generate-tool/#/ loppo 官网: https://github.com/ruanyf/loppo 依赖 node.js

设计初衷 节约时间 Java 文档一直是一个大问题. 很多项目不写文档,即使写文档,对于开发人员来说也是非常痛苦的. 不写文档的缺点自不用多少,手动写文档的缺点也显而易见: 非常浪费时间,而且会出错. 无法保证及时更新.代码已经变了,但是文档还要同步修改.需要强制人来维护这一种一致性.这很难. 为什么不是 swagger-ui java 的文档有几类: jdk 自带的 doc 生成.这个以前实践给别人用过,别人用 C#,看到 java 的默认文档感觉很痛苦. 就算是我们 java 开发者,也很讨

前端和后端注释文档生成 前端和后端的 函数及api 说明文档生成总结,持续更新中 by Qzx 参考网址 jsDoc - 中文说明 jsDoc 使用教程 后台接口文档生成器 - APIDOC官网 apiDoc - 中文说明 apiDoc的使用教程 一.安装 # 全局安装 npm install apidoc -g # 查看是否安装成功,显示命令行参数 apidoc -h 二.apidoc 常用命令说明 指令简写 指令全称 说明 -f --file-filters 过滤器,指定应该解析的文件类型,

写文档 作为一名开发者,每个人都要写代码. 工作中,几乎每一位开发者都要写文档. 因为工作是人和人的协作,产品要写需求文档,开发要写详细设计文档,接口文档. 可是,作为一个懒人,平时最讨厌的一件事情就是写文档. 写文档最令我不爽的地方是在于代码备注要改一遍,然后文档再改一遍. 所有重复的劳作,都是对于我们宝贵摸鱼时间的最大浪费. 于是,我就常常想,能不能只写一遍呢? i-doc 项目简介 idoc 为 java 项目生成项目文档. 基于原生的 java 注释,尽可能的生成简介的文档.用户可以自定

虽然有go语言的swagger,但是go版本的swagger对代码的侵入比较大,因此抽空实现了基于GO语言生成markdown文档的工具 开源链接地址: https://github.com/w3liu/gendoc gendoc 文档生成工具 MarkDown生成说明 示例 // doc是字段说明 // 如果是必填項,doc里填写 required 即可,注意required前面需要加空格 type ReqCreateOrder struct { Pass string `json:"pass

在前2篇文章这些.NET开源项目你知道吗?让.NET开源来得更加猛烈些吧 和这些.NET开源项目你知道吗?让.NET开源来得更加猛烈些吧!(第二辑)中,大伙热情高涨.再次拿出自己的私货,在.NET平台处理文档相关的开源组件.文档处理在开发中是一个非常常见的任务了,例如导出Excel,导出Word,生成PDF报表等等.那今天就看看下面这些.NET开源项目你知道不?如果有用,千万不要忘记推荐哦.同时个人能力有限,希望大家补充. .NET开源目录:[目录]本博客其他.NET开源项目文章目录 本文原文地