为什么开始写日记？

就想弄一个可以记录学习or生活的，后续将这个网站作为我记录生活和学习笔记的地方，以后也可以在互联网上留下一些东西。 今天用gemini帮我使用 Markdown 和 Jekyll做了这么一个网站。 比起写 HTML，这种方式更简单！虽然是gemini写的，但是流程还是要记录一下的。

搭建流程

一：搭建一个静态网站

参考：使用Github做一个完全免费的个人网站

二：使用 Jekyll 自动生成笔记

搭建 Jekyll 基础结构
  1. 创建配置文件 _config.yml 这个文件是网站的“大脑”，决定了网站的名字和使用的皮肤。
    • 在你的仓库根目录下新建文件，命名为 _config.yml。
    • 输入以下内容并保存：
      title: Refuse Wrong 的随笔
  description: 拒绝平庸，记录成长的每一天。
  remote_theme: jekyll/minima
  plugins:
    - jekyll-feed
    - jekyll-seo-tag
  2. 修改首页 index.html 为了让 Jekyll 自动列出你的笔记，我们需要把首页改造成一个“自动提取器”。
    • 清空你之前的 index.html，改为以下代码： 
       ---
 layout: home
 ---
写 Markdown 内容
  1. 新建 _posts 文件夹
    • 在仓库根目录创建一个新文件夹，命名为 _posts（必须带下划线，且拼写准确）。
  2. 创建笔记文件
    • 在 _posts 文件夹里新建文件。
    • 文件名格式要求极严： 年-月-日-标题.md。
    • 例如：2026-01-15-hello-world.md
  3. 编写内容

三：加入评论系统（可选）

开启仓库的 Discussions 功能
  1. 在你的 GitHub 仓库页面，点击顶部的 Settings（设置）。
  2. 在左侧菜单选 General。
  3. 向下滑动找到 Features 区块，勾选 Discussions。

    你会发现仓库顶部多了一个“Discussions”选项卡，这说明开启成功。

安装并配置 Giscus 权限
  1. 访问 giscus.app/zh-CN。
  2. 在“仓库”配置栏，输入你的仓库全名：xxx/xxx.github.io
    • 该仓库是公开的，否则访客将无法查看 discussion。
    • 确保 Discussions 功能已在你的仓库中启用。
    • 需要安装 Giscus 到该仓库，点击链接按提示授权即可（选“Only select repositories”并选中你的这个仓库）。
  3. 配置选项（推荐）：
    • 页面 ↔️ discussion 映射关系：选择“Discussion 的标题包含页面的 pathname”。
    • Discussion 分类：announcements
    • 特性：勾选“将评论框放在评论上方”、“懒加载评论”
  4. 获取代码： 配置完成后，页面下方会自动生成一段类似下面的 <script> 代码，复制它。
将评论框嵌入 Jekyll 笔记页面

由于现在使用的是 Jekyll 自动生成的 minima 主题，我们需要通过创建一个“补丁文件”来把评论框塞进去。

  1. 在你的仓库根目录新建文件夹：_layouts（必须带下划线）。
  2. 在 _layouts 文件夹内新建一个文件，命名为 post.html。
  3. 在这个文件中粘贴以下代码（注意替换脚本部分为你刚才在官网生成的）：
---
layout: default
---
*** 原始部分 ***
<div style="margin-top: 40px; padding-top: 20px; border-top: 1px solid #eee;">
   <h3 style="margin-bottom: 20px;">💬 评论互动</h3>
   *** Giscus生成部分 ***
   <script src="https://giscus.app/client.js"
            data-repo="[ENTER REPO HERE]"
            data-repo-id="[ENTER REPO ID HERE]"
            data-category="[ENTER CATEGORY NAME HERE]"
            data-category-id="[ENTER CATEGORY ID HERE]"
            data-mapping="pathname"
            data-strict="0"
            data-reactions-enabled="1"
            data-emit-metadata="0"
            data-input-position="top"
            data-theme="light"
            data-lang="zh-CN"
            data-loading="lazy"
            crossorigin="anonymous"
            async>
   </script>
</div>
</div>

优化布局风格（可选）

这部分还在探索中

今日感悟

  • 坚持学习很难，但成果很甜。
  • 代码不需要完美，但逻辑必须清晰。

    只要开始，就不算晚。

Gemini的感悟确实很有道理，还得学啊！