外包做网站要十几万,海南映客交友软件,微信开店哪个平台好,商丘网站建设推广公司参考pku大佬视频制作#xff0c;附上B站视频#xff1a;【GitHub Pages 个人网站构建与发布】
同时还参考了#xff1a;【Python版宝藏级静态站点生成器Material for MkDocs】
GitHub Pages 介绍
内容参考#xff1a;GitHub Pages - 杨希杰的个人网站 (yang-xijie.githu…参考pku大佬视频制作附上B站视频【GitHub Pages 个人网站构建与发布】
同时还参考了【Python版宝藏级静态站点生成器Material for MkDocs】
GitHub Pages 介绍
内容参考GitHub Pages - 杨希杰的个人网站 (yang-xijie.github.io)
Github pages 可以快速部署静态网站你可以在 GitHub 的每一个仓库创建一个对应的静态网站存放说明或文档。
通俗来说就是白嫖GitHub的服务器来建站GitHub Pages与Git管理超搭相当稳定的而且有全球的CDN加速也没被墙我只能说真爽。
这里一定要注意个人用户只有两种 GitHub Pages 网站的类型一种是 user(用户)一种是project(项目)。
这里有介绍GitHub Pages
user类型的网址只能对应唯一的用户而且仓库的名字必须为 username.github.io对应的网址为 http(s)://username.github.io。
project类型的仓库则可以新建很多只要仓库的名字不为 username.github.io 即可对应的网址为 http(s)://username.github.io/repository。
根据这两种类型建站可以有两种策略
只创建一个user仓库username.github.io所有的文章都放在这个仓库中。 优点只有一个仓库维护方便缺点你的个人账户再新建project类型的仓库大概率会与这个user仓库冲突。但我感觉一般对于个人来说 一个仓库也完全够用。不创建user仓库需要静态网站时新建多个project类型的仓库 优点仓库不限量 仓库之间互不冲突 可以使用不同的框架缺点多个仓库维护困难
GitHub Pages创建这部分可以不进行
这部分参考Github官方文档GitHub Pages
注意这节是说的pages的创建看个流程就可以了如果要使用下一章节的Mkdocs主题可以只创建好仓库。
创建仓库
创建一个名为username.github.io的新公共repos。其中username就是你在GitHub上的用户名。
注意如果repos的第一部分与你的用户名不完全匹配那么它将无法工作因此确保正确使用。
clone repos
创建好仓库后将仓库clone到本地。
git clone https://github.com/username/username.github.io
这里的username及的更换成你自己的。
编辑、push
git add --allgit commit -m Initial commitgit push -u origin main
关于git操作可以参考其他博客也可以参考我的记录http://t.csdn.cn/AhjXg
Mkdocs
介绍完Github pages 后还有模板介绍对于我这种前端小白来说写一个前端UI能够杀了我所以我采用了佬使用的模板Mkdocs。具体怎么使用可以参考以下部分
Installation - Material for MkDocs (squidfunk.github.io)
Publish a Website with Material for MkDocs and GitHub Pages - 杨希杰的个人网站 (yang-xijie.github.io)
只要按照上述过程来就可以成功创建一个属于自己的博客。
注意,这些博客全部都是Makedown格式的只需要git md文件就行github会自动将其部署为HTML文件所以说对我这种小白来说非常的方便。
mkdocs部署过程
这部分记录了我自己的部署过程可以参考本节开始的url也是可以的。
创建project
mkdocs new mkdocs-sitecd mkdocs-site添加github操作 Add GitHub Workflow
使用GitHub Actions您可以自动部署您的项目文档。在仓库的根目录下创建一个新的GitHub Actions工作流例如:. GitHub /workflows/PublishMySite.yml文件
$ mkdir .github
$ cd .github
$ mkdir workflows
$ cd workflows
$ vim PublishMySite.yml如果vim用不了就自己建一个文件。
在yml文件中复制粘贴如下内容:
name: publish site
on: # 在什么时候触发工作流push: # 在从本地main分支被push到GitHub仓库时branches:- mainpull_request: # 在main分支合并别人提的pr时branches:- main
jobs: # 工作流的具体内容deploy:runs-on: ubuntu-latest # 创建一个新的云端虚拟机 使用最新Ubuntu系统steps:- uses: actions/checkoutv2 # 先checkout到main分支- uses: actions/setup-pythonv2 # 再安装Python3和相关环境with:python-version: 3.x- run: pip install mkdocs-material # 使用pip包管理工具安装mkdocs-material- run: mkdocs gh-deploy --force # 使用mkdocs-material部署gh-pages分支现在当一个新的提交被推送到主分支或主分支时静态站点将被自动构建和部署。推送您的更改以查看工作流程的运行情况。
Github
将内容git到github上
$ git init
$ git add .
$ git commit -m initGitHub New Repository
GitHub Repository Settings Actions General
Actions permissions: Allow all actions and reusable workflowsWorkflow permissions: Read and write permissionsClick Save
$ git remote add origin 你自己的clone地址
$ git branch -M main
$ git push -u origin mainGitHub Repository Settings Pages Source gh-pages Click Save 如果出现404那就等一下让子弹飞一会。
