美文网首页
使用 Github + Hexo 建立自己的博客

使用 Github + Hexo 建立自己的博客

作者: Mogeko丶 | 来源:发表于2018-02-06 12:00 被阅读0次
    Logo
    自从我开了这个博客后,就有很多小伙伴问我怎么弄的?(好吧,其实就一个(*/ω\*))
    为了教她,也为了给各位看官一点参考。我写了这篇文章。
    因为她比较小白,所以这篇文章会写得比较详细。

    准备工作

    1. 一个 Github 账号。 <-我们要使用它提供的 Github Pages 服务来搭建博客 https://github.com/
    2. Node.js <- Hexo 依赖于此 https://nodejs.org/zh-cn/
    3. Git <- 用来发布博客 https://git-scm.com/
    4. Hexo <- 博客框架 https://hexo.io/zh-cn/index.html
    5. [非必需]Chocolatey <- 用来安装 Node.js 和 Git https://chocolatey.org/

    Start

    安装 Node.js & Git

    使用 安装包 安装(小白看这里)

    首先去官网下载各自的安装包。(地址在上面)
    其中 Node.js 一般会有两个版本;都可以用。
    Git 的官网是英文的,点 [Downloads for Windows] 下载。

    下载好后,双击安装包,就像安装普通软件一样安装。

    安装好后打开按 Win键 + R,输入 cmd,回车。
    在弹出的黑框框中分别输入

    $ node -v
    
    $ npm -v
    
    $ git version
    

    如果显示的是各种的版本号,说明安装成功

    查看版本号

    使用 Chocolatey 安装

    我比较喜欢用 Chocolatey 来安装;比较方便。
    虽然赶 apt 还有一段距离,但确实是 Windows 下最好的包管理程序。
    有空我会写一篇比较详尽的 Chocolatey 使用教程。

    首先安装 Chocolatey
    用管理员身份打开 CMD,输入一下命令,回车

    $ @"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"
    

    然后安装 Node.js
    在 CMD 中键入:(同样是以管理员身份运行)

    $ choco install nodejs
    

    出现一下文字说明它安装完成了


    安装 Node.js

    然后安装 Git

    $ choco install git
    
    安装 Git

    同样的,验证一下是否安装成功
    关闭 CMD 然后重新打开它(刷新 %PATH% )键入

    $ node -v
    
    $ npm -v
    
    $ git version
    

    如果显示的是各种的版本号,说明安装成功

    查看版本号

    注册 Github 账号

    如果你已经拥有,请跳过
    打开 https://github.com/ 分别填上 名字邮箱密码Sign up to GitHub

    注册 Github 账号
    然后前往自己刚才填写的邮箱,点开 Github 发送给你的注册确认信,确认注册

    创建代码库

    登陆之后,点击页面右上角的加号,选择 New repository

    创建代码库

    Repository name 下填写 [你的名字].github.io(填写注册时的名字,英文),Description (optional) 下填写一些简单的描述(不写也没有关系)

    创建代码库
    然后你会看到
    创建代码库

    选择右侧的Settings,向下拖动,直到看见GitHub Pages

    创建代码库
    点击 Automatic page generator,Github 将会自动替你创建出一个 gh-pages 的页面。 如果你的配置没有问题,那么大约 15 分钟之后,[你的名字].github.io 这个网址就可以正常访问了

    安装 Hexo

    按照官网的说法,Hexo是一个 快速、简洁且高效的博客框架
    我们要用它来将 Markdown 渲染成网页,然后发布到 Github 上。

    Hexo 通过 Node.js 来安装
    在 CMD 中输入:

    $ npm install hexo-cli -g
    

    你会看到


    安装 Hexo

    然后输入

    $ npm install hexo -g
    
    安装 Hexo

    等它安装好了,我们验证一下是否安装成功
    输入

    $ hexo -v
    
    安装 Hexo

    下面,初始化我们的 Hexo
    找一个地方新建一个文件夹,这个文件夹将是用来存放你博客的地方
    切换的刚刚新建的文件夹下,初始化 Hexo:(将[你新建的文件夹的路径]改为你刚刚新建文件夹的路径)

    $ cd [你新建的文件夹的路径]
    $ hexo init
    
    
    初始化 Hexo

    因为我们要用 Git 来发布博客,所以还需要安装一个名为 hexo-deployer-git 的插件
    在 CMD 中输入

    $ npm install hexo-deployer-git --save
    
    安装 hexo-deployer-git

    此时的目录结构↓

    .
    ├── .deploy #需要部署的文件
    ├── node_modules #Hexo插件
    ├── public #生成的静态网页文件
    ├── scaffolds #模板
    ├── source #博客正文和其他源文件,404、favicon、CNAME 都应该放在这里
    | ├── _drafts #草稿
    | └── _posts #文章
    ├── themes #主题
    ├── _config.yml #全局配置文件
    └── package.json

    配置 Deployment

    首先,你需要为自己配置身份信息,打开命令行,然后输入:

    $ git config --global user.name "[yourname]"
    $ git config --global user.email "[youremail]"
    

    修改 _config.yml

    按照一下注释按需修改

    # Hexo Configuration
    ## Docs: http://hexo.io/docs/configuration.html
    ## Source: https://github.com/hexojs/hexo/
    # Site #站点信息
    title:  #标题
    subtitle:  #副标题
    description:  #站点描述,给搜索引擎看的
    author:  #作者
    email:  #电子邮箱
    language: zh-CN #语言
    # URL #链接格式
    url:  #网址
    root: / #根目录
    permalink: :year/:month/:day/:title/ #文章的链接格式
    tag_dir: tags #标签目录
    archive_dir: archives #存档目录
    category_dir: categories #分类目录
    code_dir: downloads/code
    permalink_defaults:
    # Directory #目录
    source_dir: source #源文件目录
    public_dir: public #生成的网页文件目录
    # Writing #写作
    new_post_name: :title.md #新文章标题
    default_layout: post #默认的模板,包括 post、page、photo、draft(文章、页面、照片、草稿)
    titlecase: false #标题转换成大写
    external_link: true #在新选项卡中打开连接
    filename_case: 0
    render_drafts: false
    post_asset_folder: false
    relative_link: false
    highlight: #语法高亮
      enable: true #是否启用
      line_number: true #显示行号
      tab_replace:
    # Category & Tag #分类和标签
    default_category: uncategorized #默认分类
    category_map:
    tag_map:
    # Archives
    2: 开启分页
    1: 禁用分页
    0: 全部禁用
    archive: 2
    category: 2
    tag: 2
    # Server #本地服务器
    port: 4000 #端口号
    server_ip: localhost #IP 地址
    logger: false
    logger_format: dev
    # Date / Time format #日期时间格式
    date_format: YYYY-MM-DD #参考http://momentjs.com/docs/#/displaying/format/
    time_format: H:mm:ss
    # Pagination #分页
    per_page: 10 #每页文章数,设置成 0 禁用分页
    pagination_dir: page
    # Disqus #Disqus评论,替换为多说
    disqus_shortname:
    # Extensions #拓展插件
    theme: landscape-plus #主题
    exclude_generator:
    plugins: #插件,例如生成 RSS 和站点地图的
    - hexo-generator-feed
    - hexo-generator-sitemap
    # Deployment #部署,将 lmintlcx 改成用户名
    deploy:
      type: git
      repo: git@github.com:[你的名字]/[你的名字].github.io.git
      branch: master
    
    

    注意:

    安装 NexT 主题

    使用 Hexo 的最大好处就是非常的自由,你可以完全掌握你的博客,想把它弄成什么样都可以。
    因此,我们可以安装跟好看的主题来替换 Hexo 自带的 landscape 主题。
    我推荐使用 NexT 主题(就是你们现在看到的样子),因为它简洁大方,比较符合我的审美。
    而且它也是所有主题中,获得 stars 最多的。(在 Github 中,stars 越多,说明该项目越受欢迎。)

    使用一下命令安装 NexT

    $ git clone https://github.com/iissnan/hexo-theme-next.git themes/next
    

    不嫌弃的话也可以安装我修改过的版本(*/ω\*) -> NexT

    $ git clone https://github.com/Mogeko/hexo-theme-next.git themes/next
    

    安装好后打开 Hexo 文件夹中的 _config.yml,找到 theme: landscape,将其改为theme: next

    theme: landscape -> theme: next
    

    重新部署一遍 Hexo,开启 Hexo 的本地服务器

    $ hexo g
    $ hexo s
    

    现在访问 http://localhost:4000/ 看看效果。(๑•̀ㅂ•́)و✧

    编写文章

    引用一段来自官方的文档

    你可以执行下列命令来创建一篇新文章。
    $ hexo new [layout] <title>
    您可以在命令中指定文章的布局(layout),默认为 post,可以通过修改 _config.yml 中的 default_layout 参数来指定默认布局。

    创建文章后,可以看见 source\_posts\ 下有一篇新建的以 .md 为后缀文章
    打开它可以看见

    ---
    title: hello-world   //在此处添加你的标题。
    date: 2014-11-7 08:55:29   //在此处输入你编辑这篇文章的时间。
    categories: Exercise   //在此处输入这篇文章的分类。
    toc: true  //在此处设定是否开启目录,需要主题支持。
    ---
    

    在之后空白的地方用 Markdown 编写文章。

    更多操作

    $ hexo generate  # 将 Markdown 编译成静态网页
    $ hexo deploy  # 部署 Hexo 到服务器,也就是到 Github
    $ hexo server  # 启动一个本地服务器,默认地址是 `http://localhost:4000`
    
    # 缩写
    $ hexo g  # 等同于 hexo generate
    $ hexo d  # 等同于 hexo deploy
    $ hexo s  # 等同于 hexo server
    
    $ heeo d -g # 等同于 hexo deploy + hexo generate
    
    

    原文地址:https://mogeko.github.io/2017/002/
    欢迎关注我的博客 (・ω・) ノ:Mogeko`s Blog

    相关文章

      网友评论

          本文标题:使用 Github + Hexo 建立自己的博客

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