前言
前几天我搭建了我的博客!
现在我把搭建的过程记下来(顺便存个档防止健忘症en)
本文是使用Windows 10 LTSC作为平台搭建的,但Hexo完全跨平台,大部分命令通用(有些命令要加sudo
哦)
PS:本项目无任何预算!全部是免费的XD
目录
用HEXO搭建你自己的博客!(上)
用HEXO搭建你自己的博客!(中)
用HEXO搭建你自己的博客!(下)
安装主题!
当前我其实不推荐没有接触过前端的同学安装本文所用的ARIA框架,网上基本没有相关教程,如果你看完了本文后还是不会,请转到NexT这个主题,百度一搜能找出一大堆教程——
1 |
|
以下转载与ARIA的github仓库——
修改你站点的_config.yml
把主题修改为 aria
1 |
|
语言设置,可以设置的值为 zh_CN
、zh_HK
、zh_TW
或 en
。如果你从别的主题转移过来比如旧版本 NexT,请注意这里不是 zh-Hans
而是 zh_CN
。default
是 en
的别名。
1 |
|
Hexo 搜索插件的配置
1 |
|
Hexo RSS 插件的配置
1 |
|
高亮设置,Hexo 内置的语法高亮功能使用了 highlight.js,但默认却没有给高亮的类名添加 hljs-
的前缀,而 highlight.js 项目提供的 CSS 文件却使用了这个前缀。为了保持和 highlight.js 项目 CSS 文件的兼容性,你需要像下面一样添加 hljs: true
到对应的配置里:
1 |
|
复制 ARIA 配置:把 _config.yml.example
复制为 _config.yml
:
1 |
|
修改主题配置,下面的配置需要修改 ARIA 目录下的 主题的 _config.yml
,不需要修改所有的配置项,只要修改你需要的部分就可以了:
菜单设置
如果你想要启用“分类”和“标签”页面,取消注释 categories
和 tags
,然后运行 hexo new page categories
和 hexo new page tags
生成这两个页面,最后分别把 layout: categories
和 layout: tags
添加到对应文件的文件头里。如果你想要启用“关于”页面,运行 hexo new page about
并取消注释即可:
1 |
|
生成Favicon
首先准备好一张图片作为你想要的 favicon 的原图,然后访问 https://realfavicongenerator.net/ 生成各种不同浏览器的 favicon,然后下载压缩包,解压到你站点目录下 source/favicons
目录里(没有则创建一个)。ARIA 会自动加载这些图标。
网站关键词
将 keywords
项设置为关键词列表。
CreativeCommons 许可证
设置 creative_commons
项。为了保证美观,ARIA 会将链接显示在网站底部。可选的许可证有 by
、by-sa
、by-nd
、by-nc
、by-nc-sa
、by-nc-nd
,有关它们的区别参见 https://creativecommons.org/licenses/。
代码高亮主题
ARIA 内置了四种常见代码高亮主题,设置 highlight
项为 atom-one-dark
、atom-one-light
、solarized-dark
、solarized-light
中的一个。ARIA 使用了 Hexo 内置的 highlight.js,因此如果你想添加更多的高亮主题,直接访问 highlight.js 的样式仓库,下载你需要的 CSS 文件到你站点的 source/css/
目录(也即在你存放 Markdown 文件的 source/
目录下面创建一个 css/
目录,你也可以把它放到主题的 source/css/
目录,但是这样会污染 git 工作区),然后设置这里的值为你下载的文件名(不要 添加.css
后缀,这个是自动添加的)。
自定义信息
custom_info
项的值会显示在网站底部,出于格式考虑请不要设置过长的字符串。
头像
设置 avatar
项为你头像的链接,例如设置 avatar: images/myavatar.png
,则你需要把自己的头像放置到站点根目录下的 source/images/myavatar.png
。
自定义 Logo
设置方法类似于头像,logo
项的值将会被显示在默认顶部 ARIA
的位置,或者如果你想隐藏 logo,把这一项留空。
自定义主题色
主题色 color
会被用于页眉和页脚的背景上,一些浏览器也会使用它来辅助变色,例如 Android 版 Chrome 的标题栏颜色,默认为网站的深色。由于颜色以 #
开头,需要加双引号以防止被作为 YAML 的注释。如果你没有特殊需求,最好不要修改这里的颜色。
Google 页面验证
如果想把你的网站提交给 Google,需要证明你是此网站的所有者,当 Google 要求你验证时,选择“使用 元标签”,复制 content
属性的值,填写到 google_verification
项,然后重新生成发布网站。
Tim_Paik留:如果还需要添加其他标签可以到
\themes\aria\layout\_layout.njk
中修改
网站创建年份
将 since
值设为你网站的创建年份,如果留空或者填写年份与当前年份一致,网站底部只会显示当前年份,否则显示 创建年份 - 当前年份
。
搜索设置
如果需要启用搜索,首先确保第一步中安装了 hexo-generator-search
,并且按照第二步配置过了,然后将 search
设置为 true
,搜索框会显示在侧边栏的上部。
侧边栏设置
有 left
、right
和 false
三种选择,设置为 false
则不会显示侧边栏。
动画
将 animate
设置为 true
则会启用卡片的翻转动画效果(不建议启用,在某些浏览器和较低配置电脑上可能会导致卡顿)。
不蒜子计数
如果需要关闭不蒜子计数,将 busuanzi
设置为 false
,否则在页面底部会显示 站点访问次数
、站点访问人数
、页面访问次数
。
推荐关闭,因为这会使完全加载网站变慢
MathJax 设置
MathJax 是一套用于在网页上显示数学公式和符号的 JavaScript 排版库,由于其体积较大,ARIA 没有内置,如果你有数学写作需要,首先设置 mathjax
下的 enable
为 true
,然后将 cdn
项设置为你要使用的 MathJax CDN,然后在需要使用的页面添加文件头 mathjax: true
。设置 global
为 true
可以在全部页面启用 MathJax,但可能会拖慢非数学页面的显示速度。
常用库 CDN
可以对 ARIA 内置的库使用 CDN 加速,首先将 lib_cdn
下的 enable
设置为 true
,然后将 CDN 地址添加到配置中即可,如果你不了解自己在做什么,请直接跳过这部份。
社交链接
先将 social
下面 enable
设置为 true
,然后在 links
下添加你的个人社交链接,格式如下:
1 |
|
前往 Font Awesome 获取你想要的图标。
友情链接
先将 blogroll
下面的 enable
设置为 true
,然后在 links
下添加友情链接,格式如下:
1 |
|
前往 Font Awesome 获取你想要的图标。
评论系统
首先将 comment
下 enable
设成 true
以全局启用评论(首页、归档、分类、标签页面除外),然后填入你的 Disqus Shortname。如果你有哪个页面想单独关闭评论,添加文件头 comment: false
(comment
不是 comments
!)。
如果你使用 commentjs,首先将它的 enable
设置成 true
,然后根据你的网站页面存放位置设置 type
,支持 github
和 oschina
,user
是你在这些网站的用户名,repo
是你这个仓库的名字,client_id
和 client_secret
需要你去 github 或者 oschina 生成一个应用,然后复制 Token。
如果你使用 Valine,首先设置 api_id
与 api_key
,并将 enable
设置为 true
,其它配置项参照 Valine 文档设置。
如果启用多个评论系统,默认只会显示顺序靠前的(顺序:Disqus,commentjs,Valine)。
Tips:如果想批量更改新生成的文件的文件头,编辑站点目录下 scaffolds
目录里的文件,Hexo 会把这个目录内的文件作为生成新文件时的模板。
打赏
将 reward
下 enable
设置为 true
启用打赏,然后在 comment
项设置你的打赏提示语,然后按需设置三种打赏方式的二维码(微信支付,支付宝,比特币),设置方式同头像,如果想关闭某一项留空即可。
自动截断摘要
如果你想自动生成首页的文章摘要,你可以使用这个选项。例如设置 auto_excerpt: 200
就会让主题截取文章的前 200 个字符(不含 HTML 标签)作为摘要。但是如果你想要更好的显示效果,建议你 在想要的地方放置一个 <!--more-->
标签,在这个标签之前的文章内容会被作为文章的摘要。
自定义字体
首先将 custom_font
下面的 enable
为 true
,然后去提供网页字体服务的网站比如 Google Fonts(如果你不能访问,找个替代品),然后选择所有你需要的字体,把生成的 <link>
标签里面的 href
属性网址复制出来粘贴到 link
选项下面。然后给不同的部分设置不同的字体。
示例如下:
1 |
|
内置写作样式
Markdown 会被编译成 HTML,所以你可以直接在有效的 Markdown 文件里面写 HTML 代码。为了能更好地组织文章结构,主题内置了一些自定义样式类,可以在写作时使用。
居中引用
只要给你的 HTML 代码添加 .centerquote
这个类,你就能得到一个有上下边框的居中引用。推荐给 <blockquote></blockquote>
标签使用这个类:
1 |
|
彩色警告块
只要给你的 HTML 代码添加 .alert-red
, .alert-green
或 .alert-blue
:
1 |
|
自定义 CSS 和 JavaScript
如果你需要用自定义的 CSS 覆盖 ARIA 内置的 CSS 样式,可以编辑 themes/aria/source/css/custom.styl
,这个文件会被最后加载。
如果你需要使用自定义的 JavaScript,可以编辑 themes/aria/source/js/custom.js
,这个文件会被最后加载。
更新主题
如果你使用了自定义的 CSS 或 JavaScript,更新之前请先用 Git 把它们提交。只有工作区干净的时候才能进行拉取
然后使用 git pull
拉取最新的更新,如果有冲突请手动合并提交。
每次更新完了不要忘记对比 _config.yml
和 _config.yml.example
,并手动将 example 中的更改应用到你自己的配置中。
转载完毕!
未完待续
留言
还有什么问题可以直接在评论区提!我会尽量回复的!
这里是Tim_Paik,如果有什么好想法或者求助可以找这个邮箱:timpaik#163.com(把#换成@)
转载请注明作者en