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。