美文网首页
搭建博客的艰辛历程(hexo+github)

搭建博客的艰辛历程(hexo+github)

作者: Z314 | 来源:发表于2017-11-17 17:41 被阅读0次

    前言

    加入实验室不久就让我们搭建博客 ,有指导视频但看了一点感觉完全看不懂就没看了,自己在网上找,看朋友是怎么弄的,自己尝试摸索。别人都弄出来了,为啥我用着电脑都出问题弄不好,有一段时间几乎崩溃。我凭着强大的毅力不放弃一共搭建了有10次左右终于弄出来了。可以说所有的问题都被我遇见过(要哭死......),所以我要在这里整理我的经验,在最后面分享一下问题经验,希望能给后来人一些帮助。

    一、下载软件

    首先,下载Git官网 2.15.0

    node.js官网8.9.0
    32位或64位按自己电脑的系统来选择,如果不清楚,可以直接在官网下载32位的,可以兼容64位系统。
    想要知道自己的电脑是多少位操作系统,打开“我的电脑”,在空白处单击鼠标右键,点击“属性”即可查看。

    注:不同软件版本的安装与使用会有差异。曾经就遇到过因为node.js版本太低出错搭建不成功。

    二、安装软件

    1.安装git

    • 大部分按默认安装,一路点击”Next”
    image
    • 这里选择对应的windows选项,如下图


      image.png
      image.png
    • 等待安装完成


      image.png

    2.安装node.js

    • Node安装更加简单,还是一路”Next”,最后等待安装完成即可


      image.png
      image.png

    三、验证软件是否正确安装

    • 同时按下Win键和R键(或者点击“开始菜单”->点击“运行”),打开运行窗口,输入“cmd”
      然后输入以下命令,结果与下图相同则说明安装正确,若不正确可以卸载软件重新安装
    1. git --version
    2. node -v
    3. npm -v

    四、申请GitHub账号

    • 点击GitHub进入官网注册帐号
    • 按下图分别输入用户名、邮箱、密码,然后点击注册


      image.png

    在这里就不多说如何注册GitHub账号了,有看不懂的英文复制粘贴翻译就好。

    • 点击”New repository”,新建一个版本库


      image.png
    • 输入Repository name:yourname.github.io(yourname与你的注册用户名一致


      image.png
      image.png

      *最后点击”Publish page”,发布github默认生成的一个静态站点


      image.png
    • 验证邮箱,点击个人设置


      image.png
    • 点击”Send verification Email”发送验证邮件


      image.png
    • 进入你的邮箱,查收验证邮件进行验证


      image.png

    五、安装Hexo

    hexo是基于node.js的静态博客,官网也是搭建在GitHub上

    • 在电脑上新建一个blog文件夹,该文件夹用于存放你的博客文件,然后右键单击选择“Git Bash”


      image.png

    有的是Git Bash here,是一样的,没影响。

    安装hexo为了避免出现被“墙”的情况,使用淘宝NPM镜像,输入以下命令等待安装完成:

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

    注意复制时不要复制"$",因为git上面已经有了
    如果是第一次安装则和下图差不多,如果已安装或不确定,可以输入命令$ hexo -v看是否安装。

    注意:全程都要看英文的意思,看不懂复制粘贴翻译.

    image.png
    • 使用淘宝NPM安装Hexo

    $ cnpm install -g hexo-cli

    与原先的npm完全一样,只是命令改为cnpm,一样等待hexo安装完成

    image.png
    • 出现的WARN可以不用理会,继续输入以下命令

    $ cnpm install hexo --save

    • 安装完成后,在输入命令,验证是否安装正确

    $ hexo -v

    image.png

    六、本地运行Hexo

    • 初始化hexo


      image.png
    • 安装生成器

    $ cnpm install

    *运行hexo,以后要在本地运行博客只要输入该命令即可

    $ hexo s -g

    image.png

    *停止运行,按住Ctrl+C键即可停止

    七、管理博客

    配置信息

    使用

    Sublime_Text

    编辑器(绿色软件无需安装,解压即可使用)打开blog/_config.yml文件,进行配置

    image.png
    #博客名称
    title: 我的博客
    #副标题
    subtitle: 一天进步一点
    #简介
    description: 记录生活点滴
    #博客作者
    author: John Doe
    #博客语言
    language: zh-CN
    #时区
    timezone:
    #博客地址,与申请的GitHub一致
    url: http://elfwalk.github.io
    root: /
    #博客链接格式
    permalink: :year/:month/:day/:title/
    permalink_defaults:
    source_dir: source
    public_dir: public
    tag_dir: tags
    archive_dir: archives
    category_dir: categories
    code_dir: downloads/code
    i18n_dir: :lang
    skip_render:
    new_post_name: :title.md # File name of new posts
    default_layout: post
    titlecase: false # Transform title into titlecase
    external_link: true # Open external links in new tab
    filename_case: 0
    render_drafts: false
    post_asset_folder: false
    relative_link: false
    future: true
    highlight:
      enable: true
      line_number: true
      auto_detect: true
      tab_replace:
    default_category: uncategorized
    category_map:
    tag_map:
    #日期格式
    date_format: YYYY-MM-DD
    time_format: HH:mm:ss
    #分页,每页文章数量
    per_page: 10
    pagination_dir: page
    #博客主题
    theme: landscape
    #发布设置
    deploy: 
      type: git
      #elfwalk改为你的github用户名
      repository: https://github.com/elfwalk/elfwalk.github.io.git
      branch: master
    
    • 写一篇文章
      输入创建文章命令,生成一个md文件(/blog/source/_posts/)

    $ hexo new "hello"


    image.png
    • 用编辑器打开hello.md文件,编写完后保存
    title: hello
    date: 2015-07-01 22:37:23
    categories:
      - 日志
      - 二级目录
    tags:
      - hello
    ---
    摘要:
    <!--more-->
    正文:
    

    八、发布博客

    配置SSH keys

    我们如何让本地git项目与远程的github建立联系呢?用SSH keys。

    • 生成新的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:<再次输入加密串>
    ···
    在回车中会提示你输入一个密码,这个密码会在你提交项目时使用,如果为空的话提交项目时则不用输入。这个设置是防止别人往你的项目里提交内容。(我当时就没输密码,直接回车)
    注意:输入密码的时候没有*字样的,你直接输入就可以了。
    最后看到这样的界面,就成功设置ssh key了:


    image.png
    • 添加SSH Key到GitHub
      在本机设置SSH Key之后,需要添加到GitHub上,以完成SSH链接的设置。
      1、打开本地C:\Documents and Settings\Administrator.ssh\id_rsa.pub文件。此文件里面内容为刚才生成人密钥。如果看不到这个文件,你需要设置显示隐藏文件。准确的复制这个文件的内容,才能保证设置的成功。
      2、登陆github系统。点击右上角的 Account Settings—>SSH Public keys —> add another public keys
      3、把你本地生成的密钥复制到里面(key文本框中), 点击 add key 就ok了

    设置git身份信息

    ···
    $ git config --global user.name "你的用户名"
    $ git config --global user.email "你的邮箱"
    ···
    (新建一个文本文档,复制粘贴修改成你的用户名和邮箱)

    • 发布更新博客
      ···
      $ hexo d -g
      ···


      image.png

      如果看到上面的图 Deploy done :git 说明搭建成功了
      发布时会弹出一个窗口,需要输入github的帐号和密码。输入完之后过一会去浏览器查找你的网页又可以看到你的博客了。(访问yourname.github.io看下成果)

    最后,也是最重要的,我在搭建过程中遇到了很多错误,在这分享一下错误以及解决方法。

    1.node.js版本太低出错,英文显示要大于4.0版本

    2.搭错了,删除文件后重搭建时,有的程序已走过,相应的步骤不用再弄了,不然会出现文件夹不是空的,又出错。

    3在config。yml中改写时,一定要注意用户名,网站与GitHub要一样,冒号后要有一个空格,不然又会出错。

    4.记得helo.md文件也要改,复制粘贴即可

    5.记得要添加SSH密钥,曾经出现过not found git的情况,应该是没有添加密钥,没连接github。

    6.还出现过error: Permission to userA.git denied to userB。
    出现这个的原因是电脑上的SHH公钥已经被另一个账户使用,你没有权限。或者是你改用户名了。处理方法是打开电脑Control Panel(控制面板)——>User Account and family Safety(用户账号和家庭安全)——>Manage Windows Credential(凭证管理)——>将跟Git有关的账号删除
    然后重新发布。

    我搭建博客的过程大致就这样吧,写在这里回头看时又是一番感慨,佩服自己,唉。

    相关文章

      网友评论

          本文标题:搭建博客的艰辛历程(hexo+github)

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