跳转至

项目主页

使用 GitHub Pages 为项目创建网站。

创建网站

分支选择

推荐使用 gh-pages 分支管理网站源码。

主题应用

使用 Github 页面主题,示例 zhenyuanlau/swh

文件列表

文件 说明
index.md 主页
_config.yml 主题配置文件

主题配置

文件 说明
_config.yml 配置网站标题、描述、显示或隐藏下载、下载地址
/asserts/css/style.css 自定义网站样式
/_layouts/default.html 自定义网站布局

本地预览

$ gem install jekyll bundler  
$ bundle init
$ cat >> Gemfile <<EOF
gem "github-pages", group: :jekyll_plugins
gem "webrick"
EOF
$ jekyll s
$ open http://127.0.0.1:4000

自定义域名

参见 关于自定义域名和 Github 页面

DNS 配置

![[godaddy-dns-swh.png]]

CNAME

$ swh git:(gh-pages) echo "swh.zhenyuanlau.me" > CNAME

Github 配置

Settings -> Pages -> Custom domain

![[github-pages-custom-domain.png]]


最后更新: September 10, 2023

评论