———————————————— 一.用md文件建立网页这一步要做的就是把四个实验报告做出来.1.首先为了方便管理,我们在ML下创建一个名为docs的文件夹. 2.然后在修改设置,让github从docs中读取md文件.点击settings,往下翻直到github pages.然后点击下拉菜单,选择master branch/docs folder选项.稍等两秒钟,系统会进行设置更新. 3.选择主题这一步一定要在第2步之后做选完主题后查看docs文件夹,发现会多出一个文件. 4.然后编写实验报告

前提 下面的简介摘抄自docsify的官网 https://docsify.js.org 中的简介 docsify是一个神奇的文档网站生成器.他可以快速帮你生成文档网站.不同于GitBook.Hexo的地方是它不会生成静态的.html文件,所有转换工作都是在运行时.如果你想要开始使用他,只需要创建一个index.html就可以开始编写文档并直接部署在GitHub Pages(码云Pages.阿某云OSS或者鹅云COS等等).它的主要特性如下: 无需构建,写完文档直接发布(运行时markdown文

ToShowDoc拯救不想写文档的你 写注释已经够折磨开发者了,显然天天curd的我们再去写文档岂不是分分种要被逼疯. 我想每个人都有这种经历 加了一个参数文档忘了更新 参数名更改文档忘了更新 删掉一个接口文档忘了更新 ....... 各种忘了更新 已经有Swagger的我们慢慢的已经忘掉了写文档这件事. 但是在某些不方便暴露swagger地址的那天,又回忆起被文档支配的恐惧. What is ToShowDoc showdoc是一个文档供应商,它提供了一个良好的结构易于开发者编写文档. 也提供

日前,GitHub 文档的简体中文正式发布,开发者可以到官方文档上随意查阅浏览中文文档啦!   对于想要玩 GitHub,但一直苦于英语水平较差的程序员来说,这真是一个天大的好消息.下面一起来感受一下中文文档吧     是不是瞬间觉得 GitHub 变的十分接地气了呢,而且无论你是初级入门,还是中高级选手都适用哦~   其中,GitHub 企业版帮助文档也上线了,用户可根据具体需求点击"管理员指南"或"用户指南"来查看详细内容.   企业版涵盖管理员指南和用户指南:

前言 每次开发完新项目或者新接口功能等,第一件事就是提供接口文档.说到接口文档,当然是用 Markdown 了.各种复制粘贴字段,必填非必填,字段备注,请求返回示例等等.简直是浪费时间哇.所以想到了开发一款插件来解决重复复制文档的问题.下面来看我介绍介绍这款插件. PS:插件比较简陋,还需要不断迭代. 公众号:liuzhihangs,记录工作学习中的技术.开发及源码笔记:时不时分享一些生活中的见闻感悟.欢迎大佬来指导! 为什么开发插件 每次在对外提供接口时都要写文档,各种麻烦,并且文档耗费了很大

作者:吴香伟 发表于 2014/08/07 版权声明:可以任意转载,转载时务必以超链接形式标明文章原始出处和作者信息以及版权声明 本文不讲解Markdown的语法规则,只关注它带来的好处以及我使用的方法.语法规则可以参考Markdown: Syntax. 文档内容和格式分离 使用Word写文档总花费很多时间在调整格式,并且往往最终也没让自已满意.这对有洁癖的人来说痛苦非常.Markdown只通过几个简单的符号表示文档的格式,比如##代表二级标题,**X**代表强调内容X,*X*代表X的字体为斜体

