Skip to content

Commit 59e407c

Browse files
committed
docs : add pr readme
1 parent b0d31cb commit 59e407c

File tree

5 files changed

+55
-3
lines changed

5 files changed

+55
-3
lines changed

README.md

+49
Original file line numberDiff line numberDiff line change
@@ -1 +1,50 @@
1+
# Irobot-algorithm's Blog
12

3+
## 1. 提交流程概要
4+
5+
1. fork 本仓库
6+
2.**符合命名和头部信息的规范的md文件**(例如`2023-12-15-single-step.md`) 提交到fork仓库的_posts目录下
7+
3. 提pr, 审核通过后自动编译成功后即可
8+
9+
## 2. 博客规范
10+
11+
### 2.1 markdown文件命名
12+
13+
markdown文件采用 `<year>-<month>-<date>-<name-of-Blog>` 的方式命名,放置于 `_posts/` 目录下,其中 `<name-of-Blog>` **不允许有空格,用 `-` 代替**。请尽量简洁并符合英文语法。此名称中的 `<year>-<month>-<date>` 仅用于区别不同的博客,方便识别,**分别用 4 、 2 、 2 个数字表示**,如 `2000-01-01`
14+
15+
### 2.2 markdown头部规范
16+
17+
每篇博客开始都需要配置 config 选项,**必须放置于博客最开始,采用 yaml 语法**。一个通用的头部如下,创建博客可以复制以下代码使用:
18+
19+
```yaml
20+
---
21+
title: 通信教程
22+
date: 2023-12-15
23+
categories: [Edu] # 分类,规范看下文
24+
tags: [通信] # 标签,规范看下文
25+
pin: false # 是否置顶,请设为 false ,仅我可以选择置顶与否
26+
math: false # 是否使用 mathjax 公示,不使用请关闭,加速网页加载
27+
mermaid: false # 是否使用 mermaid 绘图(https://github.com/mermaid-js/mermaid),不使用请关闭,加速网页加载
28+
---
29+
```
30+
31+
32+
### 2.3 图片和其他小附件
33+
34+
每篇博客 `<name-of-blog>.md` 所使用的图片和其他附件放置于 `assets/imgs` 目录下的同名目录 `<name-of-blog>` 下。这样规定的原因是为了便于管理和更新。
35+
36+
最终提交的图片的路径**不是本地的相对路径**,而是 GitHub的RAW上的路径。在最后上传时,应将博客中**所有的图片路径**改为` https://raw.githubusercontent.com/IRobot-Algorithm/irobot-algorithm.github.io/main/`+ `assets/imgs/<name-of-blog>/xx.img`
37+
> 例如你的**相对路径**`assets/imgs/2023-12-15-comunitcation/candump`,那么最后提交时应该改成`https://raw.githubusercontent.com/IRobot-Algorithm/irobot-algorithm.github.io/main/assets/imgs/2023-12-15-comunitcation/candump`
38+
39+
40+
### 2.4 分类规范
41+
42+
` TODO `
43+
44+
### 2.5 标签规范
45+
46+
` TODO `
47+
48+
## Acknowledge
49+
50+
网站使用了[chirpy-starter](https://github.com/cotes2020/chirpy-starter)的模板, 规范部分参考了[Harry-hhj](https://github.com/Harry-hhj/Harry-hhj.github.io/tree/master)的规范

_config.yml

+1-1
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ social:
3939
links:
4040
# The first element serves as the copyright owner's link
4141
# - https://twitter.com/username # change to your twitter homepage
42-
- https://github.com/username # change to your github homepage
42+
- https://github.com/IRobot-Algorithm # change to your github homepage
4343
# Uncomment below to add more social links
4444
# - https://www.facebook.com/username
4545
# - https://www.linkedin.com/in/username

_posts/2023-12-15-comunitcation.md

+5-2
Original file line numberDiff line numberDiff line change
@@ -4,6 +4,7 @@ date: 2023-12-15
44
categories: [Edu]
55
tags: [通信]
66
---
7+
78
| 版本 | 日期 | 人员 | 修改记录 |
89
| ---- | ---------- | ------------------------- | ------------------------------------ |
910
| v1.2 | 2023-01-04 | 郑桂勇, [email protected] | 修复部分格式问题,以及串口部分的问题 |
@@ -16,19 +17,21 @@ tags: [通信]
1617

1718
通信部分在[自瞄仓库](https://github.com/IRobot-Algorithm/Infantry)的如下目录下
1819

19-
```
20+
```shell
2021
src/Algorithm/src/Transporter/can/can.cpp
2122
src/rmos_transporter/src/can_comm_node.cpp
2223
```
2324

2425
### 学会用命令行或脚本使能can
2526

26-
```
27+
```shell
28+
2729
sudo ip link set can0 type can bitrate 1000000
2830
sudo ifconfig can0 up
2931
# or
3032
echo "nuc" | sudo -S ip link set can0 type can bitrate 1000000
3133
echo "nuc" | sudo -S ifconfig can0 up
34+
3235
```
3336

3437
### 学会在命令行使用candump can0来查看can线上的数据
-103 KB
Binary file not shown.
-116 KB
Binary file not shown.

0 commit comments

Comments
 (0)