备用博客2

备用博客已经搭好框架,如无特殊需求,只需向resource目录上传md文件即可。说来心塞,搞了好几天的原因,其实是在github上部署hugo失败,如果有人想使用github部署博客,还是推荐hugo等即成框架,如果也有问题,不妨考虑我的方案。

github博客

github项目代码

# github.io博客
## markdown文件自动转html部署

### 搭建
1. 创建{username}.github.io为名的仓库
2. 点击右上角头像-Settings-Developer settings-Personal access tokens-Generate new token,这一步用于Github Action Markdown2Html脚本提交代码
3. 克隆本项目`.github/workflows`, `css`, `js`, `build.py`, `index.html`到自己的仓库
4. 新建sitemap.json文件,内容为`{}`
5. 修改页面导航栏及其他样式


### 使用说明
1. 提交html、css、js会触发pages build工作流,将静态文件部署到github.io
2. 提交.md后缀的文件会触发Markdown2Html工作流,将resource(默认文件夹)下的md文件转为html存入pages目录,然后commit、部署到github.io
3. 每次.md文件变更,build.py会先校验md5是否改变,md5不改变不改动,文章的日期为首次生成html时间,可在`js/data.js`手动调整
4. 首页默认展示归档列表,每页展示数再index.html修改`const pageSize = 改这里;`


### 存在的问题
1. 文章使用iframe展示,避免换页闪烁,但是iframe访问地址被记录在浏览器历史记录,返回时会跳到iframe链接地址
2. 目前使用markdown2转换html,对.md文本格式要求严格,例如段落后需要加两个空格再换行,否则html不换行
3. 受制于iframe和浏览器对popstate事件限制,返回不会回到列表页,但是点击归档、分类正常,且保存之前访问页码

发表回复

您的电子邮箱地址不会被公开。