docfx（二）

1. 初始化一个docfx项目

1.建立一个文件夹D:\docfx_walkthrough

2.运行cmd 到该文件下执行命令D:\docfx_walkthrough

3.输入命令 docfx init -q  （执行后会生成一个docfx_project的文件夹）

2. 搭建本身的网站

运行命令 docfx docfx_project/docfx.json

执行完后会生成一个子文件夹 _site，这就是静态网站的资源地址。

3. 预览资源网站

运行命令docfx serve docfx_project/_site

若是端口号8080没有被占用，那么网站的运行地址为 http://localhost:8080

若是端口号被占用了，那么运行命令 docfx serve _site -p <port>。

4. 修改网站结构

建立更多的md文件到一个指定的文件夹下，为了组织这些文件夹，咱们须要编辑 toc.yml  文件（位于articles 文件夹下面）

内容大体以下：

5 . md文件注意事项

md文件的格式主要以 markdown 的基础语法为基本，但并非所有都是 markdown 的语法，有些是不同的，以下：

1.  代码须要用 ``` 来控制 ，注意 ``` 先后须要空一行。如图
2. 为了自动生成右边的导航小标题， 你须要在每一个标题前面空一行
3. 还有一些其余的能够参考 官方文档。

6. XML转 markdown

我写了一个 xml 文件转 markdown 文件的程序，基本上是知足80%到90%的语法转换，就这样就能够将一个 xml  文档的api 转换成 一docfx 为基础的api。