文章

Git拉取仓库文件

Git拉取仓库文件

太好了!您已经用 Chirpy Starter 模板成功搭建了博客。现在我来教您如何在线写文章和发布。

📝 在线写文章的几种方法

方法 1:通过 GitHub 网页直接写文章(最简单)

  1. 进入您的 GitHub 仓库 打开您创建的 Chirpy 博客仓库页面

  2. 进入 _posts 文件夹 点击进入 _posts 目录

  3. 创建新文件
    • 点击 “Add file” → “Create new file”
    • 文件名格式:YYYY-MM-DD-文章标题.md 例如:2024-01-15-my-first-post.md
  4. 编写文章内容
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    
    ---
    title: "您的文章标题"
    date: 2024-01-15 14:30:00 +0800
    categories: [分类1, 分类2]
    tags: [标签1, 标签2, 标签3] 
    ---
    
    <!-- 这里是您的文章内容 -->
    
    ## 二级标题
    
    这是段落内容。
    
    - 列表项1
    - 列表项2
    
    ```代码块```
    
  5. 提交更改
    • 滚动到页面底部
    • 填写提交信息,如 “Add new post: 文章标题”
    • 点击 “Commit new file”

方法 2:本地编辑后推送到 GitHub

  1. 克隆仓库到本地
    1
    2
    
    git clone https://github.com/您的用户名/您的仓库名.git
    cd 您的仓库名
    
  2. 创建新文章
    1
    2
    
    # 在 _posts 目录创建新文件
    notepad _posts/2024-01-15-文章标题.md
    
  3. 使用模板内容
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    
    ---
    title: "您的文章标题"
    date: 2024-01-15 14:30:00 +0800
    categories: [分类]
    tags: [标签1, 标签2]
    ---
    
    文章内容从这里开始...
    
    ## 章节标题
    
    正文内容。
    
  4. 提交并推送
    1
    2
    3
    
    git add _posts/2024-01-15-文章标题.md
    git commit -m "添加新文章:文章标题"
    git push origin main
    

方法 3:使用 GitHub Desktop(图形界面)

  1. 下载安装 GitHub Desktop
  2. 克隆您的仓库
  3. 在本地用喜欢的编辑器(VS Code、Typora等)写文章
  4. 通过 GitHub Desktop 提交和推送

🎨 文章 Front Matter 详解

每篇文章开头的元数据部分:

1
2
3
4
5
6
7
8
9
10
---
title: "您的文章标题"          # 文章标题
date: 2024-01-15 14:30:00 +0800  # 发布时间
categories: [技术, 教程]        # 分类(最多2个)
tags: [Jekyll, GitHub, 博客]    # 标签(多个)
math: true                    # 是否启用数学公式
mermaid: true                 # 是否启用流程图
image: /path/to/image.jpg     # 文章封面图
pin: true                     # 是否置顶
---

🌐 查看发布效果

  1. 自动部署:GitHub Pages 会自动部署您的更改
  2. 访问您的博客:打开 https://您的用户名.github.io/仓库名
  3. 等待几分钟:部署通常需要 1-5 分钟

💡 实用技巧

1. 使用 Markdown 语法

1
2
3
4
5
6
7
8
9
10
11
12
13
# 一级标题
## 二级标题

**粗体** *斜体* `代码`

[链接文字](https://example.com)

![图片描述](/path/to/image.jpg)

- 列表项1
- 列表项2

> 引用文字

2. 本地预览(可选)

1
2
3
4
# 在本地运行测试
bundle install
bundle exec jekyll serve
# 然后在浏览器打开 http://localhost:4000

3. 文章组织建议

  • 按年份分类:_posts/2024/01-15-文章标题.md
  • 使用有意义的文件名
  • 为每篇文章添加合适的标签和分类

🚀 立即开始

现在就去您的 GitHub 仓库,点击 _posts 文件夹,然后点击 “Add file” → “Create new file” 开始写您的第一篇文章吧!

您的博客会在每次提交后自动更新,通常几分钟后就能看到新文章上线了。

本文由作者按照 CC BY 4.0 进行授权

© 黄泽明. 保留部分权利。

本站总访问量 加载中...

本站总访客数 加载中...

本站采用 Jekyll 主题 Chirpy