闲谈

拿出你的气质,打开你的电脑,借你半小时搭建好属于你的hexo博客,小生用dockerfile自动帮你搭建好; 你只需要在你的mac或linux或windows上提前把docker安装好,如何安装不是我的重点,请参考Docker安装; 作为程序员,博客就像你的影子,我都已经忘了内心曾经多少次告诫自己,一定要搭建一个属于自己的技术博客,奈何日复一日过去了,近来终于落实到行动上来,所谓明日复明日,明日何其多,早晚要做的事,劝君晚做不如早做。

搭建Hexo

获取基础镜像

Docker安装成功之后方能进行接下来的操作,首先从我的Docker Hub仓库上获取基础镜像




docker 映射 目录 dockerfile映射目录_dockerfile 映射目录


$ docker pull icoty1/ubuntu-hexo-blog # 从Docker hub上的icoty1用户下获取基础镜像
$ docker images # 查看本地所有镜像,会发现icoty1/ubuntu-hexo-blog已经被pull下来了


生成Dockerfile

进入一个空的目录下新建空文件Dockerfile,复制如下内容:


# 基础镜像
FROM icoty1/ubuntu-hexo-blog:latest

MAINTAINER icoty1 "https://icoty.github.io"

EXPOSE 4000

# hexo部分插件安装,使支持rss,图片,字数统计等功能
RUN npm install -g hexo-cli 
&& npm install hexo-server --save
&& hexo init blog && cd/blog 
&& npm install 
&& npm install hexo-deployer-git --save
&& npm install hexo-migrator-rss --save
&& npm install hexo-asset-image --save
&& npm install hexo-wordcount --save
&& npm install hexo-generator-sitemap --save
&& npm install hexo-generator-baidu-sitemap --save
&& npm install hexo-helper-live2d --save
&& git clone https:///litten/hexo-theme-yilia.git themes/yilia 
&& sed "s/theme: landscape/theme: yilia/g" -i /blog/_config.yml


更换主题

Dockerfile中的最后两行内容表示的含义是从github上把hexo-theme-yilia克隆下来并重命名成yilia,然后放到容器的/blog/themes/目录下,其中hexo-theme-yilia是hexo的主题,hexo有很多种主题,用每一种主题搭建出来的hexo博客界面美观和布局都不尽相同,你可以通过hexo官网上浏览每一种主题长啥样子,通过github获取主题的源码仓库,选择一个你喜欢的主题,并相应的修改这两行。假如你从github选择的主题仓库地址是https:///yscoder/hexo-theme-indigo.git , 那么你需要按照如下方式进行修改,如果你就想用yilia,那么你不需要做任何修改。


&& git clone https:///yscoder/hexo-theme-indigo.git themes/indigo 
&& sed "s/theme: landscape/theme: indigo/g" -i /blog/_config.yml


构建Hexo镜像

在Dockerfile的同级目录执行:


$ docker build -t icoty1/ubuntu-hexo .  # 把icoty1/ubuntu-hexo替换成你取的名字
$ docker images # 能够看到多出一条记录icoty1/ubuntu-hexo,并能看到该镜像的[IMAGE ID]


启动容器


