美文网首页
使用 Hexo 在 Github 上建博客

使用 Hexo 在 Github 上建博客

作者: v1coder | 来源:发表于2018-12-11 18:09 被阅读0次

    先确认 git 与 npm 已经安装,在终端输入以下命令

    git --version
    npm --version
    

    安装 hexo,在终端输入

    npm install hexo-cli -g
    

    安装过程中报错

    解决方法:

    sudo npm install hexo-cli -g
    

    确认 hexo 安装成功

    hexo version
    

    来到你中意的目录(文件夹):

    cd /Users/v1coder/Documents/
    

    然后

    hexo init blog
    cd blog
    npm install
    hexo g
    hexo server
    

    此时新建了一个 blog 文件夹,并且 blog 里新建所需要的文件。( blog 可以改成你中意的其他文件夹名)

    这些完成之,你就可以打开浏览器,在地址栏里输入: http://localhost:4000,在本地先看看网站是什么样子。

    配置秘钥

    • 检查 SSH keys 是否已经存在

    终端执行如下命令:

    ls ~/.ssh
    

    如果显示如下信息(重点是要有id_rsaid_rsa.pub),就说明 SSH keys 已经存在了:

    id_rsa     id_rsa.pub     known_hosts
    

    如果存在,则直接跳到 将 SSH key 添加到 GitHub 中

    • 生成新的Key:(引号内的内容替换为你自己的邮箱)

      ssh-keygen -t rsa -C "your_email@youremail.com"

      输出显示:

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

    直接回车,不要修改默认路劲。

    >Enter passphrase (empty for no passphrase):<enter a passphrase>
    Enter same passphrase again:<enter passphrase again>
    

    设置一个密码短语,在每次远程操作之前会要求输入密码短语!闲麻烦可以直接回车,不设置。

    成功:

    Your identification has been saved in /Users/your_user_directory/.ssh/id_rsa.
    Your public key has been saved in /Users/your_user_directory/.ssh/id_rsa.pub.
    The key fingerprint is:
    ... ...
    

    默认会在路径~/.ssh下生成id_rsaid_rsa.pub两个文件。

    • 将 SSH key 添加到 GitHub 中

    终端输入:

    cat ~/.ssh/id_rsa.pub
    

    复制内容

    进入GitHub –> Settings –> SSH and GPG keys –> NEW SSH key,如下图所示:

    Title 里任意添一个标题,将复制的内容粘贴到 Key 里,点击下方 Add SSH key 绿色按钮即可,如下图所示:

    部署到 GitHub 上

    打开当前文件夹(blog)下的 _config.yml 文件,在末尾deploy后面添加几行代码:

    # Deployment
    ## Docs: https://hexo.io/docs/deployment.html
    deploy:
      type: git
      repository: git@github.com:yourname/yourname.github.io.git
      branch: master
    

    注意:冒号后面有空格,yourname 替换成你自己的 GitHub 用户名。(repository 可以在 Github 上复制,但记得选Clone with SSH

    终端输入:

    npm install hexo-deployer-git --save
    hexo deploy
    

    显示 INFO Deploy done: git 表示完成。

    设置独立域名

    博客根目录的 source/ 目录下创建一个名叫 CNAME 的文件,注意没有后缀,里面写你的域名。

    部署,添加域名解析,就 OK 了

    域名解析请参考“极简”创建 github page 并设置域名

    编辑文章

    • 创建文章
      命令行输入:
    hexo new "new article"
    

    之后在博客根目录 /source/_posts/ 文件夹下面,多了一个 new-article.md 文件。

    打开之后我们会看到:

    title: new article
    date: 2018-12-10 20:10:33
    tags:
    

    title 是当前文档名,也是将来在网页中显示的文章标题。
    date 是我们新建文档的时间。
    tags 是文档的标签,我们用次来为文章加标签。

    我们可以为文档贴标签:

    ---
    title: new article
    date: 2018-12-10 20:10:33
    tags:
    - tag1
    - tag2
    - tag3
    ---
    

    上面的文档贴上了 tag1tag2tag3 标签

    • 删除文章

    博客根目录 /source/_posts/ 文件夹下,删除对应文章的 .md 文件

    _posts/ 文件夹不能为空,否则网页会报错 Cannot GET /

    更新博客

    • 本地预览
    hexo clean
    hexo g
    hexo s
    

    打开 http://localhost:4000/ 预览效果

    • 部署到 GitHub
    hexo clean
    hexo g
    hexo d
    

    鸣谢:
    Hexo + GitHub (Coding) Pages 搭建博客
    使用 Hexo 为自己在 Github 上建一个静态 Blog 站点

    2018-12-11

    相关文章

      网友评论

          本文标题:使用 Hexo 在 Github 上建博客

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