Hexo 3.0 靜態博客使用指南 | 一路向北
我的图书馆
Hexo 3.0 靜態博客使用指南 | 一路向北
上次我介紹了Hexo的基本搭建方法 近期大神 又更新了3.0版本和之前的2.0使用步驟略有不同 目前剛剛更新 可能有許多主題和插件不兼容3.0 請等待後續更新
本文介紹從零開始搭建的方法 如需從2.x升級到3.0 遷移方法請移至本文最後
目錄I.Hexo簡介II.Hexo安裝方法III.Hexo配置方法IV.Hexo部署方法
I.Hexo簡介Hexo 是一個輕量的靜態博客框架。通過Hexo可以快速生成一個靜態博客框架,僅需要幾條命令就可以完成,相當方便。
而架設Hexo的環境更簡單了 不需要lnmp/lamp這些繁瑣複雜的環境 僅僅需要一個簡單的http服務器即可使用 或者使用互聯網上免費的頁面託管服務比如Hexo的官方網站 就是託管於github的pages服務上
II.Hexo安裝方法Mac OS X/Linux或其他UNIX/類UNIX系統node環境 請去下載源代碼編譯安裝
wget http://nodejs.org/dist/v0.12.0/node-v0.12.0.tar.gz
tar zxvf node-v0.12.0.tar.gz
cd node-v0.12.0
./configure --prefix=/usr
make install
npm(node包管理器)
yum install npm -y
apt-get install npm -y
其他發行版請自行尋找wiki獲得幫助
通過npm安裝Hexo-Cli 和 hexonpm install hexo-cli -g
npm install hexo --save
如果以上命令不能安裝 可以嘗試把官方源替換爲 再執行安裝Hexo
npm install -g cnpm --registry=https://registry.npm.taobao.org
或者你直接通過添加 npm 參數 alias 一個新命令:
alias cnpm="npm --registry=https://registry.npm.taobao.org --cache=$HOME/.npm/.cache/cnpm --disturl=https://npm.taobao.org/dist --userconfig=$HOME/.cnpmrc"
Or alias it in .bashrc or .zshrc$ echo '\n#alias for cnpm\nalias cnpm="npm --registry=https://registry.npm.taobao.org --cache=$HOME/.npm/.cache/cnpm --disturl=https://npm.taobao.org/dist --userconfig=$HOME/.cnpmrc"' && ~/.zshrc && source ~/.zshrc
Windows系統（具體環境配置請參考）node環境npm(node包管理器)
III.Hexo配置方法新建一個需要當做博客目錄的文件夾
mkdir blog
進去之後加入hexo主程序和安裝npm
hexo init && npm install
文件夾大致結構如下
scaffolds 工具模板
scripts hexo的功能js
source 博客資源文件夾
source/_drafts 草稿文件夾
source/_posts 文章文件夾
themes 存放皮膚的文件夾
themes/landscape 默認皮膚文件夾
_config.yml 全局配置文件
db.json json格式的靜態常量數據庫
_posts目錄：Hexo存放博客文章的文件夾
themes目錄：存放皮膚的文件夾，默認使用官方的主題 你也可以從下載你喜歡的主題
配置HexoHexo全局配置用文本編輯器修改_config.yml這個文件 大致如下 只需要自行修改幾個 其他保持默認即可
通常需要修改站點名稱 /URL格式 /歸檔設置 /disqus評論用戶名 /部署配置 這幾項就可以了 注意冒號後面都要添加一個半角空格 之後纔是設置參數
自定義域名設置 在source我文件夾下面新建CNAME文件 裏面寫入你的自定義域名 並設置您的dns配置cname方式到服務提供商的給的地址即可
網站參數 描述title 網站標題subtitle 網站副標題description 網站描述author 您的名字language 網站使用的語言timezone 網站時區。Hexo 預設使用您電腦的時區。時區列表
網址參數 描述 默認值url 網址root 網站根目錄permalink 文章的 永久鏈接 格式 :year/:month/:day/:title/permalink_default 永久鏈接中各部分的默認值網站存放在子目錄如果您的網站存放在子目錄中，例如
並把 root 設爲 /blog/。
目錄參數 描述 默認值source_dir 資源文件夾，這個文件夾用來存放內容。 sourcepublic_dir 公共文件夾，這個文件夾用於存放生成的站點文件。 publictag_dir 標籤文件夾 tagsarchive_dir 歸檔文件夾 archivescategory_dir 分類文件夾 categoriescode_dir Include code 文件夾 downloads/codei18n_dir 國際化（i18n）文件夾 :langskip_render 跳過指定文件的渲染，您可使用 glob 來配置路徑。
文章參數 描述 默認值new_post_name 新文章的文件名稱 :title.mddefault_layout 預設佈局 postauto_spacing 在中文和英文之間加入空格 falsetitlecase 把標題轉換爲 title case falseexternal_link 在新標籤中打開鏈接 truefilename_case 把文件名稱轉換爲 (1) 小寫或 (2) 大寫 0render_drafts 顯示草稿 falsepost_asset_folder 啓動 Asset 文件夾 falserelative_link 把鏈接改爲與根目錄的相對位址 falsefuture 顯示未來的文章 truehighlight 代碼塊的設置
分類 & 標籤參數 描述 默認值default_category 默認分類 uncategorizedcategory_map 分類別名tag_map 標籤別名日期 / 時間格式Hexo 使用 Moment.js 來解析和顯示時間。
參數 描述 默認值date_format 日期格式 MMM D YYYYtime_format 時間格式 H:mm:ss分頁參數 描述 默認值per_page 每頁顯示的文章量 (0 = 關閉分頁功能) 10pagination_dir 分頁目錄 page
擴展參數 描述theme 當前主題名稱deploy 部署
Hexo常用插件安裝與配置安裝首頁文章數量 存檔 分類 的插件安裝本地服務器代理插件安裝發佈器插件安裝更新插件 rss site-map之類的
npm install hexo-generator-index --save
npm install hexo-generator-archive --save
npm install hexo-generator-category --save
npm install hexo-generator-tag --save
npm install hexo-server --save
npm install hexo-deployer-git --save
npm install hexo-deployer-heroku --save
npm install hexo-deployer-rsync --save
npm install hexo-deployer-openshift --save
npm install hexo-renderer-marked@0.2 --save
npm install hexo-renderer-stylus@0.2 --save
npm install hexo-generator-feed@1 --save
npm install hexo-generator-sitemap@1 --save
裝完之後去全局配置文件 _config.yml 修改參數
index_generator:
per_page: 10 ##首頁默認10篇文章標題 如果值爲0不分頁
archive_generator:
per_page: 10 ##歸檔頁面默認10篇文章標題
yearly: true
##生成年視圖
monthly: true ##生成月視圖
tag_generator:
per_page: 10 ##標籤分類頁面默認10篇文章
category_generator:
per_page: 10 ###分類頁面默認10篇文章
type: atom ##feed類型 atom或者rss2
path: atom.xml ##feed路徑
##feed文章最小數量
type: git ##部署類型 其他類型自行google之
repo: &repository url& ##git倉庫地址
branch: [branch] ##git 頁面分支
message: [message] ##git message建議默認字段update 可以自定義
message: update
##git message建議默認字段update 可以自定義
github: &repository url&,[branch] ##github 倉庫地址和分支
gitcafe: &repository url&,[branch] ##gitcafe 倉庫地址和分支
更多插件可以去Hexo插件wiki找到
Hexo主題設置同樣編輯主題文件夾的_config.yml
Headermenu: #導航欄連接Home: /Archives: /archives #歸檔頁面URL自定義頁面標題: /自定義頁面URLrss: /atom.xml #rss地址 默認即可
Contentexcerpt_link: Read More #閱讀更多的文字顯示fancybox: true #開啓fancybox效果
Sidebar #側邊欄設置sidebar: rightwidgets:
categorytagtagcloudarchiverecent_posts
Miscellaneous #社交網絡和統計連接地址google_analytics: #google analytics IDfavicon: /favicon.png #網站的favicontwitter:google_plus:fb_admins:fb_app_id:
寫文章Hexo使用markdown語法的純文本存放文章 後綴爲.md 你可以在_post文件夾裏面新建這個後綴的.md文件 使用的全是UTF-8編碼
也可以輸入命令以生成
hexo new post &title&
如果是新建一個頁面
hexo new page &title&
看一下剛纔生成的
title: title #文章標題
date: 2015-02-05 12:47:44 #文章生成時間
categories: #文章分類目錄 可以省略
tags: #文章標籤 可以省略
description: #你對本頁的描述 可以省略
這裏開始使用markdown格式輸入你的正文。
多標籤注意語法格式 如下:
想在首頁文章預覽添加圖片可以添加photo參數 這個fancybox可以省略 如下:
- http://</photo.jpg
正文中可以使用&!--more--&設置文章摘要 如下:
以上是文章摘要
&!--more--&
以下是餘下全文
more以上內容即是文章摘要，在主頁顯示，more以下內容點擊『& Read More』鏈接打開全文才顯示。
IV.Hexo部署方法寫完文章之後 就可以啓動本地服務器測試了
hexo server
這個時候hexo啓動localhost的4000端口 靜態的網站架設完成
推薦部署在
的pages服務上
修改後就可以部署上去了
hexo clean #清除緩存 網頁正常情況下可以忽略此條命令
hexo g #生成靜態網頁
hexo d #開始部署
以上就是Hexo的基本使用方法 進階的可以在Hexo的官方文檔裏找到 感謝閱讀!
hexo3.0帶來了更好的性能，更新了API，模塊化了大部分組件。更多變化看這裏：
hexo2.x到3.0遷移指南：
馆藏&23711
TA的推荐TA的最新馆藏[转]&[转]&[转]&[转]&[转]&[转]&[转]&[转]&[转]&问题对人有帮助，内容完整，我也想知道答案
问题没有实际价值，缺少关键内容，没有改进余地
使用sublime的Markdown和MarkdownPreview插件可以在浏览器中显示用Markdown编写的流程图(flow)，其实就是flowchart插件，现在我想让它在hexo博客中显示流程图，hexo支持markdown，但是不支持markdown流程图，我是应该扩展hexo的highlight插件吗？
答案对人有帮助，有参考价值
答案没帮助，是错误的答案，答非所问
推荐个Hexo插件 hexo-filter-flowchart,
答案对人有帮助，有参考价值
答案没帮助，是错误的答案，答非所问
替换一个支持的插件就好了~
同步到新浪微博
分享到微博？
你好！看起来你挺喜欢这个内容，但是你还没有注册帐号。 当你创建了帐号，我们能准确地追踪你关注的问题，在有新答案或内容的时候收到网页和邮件通知。还能直接向作者咨询更多细节。如果上面的内容有帮助，记得点赞 (????)? 表示感谢。
明天提醒我
关闭理由：
删除理由：
忽略理由：
推广（招聘、广告、SEO 等）方面的内容
与已有问题重复（请编辑该提问指向已有相同问题）
答非所问，不符合答题要求
宜作评论而非答案
带有人身攻击、辱骂、仇恨等违反条款的内容
无法获得确切结果的问题
非开发直接相关的问题
非技术提问的讨论型问题
其他原因（请补充说明）
我要该，理由是：
扫扫下载 App