教程

前言 在前一篇文章，我详细描述了博客的初步搭建教程，基于此教程足以搭建一个支持通过github io访问的博客。本篇教程在之前的基础上，继续讲解如何自定义域名、增加HTTPS协议支持、增加Cloudflare代理隐藏真实github io地址。 参考链接 Shawn’s Blog

前言 本教程将详细说明如何通过Github Pages + Hugo + Cloudflare从零到一构建一个免费的静态博客站，让你在网络中拥有自己的一亩三分地。 基本原理 Hugo是Go语言实现的静态页面生成工具，用于将.md格式的文档源文件转换为浏览器可以渲染的.html文件。 Github Pages托管.html文章，可以通过username.github.io访问博客。 Cloudflare用于提供反向代理，完成自定义域名到username.github.io的映射，从而隐藏github io域名。此外也提供免费的HTTPS证书和HTTP重定向服务，保证安全访问。 准备 准备2个Github空仓库，一个设置为Public，一个设置为Private。其中公开的仓库用于存储静态页面，私有仓库用于存储外部不可见的源文件。公开的仓库命名必须为username.github.io，其中username是你的Github用户名。 这一条不是必须的。如果你想自定义域名，可以去域名商平台挑选购买自己喜欢的域名，作者本人是在Spaceship选购的域名，年费不超过10元，很便宜。 下载并安装Hugo，可以参考Hugo官方的安装教程。 搭建步骤 1. 创建新的Hugo站点 # --format yaml指定hugo的配置文件格式为yaml hugo new site /Path/to/hugo-project --format yaml # 初始化hugo项目仓库 cd /Path/to/hugo-project git init 2. 安装主题 # 安装PaperMod主题，你可以替换为自己喜欢的hugo主题 git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod git submodule update --init --recursive # needed when you reclone your repo (submodules may not get cloned automatically) 3. 编辑配置文件hugo.yaml 点击展开 ▼ baseURL: https://username.github.io/ languageCode: en-us title: My Blog theme: PaperMod # 基础设置 enableGitInfo: false enableEmoji: true # 支持 emoji 显示 paginate: 10 # 一页显示10篇文章 # params底下的应该是PaperMod的设置 params: homeInfoParams: Title: "👋 Welcome to My Blog" Content: "Hi, this is my blog." socialIcons: - name: "rss" url: "/index.xml" - name: "email" url: "[email protected]" - name: "github" url: "https://github.com/username" label: text: "User's Blog" icon: /favicon.ico # 导航栏显示的图标 iconHeight: 35 # 控制导航栏图标大小 assets: disableHLJS: true favicon: "/favicon.ico" favicon16x16: "/favicon-16x16.png" favicon32x32: "/favicon-32x32.png" # apple_touch_icon: "/apple-touch-icon.png" # android_chrome_192: "/android-chrome-192x192.png" # android_chrome_512: "/android-chrome-512x512.png" env: production defaultTheme: auto disableSpecial1stPost: true ShowRssButtonInSectionTermList: true ShowToc: true # 文章设置 ShowReadingTime: false # 显示阅读时间 ShowPostNavLinks: true ShowBreadCrumbs: true ShowCodeCopyButtons: true ShowWordCount: true # 显示字数统计 ShowAuthor: true # 显示作者 menu: main: - name: Posts url: /posts/ weight: 1 - name: Archive url: /archive/ weight: 2 - name: Search url: /search/ weight: 3 - name: Tags url: /tags/ weight: 4 # 输出设置 outputs: home: - HTML - RSS - JSON # 用于搜索功能 section: - HTML # 文章页面设置 permalinks: posts: /posts/:year-:month-:day-:filename/ # Markdown 渲染设置 markup: goldmark: renderer: unsafe: true 4. 配置Search和Archieve功能 Search功能，创建content/search.md: ...