hexo评论_Hexo系列 | Hexo的基本使用
1. 前言
Hexo是一個(gè)快速、簡(jiǎn)潔且高效的博客框架。Hexo 使用 Markdown(或其他渲染引擎)解析文章,在幾秒內(nèi),即可利用靚麗的主題生成靜態(tài)網(wǎng)頁(yè)。即把用戶的markdown文件,按照指定的主題解析成靜態(tài)網(wǎng)頁(yè)。
2. 安裝hexo
安裝使用hexo之前需要先安裝Node.js和Git,當(dāng)已經(jīng)安裝了Node.js和npm(npm是node.js的包管理工具),可以通過(guò)以下命令安裝hexo
$ npm install -g hexo-cli可以通過(guò)以下命令查看主機(jī)中是否安裝了node.js和npm
$ node --version #檢查是否安裝了node.js $ npm --version #檢查是否安裝了npm如下所示表示已經(jīng)安裝了node.js和npm
root@***:~# node --version v8.11.3 root@***:~# npm --version 6.7.03. 建站
安裝完Hexo之后,執(zhí)行下列命令,Hexo將會(huì)在指定目錄中新建所需要的文件,指定的目錄即為Hexo的工作站
$ hexo init <folder> $ cd <folder> $ npm install新建完成之后,指定目錄中的情況如下
. ├── _config.yml ├── package.json ├── scaffolds ├── source | ├── _drafts | └── _posts └── themes3.1. _config.yml
網(wǎng)站的配置信息,您可以在此配置大部分的參數(shù)。 配置參數(shù)講解
3.2. package.json
應(yīng)用程序的信息,以及需要安裝的模塊信息。
3.3. scaffolds
模版文件夾。新建文章時(shí),Hexo 會(huì)根據(jù) scaffold 中的模板文件來(lái)建立新的文件。Hexo的模板是指在新建的markdown文件中默認(rèn)填充的內(nèi)容。例如,如果修改scaffold/post.md中的Front-matter內(nèi)容,那么每次新建一篇文章時(shí)都會(huì)包含這個(gè)修改。也就是說(shuō),通過(guò)hexo命令每新建一個(gè)文章,都會(huì)包含指定模板文件中的內(nèi)容。
官網(wǎng)模板詳述
3.4. source
資源文件夾是存放用戶資源的地方,如markdown文章。Markdown 和 HTML 文件會(huì)被解析并放到 public 文件夾,而其他文件會(huì)被拷貝過(guò)去。
注意:除 _posts 文件夾之外,開(kāi)頭命名為 _ (下劃線)的文件 / 文件夾和隱藏的文件將會(huì)被忽略。3.5. themes
主題文件夾。Hexo 會(huì)根據(jù)主題來(lái)解析source目錄中的markdown文件生成靜態(tài)頁(yè)面。官網(wǎng)主題詳述
4. 寫作
可以執(zhí)行下列命令來(lái)創(chuàng)建一篇新文章。
$ hexo new [layout] <title>可以在命令中指定文章的布局(layout),不指定默認(rèn)為 post,也可以通過(guò)修改 _config.yml 中的 default_layout 參數(shù)來(lái)指定默認(rèn)布局。創(chuàng)建的新文章會(huì)自動(dòng)加上指定布局對(duì)應(yīng)的模板文件中的內(nèi)容。
4.1. 布局(Layout)
Hexo 有三種默認(rèn)布局:post、page 和 draft,它們分別對(duì)應(yīng)不同的路徑,而自定義的其他布局和 post 相同,都將儲(chǔ)存到 source/_posts 文件夾。
布局路徑postsource/_postspagesourcedraftsource/_drafts
如果你不想你的文章被處理,你可以將 Front-Matter 中的layout: 設(shè)為 false 。4.2. 模版(Scaffold)
在新建文章時(shí),Hexo 會(huì)根據(jù) scaffolds 文件夾內(nèi)相對(duì)應(yīng)的文件來(lái)建立文件,例如:
$ hexo new photo "My Gallery"在執(zhí)行這行指令時(shí),Hexo 會(huì)嘗試在 scaffolds 文件夾中尋找 photo.md,并根據(jù)其內(nèi)容建立文章,以下是您可以在模版中使用的變量:
變量描述layout布局title標(biāo)題date文件建立日期
4.3. Front-matter
Front-matter是文件最上方以 --- 分隔的區(qū)域,用于指定個(gè)別文件的變量,舉例來(lái)說(shuō):
--- title: Hello World date: 2013/7/13 20:46:25 ---注意:一般Front-matter使用的yaml語(yǔ)法,yaml語(yǔ)法需要注意空格,如title: Hello World冒號(hào)需要有一個(gè)空格,當(dāng)然除YAML 外,你也可以使用 JSON 來(lái)編寫 Front-matter。以下是預(yù)先定義的參數(shù),您可在模板中使用這些參數(shù)值并加以利用。
參數(shù)描述默認(rèn)值layout布局title標(biāo)題date建立日期文件建立日updated更新日期文件更新日期comments開(kāi)啟文章的評(píng)論功能truetags標(biāo)簽(不適用于分頁(yè))categories分類(不適用于分頁(yè))permalink覆蓋文章網(wǎng)址
分類和標(biāo)簽
只有文章支持分類和標(biāo)簽,您可以在 Front-matter 中設(shè)置。在其他系統(tǒng)中,分類和標(biāo)簽聽(tīng)起來(lái)很接近,但是在 Hexo 中兩者有著明顯的差別:分類具有順序性和層次性而標(biāo)簽沒(méi)有順序和層次。
categories: - Diary tags: - PS3 - Games WordPress支持對(duì)一篇文章設(shè)置多個(gè)分類,而且這些分類可以是同級(jí)的,也可以是父子分類。但是Hexo不支持指定多個(gè)同級(jí)分類。下面的指定方法: categories:- Diary
- Life
會(huì)使分類Life成為Diary的子分類,而不是并列分類。因此,有必要為您的文章選擇盡可能準(zhǔn)確的分類.
4.4. 文章摘要
設(shè)置文章摘要,我們只需在想顯示為摘要的內(nèi)容之后添 <!-- more --> 即可。像下面這樣:
--- title: hello hexo markdown date: 2016-11-16 18:11:25 tags: - hello - hexo - markdown ---我是短小精悍的文章摘要(??????) ?<!-- more -->緊接著文章摘要的正文內(nèi)容這樣,<!-- more --> 之前、文檔配置參數(shù)之后中的內(nèi)容便會(huì)被渲染為站點(diǎn)中的文章摘要。
注意!文章摘要在文章詳情頁(yè)是正文中最前面的內(nèi)容。4.5. 資源引用
寫個(gè)博客,有時(shí)候會(huì)想添加個(gè)圖片或者其他形式的資源等等。有以下兩種方式進(jìn)行解決:
對(duì)于使用相對(duì)路徑引用資源的,我們可以使用 Hexo 提供的資源文件夾功能。
使用文本編輯器打開(kāi)站點(diǎn)根目錄下的 _ config.yml 文件,將 post_asset_folder 值設(shè)置為 true。
post_asset_folder: true修改之后會(huì)開(kāi)啟 Hexo 的文章資源文件管理功能。Hexo 將會(huì)在我們每一次通過(guò) hexo new <title> 命令創(chuàng)建新文章時(shí)自動(dòng)創(chuàng)建一個(gè)同名文件夾,于是我們便可以將文章所引用的相關(guān)資源放到這個(gè)同名文件夾下,然后通過(guò)相對(duì)路徑引用。例如,你把一個(gè) example.jpg 圖片放在了這個(gè)同名文件夾中,使用相對(duì)路徑的常規(guī) markdown 語(yǔ)法 即可訪問(wèn) 。
5. 網(wǎng)站發(fā)布
首先執(zhí)行下列命令生成相應(yīng)的靜態(tài)網(wǎng)頁(yè),生成的靜態(tài)網(wǎng)頁(yè)以及相關(guān)資源都會(huì)在public目錄下
$ hexo generate5.1. 用hexo-server
hexo-server模塊的主要命令如下,輸入以下命令以啟動(dòng)服務(wù)器,您的網(wǎng)站會(huì)在 http://localhost:4000 下啟動(dòng)。在服務(wù)器啟動(dòng)期間,Hexo 會(huì)監(jiān)視文件變動(dòng)并自動(dòng)更新,您無(wú)須重啟服務(wù)器。
$ hexo server如果您想要更改端口,或是在執(zhí)行時(shí)遇到了 EADDRINUSE 錯(cuò)誤,可以在執(zhí)行時(shí)使用 -p 選項(xiàng)指定其他端口,如下:
$ hexo server -p 5000 但是個(gè)人認(rèn)為此方式比較適合用于調(diào)試網(wǎng)站,并不適合長(zhǎng)時(shí)間的網(wǎng)站服務(wù)器,同時(shí)為了讓這個(gè)命令在后臺(tái)長(zhǎng)時(shí)間運(yùn)行,需要編寫相應(yīng)的腳本。5.2. 部署到Git上
這個(gè)暫時(shí)沒(méi)有嘗試過(guò),但是網(wǎng)絡(luò)上很多都是關(guān)于部署到Git上的,可以自行谷歌或百度。
5.3. 部署到Apache或者Nginx上
通過(guò)hexo g命令生成的都是靜態(tài)網(wǎng)頁(yè),可以把生成的public目錄中的文件,全都拷貝到網(wǎng)站根目錄,然后啟動(dòng)apache或者nginx服務(wù)。
6. 其他基礎(chǔ)命令
6.1. 清除緩存文件
為了避免不必要的錯(cuò)誤,在生成靜態(tài)文件前,強(qiáng)烈建議先運(yùn)行以下命令:
$ hexo clean上述命令會(huì)清除本地站點(diǎn)文件夾下的緩存文件(db.json)和已有的靜態(tài)文件(public)。
7. 參考鏈接
文檔?hexo.ioHexo教程:(三)使用Hexo寫博客?lfkid.github.io更多內(nèi)容請(qǐng)關(guān)注微信公眾號(hào)【多選參數(shù)】
總結(jié)
以上是生活随笔為你收集整理的hexo评论_Hexo系列 | Hexo的基本使用的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: 高启强怎么说?强盛公司用盐水冒充神药 被
- 下一篇: 哔哩哔哩_哔哩哔哩,危!!!