jekyll

Slugify问题:「digital_mind|电子大脑」标签无法访问

February 9, 2026

摘要 Jekyll Debug经验:Collections功能的逻辑学习 AI使用经验 不要一来就使用agent,让AI开始改代码。先使用ask,定位问题在哪。 因为,Bug不一定需要很大的代码量,最重要的找到问题所在。 问题 点击首页、博客正文页的标签,显示无法访问 问题原因 博客正文页的标签链接,在_layouts/post.html中: 标签页是基于_tags_page/[tag_name|标签名].md​文件,渲染到_site/tag/[tag_name-标签名]​,注意文件名会被slugify处理。 然后发现: 在页面中,使用``​,digital_mind|电子大脑​会变成digital-mind-电子大脑​,但是_tag_page/digital_mind|电子大脑.md​文件编译到_site/tag/​下变成了digital_mind-电子大脑​,导致http://127.0.0.1:4000/tag/digital-mind-电子大脑​无法访问到_site/tag/digital_mind-电子大脑 ...

bundle exec与直接运行的差异

January 6, 2026

摘要 以jekyll serve​为例,它默认使用的系统的相关包和环境。而bundle exec Jekyll serve​是使用Gemfile.lock里申明的包的版本来运行。 当系统的包的版本与Gemfile.lock​中不一致时,特别是系统的版本比Gemfile.lock里的版本高时,会报错。 所以,推荐使用bundle exec Jekyll serve 案例: 通过bundle install生成的Gemfile.lock bigdecimal (3.3.1),运行jekyll serve提示现在bigdecimal 版本为4.0.1,能怎么提升bundle install 生成bigdecimal的版本吗? AI答案: 通过 bundle update​ 后,Gemfile.lock 中的 bigdecimal​ 仍然是 3.3.1,因为它是间接依赖(通过

已有项目创建Github Pages

January 4, 2026

思路 通过jekyll new myblog生成必要的文件,再将这些文件Copy到现有项目的指定分支下。 然后配置Github仓库的pages设置、项目CNAME文件、域名供应商的解析。 Setup步骤 一、新建jekyll博客必要文件 ​jekyll new myblog 如果卡住了,直接Ctrl+c​,进入目录,运行bundle install安装必要的Ruby包。 运行Jekyll serve,验证是否正常编译 访问localhost:4000验证可正常访问 二、将文件Copy到对应项目下 三、Github仓库配置 配置Github Actions 启用项目的 GitHub Pages:进入你的项目仓库,点击 Settings 选项卡。向下滚动找到 Pages 部分,在 Source 下选择一个分支(通常是...

Debug Jekyll & Github_Page

January 16, 2025

摘要 新发的文章总是没有在博客显示 问题:新发的文章总是没有在博客显示 原因:Github默认时区是美国西部,比中国差不多晚一天,所以发布的文章都成了“Has a Future Date” 解决办法:在_config.yml文件中,增加Timezone的设置 找到原因过程: 发现Github Action ​ ​ ​ 研究Github Action 下载编译完的文件,发现没有最新的文章

Jekyll博客标签页及Liquid经验

November 17, 2016

博客的标签页基本是一个不可或缺的功能,它能更灵活地将博客按多类别体系组织起来。 jekyll会存储文章的标签信息,但是不会生成以标签组织的静态页面,所以需要利用Collection机制来生成。 Tag Cloud 页面 所有标签展示页 --- layout: page permalink: /tags/ --- <h1>Tag Cloud</h1> <div class="tag-meta"> {% assign tags = site.tags | sort %} {% for tag in tags %} <li> <a

Jekyll入门

May 12, 2016

学习索引 博客编写 使用Category分类 分页实现 Time-Line List 下面是倒序学习过程 已入门 liquid语言 & link of tags 独立域名 显示归类

Ruby环境及Jekyll安装

May 11, 2016

选择Jekyll,因为GitHub Page直接支持Jekyll,不用像Hexo要提前编译成HTML Jekyll 是基于Ruby的,所以需要先安装相关环境,教程见官方文档,Google和百度 以下是几个需要了解的概念及关系 RVM 对于Debian系的Linux,自带Ruby版本有问题,需要通过RVM管理Ruby版本 其他环境也可以用RVM管理Ruby,与系统独立开 RVM中文安装教程 RVM官网 BUG rvm is not a function solution: bash --login GEM *.gem *.gem 是Ruby包文件扩展名。 gem gem管理工具,通过gem install {pkgName} 安装gem包,在安装ruby时已经一同安装。 官网...