hexo搭建博客教程

更好的版面阅读,请访问:我的博客

这已经不是第一次倒腾 hexo + guihub 搭建 blog 了,最开始应该是去年6月份,可是那会家里的网络实在是太差了,加上很多 js 啊 node 什么的都不懂,按照别人的教程一步一个脚印好像也没有搭载成功,后来就不想搞了,再后来,就是忘记了。直到前段时间学习了javascript 和 node ,巧逢昨天在Android 博客周刊看到一哥们的博客正是 采用 hexo + github 的方式搭建的,加上电脑的平台已经安装了git 和 node 的环境,然后,然后,就又有了搭建博客的强烈欲望了,然后的然后,打开了 git bash ,敲入了如下命令:

    mkdir blog
    cd blog
    npm install -g hexo
    hexo init xiaowen
    cd xiaowen
    hexo g
    hexo s

于是就有了这个...


下面呢一步一步来详细说明

需要的工具

工欲善其事,必先利其器,需要的一些工具和平台,如果已经有这些了,可以跳过这部分。

git(必须)

为什么需要 git ? 因为我们后面需要将本地的博客上传到github。还有一个就是:我的本地是 win10平台,本地的cmd不好用,需要安装git来使用git提供的git bash的命令操作,git bash可以执行一些linux的命令,而我最近用linux命令操作比较多,比较熟悉,所以需要这个(其实是工作天天用)。当然你如果是 ubuntu 或者 其他的工具平台也行。能执行命令即可,看个人需要。git下载地址: https://git-scm.com/downloads

node.js

这个不需要多说什么了,也是一个必备的工具,下载地址: https://nodejs.org/en/ 。

如果不会安装的朋友可以参考下这个博客 : http://www.cnblogs.com/zhouyu2017/p/6485265.html

hexo 的安装

git 和 node 安装完成后,就需要安装主角了,那就是 hexo 。打开你的桌面,右键单击会出现 Git Base HereGit Gui Here,选择第一个 Git Base Here就可以了,就可以输入命令行了。如下图
这个窗口是可以设置和调整的,在窗口里面右键会出来设置的菜单,点击option即可。如果实在不会设置的,可以联系我!下面可以执行命令安装了

    npm install -g hexo    --->执行这个命令出错或者有其他的问题时,可能是被墙的原因,可以安装淘宝的npm镜像,执行如下命令安装
    npm install -g cnpm --registry=https://registry.npm.taobao.org    --->参考:https://npm.taobao.org/ ,执行完了这个命令后,就可以执行下面的命令了
    cnpm install -g hexo 

注: 上面的命令如果执行出错才需要执行2和3的命令,否则执行1命令即可。

简单的验证下

走完了上面的步骤,应该是没有多大问题了,记得验证下 git 和 node 的安装是否完好,可以执行下面的命令验证下版本

    git version   ---> 这个是验证git版本的
    node -v         ---> 这个是验证node版本的
    npm -v     ---> 这个是验证npm包管理器的
    hexo -v    ---> 这个是验证hexo 的

经过上面的步骤,工具都已经安装完成了,下面可以开始创建本地博客啦!

本地博客

经过上面的工具操作,现在可以执行命令来创建博客了,主要的命令大约有一下几条

    hexo init    --->folder : 带这个参数说明是在当前创建一个这样博客的文件夹
    hexo generate (hexo g  也可以) 
    hexo server  (hexo s 也可以)
    hexo clean  --->清理缓存
    hexo deploy  (hexo d 也可以)--->部署上去

在你的D盘或者其他什么盘的目录底下,单击右键打开Git Base Here,输入命令hexo init ,folder表示创建的文件夹,比如hexo init ,或者其他的什么都可以。静静的等待完成吧。
完成后,执行hexo g 生成静态网页。执行hexo s运行服务,然后在浏览器输入http://localhost:4000/你就可以看效果了。前提是执行前面两个命令没有出错。看到的效果应该是这样的

看到这样的效果你已经成功了。

so...下面应该干点啥了呢?

我的第一反应是:换个好看点的主题或者背景,然后放上一两篇文章看看效果,满意后呢部署到github上去,让别人也可以访问看看,哈哈

换主题

先不管其他的什么设置先,换个主题看看效果再说,主题的网站。这么多的主题,总会有一款心仪的。我使用的主题是next : http://theme-next.iissnan.com/

建议你还是先跟我一样用这个主题吧,把流程走完熟悉了后你可以再设置你所需要的主题或者其他的。
回到根目录(是指你创建这个项目的目录),先把主题clone下来,执行如下命令:

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

clone 完成后,你会在目录themes下看到一个文件夹next,这时候说明已经clone下来了。然后就是这个启用主题了。打开根目录下的_config.yml文件(建议你用notepad ++ 打开或者 atom 编辑器 或者 Visual Studio Code 编辑器 或者 sublime text 编辑器),找到如下的信息:

    # Extensions
    ## Plugins: https://hexo.io/plugins/
    ## Themes: https://hexo.io/themes/
    theme: landscape

theme: landscape改为theme: next,保存,然后执行命令:

    hexo g
    hexo s

看到如下效果说明主题切换成功了


hexo搭建博客教程_第1张图片

这个主题有四种样式(这个文件在themes\next底下的_config.yml),分别如下:

    # Schemes
    #scheme: Muse
    #scheme: Mist
    #scheme: Pisces
    scheme: Gemini

你可以分别选择看看那种是你想要的,保存后,还需要执行命令:hexo ghexo s刷新下页面就可以看到样式了。
看到了新样式,估计你也会是很迫切的想要设置页面的各种东西了吧,那么现在你看看这个样式的文档吧,就不详细介绍了:http://theme-next.iissnan.com/theme-settings.html。

