Harry's personal Blog

网站主页：点击这里访问。

博客正在搭建中。缺少：评论、美化。

一、环境安装

安装完环境后（参考此篇教程），在本地试运行查看 post 效果，确认无误后提交 PR ：

bundle
bundle exec jekyll s

二、博客规范

博客采用 Markdown 语言编写，支持所有 Markdown 语法，允许插入 html 语言。

1）博客命名

博客名称采用 <year>-<month>-<date>-<name-of-Blog> 的方式命名，放置于 _posts/ 目录下，其中 <name-of-Blog> 不允许有空格，用 - 代替。请尽量简洁并符合英文语法。此名称中的 <year>-<month>-<date> 仅用于区别不同的博客，方便识别，分别用 4 、 2 、 2 个数字表示，如 2000-01-01 。

2）博客头部

每篇博客开始都需要配置 config 选项，必须放置于博客最开始，采用 yaml 语法。一个通用的头部如下，创建博客可以复制以下代码使用：

---
title: 
author: 
date: 2000-01-01 00:00:00 +0800
categories: []
tags: []
math: false
mermaid: false
toc: true
pin: false
image:
  src: 
  width: 
  height: 

---

说明如下：

---
title: PyTorch Basics		# 博客标题，可以与 md 命名不同，但应当相似，可以使用空格
author: Harry-hhj		# 博客作者，可以写下你的 Github 用户名
date: 2021-08-29 11:12:00 +0800		# 时戳，用于网页排列博客的真正时间戳，指明时区
categories: [Tutorial, PyTorch]		# 分类，见下分类规范
tags: [getting started, computer science, pytorch]		# 标签，见下标签规范
math: false		# 是否使用 mathjax 公示，不使用请关闭，加速网页加载
mermaid: false		# 是否使用 mermaid 绘图（https://github.com/mermaid-js/mermaid），不使用请关闭，加速网页加载
toc: true  # 默认，开启右侧网页导航栏与否
pin: false		# 是否置顶，请设为 false ，仅我可以选择置顶与否
image:		# 放置于博客标题下的图片
  src: https://github.com/Harry-hhj/Harry-hhj.github.io/blob/master/_posts/2021-08-29-Pytorch-Basics.assets/pytorch.jpeg?raw=true
  width: 480
  height: 230

---

3）图片和小附件

每篇博客 <name-of-blog>.md 所使用的图片和小附件放置于 _posts 目录下的同名目录 <name-of-blog>.assets 下。这样规定的原因是为了便于管理和更新。

最终提交的图片的路径不是本地的相对路径，而是 GitHub 上的预览路径。在最后上传时，应将博客中所有的图片路径改为 https://github.com/Harry-hhj/Harry-hhj.github.io/blob/master/_posts/<name-of-blog>.assets/<name-of-image>?raw=true ，请不要遗漏 ?raw=true 。（如果不明白可以使用相对路径并在博客中注明，我来修改）

图片允许添加说明文字，格式如下：

![img-description](/path/to/image)
_Image Caption_

为了避免图片加载造成网页内容位移影响体验，可以指定图片大小预留加载空间，例如：

![Desktop View](/assets/img/sample/mockup.png){: width="700" height="400" }

可以指定图片的位置，默认是居中，此时不再允许添加说明文字：

![Desktop View](/assets/img/sample/mockup.png){: .normal }
![Desktop View](/assets/img/sample/mockup.png){: .left }
![Desktop View](/assets/img/sample/mockup.png){: .right }

4）大附件

大型附件（如超过 100 M）请使用其他平台传输，并给出链接和密码，如可使用百度网盘或阿里云盘等。请确保链接永久有效且来源可靠。（我可能会定期下载并更新为我的链接来确保文件不会丢失）

5）分类规范

分类必须使用首字母大写，允许使用空格，最多为两级。

目前已经有的一级为（可以扩充更新，请使用 PR 或 Issue ）：

• Essay：随笔，用于分享日常生活或人生感悟或文学创作等，内容不限
• Tutorial：教程，用于分享技术，二级类别一般用英语专业名词命名，分类前先查看已有分类
• Question：问答类教程

6）标签规范

标签统一采用小写，不允许大写。

目前已有的标签规范有：

• getting started ：任何入门级教程或知识分享型教程【1】
• tools ：任何有关工具、软件、语言等如何使用的教程【1】
• skills ：关于使用技巧，主要在于提高使用效率而非讲解如何使用【1】
• questions ：问题回答型文章【1】
• diary ：日记、随笔【1】
• robomaster ：与 RoboMaster 赛事有关的文章【1】
• computer science ：和计算机科学技术相关的任何文章【2】
• infomation security ：和信息安全有关的任何文章【2】
• 一般技术文章都会带有与其核心技术点相关的英语专业名词【3】

一般标签数量小于等于 3 个为宜，上面同一 【x】表示这些标签之间一般相互冲突。

撰写博客不易，觉得本博客项目不错的请点个 star :) ~

---

作者：Harry-hhj

Github主页：https://github.com/Harry-hhj