Skip to content

Commit d6ec17c

Browse files
tyuecodetyuecode
committed
feat: 新增「好文推荐」阅读清单
基于你博客已有的主题（命令行、Git、Jekyll、WSL2、ESP32、计算机基础）， 从网上大量搜集并精选高质量文章，整理成一个合规的阅读清单页。 - 新增 /reading/ 页面，按 6 个主题分类呈现 - 每条仅收录「权威链接 + 一句话点评」，不转载原文，尊重原作者版权 - 数据由 _data/reading.yml 驱动，后续增删改只需编辑这一个文件 - 收录 18 篇：命令行的艺术、MIT Missing Semester、Pro Git、 廖雪峰 Git 教程、ESP-IDF 官方文档、CS 自学指南、提问的智慧 等 - 首页 hero、头部导航、页脚同步加入口 仅引用链接，无任何原文复制，避免侵权。
1 parent 8065d83 commit d6ec17c

5 files changed

Lines changed: 159 additions & 0 deletions

File tree

‎_data/reading.yml‎

Lines changed: 92 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
# 好文推荐清单
2+
# 说明：本站只收录「链接 + 简要点评」，原文版权归原作者所有。
3+
# 数据文件驱动，后续增删改只需编辑本文件，无需改动页面模板。
4+
- category: 命令行与 Shell
5+
items:
6+
- title: 命令行的艺术
7+
url: https://github.com/jlevy/the-art-of-command-line
8+
source: GitHub · jlevy
9+
note: 一页纸讲透命令行技巧，从基础到冷门，中文版随仓库提供。你博客里那篇《命令行的艺术》正是受它启发。
10+
- title: 计算机教育中缺失的一课
11+
url: https://missing-semester-cn.github.io/
12+
source: MIT · 中文站
13+
note: MIT 官方课程，补上学校没教的 shell、编辑器、Git 等「工具熟练度」硬功夫。
14+
- title: 每个开发者都该知道的 CLI 技巧
15+
url: https://github.blog/developer-skills/programming-languages-and-frameworks/cli-tricks-every-developer-should-know/
16+
source: GitHub Blog
17+
note: 快捷键、通配符、管道、历史命令，官方工程团队的实战总结。
18+
- title: Explainshell
19+
url: https://explainshell.com/
20+
source: explainshell.com
21+
note: 把任意一条 shell 命令拆解成图解，看不懂的命令贴进去秒懂。
22+
23+
- category: Git 与 GitHub
24+
items:
25+
- title: Pro Git（中文版）
26+
url: https://git-scm.com/book/zh/v2
27+
source: git-scm.com
28+
note: Git 官方推荐教材，从安装到分布式协作全流程，免费在线阅读。
29+
- title: 廖雪峰 Git 教程
30+
url: https://www.liaoxuefeng.com/wiki/896043488029600
31+
source: liaoxuefeng.com
32+
note: 号称「史上最浅显易懂」，实战案例驱动，适合零基础快速上手。
33+
- title: 创建 GitHub Pages 站点
34+
url: https://docs.github.com/cn/pages/getting-started-with-github-pages/creating-a-github-pages-site
35+
source: GitHub Docs
36+
note: 你博客部署方式的权威文档，遇到 Pages 问题先查这里。
37+
38+
- category: 静态博客与建站
39+
items:
40+
- title: Jekyll 官方文档
41+
url: https://jekyllrb.com/
42+
source: jekyllrb.com
43+
note: 你正在用的引擎，主题、Liquid、插件、部署全在这里。
44+
- title: Jekyll 中文网
45+
url: http://jekyllcn.com/
46+
source: jekyllcn.com
47+
note: 官方文档的中文翻译，建站和部署的入门首选。
48+
- title: 开源博客框架横评
49+
url: https://zhupite.com/tool/blog-framework-comparison.html
50+
source: zhupite.com
51+
note: Astro / Hugo / Jekyll / Hexo / Grav 五框架对比，想换引擎前先读这篇。
52+
53+
- category: WSL2 开发环境
54+
items:
55+
- title: 设置 WSL 开发环境
56+
url: https://learn.microsoft.com/zh-cn/windows/wsl/setup/environment
57+
source: Microsoft Learn
58+
note: 官方最佳实践，从安装到 VS Code、Docker、GPU 加速一步到位。
59+
- title: 安装 WSL
60+
url: https://docs.microsoft.com/zh-cn/windows/wsl/wsl2-install
61+
source: Microsoft Learn
62+
note: wsl --install 一条命令的官方说明，含故障排查。
63+
64+
- category: 嵌入式与 ESP32
65+
items:
66+
- title: ESP-IDF 编程指南（中文）
67+
url: https://docs.espressif.com/projects/esp-idf/zh_CN/latest/esp32/index.html
68+
source: Espressif
69+
note: 乐鑫官方框架文档，你 ESP32 那篇文章的工具链源头。
70+
- title: ESP32 官方文档中心
71+
url: https://docs.espressif.com/
72+
source: Espressif
73+
note: 数据手册、入门指南、开发板手册的入口，硬件资料一网打尽。
74+
- title: 150+ ESP32 教程与项目
75+
url: https://microcontrollerslab.com/esp32-tutorials-projects/
76+
source: MicrocontrollersLab
77+
note: 从点灯到 BLE、MQTT、低功耗，海量可跑的项目教程（Arduino IDE）。
78+
79+
- category: 计算机基础与必读
80+
items:
81+
- title: CS 自学指南
82+
url: https://csdiy.wiki/
83+
source: csdiy.wiki
84+
note: 北大学长整理的计算机自学路线，附每门课的国内外公开课资源。
85+
- title: 提问的智慧（中文）
86+
url: https://github.com/ryanhanwu/How-To-Ask-Questions-The-Smart-Way
87+
source: GitHub · ESR
88+
note: Eric Raymond 经典之作，学会提问是开源社区的第一课，每个人都该读。
89+
- title: 程序员阅读清单：100 篇技术文章
90+
url: https://yuanxp77.github.io/p/%E7%A8%8B%E5%BA%8F%E5%91%98%E9%98%85%E8%AF%BB%E6%B8%85%E5%8D%95%E6%88%91%E5%96%9C%E6%AC%A2%E7%9A%84-100-%E7%AF%87%E6%8A%80%E6%9C%AF%E6%96%87%E7%AB%A0
91+
source: yuanxp77.github.io
92+
note: 内存、浮点、Unicode、性能调优等经典长文的一次性聚合。

