美文网首页
OS X 使用 Hexo 和 Coding Pages 搭建静态

OS X 使用 Hexo 和 Coding Pages 搭建静态

作者: 叶寒_Alex | 来源:发表于2019-07-18 13:50 被阅读0次

    Hexo是一款基于 Node.js 的静态博客框架, 目前在 GitHub 上已有 9133 star 和 1499 fork。Hexo 生成的静态页面可以部署在 Github 或 Coding 上,并且能够免费绑定自己的域名,可以用来很方便地搭建个人博客。


    一、安装 Git

    搭建博客需要用到 git,下面这条命令可查看本机是否已安装 git,若未安装可参考这篇博文进行安装。

    git --version
    

    二、安装 Node.js

    安装 Node.js 的最佳方式是使用 nvm

    cURL:

    $ curl https://raw.github.com/creationix/nvm/v0.33.11/install.sh | sh
    

    Wget:

    $ wget -qO- https://raw.github.com/creationix/nvm/v0.33.11/install.sh | sh
    

    安装完成后,重启终端并执行下列命令即可安装 Node.js。

    $ nvm install stable
    

    或者您也可以下载 安装程序 来安装。

    三、安装 Hexo

    所有必备的应用程序安装完成后,即可使用 npm 安装 Hexo。

    $ npm install -g hexo-cli
    

    以上安装配置如有问题请参考官方文档

    四、本地建立博客

    安装完成后,新建一个目录如 blog 用于存放博客,切换到该目录下执行以下指令,Hexo 即会在目标文件夹初步生成博客所需要的所有文件

    hexo init
    

    然后切换到该目录下执行如下命令,安装所需要的依赖

    sudo npm install
    

    生成静态页面

    hexo g
    

    启动本地服务

    hexo s
    

    生成静态页面与启动本地服务可以结合成以下指令

    hexo s -g
    

    打开浏览器,输入 http://localhost:4000/ ,看到页面说明hexo环境安装成功。

    四、NexT主题配置

    • 安装
      将它的 Git 仓库 Clone 以后放到博客目录下的 themes 文件夹中即可
    git clone https://github.com/iissnan/hexo-theme-next themes/next
    
    • 启用
      与所有Hexo主题一样,把主题源码导入themes目录后,打开根目录配置文件_config.yml, 找到 theme 字段,并将其值更改为 next 就完成了主题的切换。
    theme: next
    

    四、部署到Coding Pages

    在 Coding 新建一个项目,假设为 blog,然后修改本地博客目录下的 _config.yml 文件,根据官方文档的描述,修改以下几个参数,这些参数一般在文件底部:

    deploy:
    type: git               #部署方式,这里我们用的是Coding的Git
    repo: <repository url>  #仓库地址,例如我的是git@git.coding.net:xxx/blog.git 
    branch: [branch]        #分支名,可任意填写,我填写的是master
    message: [message]      #可不填,这是显示在提交记录里的描述信息,默认为日期
    

    参数修改完成后,我们需要在终端中切换到博客所在目录安装 deploy 组建,执行以下命令将生成的博客静态页面 push 到我们上面在 Coding 创建的 blog 仓库中:

    sudo npm install hexo-deployer-git --save
    

    然后执行依次执行清理命令

    hexo clean
    

    生成命令:

    hexo g
    

    部署命令:

    hexo d
    

    如果在 _config.yml 的 repo 处填写的仓库地址是 https 形式的,在部署时可能需要输入你的 Coding 账号和密码。
    然后切换到该项目的 Pages 标签,开启 pages 服务,分支名填写为我们在_config.yml 文件中设定的分支,我的是 master。

    五、效果预览

    pages 服务开启完成后,Coding 会提供一个类似 {user_name}.coding.me/{project_name} 的链接用于访问,例如用户名为 xxx 项目名为 blog 的链接应该是:

    http://xxx.coding.me/blog
    

    若资源加载失败,主题没有显示出来,查看根目录配置文件_config.yml

    url: http://xxx.coding.me/blog/ #项目地址
    root: /blog #项目名称
    

    六、绑定域名

    默认提供的链接可能过长或者不便于日常使用,我们也可以绑定自己的域名。首先,需要提前准备一个域名,然后打开自己的域名控制面板,新建一个 CNAME 解析到 {user_name}.coding.me,例如我的是将 www.xxx.com 解析到 xxx.coding.me; 然后,打开 Coding 项目页面切换到 pages 项,填入刚才的设置解析的域名 www.xxx.com,点击“添加域名绑定”按钮即可,在浏览器中直接访问 www.xxx.com 就能成功打开。 有时可能由于缓存或者解析时间的问题,稍等片刻即可。

    七、撰写博客

    hexo new "postName" #新建文章
    hexo new page"pageName" #新建页面
    hexo generate #生成静态页面至public目录
    hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
    hexo deploy #将.deploy目录部署到指定空间
    hexo help # 查看帮助
    hexo version #查看Hexo的版本
    
    • 使用命令直接创建一篇文章
    hexo new "Hello Word"
    

    成功后我们会在source文件夹下的_posts文件夹中找到我们刚刚创建的文件Hello Word.md,编写格式为markdown, 打开文件即可直接编写

    • 手动在_posts文件夹下创建*.md文件的博客,但是我们自己要把头信息给补上

    部署博客

    hexo d -g
    
    持续更新中...

    相关文章

      网友评论

          本文标题:OS X 使用 Hexo 和 Coding Pages 搭建静态

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