美文网首页
Re:0从零开始在Github上用Hexo搭博客

Re:0从零开始在Github上用Hexo搭博客

作者: 米娜浮莲子 | 来源:发表于2017-09-13 23:36 被阅读71次

    前言:

    现在网上虽然已经有了不少详细的在github上搭建独立博客教程,但是不少都是几年前的,或是需要一些门槛才能理解,完全新手的话单看一个教程难免走些弯路。我打算在前人经验基础上结合自己的摸索经历写一篇非“程序员”也能照做的教程。

    强调一下,如果有足够的阅读能力的话建议直接阅读文档就能解决许多问题,这就像游戏的新手教学,虽然无趣了点,但对上手绝对是帮助最大的。

    为什么要搭博客

    可能有人会觉得有了简书、WordPress这样的网站,为什么我还要费力去搭一个?自己的博客其实有这些好处

    • 完全属于自己的空间。百度倒闭了也不用担心github会倒,很适合在互联网上留下自己的足迹。
    • 自由加载模块,主题,功能全可以定制,功能全靠自己定制,以后可以升级成了不得的东西
    • Cool. Cooler. Coolest!

    须要知道的基础设定

    • Github.com: 可以交流代码的社交网站,免费
    • Github pages:托管在github上的静态网页,原本用于介绍项目,也可以用来搭博客
    • Hexo: Hexo 是一个快速、简洁且高效的博客框架。可以方便的生成页面

    本地准备: 首先不用去管域名服务器方面的事,我们可以先在本地把环境装好。需要的有以下几个软件
    Git
    Node.js
    以上就是安装hexo的必备软件,如果不能下载了的话也可以搜一下国内的镜像

    接下来开始本地环境的搭建:

    首先注册个github网页,自己新建个username.github.io的库,其中username指你注册时的用户名,下同。依据官方介绍,这个名字的库的github pages可以从非库目录里上传,所以我们可以以后通过hexo来发布博客,大概就是为了做个人主页这一用途吧,注意每个账号仅限一个这种库,而且用别的库后改名是无效的。

    在本地新建个空文件夹,用来存放你的博客内容,在该文件夹下右键选择“打开Git Bash”打开控制台,如果事先打开了git bash的话需要用cd命令来到该目录下。控制台可以右键粘贴代码的,所以不会命令行也不用慌;
    然后需要安装ssh key,ssh key是用来连接本地项目和你的github项目的,具体可以参照使用Github Pages建独立博客的内容,为了方便把代码部分拷贝过来了

    1·、首先检查本地是否已有ssh :

    $ cd ~/.ssh
    

    如果显示“No such file or directory”,跳到第三步,否则继续。

    2、 备份和移除原来的ssh key设置:

    因为已经存在key文件,所以需要备份旧的数据并删除:

    $ ls
    config  id_rsa  id_rsa.pub  known_hosts
    $ mkdir key_backup
    $ cp id_rsa* key_backup
    $ rm id_rsa*
    

    3、生成新的SSH Key:

    输入下面的代码,就可以生成新的key文件

    $ ssh-keygen -t rsa -C "邮件地址@youremail.com"
    

    显示

    Generating public/private rsa key pair.
    Enter file in which to save the key (/Users/your_user_directory/.ssh/id_rsa):
    

    我们只需要默认设置就好,所以当需要输入文件名的时候,回车就好
    然后系统会要你输入加密串(Passphrase)

    Enter passphrase (empty for no passphrase):<输入加密串>
    Enter same passphrase again:<再次输入加密串>
    

    最后会出现一个字符画表明生成完毕

    4、添加SSH Key到github

    在本机搜索id_rsa.pub这个文件,一般来说在c盘下,用自带搜索很方便就找到了,搜不到把隐藏文件设为可见。用文本编辑工具,如记事本打开文件,打开github,点击自己头像,在settings选项下SSH key下新建一个,把刚才文件中的内容全部复制粘贴保存即可。

    5. 测试一下

    控制台输入下面的命令,看看设置是否成功,git@github.com的部分不要修改:

    $ ssh -T git@github.com
    

    会显示,直接输yes就好

    The authenticity of host 'github.com (207.97.227.239)' can't be established.
    RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
    Are you sure you want to continue connecting (yes/no)?
    

    6. 设置你的账号信息

    现在你已经可以通过SSH链接到GitHub了,还有一些个人信息需要完善的。

    Git会根据用户的名字和邮箱来记录提交,GitHub也是用这些信息来做权限的处理,输入下面的代码进行个人信息的设置,把名称和邮箱替换成你自己的,名字不要和昵称相同。邮箱是用来接受博客信息的。

    $ git config --global user.name "你的名字"
    $ git config --global user.email "your_email@youremail.com"
    

    安装Hexo

    以上准备完毕后开始安装hexo,因为我们采用hexo框架,所以官方文档和某些博客中提到的用ruby和jykell模板的方法就不推荐大家使用了,这样也不用安装配置ruby(RWBY?( ̄▽ ̄)~*)环境了
    安装只需要在控制台输入

    $ npm install -g hexo-cli
    $ hexo init //需要在空文件夹下执行该命令
    $ npm install
    

    然后稍等会自动下载文件到你选的文件夹中,建立完成后文件结构如下。

    .
    ├── _config.yml
    ├── package.json
    ├── scaffolds
    ├── source
    |   ├── _drafts
    |   └── _posts
    └── themes
    
    

    hexo可以使用多种模板,如果对自带的样式不满意可以到这里下载,下载完的文件解压到themes文件夹下,可以改个简短的名字

    之后需要修改_config.yml文件来进一步部署博客,在#Site标签下的一些是你个人站点的信息,如果想要进一步个性化自己的站点还可以修改其他标签下的参数,但是要注意冒号后面要空一格,不然会报错●| ̄|_
    如果要利用Git部署的话,需要把deploy下面添加如下

    type: git
    repo: 你的项目网址
    branch: master
    

    如果了使用不同主题,需要把themes后面改成你所用主题的名字,同时需要更改主题文件夹下的_config.yml文件对显示的信息进行调整,这个因不同主题而异。

    开始写文章时可以用命令$ hexo new "title",或者直接新建md文件放在\source_posts下也可以,编辑md文件,注意语法,编辑完成后执行部署命令

    $ hexo generate
    $ hexo deploy
    

    生成并部署页面,因为是及时刷新的,直接上传再看有没有需要改的也可以

    域名和DNS配置

    现在你的个人主页地址仍然还是https://username.github.io ,如果想要真有拥有自己的独立博客的话一个有个性的域名是必要的。

    购买域名其实很容易,这里就推荐大家去腾讯云或者阿里云搞一个.cn或.com就好,有微信支付宝账号就可以搞定了。去Godaddy狗爹买域名虽然可以买些.me .io之类有趣的域名,但是由于国内互联网大环境已经某些无良供应商,如某联通宽带,的原因会导致国外域名dns解析不出来,希望大家三思。至于买几年就看你自己想法了,可以买一年,到时候再更换或者续费

    DNS服务推荐大家使用腾讯旗下的DNSPod,免费还不错。登录DNSPod后台,新建两条记录,类型分别是“www”和“*”类型填CNAME。更改地址还需要在博客项目的setting中,gh-page选项那填上你的域名,然后在库里新建个叫CNAME文件,注意没有后缀,也输入域名然后保存。如果不出差错的话,这时访问你的个人域名就可以看到博客的内容了。

    至此个人的独立博客算基本完成了,如果按照教程来做就算不太明白原理你也应该能搭出来,当然此时博客也就相当于一个简单的网络日记本,功能还很粗糙。后续的优化和各种插件的安装使用、SEO优化之类就是新手级的问题了,后续如果有机会再写个教程讲述一下。

    写这篇教程参考了以下文章:

    相关文章

      网友评论

          本文标题:Re:0从零开始在Github上用Hexo搭博客

          本文链接:https://www.haomeiwen.com/subject/hthrsxtx.html