‎_layouts/default.html‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -27,6 +27,7 @@ <h1><a href="{{ "/" | absolute_url }}">{{ site.title | default: site.github.repo
2727

2828
<nav class="site-nav">
2929
<a href="{{ "/search/" | relative_url }}">搜索</a>
30+
<a href="{{ "/reading/" | relative_url }}">好文推荐</a>
3031
<a href="{{ "/stats/" | relative_url }}">数据</a>
3132
<a href="{{ "/random/" | relative_url }}">🎲 手气不错</a>
3233
<a href="{{ "/tags/" | relative_url }}">标签</a>
@@ -59,6 +60,7 @@ <h1><a href="{{ "/" | absolute_url }}">{{ site.title | default: site.github.repo
5960
<a href="{{ "/about/" | relative_url }}">关于</a> ·
6061
<a href="{{ "/tags/" | relative_url }}">标签</a> ·
6162
<a href="{{ "/search/" | relative_url }}">搜索</a> ·
63+
<a href="{{ "/reading/" | relative_url }}">好文推荐</a> ·
6264
<a href="{{ "/stats/" | relative_url }}">数据</a> ·
6365
<a href="{{ "/random/" | relative_url }}">手气不错</a> ·
6466
<a href="{{ "/feed.xml" | relative_url }}">RSS</a>

‎assets/css/style.scss‎

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -861,6 +861,44 @@ kbd {
861861
color: var(--muted);
862862
}
863863

864+
/* ==========================================================================
865+
好文推荐 /reading/
866+
========================================================================== */
867+
.reading-list {
868+
margin: 0 0 8px;
869+
padding-left: 0;
870+
list-style: none;
871+
}
872+
873+
.reading-list li {
874+
padding: 12px 0;
875+
border-bottom: 1px solid var(--border);
876+
}
877+
878+
.reading-list li:last-child { border-bottom: 0; }
879+
880+
.reading-title {
881+
font-size: 15px;
882+
font-weight: 700;
883+
color: var(--heading);
884+
text-decoration: none;
885+
}
886+
887+
.reading-title:hover { color: var(--link); text-decoration: underline; }
888+
889+
.reading-source {
890+
margin-left: 8px;
891+
font-size: 12px;
892+
color: var(--muted);
893+
}
894+
895+
.reading-note {
896+
margin: 4px 0 0;
897+
font-size: 13px;
898+
line-height: 1.7;
899+
color: var(--text);
900+
}
901+
864902
/* ==========================================================================
865903
打印
866904
========================================================================== */

‎index.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ title: 主页
88
<p class="hero-desc">我是 TY，一个喜欢折腾 Linux、嵌入式和小工具的程序员。这里记录我的踩坑、心得和一点没用的技术浪漫。</p>
99
<div class="hero-actions">
1010
<a class="hero-btn hero-btn-primary" href="{{ "/about/" | relative_url }}">认识一下我</a>
11+
<a class="hero-btn" href="{{ "/reading/" | relative_url }}">📚 好文推荐</a>
1112
<a class="hero-btn" href="{{ "/random/" | relative_url }}">🎲 手气不错，读一篇</a>
1213
<a class="hero-btn" href="{{ "/stats/" | relative_url }}">📊 博客数据</a>
1314
</div>
@@ -44,6 +45,7 @@ title: 主页
4445
- [关于我](/about/)
4546
- [标签归档](/tags/)
4647
- [站内搜索](/search/)
48+
- [好文推荐](/reading/)
4749
- [博客数据](/stats/)
4850
- [手气不错](/random/)
4951
- [RSS 订阅](/feed.xml)

‎reading.md‎

Lines changed: 25 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,25 @@
1+
---
2+
title: 好文推荐
3+
layout: default
4+
permalink: /reading/
5+
---
6+
7+
<h1>好文推荐</h1>
8+
<p class="page-desc">我读过、觉得值得反复看的优质文章，按主题整理。只收录「链接 + 一句话点评」，原文版权归原作者所有。</p>
9+
10+
{% for section in site.data.reading %}
11+
<div class="stats-section">
12+
<h2>{{ section.category }}</h2>
13+
<ul class="reading-list">
14+
{% for item in section.items %}
15+
<li>
16+
<a class="reading-title" href="{{ item.url }}" target="_blank" rel="noopener">{{ item.title }}</a>
17+
<span class="reading-source">{{ item.source }}</span>
18+
<p class="reading-note">{{ item.note }}</p>
19+
</li>
20+
{% endfor %}
21+
</ul>
22+
</div>
23+
{% endfor %}
24+
25+
<p class="page-desc">提示：清单里的链接大多在 GitHub / 官方文档，部分可能需要科学上网才能流畅访问。</p>

0 commit comments

Comments
 (0)