diff --git a/README.md b/README.md
index 9f8dc0a..bedb393 100644
--- a/README.md
+++ b/README.md
@@ -2,16 +2,6 @@
## 1. 项目开发
-安装 Git,前往 [Git 官网](https://git-scm.com/downloads)下载安装。
-
-安装 Node,需要有 Node16 及以上的版本,建议安装 **Node18**,你可以前往 [Node 官网](https://nodejs.org)下载安装。
-
-克隆项目:
-
-```sh
-git clone https://github.com/NJTUSTAS/njtustas.github.io.git
-```
-
开发项目:
```sh
@@ -20,40 +10,8 @@ npm start
启动后浏览器会自动跳转至[http://localhost:3000](http://localhost:3000)。
-## 2. 注意事项
-
-### 2.1 前提和基础
-
-首先你需要有使用 Git、Github 的经验,会写 Markdown。
-
-另外,本项目使用的文档框架是[Docusaurus](https://docusaurus.io/),也是由 Facebook 领导开发的一个开源项目,底层使用的是 React 和 Webpack,开发前建议先阅读一下他们的文档。如果你要开发独立的页面,需要了解 React 和 Typescript;如果只是写文档和文章,只需要知道这个框架的结构,会写 Markdown 就可以了。
-
-### 2.2 Mardkown 规范
-
-**安装插件**
-
-写 Markdown 文档或者文章的时候,建议安装这两个插件以保证格式的统一性:
-
-![markdown-plugin](./images/markdown-plugin.png)
-
-**内容规范**
-
-书写的内容请保证条理性和严谨性,书写的规范请参考已有的文章。
-
-**压缩图片**
-
-在 Markdown 中使用的图片最好先压缩再使用,图片不要超过 1M,建议在 **500K**左右,**越小越好**。你可以使用下面这个免费的在线压缩工具:
-
-- [https://redketchup.io/image-compressor](https://redketchup.io/image-compressor)
-
-### 2.3 格式化代码
-
-提交前请先格式化代码再提交:
-
-```
-npm run format
-```
+更多详细内容请参考[网站文档](https://njtustas.github.io/docs/intro)的说明。
-## 3. 访问链接
+## 2. 访问链接
- [https://njtustas.github.io](https://njtustas.github.io)
diff --git a/blog/stas-pc-maintenance-history.md b/blog/stas-pc-maintenance-history.md
index 5a8a969..3b5699b 100644
--- a/blog/stas-pc-maintenance-history.md
+++ b/blog/stas-pc-maintenance-history.md
@@ -60,7 +60,7 @@ authors:
-作者:学姐朱逸云
时间:2021-2022 第一学年
+作者:朱逸云学姐
时间:2021-2022 第一学年
---
@@ -70,7 +70,7 @@ authors:
-作者:学姐朱逸云
时间:2022-2023 第一学年
+作者:朱逸云学姐
时间:2022-2023 第一学年
---
@@ -78,6 +78,6 @@ authors:
-作者:学姐朱逸云
时间:2022-2023 第二学年
+作者:朱逸云学姐
时间:2022-2023 第二学年
---
diff --git a/config/footer.js b/config/footer.js
new file mode 100644
index 0000000..2b7817a
--- /dev/null
+++ b/config/footer.js
@@ -0,0 +1,44 @@
+const footer = [
+ {
+ title: "文档",
+ items: [
+ {
+ label: "文章动态",
+ to: "/blog"
+ },
+
+ {
+ label: "电子组文档",
+ to: "/docs/electronics"
+ }
+ ]
+ },
+ {
+ title: "资源",
+ items: [
+ {
+ label: "南工OJ",
+ href: "https://acm.online.njtech.edu.cn"
+ },
+ {
+ label: "值班笔记",
+ href: "https://punch.mraddict.top"
+ }
+ ]
+ },
+ {
+ title: "友链",
+ items: [
+ {
+ label: "远景实验室",
+ href: "https://www.vistalab.top"
+ },
+ {
+ label: "Mars工作室",
+ href: "https://studio.online.njtech.edu.cn"
+ }
+ ]
+ }
+];
+
+module.exports = footer;
diff --git a/config/sidebar/electronics.js b/config/sidebar/electronics.js
new file mode 100644
index 0000000..b8cacb8
--- /dev/null
+++ b/config/sidebar/electronics.js
@@ -0,0 +1,574 @@
+const electronics = [
+ {
+ type: "category",
+ label: "电子组文档",
+ collapsed: true,
+ items: [
+ {
+ type: "doc",
+ id: "electronics/intro",
+ label: "说明"
+ },
+ {
+ type: "category",
+ label: "Arduino",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/arduino/intro",
+ label: "Arduino简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/arduino/chapter1",
+ label: "Arduino和Arduino IDE"
+ },
+ {
+ type: "doc",
+ id: "electronics/arduino/chapter2",
+ label: "第一个程序Blink"
+ },
+ {
+ type: "doc",
+ id: "electronics/arduino/chapter3",
+ label: "使用按钮"
+ },
+ {
+ type: "doc",
+ id: "electronics/arduino/chapter4",
+ label: "中断Interrupt"
+ },
+ {
+ type: "doc",
+ id: "electronics/arduino/chapter5",
+ label: "定时器Timer"
+ },
+ {
+ type: "doc",
+ id: "electronics/arduino/chapter6",
+ label: "脉冲宽度调制PWM"
+ },
+ {
+ type: "doc",
+ id: "electronics/arduino/chapter7",
+ label: "模数转换ADC"
+ },
+ {
+ type: "doc",
+ id: "electronics/arduino/chapter8",
+ label: "串口通信UART"
+ },
+ {
+ type: "doc",
+ id: "electronics/arduino/chapter9",
+ label: "单片机的存储器和EEPROM"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "C语言",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/c-lang/intro",
+ label: "C语言简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter1",
+ label: "C语言基本语法"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter2",
+ label: "数据类型"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter3",
+ label: "变量和常量"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter4",
+ label: "运算符"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter5",
+ label: "条件判断if和switch"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter6",
+ label: "循环while和do/while"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter7",
+ label: "循环for"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter8",
+ label: "函数"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter9",
+ label: "函数的作用域规则"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter10",
+ label: "数组"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter11",
+ label: "多维数组"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter12",
+ label: "字符串"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter13",
+ label: "指针"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter14",
+ label: "指针的算数运算"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter15",
+ label: "指针和数组、函数"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter16",
+ label: "枚举(enum)"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter17",
+ label: "结构体(struct)"
+ },
+ {
+ type: "doc",
+ id: "electronics/c-lang/chapter18",
+ label: "共用体(union)"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "通信专题",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/communication/intro",
+ label: "通信专题"
+ },
+ {
+ type: "category",
+ label: "One-Wire",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/communication/serial/one-wire/intro",
+ label: "One-Wire简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/one-wire/chapter1",
+ label: "One-Wire通信原理"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/one-wire/chapter2",
+ label: "DHT11数据手册速览"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/one-wire/chapter3",
+ label: "代码逻辑分析"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/one-wire/chapter4",
+ label: "整合打包代码"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/one-wire/chapter5",
+ label: "总结和拓展"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "UART",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/communication/serial/uart/intro",
+ label: "UART简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/uart/chapter1",
+ label: "UART通信原理"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/uart/chapter2",
+ label: "HC-05数据手册速览"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/uart/chapter3",
+ label: "HC-05蓝牙的使用"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/uart/chapter4",
+ label: "总结和拓展"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "I2C",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/communication/serial/i2c/intro",
+ label: "I2C简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/i2c/chapter1",
+ label: "I2C通信原理"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/i2c/chapter2",
+ label: "DS3231数据手册速览"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/i2c/chapter3",
+ label: "代码逻辑分析"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/i2c/chapter4",
+ label: "整合打包代码"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/i2c/chapter5",
+ label: "总结和拓展"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "SPI",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/communication/serial/spi/intro",
+ label: "SPI简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/spi/chapter1",
+ label: "SPI通信原理"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/spi/chapter2",
+ label: "MPU9250数据手册速览"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/spi/chapter3",
+ label: "代码逻辑分析"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/spi/chapter4",
+ label: "整合打包代码"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/serial/spi/chapter5",
+ label: "总结和拓展"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "并行通信",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/communication/parallel/intro",
+ label: "并行通信简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/parallel/chapter1",
+ label: "并行通信原理"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/parallel/chapter2",
+ label: "LCD1602数据手册速览"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/parallel/chapter3",
+ label: "代码逻辑分析"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/parallel/chapter4",
+ label: "整合打包代码"
+ },
+ {
+ type: "doc",
+ id: "electronics/communication/parallel/chapter5",
+ label: "总结和拓展"
+ }
+ ]
+ }
+ ]
+ },
+
+ {
+ type: "category",
+ label: "项目制作",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/projects/intro",
+ label: "项目制作"
+ },
+ {
+ type: "category",
+ label: "NFC",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/projects/nfc/intro",
+ label: "办公室门禁历史"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/nfc/chapter1",
+ label: "初代门禁版本"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/nfc/chapter2",
+ label: "目前门禁版本"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/nfc/chapter3",
+ label: "未来的改进"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "LED-Board",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/projects/led-board/intro",
+ label: "LED Board简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/led-board/chapter1",
+ label: "制作步骤"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/led-board/chapter2",
+ label: "代码及使用"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/led-board/chapter3",
+ label: "总结和拓展"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "激光雕刻机",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/projects/cnc-engraver/intro",
+ label: "激光雕刻机简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/cnc-engraver/chapter1",
+ label: "什么是CNC"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/cnc-engraver/chapter2",
+ label: "雕刻机硬件搭建"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/cnc-engraver/chapter3",
+ label: "雕刻机控制软件"
+ },
+ {
+ type: "doc",
+ id: "electronics/projects/cnc-engraver/chapter4",
+ label: "总结和拓展"
+ }
+ ]
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "半小时入门",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/tutorial/intro",
+ label: "半小时入门"
+ },
+ {
+ type: "category",
+ label: "Git",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/tutorial/git/intro",
+ label: "Git简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/git/chapter1",
+ label: "集中式VS分布式"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/git/chapter2",
+ label: "Git的安装与配置"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/git/chapter3",
+ label: "Git的常用命令"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "EDA",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/tutorial/eda/intro",
+ label: "EDA入门简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/eda/chapter1",
+ label: "555计时器"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/eda/chapter2",
+ label: "绘制符号和封装"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/eda/chapter3",
+ label: "设计原理图"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/eda/chapter4",
+ label: "设计PCB"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "Markdown",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/tutorial/markdown/intro",
+ label: "Markdown简介"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/markdown/chapter1",
+ label: "Markdown语法(1)"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/markdown/chapter2",
+ label: "Markdown语法(2)"
+ }
+ ]
+ },
+ {
+ type: "category",
+ label: "前端基础",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/tutorial/web/intro",
+ label: "前端基础"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/web/chapter1",
+ label: "前端三语言"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/web/chapter2",
+ label: "HTML基础"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/web/chapter3",
+ label: "CSS基础"
+ },
+ {
+ type: "doc",
+ id: "electronics/tutorial/web/chapter4",
+ label: "自我介绍"
+ }
+ ]
+ }
+ ]
+ }
+ ]
+ }
+];
+
+module.exports = electronics;
diff --git a/docs/electronics/arduino/images/1-1.png b/docs/electronics/arduino/images/1-1.png
index 70640cf..5a80812 100644
Binary files a/docs/electronics/arduino/images/1-1.png and b/docs/electronics/arduino/images/1-1.png differ
diff --git a/docs/electronics/arduino/images/1-10.png b/docs/electronics/arduino/images/1-10.png
index a51b00e..2581ce9 100644
Binary files a/docs/electronics/arduino/images/1-10.png and b/docs/electronics/arduino/images/1-10.png differ
diff --git a/docs/electronics/arduino/images/1-11.png b/docs/electronics/arduino/images/1-11.png
index 9beb251..f53913e 100644
Binary files a/docs/electronics/arduino/images/1-11.png and b/docs/electronics/arduino/images/1-11.png differ
diff --git a/docs/electronics/arduino/images/1-12.png b/docs/electronics/arduino/images/1-12.png
index a77b68d..000e737 100644
Binary files a/docs/electronics/arduino/images/1-12.png and b/docs/electronics/arduino/images/1-12.png differ
diff --git a/docs/electronics/arduino/images/1-13.png b/docs/electronics/arduino/images/1-13.png
index 2e8aed0..c084048 100644
Binary files a/docs/electronics/arduino/images/1-13.png and b/docs/electronics/arduino/images/1-13.png differ
diff --git a/docs/electronics/arduino/images/1-14.png b/docs/electronics/arduino/images/1-14.png
index 9dfdeda..1bb6a8f 100644
Binary files a/docs/electronics/arduino/images/1-14.png and b/docs/electronics/arduino/images/1-14.png differ
diff --git a/docs/electronics/arduino/images/1-2.png b/docs/electronics/arduino/images/1-2.png
index 935e880..38fdea1 100644
Binary files a/docs/electronics/arduino/images/1-2.png and b/docs/electronics/arduino/images/1-2.png differ
diff --git a/docs/electronics/arduino/images/1-4.png b/docs/electronics/arduino/images/1-4.png
index c40ac2b..c6fa3a2 100644
Binary files a/docs/electronics/arduino/images/1-4.png and b/docs/electronics/arduino/images/1-4.png differ
diff --git a/docs/electronics/arduino/images/1-5.png b/docs/electronics/arduino/images/1-5.png
index 87ba471..200c2fa 100644
Binary files a/docs/electronics/arduino/images/1-5.png and b/docs/electronics/arduino/images/1-5.png differ
diff --git a/docs/electronics/arduino/images/1-6.png b/docs/electronics/arduino/images/1-6.png
index 858db7b..3b99da2 100644
Binary files a/docs/electronics/arduino/images/1-6.png and b/docs/electronics/arduino/images/1-6.png differ
diff --git a/docs/electronics/arduino/images/1-7.png b/docs/electronics/arduino/images/1-7.png
index a276b4f..758dab7 100644
Binary files a/docs/electronics/arduino/images/1-7.png and b/docs/electronics/arduino/images/1-7.png differ
diff --git a/docs/electronics/arduino/images/1-8.png b/docs/electronics/arduino/images/1-8.png
index 963a333..300366d 100644
Binary files a/docs/electronics/arduino/images/1-8.png and b/docs/electronics/arduino/images/1-8.png differ
diff --git a/docs/electronics/arduino/images/1-9.png b/docs/electronics/arduino/images/1-9.png
index e06f241..421c559 100644
Binary files a/docs/electronics/arduino/images/1-9.png and b/docs/electronics/arduino/images/1-9.png differ
diff --git a/docs/electronics/arduino/images/2-1.png b/docs/electronics/arduino/images/2-1.png
index 8924031..5fa8c34 100644
Binary files a/docs/electronics/arduino/images/2-1.png and b/docs/electronics/arduino/images/2-1.png differ
diff --git a/docs/electronics/arduino/images/3-1.png b/docs/electronics/arduino/images/3-1.png
index effa1af..00bc15e 100644
Binary files a/docs/electronics/arduino/images/3-1.png and b/docs/electronics/arduino/images/3-1.png differ
diff --git a/docs/electronics/arduino/images/3-2.png b/docs/electronics/arduino/images/3-2.png
index 10ae09f..432825b 100644
Binary files a/docs/electronics/arduino/images/3-2.png and b/docs/electronics/arduino/images/3-2.png differ
diff --git a/docs/electronics/arduino/images/3-3.png b/docs/electronics/arduino/images/3-3.png
index 1e7948c..e2af185 100644
Binary files a/docs/electronics/arduino/images/3-3.png and b/docs/electronics/arduino/images/3-3.png differ
diff --git a/docs/electronics/arduino/images/3-4.png b/docs/electronics/arduino/images/3-4.png
index 6441a3e..9941302 100644
Binary files a/docs/electronics/arduino/images/3-4.png and b/docs/electronics/arduino/images/3-4.png differ
diff --git a/docs/electronics/arduino/images/3-5.png b/docs/electronics/arduino/images/3-5.png
index 99d11a0..9f9d972 100644
Binary files a/docs/electronics/arduino/images/3-5.png and b/docs/electronics/arduino/images/3-5.png differ
diff --git a/docs/electronics/arduino/images/3-6.png b/docs/electronics/arduino/images/3-6.png
index 8357900..c662571 100644
Binary files a/docs/electronics/arduino/images/3-6.png and b/docs/electronics/arduino/images/3-6.png differ
diff --git a/docs/electronics/arduino/images/4-6.png b/docs/electronics/arduino/images/4-6.png
index c7be621..023b839 100644
Binary files a/docs/electronics/arduino/images/4-6.png and b/docs/electronics/arduino/images/4-6.png differ
diff --git a/docs/electronics/arduino/images/6-1.png b/docs/electronics/arduino/images/6-1.png
index 8157404..2cb2fda 100644
Binary files a/docs/electronics/arduino/images/6-1.png and b/docs/electronics/arduino/images/6-1.png differ
diff --git a/docs/electronics/arduino/images/9-1.png b/docs/electronics/arduino/images/9-1.png
index 6304007..3404276 100644
Binary files a/docs/electronics/arduino/images/9-1.png and b/docs/electronics/arduino/images/9-1.png differ
diff --git a/docs/electronics/arduino/images/9-2.png b/docs/electronics/arduino/images/9-2.png
index 1e8122f..04fb4d1 100644
Binary files a/docs/electronics/arduino/images/9-2.png and b/docs/electronics/arduino/images/9-2.png differ
diff --git a/docs/electronics/arduino/intro.md b/docs/electronics/arduino/intro.md
index 96ef928..21986ae 100644
--- a/docs/electronics/arduino/intro.md
+++ b/docs/electronics/arduino/intro.md
@@ -1,5 +1,6 @@
---
title: Arduino简介
+slug: /electronics/arduino
---
# Arduino 简介
diff --git a/docs/electronics/c-lang/images/10-1.png b/docs/electronics/c-lang/images/10-1.png
index 1cae95c..6e8dcc7 100644
Binary files a/docs/electronics/c-lang/images/10-1.png and b/docs/electronics/c-lang/images/10-1.png differ
diff --git a/docs/electronics/c-lang/images/10-2.png b/docs/electronics/c-lang/images/10-2.png
index 5a05886..d1f1bcb 100644
Binary files a/docs/electronics/c-lang/images/10-2.png and b/docs/electronics/c-lang/images/10-2.png differ
diff --git a/docs/electronics/c-lang/images/10-3.png b/docs/electronics/c-lang/images/10-3.png
index ad061b4..c93ed0c 100644
Binary files a/docs/electronics/c-lang/images/10-3.png and b/docs/electronics/c-lang/images/10-3.png differ
diff --git a/docs/electronics/c-lang/images/10-4.png b/docs/electronics/c-lang/images/10-4.png
index c4edbf8..1d0f59c 100644
Binary files a/docs/electronics/c-lang/images/10-4.png and b/docs/electronics/c-lang/images/10-4.png differ
diff --git a/docs/electronics/c-lang/images/11-1.png b/docs/electronics/c-lang/images/11-1.png
index a37d102..5d594e5 100644
Binary files a/docs/electronics/c-lang/images/11-1.png and b/docs/electronics/c-lang/images/11-1.png differ
diff --git a/docs/electronics/c-lang/images/12-1.png b/docs/electronics/c-lang/images/12-1.png
index f8624b9..5e0ae60 100644
Binary files a/docs/electronics/c-lang/images/12-1.png and b/docs/electronics/c-lang/images/12-1.png differ
diff --git a/docs/electronics/c-lang/images/15-1.png b/docs/electronics/c-lang/images/15-1.png
index 7bf0f83..ef7e48d 100644
Binary files a/docs/electronics/c-lang/images/15-1.png and b/docs/electronics/c-lang/images/15-1.png differ
diff --git a/docs/electronics/c-lang/images/4-1.png b/docs/electronics/c-lang/images/4-1.png
index 8ac9a80..1fbeedd 100644
Binary files a/docs/electronics/c-lang/images/4-1.png and b/docs/electronics/c-lang/images/4-1.png differ
diff --git a/docs/electronics/c-lang/intro.md b/docs/electronics/c-lang/intro.md
index a3b9970..8e3251b 100644
--- a/docs/electronics/c-lang/intro.md
+++ b/docs/electronics/c-lang/intro.md
@@ -1,5 +1,6 @@
---
title: C 语言简介
+slug: /electronics/c-lang
---
# C 语言简介
diff --git a/docs/electronics/communication/intro.md b/docs/electronics/communication/intro.md
index 534a69e..7306b92 100644
--- a/docs/electronics/communication/intro.md
+++ b/docs/electronics/communication/intro.md
@@ -1,5 +1,6 @@
---
title: 通信专题
+slug: /electronics/communication
---
# 通信专题
diff --git a/docs/electronics/communication/parallel/images/0-1.png b/docs/electronics/communication/parallel/images/0-1.png
index 90e3c53..164b15f 100644
Binary files a/docs/electronics/communication/parallel/images/0-1.png and b/docs/electronics/communication/parallel/images/0-1.png differ
diff --git a/docs/electronics/communication/parallel/images/1-1.png b/docs/electronics/communication/parallel/images/1-1.png
index e260987..c412ab5 100644
Binary files a/docs/electronics/communication/parallel/images/1-1.png and b/docs/electronics/communication/parallel/images/1-1.png differ
diff --git a/docs/electronics/communication/parallel/images/1-2.png b/docs/electronics/communication/parallel/images/1-2.png
index 2b12928..ba5c237 100644
Binary files a/docs/electronics/communication/parallel/images/1-2.png and b/docs/electronics/communication/parallel/images/1-2.png differ
diff --git a/docs/electronics/communication/parallel/images/1-3.png b/docs/electronics/communication/parallel/images/1-3.png
index e68b165..11359f0 100644
Binary files a/docs/electronics/communication/parallel/images/1-3.png and b/docs/electronics/communication/parallel/images/1-3.png differ
diff --git a/docs/electronics/communication/parallel/images/1-4.png b/docs/electronics/communication/parallel/images/1-4.png
index b540442..f5b981c 100644
Binary files a/docs/electronics/communication/parallel/images/1-4.png and b/docs/electronics/communication/parallel/images/1-4.png differ
diff --git a/docs/electronics/communication/parallel/images/1-5.png b/docs/electronics/communication/parallel/images/1-5.png
index 3866150..73d514b 100644
Binary files a/docs/electronics/communication/parallel/images/1-5.png and b/docs/electronics/communication/parallel/images/1-5.png differ
diff --git a/docs/electronics/communication/parallel/images/2-1.png b/docs/electronics/communication/parallel/images/2-1.png
index 05e3eb1..3cafabd 100644
Binary files a/docs/electronics/communication/parallel/images/2-1.png and b/docs/electronics/communication/parallel/images/2-1.png differ
diff --git a/docs/electronics/communication/parallel/images/2-2.png b/docs/electronics/communication/parallel/images/2-2.png
index 702f4bd..cd9825f 100644
Binary files a/docs/electronics/communication/parallel/images/2-2.png and b/docs/electronics/communication/parallel/images/2-2.png differ
diff --git a/docs/electronics/communication/parallel/images/2-3.png b/docs/electronics/communication/parallel/images/2-3.png
index 2117c46..637e603 100644
Binary files a/docs/electronics/communication/parallel/images/2-3.png and b/docs/electronics/communication/parallel/images/2-3.png differ
diff --git a/docs/electronics/communication/parallel/images/2-4.png b/docs/electronics/communication/parallel/images/2-4.png
index 1b65855..8829ffc 100644
Binary files a/docs/electronics/communication/parallel/images/2-4.png and b/docs/electronics/communication/parallel/images/2-4.png differ
diff --git a/docs/electronics/communication/parallel/images/2-5.png b/docs/electronics/communication/parallel/images/2-5.png
index 22418c4..bf20cb1 100644
Binary files a/docs/electronics/communication/parallel/images/2-5.png and b/docs/electronics/communication/parallel/images/2-5.png differ
diff --git a/docs/electronics/communication/parallel/images/2-6.png b/docs/electronics/communication/parallel/images/2-6.png
index 85532b7..a45e8e1 100644
Binary files a/docs/electronics/communication/parallel/images/2-6.png and b/docs/electronics/communication/parallel/images/2-6.png differ
diff --git a/docs/electronics/communication/parallel/images/2-7.png b/docs/electronics/communication/parallel/images/2-7.png
index f5c631c..b797813 100644
Binary files a/docs/electronics/communication/parallel/images/2-7.png and b/docs/electronics/communication/parallel/images/2-7.png differ
diff --git a/docs/electronics/communication/parallel/images/2-8.png b/docs/electronics/communication/parallel/images/2-8.png
index 0f36a2b..84e16a5 100644
Binary files a/docs/electronics/communication/parallel/images/2-8.png and b/docs/electronics/communication/parallel/images/2-8.png differ
diff --git a/docs/electronics/communication/parallel/intro.md b/docs/electronics/communication/parallel/intro.md
index 6f67532..18b84ab 100644
--- a/docs/electronics/communication/parallel/intro.md
+++ b/docs/electronics/communication/parallel/intro.md
@@ -1,5 +1,6 @@
---
title: 并行通信简介
+slug: /electronics/communication/parallel
---
# 并行通信简介
diff --git a/docs/electronics/communication/serial/i2c/images/0-1.png b/docs/electronics/communication/serial/i2c/images/0-1.png
index 6f2053c..7738d0a 100644
Binary files a/docs/electronics/communication/serial/i2c/images/0-1.png and b/docs/electronics/communication/serial/i2c/images/0-1.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/1-1.png b/docs/electronics/communication/serial/i2c/images/1-1.png
index 28821c6..1d7b782 100644
Binary files a/docs/electronics/communication/serial/i2c/images/1-1.png and b/docs/electronics/communication/serial/i2c/images/1-1.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/1-2.png b/docs/electronics/communication/serial/i2c/images/1-2.png
index d42e00b..b9ac3f2 100644
Binary files a/docs/electronics/communication/serial/i2c/images/1-2.png and b/docs/electronics/communication/serial/i2c/images/1-2.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/1-3.png b/docs/electronics/communication/serial/i2c/images/1-3.png
index 51e0765..0910786 100644
Binary files a/docs/electronics/communication/serial/i2c/images/1-3.png and b/docs/electronics/communication/serial/i2c/images/1-3.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/1-4.png b/docs/electronics/communication/serial/i2c/images/1-4.png
index 8051b48..dcfd2a6 100644
Binary files a/docs/electronics/communication/serial/i2c/images/1-4.png and b/docs/electronics/communication/serial/i2c/images/1-4.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-1.png b/docs/electronics/communication/serial/i2c/images/2-1.png
index 8d63e52..8a6eb1f 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-1.png and b/docs/electronics/communication/serial/i2c/images/2-1.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-10.png b/docs/electronics/communication/serial/i2c/images/2-10.png
index d6f8eb2..a69508e 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-10.png and b/docs/electronics/communication/serial/i2c/images/2-10.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-2.png b/docs/electronics/communication/serial/i2c/images/2-2.png
index d5b7c02..c887fef 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-2.png and b/docs/electronics/communication/serial/i2c/images/2-2.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-3.png b/docs/electronics/communication/serial/i2c/images/2-3.png
index c47fcb8..82f0c4d 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-3.png and b/docs/electronics/communication/serial/i2c/images/2-3.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-4.png b/docs/electronics/communication/serial/i2c/images/2-4.png
index 78f9229..7c58682 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-4.png and b/docs/electronics/communication/serial/i2c/images/2-4.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-5.png b/docs/electronics/communication/serial/i2c/images/2-5.png
index 24681f0..ece06bb 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-5.png and b/docs/electronics/communication/serial/i2c/images/2-5.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-6.png b/docs/electronics/communication/serial/i2c/images/2-6.png
index 5592d8d..89bae28 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-6.png and b/docs/electronics/communication/serial/i2c/images/2-6.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-7.png b/docs/electronics/communication/serial/i2c/images/2-7.png
index 32123c4..1e1a998 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-7.png and b/docs/electronics/communication/serial/i2c/images/2-7.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-8.png b/docs/electronics/communication/serial/i2c/images/2-8.png
index 1309368..43149aa 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-8.png and b/docs/electronics/communication/serial/i2c/images/2-8.png differ
diff --git a/docs/electronics/communication/serial/i2c/images/2-9.png b/docs/electronics/communication/serial/i2c/images/2-9.png
index c00bf16..515c000 100644
Binary files a/docs/electronics/communication/serial/i2c/images/2-9.png and b/docs/electronics/communication/serial/i2c/images/2-9.png differ
diff --git a/docs/electronics/communication/serial/i2c/intro.md b/docs/electronics/communication/serial/i2c/intro.md
index 3a8fa06..ebbfddb 100644
--- a/docs/electronics/communication/serial/i2c/intro.md
+++ b/docs/electronics/communication/serial/i2c/intro.md
@@ -1,5 +1,6 @@
---
title: I2C简介
+slug: /electronics/communication/serial/i2c
---
# I2C 简介
diff --git a/docs/electronics/communication/serial/one-wire/images/0-1.png b/docs/electronics/communication/serial/one-wire/images/0-1.png
index a14fcef..b4ee3f4 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/0-1.png and b/docs/electronics/communication/serial/one-wire/images/0-1.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/1-1.png b/docs/electronics/communication/serial/one-wire/images/1-1.png
index 38573d9..4b919ed 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/1-1.png and b/docs/electronics/communication/serial/one-wire/images/1-1.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/1-2.png b/docs/electronics/communication/serial/one-wire/images/1-2.png
index e3ea8c9..e60c393 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/1-2.png and b/docs/electronics/communication/serial/one-wire/images/1-2.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/1-3.png b/docs/electronics/communication/serial/one-wire/images/1-3.png
index 7328f42..f9b20b2 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/1-3.png and b/docs/electronics/communication/serial/one-wire/images/1-3.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/2-1.png b/docs/electronics/communication/serial/one-wire/images/2-1.png
index 303d881..df2a5e5 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/2-1.png and b/docs/electronics/communication/serial/one-wire/images/2-1.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/2-2.png b/docs/electronics/communication/serial/one-wire/images/2-2.png
index 9a24db2..f352e40 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/2-2.png and b/docs/electronics/communication/serial/one-wire/images/2-2.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/2-3.png b/docs/electronics/communication/serial/one-wire/images/2-3.png
index c7fb42e..016732f 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/2-3.png and b/docs/electronics/communication/serial/one-wire/images/2-3.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/2-4.png b/docs/electronics/communication/serial/one-wire/images/2-4.png
index 9cccbe7..26e6210 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/2-4.png and b/docs/electronics/communication/serial/one-wire/images/2-4.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/5-1.png b/docs/electronics/communication/serial/one-wire/images/5-1.png
index 87dd038..c1fdbd7 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/5-1.png and b/docs/electronics/communication/serial/one-wire/images/5-1.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/5-2.png b/docs/electronics/communication/serial/one-wire/images/5-2.png
index ec135bb..17bdc1b 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/5-2.png and b/docs/electronics/communication/serial/one-wire/images/5-2.png differ
diff --git a/docs/electronics/communication/serial/one-wire/images/5-3.png b/docs/electronics/communication/serial/one-wire/images/5-3.png
index b8cef01..f47c029 100644
Binary files a/docs/electronics/communication/serial/one-wire/images/5-3.png and b/docs/electronics/communication/serial/one-wire/images/5-3.png differ
diff --git a/docs/electronics/communication/serial/one-wire/intro.md b/docs/electronics/communication/serial/one-wire/intro.md
index 7b1b539..469a763 100644
--- a/docs/electronics/communication/serial/one-wire/intro.md
+++ b/docs/electronics/communication/serial/one-wire/intro.md
@@ -1,5 +1,6 @@
---
title: One-Wire简介
+slug: /electronics/communication/serial/one-wire
---
# One-Wire 简介
diff --git a/docs/electronics/communication/serial/spi/images/0-1.png b/docs/electronics/communication/serial/spi/images/0-1.png
index 78f86b0..290520d 100644
Binary files a/docs/electronics/communication/serial/spi/images/0-1.png and b/docs/electronics/communication/serial/spi/images/0-1.png differ
diff --git a/docs/electronics/communication/serial/spi/images/1-1.png b/docs/electronics/communication/serial/spi/images/1-1.png
index 5f808a2..548a029 100644
Binary files a/docs/electronics/communication/serial/spi/images/1-1.png and b/docs/electronics/communication/serial/spi/images/1-1.png differ
diff --git a/docs/electronics/communication/serial/spi/images/1-2.png b/docs/electronics/communication/serial/spi/images/1-2.png
index 7640697..ed783eb 100644
Binary files a/docs/electronics/communication/serial/spi/images/1-2.png and b/docs/electronics/communication/serial/spi/images/1-2.png differ
diff --git a/docs/electronics/communication/serial/spi/images/1-3.png b/docs/electronics/communication/serial/spi/images/1-3.png
index 3e2b677..c90190a 100644
Binary files a/docs/electronics/communication/serial/spi/images/1-3.png and b/docs/electronics/communication/serial/spi/images/1-3.png differ
diff --git a/docs/electronics/communication/serial/spi/images/1-4.png b/docs/electronics/communication/serial/spi/images/1-4.png
index 5e50b84..784a844 100644
Binary files a/docs/electronics/communication/serial/spi/images/1-4.png and b/docs/electronics/communication/serial/spi/images/1-4.png differ
diff --git a/docs/electronics/communication/serial/spi/images/1-5.png b/docs/electronics/communication/serial/spi/images/1-5.png
index f5df921..d61d04e 100644
Binary files a/docs/electronics/communication/serial/spi/images/1-5.png and b/docs/electronics/communication/serial/spi/images/1-5.png differ
diff --git a/docs/electronics/communication/serial/spi/images/1-6.png b/docs/electronics/communication/serial/spi/images/1-6.png
index e03d3ed..096ee71 100644
Binary files a/docs/electronics/communication/serial/spi/images/1-6.png and b/docs/electronics/communication/serial/spi/images/1-6.png differ
diff --git a/docs/electronics/communication/serial/spi/images/2-1.png b/docs/electronics/communication/serial/spi/images/2-1.png
index 573ed63..e4c4b9a 100644
Binary files a/docs/electronics/communication/serial/spi/images/2-1.png and b/docs/electronics/communication/serial/spi/images/2-1.png differ
diff --git a/docs/electronics/communication/serial/spi/images/2-2.png b/docs/electronics/communication/serial/spi/images/2-2.png
index faa9fd5..a9b1d82 100644
Binary files a/docs/electronics/communication/serial/spi/images/2-2.png and b/docs/electronics/communication/serial/spi/images/2-2.png differ
diff --git a/docs/electronics/communication/serial/spi/images/2-3.png b/docs/electronics/communication/serial/spi/images/2-3.png
index e08de8b..47d345b 100644
Binary files a/docs/electronics/communication/serial/spi/images/2-3.png and b/docs/electronics/communication/serial/spi/images/2-3.png differ
diff --git a/docs/electronics/communication/serial/spi/images/5-1.png b/docs/electronics/communication/serial/spi/images/5-1.png
index f69d259..d538ccb 100644
Binary files a/docs/electronics/communication/serial/spi/images/5-1.png and b/docs/electronics/communication/serial/spi/images/5-1.png differ
diff --git a/docs/electronics/communication/serial/spi/intro.md b/docs/electronics/communication/serial/spi/intro.md
index 470d362..dc0195e 100644
--- a/docs/electronics/communication/serial/spi/intro.md
+++ b/docs/electronics/communication/serial/spi/intro.md
@@ -1,5 +1,6 @@
---
title: SPI简介
+slug: /electronics/communication/serial/spi
---
# SPI 简介
diff --git a/docs/electronics/communication/serial/uart/images/0-1.png b/docs/electronics/communication/serial/uart/images/0-1.png
index 6588a5b..d177439 100644
Binary files a/docs/electronics/communication/serial/uart/images/0-1.png and b/docs/electronics/communication/serial/uart/images/0-1.png differ
diff --git a/docs/electronics/communication/serial/uart/images/0-2.png b/docs/electronics/communication/serial/uart/images/0-2.png
index e8702d9..a055182 100644
Binary files a/docs/electronics/communication/serial/uart/images/0-2.png and b/docs/electronics/communication/serial/uart/images/0-2.png differ
diff --git a/docs/electronics/communication/serial/uart/images/1-1.png b/docs/electronics/communication/serial/uart/images/1-1.png
index 9cee09c..dbaaf33 100644
Binary files a/docs/electronics/communication/serial/uart/images/1-1.png and b/docs/electronics/communication/serial/uart/images/1-1.png differ
diff --git a/docs/electronics/communication/serial/uart/images/1-2.png b/docs/electronics/communication/serial/uart/images/1-2.png
index 9bdf82b..a0a317c 100644
Binary files a/docs/electronics/communication/serial/uart/images/1-2.png and b/docs/electronics/communication/serial/uart/images/1-2.png differ
diff --git a/docs/electronics/communication/serial/uart/images/1-3.png b/docs/electronics/communication/serial/uart/images/1-3.png
index c2f0bde..b0bf74c 100644
Binary files a/docs/electronics/communication/serial/uart/images/1-3.png and b/docs/electronics/communication/serial/uart/images/1-3.png differ
diff --git a/docs/electronics/communication/serial/uart/images/1-4.png b/docs/electronics/communication/serial/uart/images/1-4.png
index 1a20343..3a120ae 100644
Binary files a/docs/electronics/communication/serial/uart/images/1-4.png and b/docs/electronics/communication/serial/uart/images/1-4.png differ
diff --git a/docs/electronics/communication/serial/uart/images/1-5.png b/docs/electronics/communication/serial/uart/images/1-5.png
index 6dae56d..1149207 100644
Binary files a/docs/electronics/communication/serial/uart/images/1-5.png and b/docs/electronics/communication/serial/uart/images/1-5.png differ
diff --git a/docs/electronics/communication/serial/uart/images/2-1.png b/docs/electronics/communication/serial/uart/images/2-1.png
index 191f6e3..ac22fc5 100644
Binary files a/docs/electronics/communication/serial/uart/images/2-1.png and b/docs/electronics/communication/serial/uart/images/2-1.png differ
diff --git a/docs/electronics/communication/serial/uart/images/2-2.png b/docs/electronics/communication/serial/uart/images/2-2.png
index 12ff737..764711a 100644
Binary files a/docs/electronics/communication/serial/uart/images/2-2.png and b/docs/electronics/communication/serial/uart/images/2-2.png differ
diff --git a/docs/electronics/communication/serial/uart/images/3-1.png b/docs/electronics/communication/serial/uart/images/3-1.png
index 3b985e1..fb3a1ec 100644
Binary files a/docs/electronics/communication/serial/uart/images/3-1.png and b/docs/electronics/communication/serial/uart/images/3-1.png differ
diff --git a/docs/electronics/communication/serial/uart/images/3-2.png b/docs/electronics/communication/serial/uart/images/3-2.png
index f2cd9d0..39ba887 100644
Binary files a/docs/electronics/communication/serial/uart/images/3-2.png and b/docs/electronics/communication/serial/uart/images/3-2.png differ
diff --git a/docs/electronics/communication/serial/uart/images/3-3.png b/docs/electronics/communication/serial/uart/images/3-3.png
index b8d069a..7ddfa2d 100644
Binary files a/docs/electronics/communication/serial/uart/images/3-3.png and b/docs/electronics/communication/serial/uart/images/3-3.png differ
diff --git a/docs/electronics/communication/serial/uart/images/3-4.png b/docs/electronics/communication/serial/uart/images/3-4.png
index 8ef4883..72bd5bd 100644
Binary files a/docs/electronics/communication/serial/uart/images/3-4.png and b/docs/electronics/communication/serial/uart/images/3-4.png differ
diff --git a/docs/electronics/communication/serial/uart/intro.md b/docs/electronics/communication/serial/uart/intro.md
index 23ddb51..78bf6a8 100644
--- a/docs/electronics/communication/serial/uart/intro.md
+++ b/docs/electronics/communication/serial/uart/intro.md
@@ -1,5 +1,6 @@
---
title: UART简介
+slug: /electronics/communication/serial/uart
---
# UART 简介
diff --git a/docs/electronics/intro.md b/docs/electronics/intro.md
index 57b7717..d24ab88 100644
--- a/docs/electronics/intro.md
+++ b/docs/electronics/intro.md
@@ -1,5 +1,6 @@
---
title: 电子组文档
+slug: /electronics
---
# 电子组文档
diff --git a/docs/electronics/projects/cnc-engraver/images/0-3.png b/docs/electronics/projects/cnc-engraver/images/0-3.png
index 13d5b28..a2923f1 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/0-3.png and b/docs/electronics/projects/cnc-engraver/images/0-3.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/1-1.png b/docs/electronics/projects/cnc-engraver/images/1-1.png
index 0094fae..8ff8982 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/1-1.png and b/docs/electronics/projects/cnc-engraver/images/1-1.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/1-2.png b/docs/electronics/projects/cnc-engraver/images/1-2.png
index c544dd2..c64d251 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/1-2.png and b/docs/electronics/projects/cnc-engraver/images/1-2.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/1-3.png b/docs/electronics/projects/cnc-engraver/images/1-3.png
index f7a07b2..e78e9fd 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/1-3.png and b/docs/electronics/projects/cnc-engraver/images/1-3.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/1-4.png b/docs/electronics/projects/cnc-engraver/images/1-4.png
index 75b4808..8697d71 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/1-4.png and b/docs/electronics/projects/cnc-engraver/images/1-4.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/1-5.png b/docs/electronics/projects/cnc-engraver/images/1-5.png
index 214ec8a..828fb81 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/1-5.png and b/docs/electronics/projects/cnc-engraver/images/1-5.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/1-6.png b/docs/electronics/projects/cnc-engraver/images/1-6.png
index 5fa89ad..8ebea20 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/1-6.png and b/docs/electronics/projects/cnc-engraver/images/1-6.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/1-7.png b/docs/electronics/projects/cnc-engraver/images/1-7.png
index 3402350..127b3e3 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/1-7.png and b/docs/electronics/projects/cnc-engraver/images/1-7.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/1-8.png b/docs/electronics/projects/cnc-engraver/images/1-8.png
index 98adb4e..34477da 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/1-8.png and b/docs/electronics/projects/cnc-engraver/images/1-8.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/2-1.png b/docs/electronics/projects/cnc-engraver/images/2-1.png
index 3ea97af..d47fad1 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/2-1.png and b/docs/electronics/projects/cnc-engraver/images/2-1.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/2-2.png b/docs/electronics/projects/cnc-engraver/images/2-2.png
index b1e1af0..61a03e0 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/2-2.png and b/docs/electronics/projects/cnc-engraver/images/2-2.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-1.png b/docs/electronics/projects/cnc-engraver/images/3-1.png
index 933b007..90ba7cd 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-1.png and b/docs/electronics/projects/cnc-engraver/images/3-1.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-10.png b/docs/electronics/projects/cnc-engraver/images/3-10.png
index b744714..b639477 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-10.png and b/docs/electronics/projects/cnc-engraver/images/3-10.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-11.png b/docs/electronics/projects/cnc-engraver/images/3-11.png
index ac6a8d2..c6f7ad8 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-11.png and b/docs/electronics/projects/cnc-engraver/images/3-11.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-2.png b/docs/electronics/projects/cnc-engraver/images/3-2.png
index 1b0717d..6f02b35 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-2.png and b/docs/electronics/projects/cnc-engraver/images/3-2.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-3.png b/docs/electronics/projects/cnc-engraver/images/3-3.png
index 15dd04e..db94ca0 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-3.png and b/docs/electronics/projects/cnc-engraver/images/3-3.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-4.png b/docs/electronics/projects/cnc-engraver/images/3-4.png
index e24acd4..cac5dbf 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-4.png and b/docs/electronics/projects/cnc-engraver/images/3-4.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-5.png b/docs/electronics/projects/cnc-engraver/images/3-5.png
index bb983db..0efd5a2 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-5.png and b/docs/electronics/projects/cnc-engraver/images/3-5.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-6.png b/docs/electronics/projects/cnc-engraver/images/3-6.png
index 9860238..8ab7fdd 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-6.png and b/docs/electronics/projects/cnc-engraver/images/3-6.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-7.png b/docs/electronics/projects/cnc-engraver/images/3-7.png
index 8281742..7777208 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-7.png and b/docs/electronics/projects/cnc-engraver/images/3-7.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-8.png b/docs/electronics/projects/cnc-engraver/images/3-8.png
index c0adab0..57a5f05 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-8.png and b/docs/electronics/projects/cnc-engraver/images/3-8.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/3-9.png b/docs/electronics/projects/cnc-engraver/images/3-9.png
index 78bbf18..e19da11 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/3-9.png and b/docs/electronics/projects/cnc-engraver/images/3-9.png differ
diff --git a/docs/electronics/projects/cnc-engraver/images/4-1.png b/docs/electronics/projects/cnc-engraver/images/4-1.png
index 21057c8..bf4261d 100644
Binary files a/docs/electronics/projects/cnc-engraver/images/4-1.png and b/docs/electronics/projects/cnc-engraver/images/4-1.png differ
diff --git a/docs/electronics/projects/cnc-engraver/intro.md b/docs/electronics/projects/cnc-engraver/intro.md
index eb9bb89..1cbf4ea 100644
--- a/docs/electronics/projects/cnc-engraver/intro.md
+++ b/docs/electronics/projects/cnc-engraver/intro.md
@@ -1,5 +1,6 @@
---
title: 激光雕刻机简介
+slug: /electronics/projects/cnc-engraver
---
# 激光雕刻机
diff --git a/docs/electronics/projects/intro.md b/docs/electronics/projects/intro.md
index 28734e0..79965d5 100644
--- a/docs/electronics/projects/intro.md
+++ b/docs/electronics/projects/intro.md
@@ -1,5 +1,6 @@
---
title: 项目制作简介
+slug: /electronics/projects
---
# 项目制作
diff --git a/docs/electronics/projects/led-board/images/1-2.png b/docs/electronics/projects/led-board/images/1-2.png
index 63908b4..9434aba 100644
Binary files a/docs/electronics/projects/led-board/images/1-2.png and b/docs/electronics/projects/led-board/images/1-2.png differ
diff --git a/docs/electronics/projects/led-board/images/1-3.png b/docs/electronics/projects/led-board/images/1-3.png
index b83ac1f..bae2735 100644
Binary files a/docs/electronics/projects/led-board/images/1-3.png and b/docs/electronics/projects/led-board/images/1-3.png differ
diff --git a/docs/electronics/projects/led-board/images/1-4.png b/docs/electronics/projects/led-board/images/1-4.png
index 010b295..e55f8bb 100644
Binary files a/docs/electronics/projects/led-board/images/1-4.png and b/docs/electronics/projects/led-board/images/1-4.png differ
diff --git a/docs/electronics/projects/led-board/images/1-5.png b/docs/electronics/projects/led-board/images/1-5.png
index dcf6431..e014ddd 100644
Binary files a/docs/electronics/projects/led-board/images/1-5.png and b/docs/electronics/projects/led-board/images/1-5.png differ
diff --git a/docs/electronics/projects/led-board/images/1-6.png b/docs/electronics/projects/led-board/images/1-6.png
index 6fd9de6..841a30c 100644
Binary files a/docs/electronics/projects/led-board/images/1-6.png and b/docs/electronics/projects/led-board/images/1-6.png differ
diff --git a/docs/electronics/projects/led-board/images/1-7.png b/docs/electronics/projects/led-board/images/1-7.png
index 744a814..39d05ff 100644
Binary files a/docs/electronics/projects/led-board/images/1-7.png and b/docs/electronics/projects/led-board/images/1-7.png differ
diff --git a/docs/electronics/projects/led-board/images/1-8.png b/docs/electronics/projects/led-board/images/1-8.png
index 0d75e9a..b9f8466 100644
Binary files a/docs/electronics/projects/led-board/images/1-8.png and b/docs/electronics/projects/led-board/images/1-8.png differ
diff --git a/docs/electronics/projects/led-board/images/2-2.png b/docs/electronics/projects/led-board/images/2-2.png
index 5c2c7c4..dc378de 100644
Binary files a/docs/electronics/projects/led-board/images/2-2.png and b/docs/electronics/projects/led-board/images/2-2.png differ
diff --git a/docs/electronics/projects/led-board/intro.md b/docs/electronics/projects/led-board/intro.md
index 9569f29..81af5ef 100644
--- a/docs/electronics/projects/led-board/intro.md
+++ b/docs/electronics/projects/led-board/intro.md
@@ -1,5 +1,6 @@
---
title: LED Board简介
+slug: /electronics/projects/led-board
---
# LED Board
diff --git a/docs/electronics/projects/nfc/images/0-1.png b/docs/electronics/projects/nfc/images/0-1.png
index 9837fb1..f64c9ca 100644
Binary files a/docs/electronics/projects/nfc/images/0-1.png and b/docs/electronics/projects/nfc/images/0-1.png differ
diff --git a/docs/electronics/projects/nfc/images/0-2.png b/docs/electronics/projects/nfc/images/0-2.png
index 86b6ca0..ab612a5 100644
Binary files a/docs/electronics/projects/nfc/images/0-2.png and b/docs/electronics/projects/nfc/images/0-2.png differ
diff --git a/docs/electronics/projects/nfc/images/1-1.png b/docs/electronics/projects/nfc/images/1-1.png
index fc29db0..5540e44 100644
Binary files a/docs/electronics/projects/nfc/images/1-1.png and b/docs/electronics/projects/nfc/images/1-1.png differ
diff --git a/docs/electronics/projects/nfc/images/1-2.png b/docs/electronics/projects/nfc/images/1-2.png
index 4d7cd84..d550f92 100644
Binary files a/docs/electronics/projects/nfc/images/1-2.png and b/docs/electronics/projects/nfc/images/1-2.png differ
diff --git a/docs/electronics/projects/nfc/images/1-3.png b/docs/electronics/projects/nfc/images/1-3.png
index 28ca9ef..5432634 100644
Binary files a/docs/electronics/projects/nfc/images/1-3.png and b/docs/electronics/projects/nfc/images/1-3.png differ
diff --git a/docs/electronics/projects/nfc/images/2-1.png b/docs/electronics/projects/nfc/images/2-1.png
index b02816a..16cc15d 100644
Binary files a/docs/electronics/projects/nfc/images/2-1.png and b/docs/electronics/projects/nfc/images/2-1.png differ
diff --git a/docs/electronics/projects/nfc/images/2-2.png b/docs/electronics/projects/nfc/images/2-2.png
index 825d3e2..fe535a3 100644
Binary files a/docs/electronics/projects/nfc/images/2-2.png and b/docs/electronics/projects/nfc/images/2-2.png differ
diff --git a/docs/electronics/projects/nfc/images/2-3.png b/docs/electronics/projects/nfc/images/2-3.png
index 16e376a..25558e3 100644
Binary files a/docs/electronics/projects/nfc/images/2-3.png and b/docs/electronics/projects/nfc/images/2-3.png differ
diff --git a/docs/electronics/projects/nfc/images/2-4.png b/docs/electronics/projects/nfc/images/2-4.png
index 67beeae..2589070 100644
Binary files a/docs/electronics/projects/nfc/images/2-4.png and b/docs/electronics/projects/nfc/images/2-4.png differ
diff --git a/docs/electronics/projects/nfc/intro.md b/docs/electronics/projects/nfc/intro.md
index 1dd90dd..ec48b22 100644
--- a/docs/electronics/projects/nfc/intro.md
+++ b/docs/electronics/projects/nfc/intro.md
@@ -1,5 +1,6 @@
---
title: 办公室门禁历史
+slug: /electronics/projects/nfc
---
# 办公室门禁历史
diff --git a/docs/electronics/tutorial/eda/images/0-1.png b/docs/electronics/tutorial/eda/images/0-1.png
index 767b524..10c4cbf 100644
Binary files a/docs/electronics/tutorial/eda/images/0-1.png and b/docs/electronics/tutorial/eda/images/0-1.png differ
diff --git a/docs/electronics/tutorial/eda/images/1-1.png b/docs/electronics/tutorial/eda/images/1-1.png
index 61fa913..e596463 100644
Binary files a/docs/electronics/tutorial/eda/images/1-1.png and b/docs/electronics/tutorial/eda/images/1-1.png differ
diff --git a/docs/electronics/tutorial/eda/images/1-2.png b/docs/electronics/tutorial/eda/images/1-2.png
index 34971bf..a686460 100644
Binary files a/docs/electronics/tutorial/eda/images/1-2.png and b/docs/electronics/tutorial/eda/images/1-2.png differ
diff --git a/docs/electronics/tutorial/eda/images/1-3.png b/docs/electronics/tutorial/eda/images/1-3.png
index 65f4262..943b6b0 100644
Binary files a/docs/electronics/tutorial/eda/images/1-3.png and b/docs/electronics/tutorial/eda/images/1-3.png differ
diff --git a/docs/electronics/tutorial/eda/images/2-1.png b/docs/electronics/tutorial/eda/images/2-1.png
index b76982e..c2344f5 100644
Binary files a/docs/electronics/tutorial/eda/images/2-1.png and b/docs/electronics/tutorial/eda/images/2-1.png differ
diff --git a/docs/electronics/tutorial/eda/intro.md b/docs/electronics/tutorial/eda/intro.md
index 8f74943..82133d3 100644
--- a/docs/electronics/tutorial/eda/intro.md
+++ b/docs/electronics/tutorial/eda/intro.md
@@ -1,5 +1,6 @@
---
title: EDA入门简介
+slug: /electronics/tutorial/eda
---
# EDA 入门简介
diff --git a/docs/electronics/tutorial/git/images/0-1.png b/docs/electronics/tutorial/git/images/0-1.png
index 6bbeab6..48286e8 100644
Binary files a/docs/electronics/tutorial/git/images/0-1.png and b/docs/electronics/tutorial/git/images/0-1.png differ
diff --git a/docs/electronics/tutorial/git/images/1-1.png b/docs/electronics/tutorial/git/images/1-1.png
index 0c22ce2..6dcb656 100644
Binary files a/docs/electronics/tutorial/git/images/1-1.png and b/docs/electronics/tutorial/git/images/1-1.png differ
diff --git a/docs/electronics/tutorial/git/images/1-2.png b/docs/electronics/tutorial/git/images/1-2.png
index 954fcb8..8c54afc 100644
Binary files a/docs/electronics/tutorial/git/images/1-2.png and b/docs/electronics/tutorial/git/images/1-2.png differ
diff --git a/docs/electronics/tutorial/git/intro.md b/docs/electronics/tutorial/git/intro.md
index 6188ad5..c0243e8 100644
--- a/docs/electronics/tutorial/git/intro.md
+++ b/docs/electronics/tutorial/git/intro.md
@@ -1,5 +1,6 @@
---
title: Git简介
+slug: /electronics/tutorial/git
---
# Git 简介
diff --git a/docs/electronics/tutorial/intro.md b/docs/electronics/tutorial/intro.md
index 45e5a69..affd224 100644
--- a/docs/electronics/tutorial/intro.md
+++ b/docs/electronics/tutorial/intro.md
@@ -1,3 +1,8 @@
+---
+title: 半小时入门
+slug: /electronics/tutorial
+---
+
# 半小时入门
本专题的内容主要是对某个专题或者内容作简短的介绍,选择从整体的全貌来看某些问题,起到开拓视野的作用,不会涉及非常详细的内容。
diff --git a/docs/electronics/tutorial/markdown/intro.md b/docs/electronics/tutorial/markdown/intro.md
index 8d237e4..fd7f899 100644
--- a/docs/electronics/tutorial/markdown/intro.md
+++ b/docs/electronics/tutorial/markdown/intro.md
@@ -1,5 +1,6 @@
---
title: Markdown简介
+slug: /electronics/tutorial/markdown
---
# Markdown 简介
diff --git a/docs/electronics/tutorial/web/images/4-1.png b/docs/electronics/tutorial/web/images/4-1.png
index 6985937..e98e652 100644
Binary files a/docs/electronics/tutorial/web/images/4-1.png and b/docs/electronics/tutorial/web/images/4-1.png differ
diff --git a/docs/electronics/tutorial/web/images/4-2.png b/docs/electronics/tutorial/web/images/4-2.png
index ad4cf30..188e478 100644
Binary files a/docs/electronics/tutorial/web/images/4-2.png and b/docs/electronics/tutorial/web/images/4-2.png differ
diff --git a/docs/electronics/tutorial/web/intro.md b/docs/electronics/tutorial/web/intro.md
index dc3a63f..44e4d99 100644
--- a/docs/electronics/tutorial/web/intro.md
+++ b/docs/electronics/tutorial/web/intro.md
@@ -1,5 +1,6 @@
---
title: 前端基础
+slug: /electronics/tutorial/web
---
# 前端基础
diff --git a/images/markdown-plugin.png b/docs/images/markdown-plugin.png
similarity index 100%
rename from images/markdown-plugin.png
rename to docs/images/markdown-plugin.png
diff --git a/docs/intro.md b/docs/intro.md
new file mode 100644
index 0000000..f222d84
--- /dev/null
+++ b/docs/intro.md
@@ -0,0 +1,150 @@
+---
+title: 说明
+slug: /
+---
+
+# 说明
+
+## 1. 项目背景
+
+这是我给我们技术部搭的文档,我已经把我之前写的电子组的文档搬过来了,还写了一篇有关我们[义务维修海报](/blog/stas-pc-maintenance-history)的文章,海报内容搜集不全,希望大家可以补充。
+
+做这个文档的目的也是把我们搁置已久的 [GitHub 组织](https://github.com/NJTUSTAS)
+利用起来,同时也是记录我们在技术部的历程,毕竟放在 GitHub 上的数据几乎是不会丢失的,就算我们毕业了也可以看到大家的过去和现在的动态。
+
+我非常希望大家能够参与到这个文档项目中,任何人都可以写自己想写的内容,各个组也可以写写自己的组的文档、活动和杂文,都可以的。毕竟只有大家参与才有可能让我们这个组织更有力量,我一个人写不了太多东西。
+
+参与的门槛不高,能**翻墙**(巨佬给我们配的办公室网络自带翻墙),会使用 **Git**,和 **GitHub**,会写 **Markdown** 就可以了(我觉得在技术部,会点这个还是不难的,这个应该和义务维修一样,是大家的基本技能,也可以请教请教周围的人)。不会的话现在可以学起来,值班的时候上 Google 上了解了解,和其他人交流交流。
+
+最后,大家想参与这个项目,并且有自己的想法,可以先把上面提到的技能学起来,尝试在本地练一练,然后找你们的组长会或者群里的管理员拉你们进入我们技术部的 GitHub 组织,他们或多或少已经在了。
+
+非常希望大家能够积极参与进来。
+
+## 2. 项目开发
+
+安装 Git,前往 [Git 官网](https://git-scm.com/downloads)下载安装。
+
+安装 Node,需要有 Node16 及以上的版本,建议安装 **Node18**,你可以前往 [Node 官网](https://nodejs.org)下载安装。
+
+克隆项目:
+
+```sh
+git clone https://github.com/NJTUSTAS/njtustas.github.io.git
+```
+
+开发项目:
+
+```sh
+npm start
+```
+
+启动后浏览器会自动跳转至[http://localhost:3000](http://localhost:3000)。
+
+## 3. 注意事项
+
+### 3.1 开发基础
+
+首先你需要有使用 Git、Github 的经验,会写 Markdown。
+
+另外,本项目使用的文档框架是[Docusaurus](https://docusaurus.io/),也是由 Facebook 领导开发的一个开源项目,底层使用的是 React 和 Webpack,开发前建议先阅读一下他们的文档。如果你要开发独立的页面,需要了解 React 和 Typescript;如果只是写文档和文章,只需要知道这个框架的结构,会写 Markdown 就可以了。
+
+### 3.2 Markdown 规范
+
+**安装插件**
+
+写 Markdown 文档或者文章的时候,建议安装这两个插件以保证格式的统一性:
+
+![markdown-plugin](./images/markdown-plugin.png)
+
+**内容规范**
+
+书写的内容请保证条理性和严谨性,书写的规范请参考已有的文章。
+
+**压缩图片**
+
+在 Markdown 中使用的图片一定要**先压缩再使用**,图片不要超过 1M,建议在 **500K**左右,**越小越好**。你可以使用下面这个免费的在线压缩工具:
+
+:::info
+[https://redketchup.io/image-compressor](https://redketchup.io/image-compressor)
+:::
+
+### 3.3 文件创建
+
+创建的每一个文章应该以和文章内容相近的**英文命名**,不要使用中文命名。
+
+### 3.4 Sidebar 链接
+
+项目的 Sidebar 应该在`config/sidebar`中相关的 Sidebar 文件导出,然后再在根目录的`sidebar.js`中导入。
+
+例如电子组的 Sidebar 路径是`config/sidebar/electronics.js`:
+
+```js
+const electronics = [
+ {
+ type: "category",
+ label: "电子组文档",
+ collapsed: true,
+ items: [
+ {
+ type: "doc",
+ id: "electronics",
+ label: "说明"
+ },
+ {
+ type: "category",
+ label: "Arduino",
+ items: [
+ {
+ type: "doc",
+ id: "electronics/arduino",
+ label: "Arduino简介"
+ },
+ ...
+ ]
+ },
+ ...
+ ]
+ },
+ ...
+]
+
+module.exports = electronics;
+```
+
+然后在 sidebar.js 中导入:
+
+```js
+const electronics = require("./config/sidebar/electronics");
+
+/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
+const sidebars = {
+ docs: [
+ {
+ type: "doc",
+ label: "说明",
+ id: "intro"
+ },
+ ...electronics
+ ]
+};
+
+module.exports = sidebars;
+```
+
+这么也是为了让目录结构更加清晰,Sidebar 中的每一个元素我们都可以自己定义,这样生成的目录就会按照我们想要的顺序排列了。详细内容可以参考[官方文档](https://docusaurus.io/docs/create-doc)。
+
+:::tip
+如果你实在看不懂文档可以参考我已经写好的嘛,还是不明白的话可以联系我。
+:::
+
+### 3.5 格式化代码
+
+提交前请先格式化代码再提交:
+
+```
+npm run format
+```
+
+## 4. 结束语
+
+非常希望大家可以参与进来,给科协的过去和未来留下点东西。
diff --git a/docusaurus.config.js b/docusaurus.config.js
index b42aaaf..411efd5 100644
--- a/docusaurus.config.js
+++ b/docusaurus.config.js
@@ -4,6 +4,8 @@
const lightCodeTheme = require("prism-react-renderer/themes/github");
const darkCodeTheme = require("prism-react-renderer/themes/dracula");
+const footer = require("./config/footer");
+
/** @type {import('@docusaurus/types').Config} */
const config = {
title: "技术部文档",
@@ -63,7 +65,7 @@ const config = {
},
{
to: "/blog",
- label: "动态文章",
+ label: "文章动态",
position: "left"
},
{
@@ -75,43 +77,7 @@ const config = {
},
footer: {
style: "dark",
- links: [
- {
- title: "文档",
- items: [
- {
- label: "电子组文档",
- to: "/docs/electronics/intro"
- }
- ]
- },
- {
- title: "资源",
- items: [
- {
- label: "南工OJ",
- href: "https://acm.online.njtech.edu.cn"
- },
- {
- label: "值班笔记",
- href: "https://punch.mraddict.top"
- }
- ]
- },
- {
- title: "友链",
- items: [
- {
- label: "远景实验室",
- href: "https://www.vistalab.top"
- },
- {
- label: "Mars工作室",
- href: "https://studio.online.njtech.edu.cn"
- }
- ]
- }
- ],
+ links: [...footer],
copyright: `Copyright © ${new Date().getFullYear()} 校大学生科协. All rights reversed.`
},
prism: {
diff --git a/sidebars.js b/sidebars.js
index 2aacb02..fe0d424 100644
--- a/sidebars.js
+++ b/sidebars.js
@@ -1,577 +1,15 @@
+const electronics = require("./config/sidebar/electronics");
+
/** @type {import('@docusaurus/plugin-content-docs').SidebarsConfig} */
const sidebars = {
docs: [
{
- type: "category",
- label: "电子组文档",
- collapsed: true,
- items: [
- {
- type: "doc",
- id: "electronics/intro",
- label: "说明"
- },
- {
- type: "category",
- label: "Arduino",
- items: [
- {
- type: "doc",
- id: "electronics/arduino/intro",
- label: "Arduino简介"
- },
- {
- type: "doc",
- id: "electronics/arduino/chapter1",
- label: "Arduino和Arduino IDE"
- },
- {
- type: "doc",
- id: "electronics/arduino/chapter2",
- label: "第一个程序Blink"
- },
- {
- type: "doc",
- id: "electronics/arduino/chapter3",
- label: "使用按钮"
- },
- {
- type: "doc",
- id: "electronics/arduino/chapter4",
- label: "中断Interrupt"
- },
- {
- type: "doc",
- id: "electronics/arduino/chapter5",
- label: "定时器Timer"
- },
- {
- type: "doc",
- id: "electronics/arduino/chapter6",
- label: "脉冲宽度调制PWM"
- },
- {
- type: "doc",
- id: "electronics/arduino/chapter7",
- label: "模数转换ADC"
- },
- {
- type: "doc",
- id: "electronics/arduino/chapter8",
- label: "串口通信UART"
- },
- {
- type: "doc",
- id: "electronics/arduino/chapter9",
- label: "单片机的存储器和EEPROM"
- }
- ]
- },
- {
- type: "category",
- label: "C语言",
- items: [
- {
- type: "doc",
- id: "electronics/c-lang/intro",
- label: "C语言简介"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter1",
- label: "C语言基本语法"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter2",
- label: "数据类型"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter3",
- label: "变量和常量"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter4",
- label: "运算符"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter5",
- label: "条件判断if和switch"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter6",
- label: "循环while和do/while"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter7",
- label: "循环for"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter8",
- label: "函数"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter9",
- label: "函数的作用域规则"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter10",
- label: "数组"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter11",
- label: "多维数组"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter12",
- label: "字符串"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter13",
- label: "指针"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter14",
- label: "指针的算数运算"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter15",
- label: "指针和数组、函数"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter16",
- label: "枚举(enum)"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter17",
- label: "结构体(struct)"
- },
- {
- type: "doc",
- id: "electronics/c-lang/chapter18",
- label: "共用体(union)"
- }
- ]
- },
- {
- type: "category",
- label: "通信专题",
- items: [
- {
- type: "doc",
- id: "electronics/communication/intro",
- label: "通信专题"
- },
- {
- type: "category",
- label: "One-Wire",
- items: [
- {
- type: "doc",
- id: "electronics/communication/serial/one-wire/intro",
- label: "One-Wire简介"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/one-wire/chapter1",
- label: "One-Wire通信原理"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/one-wire/chapter2",
- label: "DHT11数据手册速览"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/one-wire/chapter3",
- label: "代码逻辑分析"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/one-wire/chapter4",
- label: "整合打包代码"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/one-wire/chapter5",
- label: "总结和拓展"
- }
- ]
- },
- {
- type: "category",
- label: "UART",
- items: [
- {
- type: "doc",
- id: "electronics/communication/serial/uart/intro",
- label: "UART简介"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/uart/chapter1",
- label: "UART通信原理"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/uart/chapter2",
- label: "HC-05数据手册速览"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/uart/chapter3",
- label: "HC-05蓝牙的使用"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/uart/chapter4",
- label: "总结和拓展"
- }
- ]
- },
- {
- type: "category",
- label: "I2C",
- items: [
- {
- type: "doc",
- id: "electronics/communication/serial/i2c/intro",
- label: "I2C简介"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/i2c/chapter1",
- label: "I2C通信原理"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/i2c/chapter2",
- label: "DS3231数据手册速览"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/i2c/chapter3",
- label: "代码逻辑分析"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/i2c/chapter4",
- label: "整合打包代码"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/i2c/chapter5",
- label: "总结和拓展"
- }
- ]
- },
- {
- type: "category",
- label: "SPI",
- items: [
- {
- type: "doc",
- id: "electronics/communication/serial/spi/intro",
- label: "SPI简介"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/spi/chapter1",
- label: "SPI通信原理"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/spi/chapter2",
- label: "MPU9250数据手册速览"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/spi/chapter3",
- label: "代码逻辑分析"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/spi/chapter4",
- label: "整合打包代码"
- },
- {
- type: "doc",
- id: "electronics/communication/serial/spi/chapter5",
- label: "总结和拓展"
- }
- ]
- },
- {
- type: "category",
- label: "并行通信",
- items: [
- {
- type: "doc",
- id: "electronics/communication/parallel/intro",
- label: "并行通信简介"
- },
- {
- type: "doc",
- id: "electronics/communication/parallel/chapter1",
- label: "并行通信原理"
- },
- {
- type: "doc",
- id: "electronics/communication/parallel/chapter2",
- label: "LCD1602数据手册速览"
- },
- {
- type: "doc",
- id: "electronics/communication/parallel/chapter3",
- label: "代码逻辑分析"
- },
- {
- type: "doc",
- id: "electronics/communication/parallel/chapter4",
- label: "整合打包代码"
- },
- {
- type: "doc",
- id: "electronics/communication/parallel/chapter5",
- label: "总结和拓展"
- }
- ]
- }
- ]
- },
-
- {
- type: "category",
- label: "项目制作",
- items: [
- {
- type: "doc",
- id: "electronics/projects/intro",
- label: "项目制作"
- },
- {
- type: "category",
- label: "NFC",
- items: [
- {
- type: "doc",
- id: "electronics/projects/nfc/intro",
- label: "办公室门禁历史"
- },
- {
- type: "doc",
- id: "electronics/projects/nfc/chapter1",
- label: "初代门禁版本"
- },
- {
- type: "doc",
- id: "electronics/projects/nfc/chapter2",
- label: "目前门禁版本"
- },
- {
- type: "doc",
- id: "electronics/projects/nfc/chapter3",
- label: "未来的改进"
- }
- ]
- },
- {
- type: "category",
- label: "LED-Board",
- items: [
- {
- type: "doc",
- id: "electronics/projects/led-board/intro",
- label: "LED Board简介"
- },
- {
- type: "doc",
- id: "electronics/projects/led-board/chapter1",
- label: "制作步骤"
- },
- {
- type: "doc",
- id: "electronics/projects/led-board/chapter2",
- label: "代码及使用"
- },
- {
- type: "doc",
- id: "electronics/projects/led-board/chapter3",
- label: "总结和拓展"
- }
- ]
- },
- {
- type: "category",
- label: "激光雕刻机",
- items: [
- {
- type: "doc",
- id: "electronics/projects/cnc-engraver/intro",
- label: "激光雕刻机简介"
- },
- {
- type: "doc",
- id: "electronics/projects/cnc-engraver/chapter1",
- label: "什么是CNC"
- },
- {
- type: "doc",
- id: "electronics/projects/cnc-engraver/chapter2",
- label: "雕刻机硬件搭建"
- },
- {
- type: "doc",
- id: "electronics/projects/cnc-engraver/chapter3",
- label: "雕刻机控制软件"
- },
- {
- type: "doc",
- id: "electronics/projects/cnc-engraver/chapter4",
- label: "总结和拓展"
- }
- ]
- }
- ]
- },
- {
- type: "category",
- label: "半小时入门",
- items: [
- {
- type: "doc",
- id: "electronics/tutorial/intro",
- label: "半小时入门"
- },
- {
- type: "category",
- label: "Git",
- items: [
- {
- type: "doc",
- id: "electronics/tutorial/git/intro",
- label: "Git简介"
- },
- {
- type: "doc",
- id: "electronics/tutorial/git/chapter1",
- label: "集中式VS分布式"
- },
- {
- type: "doc",
- id: "electronics/tutorial/git/chapter2",
- label: "Git的安装与配置"
- },
- {
- type: "doc",
- id: "electronics/tutorial/git/chapter3",
- label: "Git的常用命令"
- }
- ]
- },
- {
- type: "category",
- label: "EDA",
- items: [
- {
- type: "doc",
- id: "electronics/tutorial/eda/intro",
- label: "EDA入门简介"
- },
- {
- type: "doc",
- id: "electronics/tutorial/eda/chapter1",
- label: "555计时器"
- },
- {
- type: "doc",
- id: "electronics/tutorial/eda/chapter2",
- label: "绘制符号和封装"
- },
- {
- type: "doc",
- id: "electronics/tutorial/eda/chapter3",
- label: "设计原理图"
- },
- {
- type: "doc",
- id: "electronics/tutorial/eda/chapter4",
- label: "设计PCB"
- }
- ]
- },
- {
- type: "category",
- label: "Markdown",
- items: [
- {
- type: "doc",
- id: "electronics/tutorial/markdown/intro",
- label: "Markdown简介"
- },
- {
- type: "doc",
- id: "electronics/tutorial/markdown/chapter1",
- label: "Markdown语法(1)"
- },
- {
- type: "doc",
- id: "electronics/tutorial/markdown/chapter2",
- label: "Markdown语法(2)"
- }
- ]
- },
- {
- type: "category",
- label: "前端基础",
- items: [
- {
- type: "doc",
- id: "electronics/tutorial/web/intro",
- label: "前端基础"
- },
- {
- type: "doc",
- id: "electronics/tutorial/web/chapter1",
- label: "前端三语言"
- },
- {
- type: "doc",
- id: "electronics/tutorial/web/chapter2",
- label: "HTML基础"
- },
- {
- type: "doc",
- id: "electronics/tutorial/web/chapter3",
- label: "CSS基础"
- },
- {
- type: "doc",
- id: "electronics/tutorial/web/chapter4",
- label: "自我介绍"
- }
- ]
- }
- ]
- }
- ]
+ type: "doc",
+ label: "说明",
+ id: "intro"
}
- ]
+ ,
+ ...electronics]
};
module.exports = sidebars;