# Yulv-git
**Repository Path**: Yulv-git/yulv-git
## Basic Information
- **Project Name**: Yulv-git
- **Description**: No description available
- **Primary Language**: HTML
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://Yulv-git.gitee.io
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-05-01
- **Last Updated**: 2022-05-03
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
Blog on GitHub/Gitee Pages using Jekyll
使用Jekyll在GitHub/Gitee页面上写博客。
---
- [1. 致谢](#1-致谢)
- [2. 创建模板文件](#2-创建模板文件)
- [3. 创建文章](#3-创建文章)
- [4. 创建首页](#4-创建首页)
- [5. 发布blog](#5-发布blog)
---
# 1. 致谢
本项目基于[搭建一个免费的，无限流量的Blog----github Pages和Jekyll入门](https://www.ruanyifeng.com/blog/2012/08/blogging_with_jekyll.html)进行实践和整理。
# 2. 创建模板文件
在项目根目录下，创建`_layouts`目录，用于存放模板文件，其具体内容见[default.html](./_layouts/default.html)。
``` html
{{ page.title }}
{{ content }}
```
`default.html`是Blog的默认模板。Jekyll使用[Liquid模板语言](https://github.com/shopify/liquid/wiki/liquid-for-designers)，`{{ page.title }}`表示文章标题，`{{ content }}`表示文章内容,更多模板变量请参考[官方文档](https://github.com/mojombo/jekyll/wiki/Template-Data)。
# 3. 创建文章
在项目根目录下，创建`_posts`目录，用于存放blog文章，如[2022-04-28-hello-world.html](./_posts/2022-04-28-hello-world.html)。
``` html
---
layout: default
title: 您好，世界
---
{{ page.title }}
Hello, World! I'm Yulv. See Yulv-git.github.io for more details.
{{ page.date | date_to_string }}
```
- 文件名必须为`年-月-日-文章标题.后缀名`的格式。后缀名有为html、md等。
- 每篇文章的头部，必须有设置元数据的yaml文件头。它用三根短划线`---`，标记开始和结束，里面每一行设置一种元数据。`layout:default`，表示该文章的模板使用`_layouts`目录下的`default.html`；`title: 你好，世界`，表示该文章的标题是`你好，世界`，如果不设置这个值，默认使用嵌入文件名的标题，即`hello world`。
- `{{ page.title }}`就是文件头中设置的`你好，世界`，`{{ page.date }}`则是嵌入文件名的日期（也可在文件头重新定义date变量），`| date_to_string`表示将page.date变量转化成人类可读的格式。
# 4. 创建首页
创建index.html文件，具体内容见[index.html](./index.html)。
``` html
---
layout: default
title: 我的Blog
---
{{ page.title }}
最新文章
{% for post in site.posts %}
-
{{ post.date | date_to_string }} {{ post.title }}
{% endfor %}
```
`{% for post in site.posts %}`，表示对所有帖子进行遍历。
Liquid模板语言规定，`输出内容使用两层大括号`，`单纯的命令使用一层大括号`。
# 5. 发布blog
``` bash
git stage .
git commit -m "提交的描述"
git push origin master
```
注意，Gitee Pages不会像GitHub Pages那样会在commit后自动部署，需要手动操作来启动和更新Pages（Gitee项目主页上方的工具栏，下拉“服务”菜单，点击“Gitee Pages”，然后按提示进行操作即可）。
发布成功后，可在 [yulv-git.gitee.io](https://yulv-git.gitee.io) 网页上看到blog。(`yulv-git`换成您的GitHub用户名。)