Skip to content

Commit 51e7514

Browse files
RenchZhaoRenchZhao
committed
Add ReadMe.md LICENSE and blog building-my-website
1 parent 0d096ca commit 51e7514

File tree

9 files changed

+134
-11
lines changed

9 files changed

+134
-11
lines changed

‎LICENSE‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
The MIT License (MIT)
2+
3+
Copyright (c) 2026 Rench Zhao
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
6+
7+
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
8+
9+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

‎ReadMe.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
2+
# 开发过程与说明
3+
- 作者使用Vibe Coding技巧搭建了这个仓库。
4+
- 这篇博客描述了这个仓库的开发过程与说明：[我如何在一天内用黑客马拉松精神搭建这个网站](https://renchzhao.github.io/学习笔记/2026/01/13/building-my-website.html)
5+
- 欢迎各位克隆本仓库并在一天之内完成你自己的个人网站！！你愿意接受这个挑战吗？
6+
7+
# 网站开发框架
8+
9+
本网站基于[Jekyll](https://github.com/jekyll/jekyll)框架开发。Jekyll采用MIT许可证，原始版权信息如下：
10+
> Copyright (c) 2008-present Tom Preston-Werner and Jekyll contributors
11+

‎_config.yml‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,9 +23,9 @@
2323
title: "RenchZhao's WorkStation"
2424
email: RenchZhao@189.com
2525
description: >- # this means to ignore newlines until "baseurl:"
26-
Write an awesome description for your new site here. You can edit this
27-
line in _config.yml. It will appear in your document head meta (for
28-
Google search results) and in your feed.xml site description.
26+
RenchZhao's WorkStation, his personal website contains of gallery information such as cv, blogs and publications.
27+
He completed this website in one day with the spirit of hackathon.
28+
I challenge you to build your personal website in one day like him.
2929
baseurl: "/"
3030
url: ""
3131
# baseurl: "/"

‎_pages/cv.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -8,8 +8,8 @@ author_profile: true
88
# 技能
99
---
1010
- 编程语言：Python, C++, Java
11-
- 框架工具：PyTorch, TensorFlow, Jekyll, Langgraph
12-
- 技能领域：软件工程, 深度学习, NLP, LLMs, RAG, Agent, Git, Docker, Linux Shell
11+
- 框架工具：PyTorch, TensorFlow, Jekyll, Langgraph, Git, Docker, Linux Shell
12+
- 技能领域：软件工程, 深度学习, NLP, LLMs, RAG, Agent
1313

1414
# 教育背景
1515
---
@@ -45,5 +45,5 @@ author_profile: true
4545
基于LLaMA-Factory使用LoRA算法微调
4646

4747
- **基于Langgraph和Tavily搜索引擎的RAG文献检索Agent** - 2025.08 - 2025.09
48-
使用量化技术和缓存优化，将推理速度提升3倍
48+
Agent通过结果反馈对Query迭代优化持续提升搜索效果
4949

‎_pages/publications.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,6 @@
22
layout: archive
33
title: "出版物"
44
permalink: /publications/
5-
author_profile: true
65
---
76

87
# 论文

‎_posts/2026-01-12-my-first-post.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ layout: single
33
title: "我的第一篇博客"
44
date: 2026-01-12 23:30:00 +0800
55
categories: 学习笔记
6-
tags: [Jekyll, 博客, Quick Start]
6+
tags: [Jekyll, 博客, Python]
77
---
88

99
这是我使用Jekyll搭建的第一篇博客！
@@ -13,4 +13,4 @@ tags: [Jekyll, 博客, Quick Start]
1313
```python
1414
def hello_world():
1515
print("Hello, Jekyll!")
16-
16+
```

‎_posts/2026-01-12-welcome-to-jekyll.markdown‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,10 @@
22
layout: single
33
title: "Welcome to Jekyll!"
44
date: 2026-01-12 23:57:56 +0800
5-
categories: jekyll update
5+
categories: jekyll
66
---
7+
# 这是一条Jekyll官方面对网页开发者的博客
8+
79
You’ll find this post in your `_posts` directory. Go ahead and edit it and re-build the site to see your changes. You can rebuild the site in many different ways, but the most common way is to run `jekyll serve`, which launches a web server and auto-regenerates your site when a file is updated.
810

911
Jekyll requires blog post files to be named according to the following format:

‎_posts/2026-01-13-building-my-website.md‎

Lines changed: 102 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,102 @@
1+
---
2+
layout: single
3+
title: "我如何在一天内用黑客马拉松精神搭建这个网站"
4+
date: 2026-01-13 22:22:00 +0800
5+
categories: 学习笔记
6+
tags: [Jekyll, 博客, Vibe Coding, 前端]
7+
---
8+
9+
本网站源代码已在[github仓库](https://github.com/RenchZhao/RenchZhao.github.io)开源了，欢迎借鉴
10+
11+
## 动机
12+
每当我看到大牛博主，我的师兄还有我的老师拥有自己的个人网页，我就非常羡慕。
13+
做一个自己的网站看起来是一件很酷的事情。仔细想来，这不仅是一种学习内容留痕，帮助更多人学习，更是个人能力展示平台和品牌架构。
14+
习惯建立起来之后有很多输出的博客。可以帮助其他学习者。
15+
同时面试官查看你的博客和网页，就是对你的技术最好的肯定。
16+
17+
但是我一直觉得我的相关技术学的不好，没有开始自己的实践，而是仅仅在远处看看。
18+
直到2026年，Vibe Coding火热了，许多不会编程的人也可以迅速搭起一个网站。
19+
我还有编程技术基础，那就更应该尝试一下了？想到这一点，我尝试改变行为方式，先去做而不是先去学。事实证明这对我来说是更成功的策略。
20+
21+
## 搭建过程
22+
我以黑客马拉松精神在一天之内完成这一个网站的雏形。
23+
或者简单的说，就是心无旁骛地全心全意投入一天时间，尽可能快速完成一个原型。不管技术会不会，先动手去做，在做中学习。
24+
我是从[数字游牧人](https://space.bilibili.com/4848323)视频这里第一次接触到"黑客马拉松"这一精神。
25+
你的潜力像水下的冰山，有时候你并不是做不到，只不过是你没有让脑中的潜意识认为这个任务是可能完成的罢了。
26+
不开始想具体怎么做，你的潜意识会认为这目标是不可能的，因此一直不去做。永远未能开始，又怎么能够完成？
27+
28+
我合作的对象是中国字节跳动公司开发的“扣子空间”Agent与中国阿里巴巴公司的千问AI。
29+
在2026年1月12日晚至2026年1月13日下午的过程中，我们合作完成了这个网站项目，或者说，我在这两个AI的指导下完成了这个项目。
30+
因为我希望作为开发维护者，了解实现的细节，因此我没有让AI完全自主以Agent模式设计所有代码，而是要求它们提供模板，我在上面改进。
31+
因此我花1天时间也许还算久的，如果您只是需要一个网站成品，也许更快，一个上午就行。
32+
33+
此前，我对Jekyll和Ruby语言一无所知。我只有一点点Html和Java Script基础。
34+
"扣子空间"Agent和我交流之后根据我既想放简历又想要贴博客的需求，向我推荐了Ruby语言的Jekyll框架。
35+
Jekyll框架能从MarkDown翻译成Html，让我专注于内容即可。这是很吸引我的，我因此上了这艘船。
36+
37+
其实上手Jekyll框架并不困难，2个小时我就完成了全部功能。
38+
事实证明，即使不会Ruby语言，也不会所有的前端知识，你同样可以在1天内完成这个网站。
39+
时间大头是环境调试，开发的这一天里，有80%时间是环境配置debug，详见下方的踩坑总结部分。
40+
41+
有时候强如扣子AI，也不可能一次性考虑到所有事情。它能ReAct慢慢找到解决方案是最好的，但是这次我没有使用。
42+
因为我想边搭建网站边学习，因此仍然采取自己撰写大部分代码的方式。
43+
不过如果自己搭，还是会有一定的坑会踩到的。我一边学习一边踩坑debug。
44+
如果有bug，我先自己尝试解决，找到解决方案就让我的AI导师判断我的修改是否正确。在debug过程中理解代码是如何工作的。
45+
如果我感觉报的错误是细节问题和扣子AI上下文没这么接近，我就会复制报错信息给千问AI，它也是一个不错的反馈迅速的导师。
46+
还是需要去官网先搜索Quick Start等类似的代码，读懂之后AI判断解决方案，然后有bug再输回给AI进行反馈迭代。
47+
48+
## 踩坑总结
49+
我主要踩了3个坑：include，layout，remote-theme这三个。
50+
如果你没有动手使用Jekyll框架搭建过网站，可能难以理解。建议你先上手尝试过后再看这一部分。
51+
52+
### _config.yml中的include
53+
Jekyll在将MarkDown转换成Html时候默认只搜寻根目录。我听从扣子AI建议用Minimal-Mistakes风格将一些页面放在_page文件夹下面，这导致无法生成_site文件夹下Html时没有被搜寻到，然后页面404。
54+
扣子AI排查了6-7轮才找到这个原因。
55+
56+
### md页面的Front Matter中的Layout
57+
扣子AI的模板代码生成时候有时候我没有给_config.yml中theme的上下文，导致md页面的Front Matter中的Layout是theme中没有定义的。
58+
这导致theme找不到对应的Layout按照无Layout生成,页面是朴素的Html页面，只有内容没有好的组织格式。
59+
后来我自己意识到这个问题，询问扣子AI我的theme有哪些Layout才解决这个问题。
60+
61+
不过后来还有一些内容字体格式等等没解决。我想在theme的Layout上面微调，但是没成功。
62+
扣子AI最后也没有找到解决方案，就是自己写的CSS样式微调的部分可能被theme的CSS覆盖掉。
63+
因此可能还得是全部CSS自己写。
64+
65+
下面列出了我使用的theme:Minimal-Mistakes-Jekyll的各种可用Layout
66+
|场景|推荐Layout|说明|
67+
| ----------- | ----------- | ----------- |
68+
|个人简介、CV、Projects|single|单页内容，带作者头像|
69+
|博客文章列表|archive|时间线样式，适合列表；例如博客首页，显示所有文章|
70+
|首页|home|首页专用布局，支持更多配置|
71+
|分类归档|categories|按分类显示文章，便于读者查看特定分类下的文章|
72+
|标签归档|tags|按标签显示文章，便于读者查看特定标签下的文章|
73+
|欢迎页|splash|大图背景，适合着陆页|
74+
|搜索页|search|搜索功能页面|
75+
76+
77+
### github.io第三方网页部署环境和本地不一样
78+
这个算是较有心理准备而且容易解决的坑了。因为不同机器环境不一样跑不起来的事情简直太多了。
79+
本地的网页调试是正常的，但是传到github就无法build，报错找不到theme。
80+
扣子AI好几轮对话都没能找到真正的问题。我自己搜索官方教程就能很快解决。
81+
原因是我本地调试用theme能够调用本地环境gem加载内容，正确生成网页。
82+
但是在github上不能这样，需要使用remote-theme代替theme。修改其实很容易。
83+
84+
首先Gemfile的gem "jekyll"换成gem "github-pages"加上对应github教程版本；
85+
后面加上gem "jekyll-include-cache", group: :jekyll_plugins即可。
86+
```
87+
gem "github-pages", "~> 232", group: :jekyll_plugins
88+
# gem "jekyll", "~> 4.4.1"
89+
gem "jekyll-include-cache", group: :jekyll_plugins
90+
```
91+
92+
然后_config.yml将theme改成remote_theme。@字符后面是版本号或者是可以追踪到特定提交版本的哈希值。
93+
```
94+
# theme: minimal-mistakes-jekyll
95+
remote_theme: "mmistakes/minimal-mistakes@4.27.3"
96+
```
97+
98+
参考这两个官方教程就能很快掌握：
99+
- [https://docs.github.com/zh/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll](https://docs.github.com/zh/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll)
100+
101+
- [https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/](https://mmistakes.github.io/minimal-mistakes/docs/quick-start-guide/)
102+

‎requirements.txt‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# I deployed it on Ubuntu 22.04
1+
# I developed it on Ubuntu 22.04
22
# https://www.jekyll.com.cn/docs/installation/#requirements
33
# https://www.jekyll.com.cn/docs/
44

0 commit comments

Comments
 (0)