搜索

[27419] 2019-09-27_利用GitHub从零开始搭建一个博客

文档创建者：s7ckTeam
浏览次数：1
最后更新：2025-01-19
2019-09-27_利用GitHub从零开始搭建一个博客 利 用   G i t H u b   从 零 开 始 搭 建 一 个 博 客 原 创   崔 庆 才   N i g h t T e a m   2 0 1 9 - 0 9 - 2 7 " N i g h t T e a m " ， 一 个 值 得 加 星 标 的 公 众 号 。 趁 着 周 末 ， 搭 建 了 一 下   N i g h t T e a m   的 官 方 博 客 和 官 方 主 页 ， 耗 时 数 个 小 时 ， 两 个 站 点 终 于 完 工 了 。 由 于   N i g h t T e a m   的 域 名 是   n i g h t t e a m . c n ， 所 以 这 里 官 方 博 客 使 用 了 二 级 域 名   b l o g . n i g h t t e a m . c n ， 官 方 主 页 使 用 了 根 域 名 n i g h t t e a m . c n ， 现 在 两 个 站 点 都 已 经 稳 定 运 行 在   G i t H u b   P a g e s   上 面 了 ， 大 家 如 果 感 兴 趣 可 以 去 看 一 下 。 • N i g h t T e a m   H o m e P a g e ： h t t p s : / / n i g h t t e a m . c n / • N i g h t T e a m   B l o g :   h t t p s : / / b l o g . n i g h t t e a m . c n / 下 面 是 两 个 站 点 的 预 览 图 ：
这 里 的 主 页 就 是 用 一 个 基 本 的 静 态 页 面 搭 建 了 ， 没 有 什 么 技 术 含 量 。 博 客 相 对 复 杂 一 点 ， 使 用 了   H e x o   框 架 ， 采 用 了   N e x t   主 题 ， 在 搭 建 的 过 程 中 我 就 顺 手 把 搭 建 的 流 程 大 致 记 录 下 来 了 ， 在 这 里 扩 充 一 下 形 成 一 篇 记 录 ， 毕 竟 好 记 性 不 如 烂 笔 头 。 于 是 ， 这 篇 《 利 用   G i t H u b   从 零 开 始 搭 建 一 个 博 客 》 的 文 章 就 诞 生 了 。 准 备 条 件 准 备 条 件 在 这 里 先 跟 大 家 说 一 些 准 备 条 件 ， 有 些 同 学 可 能 一 听 到 搭 建 博 客 就 望 而 却 步 。 弄 个 博 客 网 站 ， 不 得 有 台 服 务 器 吗 ？ 不 得 搞 数 据 库 吗 ？ 不 得 注 册 域 名 吗 ？ 没 事 ， 如 果 都 没 有 ， 那 照 样 是 能 搭 建 一 个 博 客 的 。 G i t H u b   是 个 好 东 西 啊 ， 它 提 供 了   G i t H u b   P a g e s   帮 助 我 们 来 架 设 一 个 静 态 网 站 ， 这 就 解 决 了 服 务 器 的 问 题 。 H e x o   这 个 博 客 框 架 没 有 那 么 重 量 级 ， 它 是   M a r k D o w n   直 接 写 文 章 的 ， 然 后   H e x o   可 以 直 接 将 文 章 编 译 成 静 态 网 页 文 件 并 发 布 ， 所 以 这 样 文 章 的 内 容 、 标 题 、 标 签 等 信 息 就 没 必 要 存 数 据 库 里 面 了 ， 是 直 接 纯 静 态 页 面 了 ， 这 就 解 决 了 数 据 库 的 问 题 。 G i t H u b   P a g e s   允 许 每 个 账 户 创 建 一 个 名 为   { u s e r n a m e } . g i t h u b . i o   的 仓 库 ， 另 外 它 还 会 自 动 为 这 个 仓 库 分 配 一 个   g i t h u b . i o   的 二 级 域 名 ， 这 就 解 决 了 域 名 的 问 题 ， 当 然 如 果 想 要 自 定 义 域 名 的 话 ， 也 可 以 支 持 。 所 以 说 ， 基 本 上 ， 先 注 册 个   G i t H u b   账 号 就 能 搞 了 ， 下 面 我 们 来 正 式 开 始 吧 。
新 建 项 目 新 建 项 目 首 先 在   G i t H u b   新 建 一 个 仓 库 （ R e p o s i t o r y ） ， 名 称 为   { u s e r n a m e } . g i t h u b . i o ， 注 意 这 个 名 比 较 特 殊 ， 必 须 要 是   g i t h u b . i o   为 后 缀 结 尾 的 。 比 如   N i g h t T e a m   的   G i t H u b   用 户 名 就 叫   N i g h t T e a m ， 那 我 就 新 建 一 个   n i g h t t e a m . g i t h u b . i o ， 新 建 完 成 之 后 就 可 以 进 行 后 续 操 作 了 。 另 外 如 果   G i t H u b   没 有 配 置   S S H   连 接 的 建 议 配 置 一 下 ， 这 样 后 面 在 部 署 博 客 的 时 候 会 更 方 便 。 安 装 环 境 安 装 环 境 安 装 安 装   N o d e . j s 首 先 在 自 己 的 电 脑 上 安 装   N o d e . j s ， 下 载 地 址 ： h t t p s : / / n o d e j s . o r g / z h - c n / d o w n l o a d / ， 可 以 安 装   S t a b l e   版 本 。 安 装 完 毕 之 后 ， 确 保 环 境 变 量 配 置 好 ， 能 正 常 使 用     命 令 。 安 装 安 装   H e x o 接 下 来 就 需 要 安 装   H e x o   了 ， 这 是 一 个 博 客 框 架 ， H e x o   官 方 还 提 供 了 一 个 命 令 行 工 具 ， 用 于 快 速 创 建 项 目 、 页 面 、 编 译 、 部 署 H e x o   博 客 ， 所 以 在 这 之 前 我 们 需 要 先 安 装   H e x o   的 命 令 行 工 具 。 命 令 如 下 ： 安 装 完 毕 之 后 ， 确 保 环 境 变 量 配 置 好 ， 能 正 常 使 用     命 令 。 初 始 化 项 目 初 始 化 项 目 接 下 来 我 们 使 用   H e x o   的 命 令 行 创 建 一 个 项 目 ， 并 将 其 在 本 地 跑 起 来 ， 整 体 跑 通 看 看 。 首 先 使 用 如 下 命 令 创 建 项 目 ： 这 里 的   n a m e   就 是 项 目 名 ， 我 这 里 要 创 建   N i g h t T e a m   的 博 客 ， 我 就 把 项 目 取 名 为   n i g h t t e a m   了 ， 用 了 纯 小 写 ， 命 令 如 下 ： n p m n p m   i n s t a l l   - g   h e x o - c l i h e x o h e x o   i n i t   { n a m e } h e x o   i n i t   n i g h t t e a m
这 样   n i g h t t e a m   文 件 夹 下 就 会 出 现   H e x o   的 初 始 化 文 件 ， 包 括   t h e m e s 、 s c a f f o l d s 、 s o u r c e   等 文 件 夹 ， 这 些 内 容 暂 且 先 不 用 管 是 做 什 么 的 ， 我 们 先 知 道 有 什 么 ， 然 后 一 步 步 走 下 去 看 看 都 发 生 了 什 么 变 化 。 接 下 来 我 们 首 先 进 入 新 生 成 的 文 件 夹 里 面 ， 然 后 调 用   H e x o   的   g e n e r a t e   命 令 ， 将   H e x o   编 译 生 成   H T M L   代 码 ， 命 令 如 下 ： 可 以 看 到 输 出 结 果 里 面 包 含 了   j s 、 c s s 、 f o n t   等 内 容 ， 并 发 现 他 们 都 处 在 了 项 目 根 目 录 下 的   p u b l i c   文 件 夹 下 面 了 。 然 后 我 们 利 用   H e x o   提 供 的   s e r v e r   命 令 把 博 客 在 本 地 运 行 起 来 ， 命 令 如 下 ： 运 行 之 后 命 令 行 输 出 如 下 ： 它 告 诉 我 们 在 本 地   4 0 0 0   端 口 上 就 可 以 查 看 博 客 站 点 了 ， 如 图 所 示 ： 这 样 一 个 博 客 的 架 子 就 出 来 了 ， 我 们 只 用 了 三 个 命 令 就 完 成 了 。 部 署 部 署 接 下 来 我 们 来 将 这 个 初 始 化 的 博 客 进 行 一 下 部 署 ， 放 到   G i t H u b   P a g e s   上 面 验 证 一 下 其 可 用 性 。 成 功 之 后 我 们 可 以 再 进 行 后 续 的 修 改 ， 比 如 修 改 主 题 、 修 改 页 面 配 置 等 等 。 h e x o   g e n e r a t e h e x o   s e r v e r I N F O     S t a r t   p r o c e s s i n g I N F O     H e x o   i s   r u n n i n g   a t   h t t p : / / l o c a l h o s t : 4 0 0 0   .   P r e s s   C t r l + C   t o   s t o p .
那 么 怎 么 把 这 个 页 面 部 署 到   G i t H u b   P a g e s   上 面 呢 ， 其 实   H e x o   已 经 给 我 们 提 供 一 个 命 令 ， 利 用 它 我 们 可 以 直 接 将 博 客 一 键 部 署 ， 不 需 要 手 动 去 配 置 服 务 器 或 进 行 其 他 的 各 项 配 置 。 部 署 命 令 如 下 ： 在 部 署 之 前 ， 我 们 需 要 先 知 道 博 客 的 部 署 地 址 ， 它 需 要 对 应   G i t H u b   的 一 个   R e p o s i t o r y   的 地 址 ， 这 个 信 息 需 要 我 们 来 配 置 一 下 。 打 开 根 目 录 下 的   _ c o n f i g . y m l   文 件 ， 找 到   D e p l o y m e n t   这 个 地 方 ， 把 刚 才 新 建 的   R e p o s i t o r y   的 地 址 贴 过 来 ， 然 后 指 定 分 支 为   m a s t e r 分 支 ， 最 终 修 改 为 如 下 内 容 ： 我 的 就 修 改 为 如 下 内 容 ： 另 外 我 们 还 需 要 额 外 安 装 一 个 支 持   G i t   的 部 署 插 件 ， 名 字 叫 做   h e x o - d e p l o y e r - g i t ， 有 了 它 我 们 才 可 以 顺 利 将 其 部 署 到   G i t H u b   上 面 ， 如 果 不 安 装 的 话 ， 在 执 行 部 署 命 令 时 会 报 如 下 错 误 ： 好 ， 那 就 让 我 们 安 装 下 这 个 插 件 ， 在 项 目 目 录 下 执 行 安 装 命 令 如 下 ： 安 装 成 功 之 后 ， 执 行 部 署 命 令 ： 运 行 结 果 类 似 如 下 ： h e x o   d e p l o y #   D e p l o y m e n t # #   D o c s :   h t t p s : / / h e x o . i o / d o c s / d e p l o y m e n t . h t m l d e p l o y :     t y p e :   g i t     r e p o :   { g i t   r e p o   s s h   a d d r e s s }     b r a n c h :   m a s t e r #   D e p l o y m e n t # #   D o c s :   h t t p s : / / h e x o . i o / d o c s / d e p l o y m e n t . h t m l d e p l o y :     t y p e :   g i t     r e p o :   g i t @ g i t h u b . c o m : N i g h t T e a m / n i g h t t e a m . g i t h u b . i o . g i t     b r a n c h :   m a s t e r D e p l o y e r   n o t   f o u n d :   g i t n p m   i n s t a l l   h e x o - d e p l o y e r - g i t   - - s a v e h e x o   d e p l o y I N F O     D e p l o y i n g :   g i t I N F O     C l e a r i n g   . d e p l o y _ g i t   f o l d e r . . . I N F O     C o p y i n g   f i l e s   f r o m   p u b l i c   f o l d e r . . . I N F O     C o p y i n g   f i l e s   f r o m   e x t e n d   d i r s . . . O n   b r a n c h   m a s t e r n o t h i n g   t o   c o m m i t ,   w o r k i n g   d i r e c t o r y   c l e a n C o u n t i n g   o b j e c t s :   4 6 ,   d o n e . D e l t a   c o m p r e s s i o n   u s i n g   u p   t o   8   t h r e a d s . C o m p r e s s i n g   o b j e c t s :   1 0 0 %   ( 3 6 / 3 6 ) ,   d o n e . W r i t i n g   o b j e c t s :   1 0 0 %   ( 4 6 / 4 6 ) ,   5 0 7 . 6 6   K i B   |   0   b y t e s / s ,   d o n e .
如 果 出 现 类 似 上 面 的 内 容 ， 就 证 明 我 们 的 博 客 已 经 成 功 部 署 到   G i t H u b   P a g e s   上 面 了 ， 这 时 候 我 们 访 问 一 下   G i t H u b   R e p o s i t o r y   同 名 的 链 接 ， 比 如 我 的   N i g h t T e a m   博 客 的   R e p o s i t o r y   名 称 取 的 是   n i g h t t e a m . g i t h u b . i o ， 那 我 就 访 问   h t t p : / / n i g h t t e a m . g i t h u b . i o ， 这 时 候 我 们 就 可 以 看 到 跟 本 地 一 模 一 样 的 博 客 内 容 了 。 这 时 候 我 们 去   G i t H u b   上 面 看 看   H e x o   上 传 了 什 么 内 容 ， 打 开 之 后 可 以 看 到   m a s t e r   分 支 有 了 这 样 的 内 容 ： W r i t i n g   o b j e c t s :   1 0 0 %   ( 4 6 / 4 6 ) ,   5 0 7 . 6 6   K i B   |   0   b y t e s / s ,   d o n e . T o t a l   4 6   ( d e l t a   3 ) ,   r e u s e d   0   ( d e l t a   0 ) r e m o t e :   R e s o l v i n g   d e l t a s :   1 0 0 %   ( 3 / 3 ) ,   d o n e . T o   g i t @ g i t h u b . c o m : N i g h t T e a m / n i g h t t e a m . g i t h u b . i o . g i t   *   [ n e w   b r a n c h ]             H E A D   - >   m a s t e r B r a n c h   m a s t e r   s e t   u p   t o   t r a c k   r e m o t e   b r a n c h   m a s t e r   f r o m   g i t @ g i t h u b . c o m : N i g h t T e a m / n i g h t t e a m . g i t h u b . i o . g i t . I N F O     D e p l o y   d o n e :   g i t
仔 细 看 看 ， 这 实 际 上 是 博 客 文 件 夹 下 面 的   p u b l i c   文 件 夹 下 的 所 有 内 容 ， H e x o   把 编 译 之 后 的 静 态 页 面 内 容 上 传 到   G i t H u b   的   m a s t e r 分 支 上 面 去 了 。 这 时 候 可 能 就 有 人 有 疑 问 了 ， 那 我 博 客 的 源 码 也 想 放 到   G i t H u b   上 面 怎 么 办 呢 ？ 其 实 很 简 单 ， 新 建 一 个 其 他 的 分 支 就 好 了 ， 比 如 我 这 边 就 新 建 了 一 个   s o u r c e   分 支 ， 代 表 博 客 源 码 的 意 思 。 具 体 的 添 加 过 程 就 很 简 单 了 ， 参 见 如 下 命 令 ： 成 功 之 后 ， 可 以 到   G i t H u b   上 再 切 换 下 默 认 分 支 ， 比 如 我 就 把 默 认 的 分 支 设 置 为 了   s o u r c e ， 当 然 不 换 也 可 以 。 g i t   i n i t g i t   c h e c k o u t   - b   s o u r c e g i t   a d d   - A g i t   c o m m i t   - m   " i n i t   b l o g " g i t   r e m o t e   a d d   o r i g i n   g i t @ g i t h u b . c o m : { u s e r n a m e } / { u s e r n a m e } . g i t h u b . i o . g i t g i t   p u s h   o r i g i n   s o u r c e
配 置 站 点 信 息 配 置 站 点 信 息 完 成 如 上 内 容 之 后 ， 实 际 上 我 们 只 完 成 了 博 客 搭 建 的 一 小 步 ， 因 为 我 们 仅 仅 是 把 初 始 化 的 页 面 部 署 成 功 了 ， 博 客 里 面 还 没 有 设 置 任 何 有 效 的 信 息 。 下 面 就 让 我 们 来 进 行 一 下 博 客 的 基 本 配 置 ， 另 外 换 一 个 好 看 的 主 题 ， 配 置 一 些 其 他 的 内 容 ， 让 博 客 真 正 变 成 属 于 我 们 自 己 的 博 客 吧 。 下 面 我 就 以 自 己 的 站 点   N i g h t T e a m   为 例 ， 修 改 一 些 基 本 的 配 置 ， 比 如 站 点 名 、 站 点 描 述 等 等 。 修 改 根 目 录 下 的   _ c o n f i g . y m l   文 件 ， 找 到   S i t e   区 域 ， 这 里 面 可 以 配 置 站 点 标 题   t i t l e 、 副 标 题   s u b t i t l e   等 内 容 、 关 键 字   k e y w o r d s   等 内 容 ， 比 如 我 的 就 修 改 为 如 下 内 容 ： 这 里 大 家 可 以 参 照 格 式 把 内 容 改 成 自 己 的 。 另 外 还 可 以 设 置 一 下 语 言 ， 如 果 要 设 置 为 汉 语 的 话 可 以 将   l a n g u a g e   的 字 段 设 置 为   z h - C N ， 修 改 如 下 ： 这 样 就 完 成 了 站 点 基 本 信 息 的 配 置 ， 完 成 之 后 可 以 看 到 一 些 基 本 信 息 就 修 改 过 来 了 ， 页 面 效 果 如 下 ： #   S i t e t i t l e :   N i g h t T e a m s u b t i t l e :   一 个 专 注 技 术 的 组 织 d e s c r i p t i o n :   涉 猎 的 主 要 编 程 语 言 为   P y t h o n 、 R u s t 、 C + + 、 G o ， 领 域 涵 盖 爬 虫 、 深 度 学 习 、 服 务 研 发 和 对 象 存 储 等 。 k e y w o r d s :   " P y t h o n ,   R u s t ,   C + + ,   G o ,   爬 虫 ,   深 度 学 习 ,   服 务 研 发 ,   对 象 存 储 " a u t h o r :   N i g h t T e a m l a n g u a g e :   z h - C N
修 改 主 题 修 改 主 题 目 前 来 看 ， 整 个 页 面 的 样 式 个 人 感 觉 并 不 是 那 么 好 看 ， 想 换 一 个 风 格 ， 这 就 涉 及 到 主 题 的 配 置 了 。 目 前   H e x o   里 面 应 用 最 多 的 主 题 基 本 就 是   N e x t   主 题 了 ， 个 人 感 觉 这 个 主 题 还 是 挺 好 看 的 ， 另 外 它 支 持 的 插 件 和 功 能 也 极 为 丰 富 ， 配 置 了 这 个 主 题 ， 我 们 的 博 客 可 以 支 持 更 多 的 扩 展 功 能 ， 比 如 阅 览 进 度 条 、 中 英 文 空 格 排 版 、 图 片 懒 加 载 等 等 。 那 么 首 先 就 让 我 们 来 安 装 下   N e x t   这 个 主 题 吧 ， 目 前   N e x t   主 题 已 经 更 新 到   7 . x   版 本 了 ， 我 们 可 以 直 接 到   N e x t   主 题 的   G i t H u b R e p o s i t o r y   上 把 这 个 主 题 下 载 下 来 。 主 题 的   G i t H u b   地 址 是 ： h t t p s : / / g i t h u b . c o m / t h e m e - n e x t / h e x o - t h e m e - n e x t ， 我 们 可 以 直 接 把   m a s t e r   分 支   C l o n e   下 来 。 首 先 命 令 行 进 入 到 项 目 的 根 目 录 ， 执 行 如 下 命 令 即 可 ： 执 行 完 毕 之 后   N e x t   主 题 的 源 码 就 会 出 现 在 项 目 的   t h e m e s / n e x t   文 件 夹 下 。 然 后 我 们 需 要 修 改 下 博 客 所 用 的 主 题 名 称 ， 修 改 项 目 根 目 录 下 的   _ c o n f i g . y m l   文 件 ， 找 到   t h e m e   字 段 ， 修 改 为   n e x t   即 可 ， 修 改 如 下 ： 然 后 本 地 重 新 开 启 服 务 ， 访 问 刷 新 下 页 面 ， 就 可 以 看 到   n e x t   主 题 就 切 换 成 功 了 ， 预 览 效 果 如 下 ： 主 题 配 置 主 题 配 置 g i t   c l o n e   h t t p s : / / g i t h u b . c o m / t h e m e - n e x t / h e x o - t h e m e - n e x t   t h e m e s / n e x t t h e m e :   n e x t
现 在 我 们 已 经 成 功 切 换 到   n e x t   主 题 上 面 了 ， 接 下 来 我 们 就 对 主 题 进 行 进 一 步 地 详 细 配 置 吧 ， 比 如 修 改 样 式 、 增 加 其 他 各 项 功 能 的 支 持 ， 下 面 逐 项 道 来 。 N e x t   主 题 内 部 也 提 供 了 一 个 配 置 文 件 ， 名 字 同 样 叫 做   _ c o n f i g . y m l ， 只 不 过 位 置 不 一 样 ， 它 在   t h e m e s / n e x t   文 件 夹 下 ， N e x t   主 题 里 面 所 有 的 功 能 都 可 以 通 过 这 个 配 置 文 件 来 控 制 ， 下 文 所 述 的 内 容 都 是 修 改 的   t h e m e s / n e x t / _ c o n f i g . y m l   文 件 。 样 式 样 式 N e x t   主 题 还 提 供 了 多 种 样 式 ， 风 格 都 是 类 似 黑 白 的 搭 配 ， 但 整 个 布 局 位 置 不 太 一 样 ， 通 过 修 改 配 置 文 件 的   s c h e m e   字 段 即 可 ， 我 选 了   P i s c e s   样 式 ， 修 改   _ c o n f i g . y m l   （ 注 意 是   t h e m e s / n e x t / _ c o n f i g . y m l   文 件 ） 如 下 ： 刷 新 页 面 之 后 就 会 变 成 这 种 样 式 ， 如 图 所 示 ： 另 外 还 有 几 个 可 选 项 ， 比 如 ： 大 家 可 以 自 行 根 据 喜 好 选 择 。 f a v i c o n f a v i c o n   就 是 站 点 标 签 栏 的 小 图 标 ， 默 认 是 用 的   H e x o   的 小 图 标 ， 如 果 我 们 有 站 点   L o g o   的 图 片 的 话 ， 我 们 可 以 自 己 定 制 小 图 标 。 s c h e m e :   P i s c e s #   s c h e m e :   M u s e # s c h e m e :   M i s t s c h e m e :   P i s c e s # s c h e m e :   G e m i n i
回复

举报

高级模式
B Color Image Link Quote Code Smilies
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

使用Markdown编辑器编辑 使用富文本编辑器编辑

Archiver| 手机版| 小黑屋|
Powered by Discuz! X3.4 Copyright © 2001-2020, Tencent Cloud. 商业源码建议获取授权，如侵犯您的权益，请联系客服处理