Skip to content

Commit

Permalink
Merge branch 'pianfan:main' into main
Browse files Browse the repository at this point in the history
  • Loading branch information
HowieHepburn authored Jul 17, 2024
2 parents 451bc28 + a745cee commit dd6a520
Show file tree
Hide file tree
Showing 3 changed files with 10 additions and 32 deletions.
10 changes: 4 additions & 6 deletions _posts/2024-1-25-letter_to_you.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
layout: post
title: "来自博主的一封告白信——致每一个我们"
title: "来自博主的一封信——致每一个我们"
date: 2024-1-25
tags: [notice]
comments: true
Expand All @@ -19,12 +19,10 @@ author: pianfan

- 作为面临就业压力的大学生,拥有自己的一个博客,并且发表过能体现个人水平和项目经历等有价值的内容,对于简历是一个不错的加分项。

- 作为立志成为IT界大牛的有志青年,早日养成写技术博客的习惯,有助于今后打造在互联网领域的个人品牌,提高自己的社区声望和影响力。

- 拥有自己的个人博客站点,可以不受第三方平台的限制,自主设计喜欢的页面风格,网站的一切规则几乎都由自己制定,自由度高,可塑性强,~~有逼格~~

以上原因也适用于每一个和我有着同样追求的你,所以,我的第一篇非公告类文章,会教你如何用最简单的方式借助 GitHub Pages 建立自己的个人博客。如果你目前还没有自己的专属个人博客,而且有这个想法,可以按照我教给你的步骤快速建造出你的个人博客网站。链接:[零基础小白如何搭建自己的 github.io 个人网站](https://pianfan.github.io/build_own_website/)当然,前提是你能打开 [GitHub 官网](https://github.com)
以上原因也适用于每一个和我有着同样追求的你,所以,我的第一篇非公告类文章,会教你如何用最简单的方式借助 GitHub Pages 建立自己的个人博客。如果你目前还没有自己的专属个人博客,而且有这个想法,可以按照我教给你的步骤快速建造出你的个人博客网站。链接:[零基础小白如何搭建自己的 github.io 个人网站](https://pianfan.github.io/build_own_website/)

非常感谢你阅读本篇文章。如果你在阅读教程类文章的过程中遇到什么问题,或是有其他需求,比如希望我出新的教程之类的,都可以进入 [issues](https://github.com/pianfan/pianfan.github.io/issues) 向社区提问或发布你的需求,博主一定会认真查看,而且说不定会有隐藏大佬回答你的问题(先orz了再说.jpg)。相信在这个技术开放的社区你会很有收获
非常感谢你阅读本篇文章。如果你在阅读教程类文章的过程中遇到什么问题,或是有其他需求,比如希望我出新的教程之类的,都可以进入 [issues](https://github.com/pianfan/pianfan.github.io/issues) 向社区提问或发布你的需求,博主一定会认真查看,而且说不定会有其他大佬回答你的问题

接下来的日子里,让我们一起,共同进步,见证成长,合力打造一个**平等、友好、开放、极简**的技术博客环境!你对我,对这个博客社区,对社区里的每一位成员,都至关重要。
接下来的日子里,让我们一起,共同进步,见证成长,合力打造一个**平等、友好、开放、极简**的技术博客环境!
4 changes: 1 addition & 3 deletions _posts/2024-1-26-user_manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,12 +26,10 @@ author: pianfan

![评论类型](https://pianfan.github.io/images/discussion.png "评论类型")

- 如果您想针对某一个文章或议题发表您的疑问,并希望得到更多更专业的解答,推荐您使用 [GitHub 提供的 issues 交流社区](https://github.com/pianfan/pianfan.github.io/issues),您也可以在这里解答他人的疑惑。除此之外,如果您发现我的文章中存在技术性错误,或者认为我的博客需要再添加一些功能,也可以在这里提出。
- 如果您想针对某一个文章或议题发表您的疑问,并希望得到更精确的解答,推荐您使用 [GitHub 提供的 issues 交流社区](https://github.com/pianfan/pianfan.github.io/issues),您也可以在这里解答他人的疑惑。除此之外,如果您发现我的文章中存在技术性错误,或者认为我的博客需要再添加一些功能,也可以在这里提出。

- 因为 github 官方网址可能无法访问,如果您对我的文章存在疑问,或者想要与我合作,可联系我的私人邮箱:<[email protected]>

如果今后我的博客到达了足够数量的活跃用户,我会考虑建一个博客专属qq群,供大家在群里交流讨论,但是目前来说还没有这个必要。

## 如何快速查找文章?

- **通过首页搜索框输入文章标题或标签进行查找**
Expand Down
28 changes: 5 additions & 23 deletions _posts/2024-1-27-build_own_website.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ author: pianfan

.md 文件是 markdown 文件,使用的是 Markdown 语言。这一易学易用的语言将 HTML 里的一些常见标签都用带有特殊含义的符号来表示,大大方便了文档的书写,而且对代码类文本的支持度很高,因此深受程序员的喜爱。我们的博客文章也需要用 Markdown 进行写作。如果你还不了解这个语言,可以去看[菜鸟教程](https://www.runoob.com/markdown/md-tutorial.html),非常简单。

令人欣喜的是,github 支持对 markdown 文件进行预览。当在 github 上对 markdown 文件进行编辑的时候,点击 Edit 旁边的 Preview,即可预览当前的页面效果。这在编辑过程中经常用来检查文章排版是否符合预期。
github 支持对 markdown 文件进行预览。当在 github 上对 markdown 文件进行编辑的时候,点击 Edit 旁边的 Preview,即可预览当前的页面效果。这在编辑过程中经常用来检查文章排版是否符合预期。

![切换预览](https://pianfan.github.io/images/preview.png)

Expand All @@ -73,7 +73,7 @@ author: pianfan

![头像和logo](https://pianfan.github.io/images/avatar&ico.png)

avatar 代表头像,后面的链接是你想显示在页面的头像图片的 url。favicon 指网站图标,即显示在浏览器标签页和收藏夹里的 logo,通常以 32 * 32 像素大小的 .ico 图片为宜,也可以不设置。注意不要直接用已经注册过的 logo 来当作自己的网站图标,否则有可能涉及到侵权问题。我的网站图标就是我自己设计的,与 GitHub 的 logo 有点相似,我确实是参照它来设计的。你们大概看得出来是一个熊的样子吧(
avatar 代表头像,后面的链接是你想显示在页面的头像图片的 url。favicon 指网站图标,即显示在浏览器标签页和收藏夹里的 logo,通常以 32 * 32 像素大小的 .ico 图片为宜,也可以不设置。

咱博客网站里的所有图片不是上传到 github 仓库里就可以显示到页面上了,需要用到图床。我用的是 [PicGo](https://picgo.github.io/PicGo-Doc/zh/),只要与 github 仓库绑定就可以实现上传,且可以一键复制为 Markdown 形式,方便写文时插入图片。

Expand All @@ -91,27 +91,21 @@ author: pianfan

![版权标注和网址](https://pianfan.github.io/images/footer&url.png)

这两个就是我不说你也知道怎么改吧……

我要说的是,对于自由度满级的个人网站而言,footer-text 不一定非得是版权标注,如果你不在意的话,就不必这么严肃。但如果说你网站里的内容都确确实实是你自己创作的劳动成果的话,最好还是要有一个**版权声明**,以免无耻之人随便盗用你的文章。

- **其他**

如果你不知道改了之后会有什么后果,**不要去动它**

- ### 删除 _posts 文件夹并重建

_posts 文件夹里放的是博客文章,你以后的文章也要放在这里。现在你的_posts 文件夹里面放的还是我的文章,**请把它们全部删除**,以免造成侵权。如果要转载我的文章,请通过邮件向我申请。建议非必要不转载,直接分享链接是一样的效果。
_posts 文件夹里放的是博客文章,你以后的文章也要放在这里。现在你的_posts 文件夹里面放的还是我的文章,**请把它们全部删除**,以免造成侵权。

- ### 删除 images 文件夹并重建

别看了,快删,你留着我的图片干嘛,暗恋哥?

- ### 修改 about.md文件

about.md里的内容是展示在“关于”页面上的。

好了,以上就是所有必须要你修改的文件。你现在再点进去你的博客页面看看,不出意外的话应该是成功修改了的。这就是你最开始的博客网站了,以后的日子,就由你自己去探索、去创造、去经营。
好了,以上就是所有必须要你修改的文件。你现在再点进去你的博客页面看看,不出意外的话应该是成功修改了的。

## Step 3. 开始写你的第一篇文章

Expand All @@ -137,18 +131,6 @@ author: pianfan

- tags 是文章标签,可以有一个或多个。

- comments 不用管。本来我是打算用 Gitalk 做评论系统,但是一直连不上那边的服务器,不但无法使用评论,还拖慢网页加载速度,十分影响用户体验。我一开始是把它的相关文件都删了的,结果导致 Jekyll 那边无法通过,所以我后来用注释的形式将它屏蔽了(ps:其实由 GitHubPages 提供域名的个人网站并非完全由我们自己控制,而是借助了 Jekyll 静态网站生成器,它主要是提供一些部署上的支持,如果没有它,我们的网站就无法生成。所以我们要严格按照人家的规定来,不能随便乱动仓库里的文件结构)。那么干脆就用 GitHub 官方平台的评论系统,反正不用白不用嘛。

去开始构思你的第一篇博客文章吧,好的开始是成功的一半。如果你能坚持下去,我将会非常佩服你。因为我也不敢确定自己能否把写文的习惯坚持下去,这需要长期的投入,而且不一定有很理想的回馈。

---

恭喜你!读到这里,你已经成功一半了。剩下的那一半,需要你去自己摸索:这个博客仓库里的每一个文件里的每一句代码都有什么意义,该怎么把它玩转?如何改变网页的结构?如何把网页弄成你最喜欢的样式?如何给网站添加更多实用的功能?如何写出高质量高点击率的文章?如何吸引更多的人来到你的博客?如何把你的博客长期经营下去……等等等等。真的想做好个人博客的话,这些问题都是要考虑的。

感谢阅读,如果本篇文章对你有所帮助或启发,不妨在[评论区](https://github.com/pianfan/pianfan.github.io/discussions)里赞美一下博主,让博主看到你们的反馈,这样我就会更有信心和动力继续写下去了。

有什么疑问,请一定不要害羞,大胆在[社区](https://github.com/pianfan/pianfan.github.io/issues)提出来,这样我才能帮助你解答疑惑。

如果有读者要求的话,我会考虑出本篇教程的后续,来讲解具体怎么操作来改变博客的结构、样式和添加功能。

我应该不会讲 HTML、CSS 和 JavaScript 的语法规则,因为笔者实在觉得没有这个必要,笔者的目标也不是成为 Web 前端工程师,这些东西我也只是浅尝辄止。如果你正在找这方面的学习资源,可以去读 [MDN Web Docs](https://developer.mozilla.org/zh-CN/),这应该算是最权威的前端文档了,而且浅显易懂、内容精简,小白也能轻松掌握。[菜鸟教程](https://www.runoob.com/)的前端教程还要全面一点,也是专门为初学者设计的。笔者建议可以两个同时进行,先看一个学习完一节内容,再看另一个巩固一下,这也达到了练习和查漏补缺的效果。如果你比较倾向于跟着视频学习,那更不用说了,b站一抓一大把。
感谢阅读!

0 comments on commit dd6a520

Please sign in to comment.