美文网首页
Hexo + github 构建博客

Hexo + github 构建博客

作者: YQY_苑 | 来源:发表于2018-02-12 13:13 被阅读0次

    概况

    1. 为什么选择GitHub Pages
      1、GitHub Pages有免费的代码托管空间,资料自己管理,保存可靠;
      2、学着用 GitHub,享受 GitHub 的便利,上面有很多大牛,眼界会开阔很多;
      3、顺便理解 GitHub 工作原理,最好的团队协作流程;
      4、GitHub建立私有仓库才会收费,所以会有很多开源代码。
    2. GitHub Pages是什么
      应用GitHub Pages创建属于自己的个人博客,GitHub将提供免费的空间。GitHub提供的域名(用户名+github+io),在Repository name对应处填写资源名,其需要使用自己的用户名,每个用户名下面只能建立一个,并且资源命名必须符合这样的规则username/username.github.io,之后勾选下面的”Initialize this repository with a README” 。
    3. hexo出自何人
      hexo出自台湾大学生 tommy351 之手,是一个基于Node.js的静态博客程序,其编译上百篇文字只需要几秒。hexo生成的静态网页可以直接放到GitHub Pages,BAE,SAE等平台上。

    安装准备

    环境搭建:

    1. Node.js:下载地址

    2. Git:下载地址

    3. Sublime:下载地址

      安装Node

      到 Node.js 官网下载相应平台的 最新版本 ,一路安装即可。我用的是 node-v0.10.22-x86.msi

      安装Git

      Git的客户端很多,我用的是 msysgit ,喜欢用绿色版本 Portable application for official Git for Windows 1.8.4 ,下载下来设置一下环境变量即可,Git_HOME,%Git_HOME%\bin之类的,不多说。

      安装Sublime

      Sublime Text 2 在这里仅仅作为一个文本编辑器使用,支持各种编程语言和文件格式,当然也支持Markdown语法,实在是个不可多得的练码奇才。喜欢追鲜的也可以尝试处于beta版本的 Sublime Text 3 。

    GitHub注册与配置

    1. 注册:
      访问:GitHub,注册你的username和邮箱,邮箱十分重要,GitHub上很多通知都是通过邮箱的。注册过程比较简单,详细也可以看:
      使用Github Page搭建博客, 需要遵循一定的规则, 需要在github建立仓库,仓库名为Github用户.github.io, 更多详情请参考官方文档
    1. 配置和使用Github
      以下教程主要参考beiyuu的《使用Github Pages建独立博客》写成。
    1. 配置SSH keys
      我们如何让本地git项目与远程的github建立联系呢?用SSH keys。
      打开Git Bash工具,执行以下操作
    1. 检查SSH keys的设置
      // 首先我们需要检查你电脑上现有的ssh key:
    $ cd ~/. ssh 检查本机的ssh密钥
       // 如果提示:No such file or directory 说明你是第一次使用git。
       // 生成新的SSH 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):<回车就好>
    

    注意1: 此处的邮箱地址,你可以输入自己的邮箱地址;
    注意2: 此处的「-C」的是大写的「C」

    然后系统会要你输入密码:

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

    在回车中会提示你输入一个密码,这个密码会在你提交项目时使用,如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。

    注意:输入密码的时候没有*字样的,你直接输入就可以了。

    1. 添加SSH Key到GitHub
    2. 在本机设置SSH Key之后,需要添加到GitHub上,以完成SSH链接的设置。
    3. 打开本地C:\Documents and Settings\Administrator.ssh\id_rsa.pub文件。此文件里面内容为刚才生成人密钥。如果看不到这个文件,你需要设置显示隐藏文件。准确的复制这个文件的内容,才能保证设置的成功。
    4. 登陆github系统。点击右上角的 Account Settings—>SSH Public keys —> add another public keys
    5. 把你本地生成的密钥复制到里面(key文本框中), 点击 add key 就ok了
    6. 测试
      可以输入下面的命令,看看设置是否成功,git@github.com的部分不要修改:
    $ ssh -T git@github.com
        如果是下面的反馈:
    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)?
        不要紧张,输入yes就好,然后会看到:
    Hi cnfeat! You've successfully authenticated, 
    but GitHub does not provide shell access.
        设置用户信息:
        现在你已经可以通过SSH链接到GitHub了,还有一些个人信息需要完善的。
        Git会根据用户的名字和邮箱来记录提交。
        GitHub也是用这些信息来做权限的处理,输入下面的代码进行个人信息的设置,把名称和邮箱替换成你自己的,名字必须是你的真名,而不是GitHub的昵称。
    $ git config --global user.name "cnfeat"//用户名
    $ git config --global user.email "cnfeat@gmail.com"//填写自己的邮箱
        SSH Key配置成功,本机已成功连接到github。
    

    Hexo博客

    Hexo
    Hexo的作者是tommy351,根据官方介绍,Hexo是一个简单、快速、强大的博客发布工具,支持Markdown格式。hexo的主题列表 Hexo Themes。 我比较喜欢 pacmanmodernistishgoraytaylorism

    安装Hexo

    打开Git Bash工具(前提确保Node.js已经安装,环境配置OK)

    $ npm install -g hexo
    

    部署Hexo

        在我的电脑中建立一个名字叫「Hexo」的文件夹,然后在此文件夹中右键打开Git Bash。
    $ hexo init
        如果无法使用右击“Git Bash”,则可以切换到指定目录
        UUhike@UUhike-pc MINGW64 ~
    $ cd j:/github/hexo
        UUhike@UUhike-pc MINGW64 /j/github/hexo
        安装依赖包
    $ npm install
        Hexo随后会自动在目标文件夹建立网站所需要的所有文件。
        现在我们已经搭建起本地的hexo博客了,
        执行以下命令(在H:\hexo),然后到浏览器输入localhost:4000看看。
        本地查看
    $ hexo generate #生成静态页面至public目录(最终上传这个文件到GitHub)
    $ hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
    

    部署到GitHub

    编辑E:\hexo下的_config.yml,修改Deployment部分:
    # Deployment
    ## Docs: http://hexo.io/docs/deployment.html
    deploy:
      type: git
        repository: git@github.com:silvia-YQY/silvia-YQY.github.io.git   
        branch: master
    

    hexo简写命令

    $ hexo g #生成
    $ hexo s #启动本地服务,进行文章预览调试
    或者直接作用组合命令
    $ hexo deploy -g
    $ hexo server -g
    简写:
    hexo n == hexo new
    hexo g == hexo generate
    hexo s == hexo server
    hexo d == hexo deploy
    
    

    相关文章

      网友评论

          本文标题:Hexo + github 构建博客

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