关于html5:利用mkdocs部署静态网页至GitHub-pages

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 .github
2.$ cd .github
3.$ mkdir workflows
4.$ cd workflows
5.$ 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/

下次谈谈网站的具体配置

【腾讯云】轻量 2核2G4M,首年65元

阿里云限时活动-云数据库 RDS MySQL  1核2G配置 1.88/月 速抢

本文由乐趣区整理发布,转载请注明出处,谢谢。

您可能还喜欢...

发表回复

您的电子邮箱地址不会被公开。 必填项已用*标注

此站点使用Akismet来减少垃圾评论。了解我们如何处理您的评论数据