约 56 字
预计阅读 1 分钟
博客制作尝试(二)

摸索修改的门路 #

在主题之上修改的原则是什么: 不要在themes文件里面改,在根目录下改,根目录的修改会覆盖主题里面的

  1. layouts: 存放用来渲染content目录下面内容的模版文件,模版.html格式结尾,layouts可以同时存储在项目目录和themes/layouts目录下
    • _default: 是layouts的子文件,应该是用于默认配置。 这里有baseof.html文件用来管理通用模板,它里面有
 ""{{ block "main" . }}{{ end }}""

:这块会提取_makeup里面的home、list、single来进行替代,从而使得文章有了主页,文章和列表这些不同的展示页面。

  • partials:最主要的模板配置文件,是在列表和页面模板中使用的更小的上下文感知组件, 用于复用代码和内容的一种机制.
  1. static: 用来存储静态资源,最常见应该是图片,目前没有子文件的命名要求。如果说你的css、js文件不用本地编译,希望通过浏览器进行编译那么就放在static中,否则放入assets中。
  2. hugo.toml: 相当于总控,很多配置在这个地方设置,包括如果你之后的css和js文件有些也可以配置到这里设置。(我没有这么干,我自己看懂自己魔改的js和css就行,不追求这种简洁化了)
  3. 页面绑定:
  • index.md 主要用于普通页面,通常作为目录的默认页面,该文件内的任何文件都被视为index.md的资源,即使创建一个新的 Markdown 文件,这个新的文件既不会被渲染也不会被打包,因为它不被视为文章 (页面)
  • _index.md 是hugo的一个预设,声明当前文件夹是一个 Branch Bundle,允许在其下嵌套集合和页面。
  1. assets文件:存放所有静态资源的地方。这些资源可以是css、js、图片等,通常用于网站的前端展示。Hugo编译的过程中会对assets中的文件进行编译处理。 引用方式利用{{ “path/to/your/file” | resources.Get }} 可以添加压缩方式,指纹什么的,我的建议是能不添加不添加,因为很有可能报错😭,静态网站也不需要什么安全性保证。

这是我折腾中间随便写的,应该只有我自己能看懂,也不想删除掉就留着做个纪念。下一篇博客已经列出解决某些部署遇到问题的解决方案。

内联公式mathjax用$, 块用\$$ , 应该不是我想的两者冲突,而是因为编译完成之后,刷新当作拉取界面又编译了一次。 (preload的锅?不是 headplugin?不是)暂且不表。 (这个地方解决了,应该是按照hugo的官方指导,引入的mathjax这个在进入新页面的时候没有正常加载,由于这个math.html最终是被head处引用,所以用swup的SwupHeadPlugin插件将问题解决了,不对这里是重复渲染的问题没有解决。 woc,按照waline的同款方法解决了,爽的爆炸)

手贱,给waline加上类比于恐咖兵糖大佬的关于开发和生产环境的引用有个fingerprint,导致本地部署没问题,netlilfy引用的时候waline库出现bug无法正常引用,删除掉后恢复正常,我真是个傻逼。

尼玛同步评论系统的黑白问题太简单了吧,只要把dark后面设置成 ‘.dark’ 因为我的css选择器没有前缀名,设置成.dark就行了。 (瞅了一眼waline源代码)

博客制作尝试(二)
https://tsbprogress.xin/posts/blogmake2/
作者
Devil
发布于
2025-02-14
  Comment