Warmchay / Hexo-learn-document

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Hexo-blog-learning-doc

本教程以使用Hexo完成博客搭建这个简单任务为主线,涉及git与GitHub的使用、域名解析记录、CDN(以Cloudflare为例)、Node.js、markdown语法、dockerfile编写、CI/CD工具(以GitHub actions为例)等内容。期待在完成博客搭建这个小任务的过程中涉猎一些常用工具和学习一些基本技能。

完成本教程你将获得什么?

一个带有评论功能的、能够完成基本在线编辑功能的、有自定义域名的、配置CDN加速的、具有rss生成功能的基于Hexo的属于你自己的、几乎免费(也可以完全免费)的个人博客。

完成较好的同学可以获得微软周边小礼品

注:自定义域名那个在国内需要备案,CDN使用国内产品的话同样需要备案。

面向对象

内容设计较为基础简单,面向群体主要有:

  1. 想自己搭建博客的(废话)
  2. 想简单了解一下web的
  3. 想学习GitHub和git的
  4. 想简单了解教程开头那些涉及到的内容都是啥东西的
  5. 想来玩的

主要任务目录

  1. 学习了解GitHub并开始本教程
  2. 完成Step2开始前的准备部分,如果遇到问题在本仓库issue中提出
  3. 安装并完成hexo的最基本配置
  4. 使用GitHub pages发布你的内容
  5. 使用GitHub actions自动化博客的构建过程
  6. 为你的博客添加自定义域名、配置CDN加速
  7. 挑选博客主题、了解hexo的工作机制、简单修改主题、添加rss生成
  8. 如果愿意的话将你的博客和rss添加到MSCer RSS列表

Pre-Step

如果你听了本学期第一次技术沙龙的建议申请了学生邮箱的话,强烈建议在开始前去申请GitHub education pack

本文涉及的所有服务均可在pack中找到免费额度,而且不需要信用卡

申请需要你的学生邮箱以及学生证照片,另外上传照片时一定不要用梯子,会导致ip地址偏离学校太多审核失败

另外,你的学生邮箱能为你提供非常多的学生优惠,不过这不是本文的内容,可以参考知乎的这篇文章

Step1.1 了解git

基本内容(为顺利完成本教程必须掌握的内容):

首先请安装git 官方下载过慢的话可以从这里下载

粗略阅读这篇文章,没看懂的部分跳过即可,只要弄明白以下几个命令如何使用即可:

  1. git clone
  2. git add
  3. git commit
  4. git push
  5. git status

我想这份GitHub出品的git备忘录应该也会有帮助

基础扩展(日常使用经常用到的内容):

  1. 阅读这篇微信推文
  2. 弄明白下面几个命令:
    1. git checkout
    2. git log
    3. git reflog
    4. git merge
    5. git pull
  3. 解答issue #1中的问题(直接回复即可)

进阶阅读材料:

  1. 关于git原理 公众号文章通过 .git 目录深入理解 Git

Step1.2 了解github并完成签到任务

你可以参照GitHub的文档

此外我觉得如果你完成了Step1-1-基本内容那部分,那么接下来最好的方式就是尝试(随便乱点一通看看发生什么 逃)

  1. 请在自己的账号下面(如果没有请注册一个,这是下面必须的)创建一个仓库,不用纠结名字,然后尝试:
    1. 用上面的git知识向你的仓库添加一些东西
    2. 给自己的仓库提交一个issue
    3. 尝试删除自己的仓库
    4. 其它你想做的任何事情
  2. 我也给你准备了一个仓库你可以尝试:
    1. fork它并修改一些东西然后提交一个Pull Request
    2. 给这个交一个issue
    3. 其它你想做的任何事情

然后请完成签到任务fork本仓库,把你fork的把版本clone到本地,在Registration-list.md文件里面添加你的名字或昵称,commitpush,最后给本仓库提交一个Pull request

建议填写QQ昵称我会根据本教程的完成情况,在返校后发放一些微软周边小礼品

Step2&3&4

这部分请参照下面内容:

  1. hexo博客搭建教程(by alpha-yang) 此处超级超级感谢!!!
  2. hexo官方文档

附录-Hexo模版推荐

Volantis by 19-(。・∀・)ノ゙ヾ(・ω・。)

About