A blog generator with my own theme customized upon PaperMod.
基于 hugo 的 PaperMod, 简单做了下修改, 仍在完善中。
- 初始化过程已截图
- hugo new site
- PaperMod 主题安装
- hugo.yaml
- theme: "PaperMod"
- 修改 archetypes/default.md 为 yaml 格式
- 添加 .gitignore
- 添加 .gitkeep 占位
- layouts & assets
- theme-vars.css
- 主题颜色, 仅注释, 待后续调整
- anchored_headings.css & anchored_headings.html
- anchor of [h1-h6] 的图案、颜色
- archives.html
- 仅注释, 标记下 ShowAllPagesInArchive 和 mainSections 的位置
- breadcrumbs.html
- breadcrumb 格式: 🔖 Yiny
- footer.html
- copyright 格式: © 2024 Yiny's Blog
- 404.html
- robots.txt
- 禁止爬虫
- theme-vars.css
- search.html
- 修改显示格式
- Section Search
- /index.json(默认) : 只在根目录生成用于 search 的 json, 即只有全局搜索(site.RegularPages)
- section search: 我希望 section 的搜索结果不受其他 section 影响, 即局部搜索
- list.json: 生成 section 的 json
- list.html: 在 list page 里增加 🔍 按钮
- archetypes/default.md
- content/ - 骨架搭建
- 几个特殊的 .md 文件
- about(关于): 不写自己, 写点祝福吧
- blogroll(友链): 待填
- archives(文章), 多个 search(搜索). ==注意配置 "layout" 才会生效==
- 关联配置: menu buttons socialIcons taxonomies(暂时维持默认)
- 几个特殊的 .md 文件
- static 图标
- 头像: avatar/*
- 封面: about/*
- favicon/*
- hugo.yaml
- 按 PaperMod wiki 与 Hugo Doc 修改配置
- profile-mode copyright ...
- 暂未启用: comments, share, ShowPostNavLinks(上一页下一页), hidemeta ...
- 详情参考配置文件
- 按 PaperMod wiki 与 Hugo Doc 修改配置
- 配置 [markup.goldmark.renderer.unsafe]: true
- goldmark 默认不会渲染 html, 需要在 markdown 里用
{{ rawhtml}}
{{ /rawhtml }}
- 启用以能在 markdown 里直接使用 html, 顺便把 about.md 改了
- ps. 在模版里用 safehtml
- goldmark 默认不会渲染 html, 需要在 markdown 里用
- 新增特效
- fish.js - 底部小鱼跃动特效
- canvas-nest - 蛛网背景
- cursor
- firework.js - 鼠标点击特效
- Aplayer - 音乐播放器, 音乐外链
- 相关文件
- assets/
- css/extended/ cursors.css, fish.css
- js/*
- layouts/
- partials/extended_footer.html
- static/
- audio/*
- cursors/*
- assets/
- 问题描述
- 本地运行正常, 但是 GitHub Page 显示异常, 报错 404 即文件下载异常
- 原因分析
- css 路径写的有问题, 原以为是需要带域名 wooyiny.github.io
- 结果是因为 url 最后的
\
被一起识别进后缀名.png\
导致文件类型识别异常, 太离谱了
- 问题描述
- Github 的仓库免费空间和网速都有限制, 将音频文件原封上传属实太大了, 用外链更合适
- 具体实现
- extend_footer.html - Aplayer 配置里的 URL 改用外链
- 目前使用的 Github Repo + PicGo + jsdelivr 的方案, 设置了两个仓库, 一个用做图床, 一个用于音乐外链
- 删除 static/audio/*
- extend_footer.html - Aplayer 配置里的 URL 改用外链
- 后续
- 资源还是得慢慢上云才行, 否则本体太大无法接受
- Aplayer 外链重构 (audio cover lrc), 并修改歌词颜色
- copyright 右对齐, 主要是和歌词的位置冲突了
- about 改用外链 avator cursor favicon 暂时保留
- PaperMod 主题更新. 理由: 当前版本显示 logo 有 bug, 观感很不好
- separator displayed with Single lang sites
- 注意
- submodule 的 HEAD 是分离状态, 要 checkout 到 master 才能 pull
- 更新完记得 detach HEAD, 以防之后自动跟着更新
- about 外链地址写错了
- content 目录名改了几个
- 问题描述
- 目录名关联三个功能: menu、archives 搜索、 button 主页图标
- 重命名后, 配置文件忘记改了, 造成访问异常
- 目录名从 cursors 改用 cursor
- 改用 DOTA2 TI5 金叶子指针
- 原因
- 配置文件必须配上 [outputs:], 否则缺少 json 文件会导致搜索功能异常
- 字体使用 得意黑 (Smiley Sans)
- 指针尺寸调整
- 取消得意黑 (Smiley Sans), 风格不匹配.
- 改用 Iosevka Custom + 思源黑体 (Source Han Sans CN)
- 改用 css 取代 extend_head.html
- theme-vars.css 修改 code block 颜色