俗话说的好“吃水不忘挖井人”,当本身体验过Hexo搭建我的网站后,也来分享一下搭建过程遇到的乐趣以及遇到的坑!html
在搭建Hexo博客以前,首先须要简单在你电脑安装一些工具以及依赖包(具体安装方法相信你们都会,就省略了)node
首先要有一个github帐号 其次安装node.js,npm依赖 而后安装git工具(固然电脑自身的cmd工具也是能够用的)
新建一个名为“你的用户名.github.io”的仓库,好比说,若是你的github用户名是mengnn,那么你就新建"mengnn.github.io"的仓库(必须是你的用户名,其它名称无效),未来你的网站访问地址就是 mengnn.github.io了,对的,就是这么方便。git
<!--more-->github
固然,一个github帐户下只能建立一个以此命名的仓库,用来直接访问。shell
点击New repository 输入Repository name,必需为username.github.io格式。username替换为用户名 点击按钮Create repository 进入仓库username.github.io,点击setting,找到GitHub Pages模块 点击choose a theme选择一个页面主题 访问https://username.github.io就能够访问博客网站了
之因此配置SSH Keys,是由于你提交代码确定要拥有你的github权限才能够,可是直接使用用户名和密码太不安全了,因此咱们使用ssh key来解决本地和服务器的链接问题。npm
首先检查机器上是否已经存在id_rsa.pub文件浏览器
cd ~/. ssh #检查本机已存在的ssh密钥
若是不存在那就经过命令生成秘钥安全
ssh-keygen -t rsa -C "邮箱地址"
一路回车就好(记得应该是连续3次回车),最终会生成一个文件在用户目录下,打开用户目录,找到.ssh\id_rsa.pub
文件,记事本打开并复制里面的内容。服务器
打开你的github页面,点击setting进入---> SSH and GPG keys ---> New SSH key,而后把你复制的内容放到Key中,其中Title中的内容能够随便填一个就ok了,以下图:hexo
添加成功保存就OK了。
输入下面命令,测试SSH Key是否安装成功
ssh -T git@github.com # 不用改邮箱地址
若是提示Are you sure you want to continue connecting (yes/no)?
,输入yes,而后会相似于:`Hi mengnn! You've successfully authenticated, but GitHub does not provide shell
access.`的字符,说明你安装成功了。
以上准备工做完成后,就要放大招了,对,接下来就是重头戏-本地部署Hexo。
具体的Hexo介绍,你能够在网上查询,有不少,固然你也能够去Hexo官网详细了解,这里就不作过多介绍,不过要特别强调的是,上面的命令行以及下面的npm操做都是经过Git Bash Here操做的,因此前面写到要提早安装git工具。
特别注意的是:国内npm安装依赖实在是太慢太慢太慢了,尤为一些依赖小则一百兆左右,大则几百甚至上G兆,因此强烈推荐使用淘宝镜像cnpm安装依赖,淘宝镜像安装方法以下:
npm install -g cnpm --registry=https://registry.npm.taobao.org //查看cnpm是否安装成功 cnpm -v //若是出现版本号的信息,说明你安装成功
而后全部的npm操做你均可以换成cnpm操做了,固然下面为了你们不混淆,仍是用的npm操做,你操做的时候全均可以替换成cnpm。
经过如下命令行全局安装Hexo
$ npm install -g hexo
在你机器的合适位置建立项目文件夹(这个文件夹就是之后你写博客的存档文件夹,全部的内容都会在这个里面),好比我建立的是Blog,而后使用git找到Blog根目录下
cd Blog
在项目根目录下初始化你的Hexo。
在初始化以前,尤为抢到一点,你进行的hexo init操做会比较慢,耐心等待,特别特别抢到的事,你的node版本尽可能要高于v.6.3.0,否则很大可能你的初始化操做进行一天也不会完成,因此,初始化以前尽量的检查一下node版本,升级 一下
cd /f/Blog hexo init
初始化完成后,在你根目录下面会生成一些文件
而后你就能够进行hexo操做生成文章以及本地运行
hexo g # 生成对应的html hexo s # 启动服务
上面命令执行完成后,你就能够在根目录的public文件夹下看到对应的生成页面(这个文件夹的内容也会是你推送到github上的内容)
hexo s是开启本地预览服务,打开浏览器访问 http://localhost:4000 便可看到内容。
以上内容都配置好了,你就能够上传到github上了(首先,ssh key
确定要配置好,其次,配置_config.yml
中有关deploy的部分)
在以前,咱们已经配置好ssh了,因此接下来咱们要配置初始化后生成的_config.yml文件,配置以下:
deploy: type: git repository: git@github.com:mengnn/mengnn.github.io.git branch: master
而后你就能够上传了
hexo d #上传本地代码到github
上传成功后你就能够访问你的github域名进行访问了,好比例子中的[mengnn.github.io]()
第一次初始化的时候hexo已经帮咱们写了一篇名为 Hello World 的文章,默认的主题比较丑。不信你能够本身打开看看。不要急,咱们能够更改本身喜欢的主题。固然你能够先在官网中查看本身喜欢的主题,而后下载下来就OK了。我选择的是一个yilia主题
下载这个主题(固然,下载主题能够有不少方法,最后只要你能下载的主题文件copy到根目录下的theme文件夹中便可):
cd F:\Blog\themes #进入到根目录下的themes文件夹(这个就是主题文件夹) git clone https://github.com/litten/hexo-theme-yilia.git themes/yilia #下载yilia主题到文件夹中
下载完成后,你会看到下面的内容(第一个文件就是你刚刚下载的yilia主题文件,第二个是系统默认主题文件)
修改根目录下的_config.yml中的
theme: landscape改成
theme: hexo-theme-yilia,而后从新执行hexo g
来从新生成,而后hexo d提交就OK啦。
若是出现一些莫名其妙的问题,能够先执行hexo clean来清理一下public的内容,而后再来从新生成和发布。
对的,这样你的新主题就更改为功,而后这个主题下还有不少详细高端配置,就暂时不在这里详说了,放一个我本身配置好的界面:
全部的都配置好,怎么去写博客呢?
定位到咱们的项目文件F:Blogsource_posts中,你全部的初始博客都是保存在这里的,包括你全部的md文件
cd F:\Blog\source\_posts
定位以后你就能够在定位的文件夹里生成md文件了
hexo new 'my-first-blog'
固然,你也能够本身手动在_posts文件夹中建立.md文件,进行编写
--- title: postName #文章页面上的显示名称,通常是中文 date: 2019-08-14 22:30:16 #文章生成时间,通常不改,固然也能够任意修改 categories: 默认分类 #分类 tags: [tag1, tag2, tag3] #文章标签,可空,多标签请用格式,注意逗号后面有个空格 description: 附加一段文章摘要,字数最好在140字之内,会出如今meta的description里面 ---
另外在这里我推荐一个我的认为比较好用的写博客工具:Typora,目前为止我发现的最好用的md文件编辑器,能够上传图片,代码块,文字编辑,主题更好等等,轻量级并且好用,Typora官网,你能够下载你须要的版本。
以上就是简单的Hexo+github博客的部署以及上传,相信对于入门的你来讲已经足够了,后续会推出进阶版的文章,请持续关注。