​ 作为一个开发人员最怕的就是写文档了,但是要想成为一个合格的程序员,写好文档也是一个必备的技能.开发中我们经常要写接口服务,既然是服务就要跟别人对接,那难免要写接口文档,那么如何”优雅“的写接口文档呢?本文介绍一个在写代码的过程就可以写完接口文档的工具——Swagger2(江湖人称丝袜哥

最新博客链接 "Tsanfer's Blog" 创建Sphinx + GitHub + ReadtheDocs托管文档 Readthedocs在线电子书链接

今天给大家介绍一个Github上的README文档写作教程模版,该模版目前获得6634颗星星,2296Fork,相对而言,还是比较得到大家认可的.不花哨,不别出心裁,一个比较实用的,普适性的架子:所谓教科书式,不外如此.原文是英语,大神可直接看戳我查看.下面是我翻译的中文版(未完全按照原文翻译),献丑了. 项目名称 这里再写一句骚气又精准的话描述你的项目吧. 上手指南 写几句这样的话概括接下来的内容:以下指南将帮助你在本地机器上安装和运行该项目,进行开发和测试.关于如何将该项目部署到在线环境,请

Sphinx 是一个工具,它使得创建一个智能而美丽的文档变得简单.作者Georg Brandl,基于BSD许可证. 起初为写 Python 文档而诞生的 Sphinx,支持为各种语言生成软件开发文档. 它有着以下突出特性: 输出格式:HTML(包括Windows的HTML帮助文件).LaTex(可以打印为PDF).epub(流行的电子书格式).Texinfo.manual pages(man手册).plain Text(纯文本) 广泛的交叉引用:语义标记,函数.类等的自动连接等 分层架构:目录树

前言 之前想用Markdown来写框架文档,找来找去发现还是Jekyll的多,但又感觉不是很合我的需求 于是打算自己简单弄一个展示Markdown文档的网站工具,要支持多版本.多语言.导航.页内导航等,并且支持Github Pages免费站点 组件选择 我自己呢比较喜欢C#,恰好现在ASP.Net Core Blazor支持WebAssembly,绝大部分代码都可以用C#完成 对于Markdown的分析,可以使用markdig组件(有个缺点,目前它把生成Html的代码也放到了程序集里,增加了不少

转载于:http://blog.csdn.net/xiahouzuoxin/article/details/19752603 Markdown是一种网络书写语言,其目标是实现易读易写,且兼容HTML语言.Markdown的流行得益于Github和Stackoverflow,Stackoverflow的代码块以及Github上的README.md文件格式都是通过Markdown表现的.从这里您可以很直观的看到Markdown的效果:https://github.com/adam-p/markdow

最近在学 Python,所以总是在看 Python 的官方文档, https://docs.python.org/2/ 因为祖传基因的影响,我总是喜欢把这些文档保存到本地,不过 Python 的文档实在是太多, 根本存不过来.后来追踪到 Python 官方的 GitHub 文档地址, 干脆就把官方的 GitHub 下载下来了:cpython GitHub 地址. 1. 下载 Python 的 GitHub 仓库:cpython从 GitHub 上 clone 仓库很简单,在命令行中执行命令 gi

本文主要参考资料为该网址:https://github.com/GitbookIO/gitbook/blob/master/docs/setup.md 如何想使用现成的gitbook,网络上虽说可以搜索的到,但是要使用,可能会受到限制,需要翻墙. 但是通过这种方式,就不必翻墙,可以作为公司内部文档或者是自己的开源项目介绍等. 步骤如下(以生成一个blog文档为例): 全局安装gitbook-cli npm install gitbook-cli -g 初始化 gitbook init ./blo

有两种编写方式: In reStructuredText In Markdown In reStructuredText  工具:  pip install sphinx sphinx-autobuild 克隆你的仓库到本地:  git clone https://github.com/yourusername/yourrepository.git 在仓库根目录内创建文档: mkdir docs & cd docs sphinx-quickstart //按照提示一路下去,会生成index.rs

可以通过github提供的ghpage服务来搭建网站,有以下三种方式来实现: 1.文档放在master分支,作为一个子目录. 仓库:https://github.com/Ourpalm/ILRuntime 文档:https://ourpalm.github.io/ILRuntime 2.文档做为一个独立的分支 仓库:https://github.com/mr-kelly/KSFramework 文档:https://mr-kelly.github.io/KSFramework/ 3.以githu

导航 前言 离线文档 1 保存为html 2 导出成pdf文档 3 导出成Word文档 参考 前言   早前笔者曾经写过一篇文章<研发团队,请管好你的API文档>.团队协作中,开发文档的重要性,这里就不再赘述,今天的话题集中在如何进一步提升更加高效的使用文档. 离线文档   swagger已经很方便了,我们为什么还需要离线文档?公司同一个项目组,一般只要集成了swagger基本就够了,但是难免会有跨组,甚至会有公司对外合作的项目.特别是在"微服务大行其道的今天",多个团队之

一. 思路 今天接到个小任务,让把json文件转换成excel文件,按照列展开. 思路:既然json已经都已经是现成的,那直接将json文件做读操作,在通过不同的key,找到对应的信息,在存到单元格中,在写操作,生成excel文档 二.jar包 涉及到的jar包,阿里的fastjson和poi的jar包 三.代码 我的json文档里数据的格式是这样的 [ { "total": 1, "name": "规则限制:XXXX", "timeS

package apache.poi; import java.io.ByteArrayInputStream;import java.io.ByteArrayOutputStream;import java.io.File;import java.io.FileInputStream;import java.io.FileOutputStream;import java.io.IOException;import java.io.OutputStream;import java.util.Ha

vuepress的官方文档:https://vuepress.vuejs.org/zh/guide/ 参考:https://segmentfault.com/a/1190000016333850 https://juejin.im/post/5d1f1136f265da1ba77cc3d3 https://juejin.im/post/5d1ab9c151882579dd60d5e0 视频教程:https://www.bilibili.com/video/av78052346?p=2 搭建一个v

1.找一个文档规范要求. 2.根据文档的规范要求调整正文的格式,标题1的格式,标题2的格式,标题3的格式,图表的格式,把没用的那些格式都删除掉. 3.图注表注后空格一行. 4.设置页眉页脚. 5.生成一个目录.