/* 把[IMAGE ID]替换成上一步构建出来的镜像的ID,该句执行成功会多出来一个容器并有一个[CONTAINER ID]
* -v/home/yangyu/blog/:/blog/是把本机的/home/yangyu/blog/目录映射到容器的/blog/目录
* 通过目录映射,你只需要在本机编辑/home/yangyu/blog/目录下的文件,而不用每次都进入容器/blog/目录下编辑文件
* -p4000:4000 将主机的4000端口映射到容器的4000端口
*
$ docker run -d -ti -p 4000:4000 -v /home/yangyu/blog/:/blog/ [IMAGE ID] /bin/bash 
$ docker ps -a # 执行该句列出当前所有的容器
$ docker exec -it [CONTAINER ID] /bin/bash # 根据前一步的容器ID进入该容器内部
$ cd /blog/ && hexo s # 进入容器内部的/blog/目录下,启动hexo


浏览器测试

浏览器访问http://localhost:4000 ,出现下图说明已经成功,以后你的博客配置,文章撰写和发布等,都在/home/yangyu/blog/目录下进行,这和在容器内部/blog/目录下操作完全对等。


docker 映射 目录 dockerfile映射目录_docker 映射 目录_02


Hexo部署到Github

注册Github账户,如果已经注册,跳过此步; 在github上仓库“用户名.github.io”,比如我的用户名为icoty,仓库名则为:icoty.github.io;


docker 映射 目录 dockerfile映射目录_dockerfile 映射目录_03


执行如下命令生成ssh key,执行完后复制~/.sshid_rsa.pub文件内的全部内容,按照图示添加ssh keys,并粘贴保存到Key栏中,Title栏随便取。


$ cd ~/.ssh
$ ssh-keygen -t rsa -C "youremail@example.com" # 全程回车
$ git config --global  "你用github用户名"
$ git config --global user.email "你的github邮箱地址"


docker 映射 目录 dockerfile映射目录_dockerfile 映射目录_04


docker 映射 目录 dockerfile映射目录_ico_05


配置Hexo主题

编辑/blog/_config.yml文件,编辑标题、描述信息、Github信息,下图参见我的:


# Site
title: 阳光沥肩头 仿佛自由人 # 标题
subtitle: # 子标题
description: Linux C++服务端 # 描述信息
keywords: 
author: icoty
language: zh-CN # 语言
timezone: # 时区

deploy:
 -type: git
  repository: git@:icoty/icoty.github.io.git  # 设置repository对应的链接
  branch: master                                        # 设置提交到的分支
  message: Site updated at {{ now("YYYY-MM-DD HH:mm:ss") }} # 设置我们提交的信息


执行如下命令发布到github上,通过“https://你的github用户名.github.io”访问,我的是https://icoty.github.io


$hexo generate
$hexo deploy # 部署到GitHub


编辑/blog/themes/yilia/_config.yml文件,自定义其他配置,如友链、评论、分享、头像等,这些配置并不是一定要做,做不做都行,只是配置的完善些,你的Hexo博客界面看起来美观些,如何配置在此不一一赘述,请自行查看对应主题的官方文档和Github说明。如果你能操作这里,说明我这个教程还是有效的,感谢你的坚持!

Hexo命令

Hexo搭建好后,你可以写博客发布到GitHub 上,别人通过“https://你的github用户名.github.io”就能访问你的博客和看到你写的文章,而这个章节就是教你怎么在本地写你的博客,写博客用的MarkDown语法,推荐你安装MarkDown编辑器Typora。下面列出写博客过程中常用的命令,这些命令都需要走到/blog/目录下执行。


$hexo new "my-hexo" #新建my-hexo文章,在/blog/source/_post/目录下生成my-hexo.md,在这个文件里面写你的文章
$hexo generate # 文章写好后保存,然后执行这条命令,生成静态页面至public目录
$hexo s # 然后开启预览访问端口(默认端口4000,'ctrl+c'关闭server,‘ctrl+z’放到后台运行),通过http://localhost:4000 查看效果,如果满意就执行下一条命令发布到github
$hexo deploy # 发布到github,通过https://你用的github用户名.github.io 访问
$hexo clean # 有时你写文章和配置其他内容后,老是不生效,就执行下该命令清除缓存文件 (db.json) 和已生成的静态文件 (public),不是删除,你的文章仍然在的
$nohup hexo s & # 启动hexo以后台方式运行
$hexo new page "About" #新建About页面,这个是配置Hexo界面多出来一个About布局
$hexo help  # 查看帮助
$hexo version  #查看Hexo的版本


MarkDown语法

这个比较基础,网上教程也一大堆,MarkDown很容易学,放心比九九表容易多了,只要你用markdown实际动手写过一篇博文后就上手了,因此没啥可说的。