实验一 在Github上用Markdown创建技术博客

一、实验目的

1.熟悉Github网站
2.掌握Markdown语法

二、实验任务

1.注册Github账号
2.创建Github Pages repository
3.发布第一篇博客
4.学习Markdown
5.利用Hexo生成博客并部署到Github

三、实验步骤与结果

1.注册Github账号

打开Github,网址https://github.com/,点击右上角Sign up进入注册页面,填写相关信息创建账号,并打开邮箱确认信息。
我注册的用户名为:chen-rhythm

2.创建Github Pages repository

登录账号,点击Start a project,或者右上角“+”选择New repository,进入仓库创建页面,其中Repo name必填,其它选填。
点击右上角头像选择Your profile进入自己的github主页,在Repository里面看到拥有的所有仓库,包括自己创建的和Fork别人来的仓库。

3.发布第一篇博客

在仓库里,点击Create new file写一篇后缀名为.md的文件,采用Markdown语法,写完之后点击Commit new file完成发布。
如需进行修改,点击该文件,在右上角找到铅笔字样的图标(Edit this file),进入编辑页面,修改完后点击Commit changes提交修改,可以点History查看修改记录。也可以Fork别人的仓库进行修改,Pull requests请求与原仓库合并。
Fork一篇文章并Pull request
Pull request

4.学习Markdown

参考作业部落https://www.zybuluo.com/提供的语法帮助。

5.利用Hexo生成博客并部署到Github

结果展示
1.安装Git,Node.js
2.新建MD文件夹,在该目录下右键选择Git Bash Here
3.设置npm淘宝镜像

1
$ npm install -g cnpm --registry=https://registry.npm.taobao.org

4.安装Hexo

1
$ npm install -g hexo-cli

5.初始化站点

1
2
3
$ hexo init hexo
$ cd /d/MD/hexo
$ npm install

6.本地部署测试

1
$ hexo s

服务运行起来之后,打开浏览器,输入http://localhost:4000/即可打开Hexo的默认页面
7.新建仓库
登录Github,创建一个repository,名称必须是——用户名.github.io
8.修改配置文件
打开hexo目录下的_config.yml文件,找到最后Deployment的配置并修改,在repo一行中填上自己的Github用户名,注意冒号和末尾的.git,格式如下:

1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
type: git
repo: git@github.com:用户名/用户名.github.io.git
branch: master

9.安装Hexo-deployer-git
在hexo目录下,右键选择Git Bash Here

1
$ npm install hexo-deployer-git --save

10.配置Git全局邮箱&用户名

1
2
3
$ npm install hexo-deployer-git --save
$ git config --global user.email "邮箱"
$ git config --global user.name "用户名"

11.生成并部署博客

1
$ hexo d -g

更多详细内容请参看利用Hexo生成博客并部署到Github

四、实验小结

本次实验学习并尝试使用Github,并利用Hexo将Github部署到了网页上。难点在于本地配置Hexo文件,总是出现很多问题,但是基本上已经解决了。
>>点此回到开头<<