从0到1 记录搭建Hugo个人博客-03 使用Algolia搜索

Hugo添加Algolia搜索支持 本文主要介绍如何在Hugo上增加Algolia的搜索支持,Alogolia官网 添加Algolia搜索支持主要以下步骤: ###1. 进入 Algolia 官网注册创建环境 个人使用选择免费版即可,可以满足日常需求了 地区若是国内则建议选择Hong Kong ,延迟较小效果比较好 最后提交即可 ###2. 创建Application和Index 名称可自定义,我为了方便区别,创建都习惯用直接的域名作为名称 https://www.algolia.com/account/api-keys/all?applicationId=你的applicationId ###3. Hugo配置Algolia的环境 修改 config.toml 文件声明需要生成Algolia索引文件以及相关信息 [outputs] home = [“HTML”, “RSS”, “Algolia”] …中间省略 [outputFormats.Algolia] baseName = “algolia” isPlainText = true mediaType = “application/json” notAlternative = true [params.algolia] appId = “你的Application ID” indexName = “你的索引名字” searchOnlyKey = “你的Search-Only API Key” 注意outputs下面home的末尾有"Algolia",漏了就不会生成了。 appId, indexName, searchOnlyKey 填写刚才记录的Algolia信息。 根目录下 layouts/_default (没有就新建) 文件夹中新建 list.algolia.json 文件,内容如下: {{/* 生成Algolia搜索索引文件 /}} {{- $.Scratch.Add “index” slice -}}...

八月 15, 2022 · 2 分钟 · Ken

从0到1 记录搭建Hugo个人博客-01 搭建环境

使用HUGO搭建一个自己的博客Blog 对于常在敲代码的程序员来说,有个博客能记录和分享是一个相当有意义的事情, Hugo 是一个高效的网站搭建框架,能用简单的markdown语法编辑生成出富有个性的网页,即使是刚学的小白也能很简单的入门使用 说明:Markdown是一种轻量级标记语言,它允许人们使用易读易写的纯文本格式编写文档,同时也对图片、图表、数学公式提供了支持,可以用来书写电子书、软件文档等,同时也可以非常方便的转换为HTML页面或者是PDF文档。 step 1:安装环境 首先选择适合自己操作系统的环境https://github.com/gohugoio/hugo/releases/tag/v0.101.0 ,如我在window上使用就下载了 hugo_extended_0.101.0_Windows-64bit.zip step 2:创建一个新站点 hugo new site quickstart -f yml step 3:添加主题 根据自己的兴趣或者网站的用途,可以选择合适的博客主题,避免了例如我这种设计能力不足的程序员,只需简单的二次修饰即可上线 https://themes.gohugo.io/ cd quickstart git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke step 4:添加内容 辅助命令 hugo new posts/my-first-post.md 当然也可以自己手工创建在content目录下,如该页面就是在person/_index.md,文件格式如下: --- title: "个人介绍" date: 2022-06-19T08:47:11+08:00 --- step 4:开始启动 如果在本地测试环境下想随时编辑查看,可使用 hugo server 此时打开http://localhost:1313就可以看到效果了 而需要上线编译的时候则可以简单的 hugo step 5:完成 最后把编译后的文件部署到你的服务器或者其他地方,搭配域名等就大功告成了

八月 11, 2022 · 1 分钟 · Ken