创建这个博客

本文内容持续更新 记一下创建博客的过程,以方便以后重复,并且可以拿给别人装逼.. 主要内容参考自 5分钟搭建免费个人博客

创建GitHub仓库

注册GitHub账号,创建一个仓库,要求Respository name的username与Owner一致。

安装必要的工具

安装Git

可以直接到https://desktop.github.com/下载安装GitHub,但是要添加环境变量:默认路径是

C:\Users\cheng\AppData\Local\GitHub\PortableGit_xxx\mingw32\bin    

C:\Users\cheng\AppData\Local\GitHub\PortableGit_xxx\mingw32\libexec\git-core

添加环境变量的方法:此电脑-属性-高级系统设置-环境变量-编辑PATH-新建,然后将路径粘贴即可。 还需要安装Git。 下载Git:http://msysgit.github.com/ 需要将

F:\Program Files\Git\bin

F:\Program Files\Git\mingw64\libexec\git-core

添加至环境变量。

安装Node.js

官网正常下载安装即可。

安装Hexo

以上所有都安装完成之后再安装Hexo。直接在命令行里输入

$ npm install hexo-cli -g

建站

建站的工作可以直接参考hexo的官方教程。建站后进入建立的文件夹。

添加主题

官网有丰富的主题选择。挑选喜欢的主题后,点击进入主题的GitHub主页(这里以next主题为例,一般主题的GitHub主页会有安装和使用说明),复制主页地址https://github.com/iissnan/hexo-theme-next,在命令行里输入

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

然后打开_站点配置文件_,即主文件夹下的_config.yml,找到theme字段,将其改成next。

写作和更新

创建文章:

$ hexo new [layout] <title>

生成、部署:

$ hexo clean && hexo generate -d

clean是清除缓存的命令,generate是生成,-d表示同时部署(deploy)。 可以直接将命令行保存为cmd文件,直接使用。 注意在powershell里不能使用&&,需要将命令分成两步:

$ hexo clean
$ hexo generate -d

同样具体工作可以看官方教程。

Tips

  • 进行进行一定的更新之后,可以先使用命令在本地测试:

    $ hexo server
    输入命令后打开http://localhost:4000测试站点。
  • 自动保存用户名和密码:(参考自走啊走
    1. 直接右键鼠标任意位置打开 Git Bash Here,然后输入以下命令:

      $ ssh-keygen -t rsa -C "your_email@example.com"

      使用默认的文件名直接enter,接下来显示如下:

      Enter passphrase (empty for no passphrase): [Type a passphrase]
      Enter same passphrase again: [Type passphrase again]
      按提示输入密码即可,不添加密码可以直接enter。
    2. 设置GitHub项目的Deploy keys: 到GitHub页面,在首页点击Settings-Deploy keys-Add deploy key,Title随便起,然后将生成的id_rsa.pub中的内容全选复制到key中,勾选最下面的Allow write access,点击Add key。 接下来测试配置是否成功:

       $ ssh -T git@github.com

      如果出现以下内容即表示配置完成并且成功:

       Hi username! You've successfully authenticated, but GitHub does not provide shell access.
    3. 设置博客的提交地址: 回到站点配置文件,在最下面的deploy属性如此修改:

       deploy:
           type: git
           repo: git@github.com:username/username.github.io.git
           branch: master
      即可。
  • 使用MathJax:hexo自带的markdown渲染器不能渲染MathJax。可以改用pandox-markdown。首先在电脑上安装pandox,然后进入站点根目录,执行命令:

      npm uninstall hexo-renderer-marked --save
      npm install hexo-renderer-pandoc --save

    先卸载旧的,再安装新的。

  • 各种元素前后要加空行。

添加应用和主题设置

  • 多说、百度统计、google分析、Local Search、MathJax见此

    对于mathjax,要改用pandoc渲染才能达到良好的效果。运行

    npm install hexo-renderer-pandoc --save
  • 使用LeanCloud统计文章阅读量见此

  • 设置rss、标签、分类、字体、代码主题、社交链接、打赏、友链、微信公众号见此

  • 显示摘要并添加阅读全文按钮见此

  • 网页图标设置:将图片转为ico文件,重命名为favicon.ico,放到站点文件夹下的source文件夹下,清空浏览器缓存,重新加载网页

添加网易云音乐的外链

可以使用网易云给的iframe插件,能在chrome和edge上运行。直接从网易云复制HTML代码,粘贴在需要的地方,然后将width和height的值加上引号即可。

SEO

seo. - 百度站长验证:由于hexo生成时会自动创建HTML文件,会在上传的HTML文件中添加内容,所以需要直接到GitHub处添加HTML文件。

关于编辑器

为了能写公式找了各种编辑器,最后用的Atom。为了能够正确预览公式需要安装markdown-preview-plusmathjax-wrapper两个插件,然后在设置中关掉Atom内置的 markdown-preview

还可以安装 markdown-writer ,写得方便一些,有各种快捷键,但好像需要先打开一下快捷键配置文件(这样听起来好扯但我确实是这么解决的……),否则会有冲突。

还有一个插件 markdown-scroll-sync,可以让预览页面和写作页面同步滚动。(这么个功能也要单独装插件……)

2017.2.8更新:终于找到了迄今最好的编辑器:Typora。google直达主页。