新建文章

看了新样式,很期待应该怎样写文章吧?
在目录source\_posts下有一个hello world.md的文件,这个就是你看到的博客第一篇文章。那么应该要怎样创建文章呢?执行如下命令:

    hexo new hexo博客     --->“hexo博客” 这个是你的文章名称

编辑这个文件就是编辑你的文章了,对于不认识md文件或者语法的,参考: http://www.appinn.com/markdown/
编辑完了后,保存,依然要执行命令:hexo ghexo s,然后你就可以看到文章的内容了。
删除文章的方式是直接删除那个.md文件,然后执行hexo clean

添加主页tags菜单

在刚刚的新建文章的命令中,其实是隐含了一个参数 layout,这个参数的默认值是post,所以你看到新建的文章是在目录_post里面的。
例子:添加一个标签的菜单按钮

在样式文件夹下的配置文件中设置

在文件themes\next\_config.yml中有如下信息:

    # When running the site in a subdirectory (e.g. domain.tld/blog), remove the leading slash from link value (/archives -> archives).
    # Usage: `Key: /link/ || icon`
    # Key is the name of menu item. If translate for this menu will find in languages - this translate will be loaded; if not - Key name will be used. Key is case-senstive.
    # Value before `||` delimeter is the target link.
    # Value after `||` delimeter is the name of FontAwesome icon. If icon (with or without delimeter) is not specified, question icon will be loaded.
    menu:
      home: / || home
      
      #tags: /tags/ || tags
      #categories: /categories/ || th
      archives: /archives/ || archive
      #schedule: /schedule/ || calendar
      #sitemap: /sitemap.xml || sitemap
      #commonweal: /404/ || heartbeat
      #about: /about/ || user
    
    # Enable/Disable menu icons.
    menu_icons:
      enable: true

你有没有发现,点击浏览器上面的归档,网址后面有一个archives,其实就是在这里设置的。
现在要新加一个tags的菜单,那么就需要把上面的tags那行注释去掉。

命令行添加

注释了以后,执行命令:

    hexo new page tags   --->注意的是:这个命令是在根目录底下执行的

执行完了以后,进入source文件夹,你会发现多了一个tags的文件夹,再进入,打开index.md,在文件里面随便输入点东西,保存,执行hexo ghexo s,你就看到一个标签的菜单选项了,点击后,页面跳转显示的内容就是你刚刚输入的内容。
添加了菜单的item,怎样才使文章有标签呢?

在文章里面添加标签

需要在文章里面添加标签,在每篇文章的开头都会有如下的信息:

    title:
    date: 
    tags: 

只要我们在tags里面添加就行,比如tags: [andoid html]

在首页添加‘阅读全文’

主要有三种方式:

在文章中使用 `` 手动进行截断,Hexo 提供的方式。--->推荐方式
在文章的 front-matter 中添加 description,并提供文章摘录
自动形成摘要

    auto_excerpt:
    enable: true
    length: 150

添加头像信息

你有没有发现,在网页tab上面会有一个N的图片?怎么替换成自己想要的图片呢?
public\images下面,将你的图片替换favicon-16x16-next.png 和 favicon-32x32-next.png,同时制作一个svg,不会做的同学参考:https://c.runoob.com/more/svgeditor/,命名为logo.svg,同时替换public\images下的logo.svg

部署到github

前提:有github的帐号。如果没有,先到github注册一个:https://github.com/

建仓库

hexo搭建博客教程_第2张图片
create_new_repositiory.png

设置仓库信息

新建仓库后,点击右侧的设置,往下拉,找到GitHub Pages设置你的域名信息,一般有自己域名的就需要设置,不然是不需要的,前提是创建的仓库是:github用户名.github.io。如果不是的,重新再建仓库吧。然后你就会看到如下这个:Your site is published at [http://github用户名.github.io](github用户名.github.io),点击这个域名跳转到了你的博客了。如果想设置个性域名的话,留意下篇介绍。下面会教你怎样将你本地的博客上传到你的github,然后进行展示。

hexo搭建博客教程_第3张图片
github_setting_1.png
hexo搭建博客教程_第4张图片
github_setting_1.png
hexo搭建博客教程_第5张图片
github_setting_2.png

配置远程仓库信息

打开根目录的文件vim _config.yml,按照下面的信息进行配置

    # Deployment
    ## Docs: https://hexo.io/docs/deployment.html
    deploy:
      type: git
      repo: https://github.com/xiaowen2013/xiaowen2013.github.io.git    ---> 远程仓库地址
      branch: master    ---> 分支

部署到远程仓库

到了这一步,也就是执行命令的事情了

    npm install hexo-deployer-git --save      --->连接远程仓库,如果是第一次,会弹出窗口输入github 的帐号和邮箱
    或者 cnpm install hexo-deployer-git --save
    hexo deploy   --->这是部署的,执行完这个就可以看效果了

验证

这个操作很简单,浏览器输入http://yourname.github.io/,yourname -->你的账户名
最后,恭喜,搭建完成

每次部署的操作流程

    hexo clean
    hexo generate
    hexo deploy

本地操作预览的流程

hexo g
hexo s

然后输入:http://localhost:4000

文档参考

说千道万,不如参考官方的设置,多看看文档,如果说要想搭建的更好,还是需要多学点其他东西。
hexo : https://hexo.io/zh-cn/api/index.html
next 主题 : http://theme-next.iissnan.com/

最后:下一篇教你打造更好看的博客和建立属于自己的专属域名。

你可能感兴趣的:(hexo搭建博客教程)