Info:
官方网站：MkDocs
我的集体网站成绩：http://wcowin.work/

一、筹备工作

1.下载Github Desktop

2.有一个GitHub账号

二、Creating your site

参考教程：

网站制作 - Wcowin的集体网站

与以往教程不同，我首先倡议先在Github创立一个名为你的名字+github.io的仓库

而后关上github Desktop 克隆到本地


关上Wcowin.github.io目录进入终端运行:

mkdocs new mkdocs-site

呈现下图的几个文件

docs文件下是当前网站的内容，mkdocs.yml是配置文件（配置主题，目录，插件等）

你在这个目录下写的任何货色都能够通过github Desktop 上传到github上

以VScode为例咱们关上具体看看外面的货色

(倡议先执行上面的代码增加一个GitHub Workflow)

1.$ mkdir .github2.$ cd .github3.$ mkdir workflows4.$ cd workflows5.$ vim PublishMySite.yml

目录树状图:

$ tree -a.├── .github│   ├── .DS_Store│   └── workflows│       └── PublishMySite.yml├── docs│   └── index.md└── mkdocs.yml

三、配置欠缺

关上mkdocs.yml

把以下的内容输出进去（最简略配置）

site_name: 网站名字site_url: site_author: 你的名字theme: name: material #主题

具体mkdocs.yml配置见Changing the colors - Material for MkDocs

下次我会具体谈谈这个问题

在下方终端运行能够在浏览器看到实时网站

mkdocs serve


这个网站就算是初步建好了

最初去github Desktop上传到github

你的网站网址就是：

https://你github的名字.github.io/

下次谈谈网站的具体配置