GitHub Pages Start!

GitHub Pages

  在github注册生成一个仓库，并命名为username.github.io 。进行仓库设置倒数第2?个有Page设置，可以在里面选择主题以及编辑自定义域名等操作。在绑定自己域名前，默认域名为前面设置的名字。点击进入自己的网站。基于Jekyll框架和Hexo框架搭建有较大的差异，前者甚至不需要本地环境的设置，无需命令操作；后者要搭建本地环境，在本地生成好网页页面再上传。

一、jekyll

  jekyll设置很简单，只需要将主题复制到自己仓库下，或者use this template方法创建自己的Pages仓库，也可心在本地搭建环境，并生成服务器预览后git上传（github客户端上传）。然后在指定的文件夹内用MD语法进行文章的编辑，上传就可以。总之基于jekyll的可以不用本地环境（用于预览需要），网页文件全部是在云端生成的。但是jekyll的主题比较简单，功能单一，中文资源较少入门比较困难。
  jekyll生成后在根目录有许多文件夹（强制生成时会覆盖掉CNAME文件，它是GHPs的域名定义文件），其中 _posts 文件夹存放文章。写好文章后，可以在本地渲染后查看效果再上传，运行 jekyll serve 命令, 它能启动一个网页服务器，然后自动生成网页文本。再能过git或者客户端上传文件就可以了。
  由于github仓库是公开的，所以这种方式下你文章的原始md文件也可以被他人获取。其它的一些按照规范设置书写就好了。由于前面说的各个劣势，主要是中文资源少，遇到问题不好解决。加之本地环境搭建时，jekyll在windows用户名为中文时会报错，不要重新创建用户进行搭建。最后jekyll主题简单，可玩性不强，比较纯粹的文章型博客。最后弃坑jekyll，入坑hexo；但因为基于Jekyll框架和Hexo框架搭建有较大的差异，在搭建hexo时怀着jekyll的认识，导致走了许多弯路，失败了数次才成功。

二、Hexo

  相比jekyll而言，HEexo社区有许多中文玩家，贡献了大量的主题以及插件来丰富优化自己的博客网站。Hexo的网页都是在本地生成再上传的，所以主题、插件等都在本地，云端只有网页的文件了。

1、安装配置

  首先生成github pages，然后根据官方文档，对本地环境搭建（比jekyll环境好搭建许多）（前置环境：git、node.js）。然后随便选择一个文件夹来存放建设网站的相关数据（例如叫Hexo）,也称之为根目录。今后的许多插件安装，文件生成上传等都是在这个目录下进行。

1. 通过hexo init命令在根目录生成相关文件
2. 通过 hexo new 文件名生成文章并编写
3. 通过hexo g生成文章
4. 通过hexo s建立本地服务器，本地查看网页效果，可实时修改，但上传前要先g生成一次才行
5. 上传文件夹public里面的内容到github或者其它托管网站里
   • 通过客户端，手动将public里面的内容复制并替换掉客户端对应仓库的文件夹里面。通过硬链接和符号链接的方式都不能自动复制过去，客户端识别时会有问题。
   • 通过git上传——hexo s，前提要配置SSH密钥。

2、SSH相关

参考文献5有详细的SSH生成配置过程。ssh生成后会在c:user/[username]/.ssh/里面生成2个文件，无后缀的为私钥，有后缀的为公钥。

ssh     #生成用户名
        #生成用户邮箱
        #生成ssh密钥，可直接用于github pages里面
        #测试
        #添加密钥

3、参考

1. 官方文档
2. matery
3. butterfly
4. easy
5. shawloon

三、markdown语法

1、标题

在标题的下一行用====表示一级标题，—-表示二级标题。（好像不行）
在标题前用n个#表示n级标题。

2、段落

在段落的末尾加上2个以上空格再回车就是换行，或者两段之间空一行。

1)字体

<<<<<<< HEAD
斜体&斜体(星 文字 星)（_ 文字 _）
粗体&粗体(二星 文字 二星)（二划 文字 二划）
斜粗体, 斜粗体 （三星 文字 三星）（三划 文字 三划）

2)分隔线(useless)

用3个以上的*或-或_来形成分隔线

---

分隔线

---

分隔线

---

3)删除线

在文字两端添加2个~代表删除线
删除线就是我

4)下划线

在文字的两端加上<字母u>和<左斜 字母u>

5)脚注

文字[指数号 脚注]
[指数号 脚注]：脚注说明
例：我要发表一篇ISSCC[^ISSCC]
[^ISSCC]: 集成电路设计顶级会议！

3、列表

1)无序列表

使用星号(*)、加号(+)或是减号(-)作为列表标记，这些标记后面要添加一个空格，然后再填写内容。

• 新年

• 快乐

• 恭喜

• 发财

2)有序列表

使用数字并加上.再空格

1. 新年
2. 快乐

3)列表嵌套

列表嵌套只需在子列表中的选项前面添加4个空格即可

• 新年
  1. 新年快乐
  2. 恭喜发财
• 发财
  1. 财源广进
  2. 一夜暴富

4、区块

1)区块引用

区块引用是在段落开头使用 > 符号 ，然后后面紧跟一个空格符号

区块引用
能干什么呢？
把这个区域标识出来了

2)区块的嵌套

一个 > 符号是最外层，两个 > 符号是第一层嵌套，以此类推。类似标题格式。

第一章

第1节

第1段

3)列表中放区块

1. 列表一

   区块1.1
   区块1.2

2. 列表二

   区块2.1

4)区块中放列表

区块一

1. 列表1.1
   2. 列表1.2

• 列表二
• 列表三

5、代码

如果是段落上的一个函数或片段的代码可以用反引号把它包起来，printf()函数

1)代码区块

用4个空格或一个Tab键
<?hph
echo ‘hello,world’;
function ….
>
也可以用3个`包裹一段代码，并紧接着指定在一种语言

$(document).ready(function()){
  alert('hello');
};

6、链接

1)简单地址

[链接名](地址) 或者直接显示地址<地址>
百度

2)高级地址

我们可以通过变量来设置一个链接，变量赋值在文档末尾进行

[谷歌][google]，文末再统一赋值[google]: www.google.com

友情链接：谷歌

7、图片

图片的语法格式

![alt 属性文本](地址 "可选标题")  
也可以向网址一样对图片网址进行变量代换  
设置宽度<img src="https://gimg2.baidu.com/image_search/s0c" width="50%">

8、表格(useless)

paper	noise figure(NF)	OIP3
jssc	3.2	-3
ISSCC	2.8	0

9、进阶

进阶技巧

---

---