快乐的碎片

切换主题

第二章 基础配置 ​

字数
455 字
阅读时间
2 分钟

第三步：本地自定义与内容管理 ​

  1. 基础配置修改

    • 编辑_config.yml文件，更新以下关键字段：
      yaml
      title: 你的博客名称
description: 博客简介
url: "https://你的用户名.github.io"  # 必须与仓库名一致
github_username: 你的GitHub账号
disqus_username:  # 如需评论系统，注册Disqus后填写

  2. 添加文章

    • 在_posts目录下新建Markdown文件，命名格式为YYYY-MM-DD-标题.md，文件头部需包含YAML元数据：
      markdown
      ---
layout: post
title: "文章标题"
subtitle: "副标题"
date: 2025-06-03
author: "你的名字"
header-img: "img/post-bg.jpg"  # 标题背景图路径
catalog: true  # 启用分类
tags:
  - 标签1
  - 标签2
---

第四步：高级功能配置（可选） ​

  1. 自定义域名

    • 在仓库根目录创建CNAME文件（全大写），内容为你的域名（如blog.example.com）。
    • 到域名服务商（如阿里云、DNSPod）添加DNS记录：
      • CNAME记录：www → 你的用户名.github.io
      • A记录：@ → GitHub Pages的IP（如185.199.108.153）。

  2. HTTPS强制跳转

    • 在GitHub Pages设置的Enforce HTTPS选项打勾，自动启用SSL证书。

  3. 数据分析集成

    • 在_config.yml中添加Google Analytics的跟踪ID：
      yaml
      ga_tracking_id: UA-XXXXX-X

常见问题与解决方案 ​

  • 构建失败：检查.github/workflows下的日志，常见原因是_config.yml语法错误或依赖缺失。
  • 域名不生效：DNS变更可能需要数小时传播，使用dig +nostats www.example.com验证解析。
  • 本地预览：安装Jekyll后运行bundle exec jekyll serve，实时调试。

贡献者 ​

The avatar of contributor named as Qiu"一叶知秋"Ye Qiu"一叶知秋"Ye

文件历史 ​