↓
豆逗子的小黑屋
  1. 文章/

博客搭建简述

·3 分钟
编程
Weaxs
作者
Weaxs

hugo搭建 #

  具体文件详见 HUGO安装文档，下面主要解释一下docker部署的方式。

docker镜像地址：https://hub.docker.com/r/klakegg/hugo
github地址：https://github.com/klakegg/docker-hugo

  lakegg/hugo镜像有基于 Busybox、 Alpine、 Debian 和 Ubuntu4个系统.其中每个系统又分为normal、ext、onbuild、ci、ext-ci、ext-onbuild 6种，Busybox没有ext相关，下面简要介绍一下几种的区别

  • normal：只有基础的hugo命令。默认Entrypoint是hugo，所以common只需要写server，即可执行hogu server
  • ext：拓展版，在normal基础上添加了go、git、nodejs等拓展工具 (推荐)
  • ci: 主要用于持续集成/部署。在normal基础上，新增了环境变量HUGO_ENV，去掉了默认Entrypoint，需要自行添加容器运行命令
  • onbuild: 此版本主要用于编译构建并可以分开源码和产出。默认源码文件夹是/src，产出文件夹是.target，可以通过HUGO_DIR和HUGO_DESTINATION_ARG进行自定义设置。

docker镜像版本如下：

busyboxAlpineAlpine with AsciidoctorAlpine with PandocDebianUbuntu
normallatest
busybox		alpineasciidoctorpandocdebianubuntu
ext-ext-alpineext-asciidoctorext-pandocext-debianext-ubuntu
cici
busybox-ci		alpine-ciasciidoctor-cipandoc-cidebian-ciubuntu-ci
onbuildonbuild
busybox-onbuild		alpine-onbuildasciidoctor-onbuildext-pandoc-onbuilddebian-onbuildubuntu-onbuild
ext-ci-ext-alpine-ciext-asciidoctor-ciext-pandoc-ciext-debian-ciext-ubuntu-ci
ext-onbuild-ext-alpine-onbuildext-asciidoctor-onbuildext-pandoc-onbuildext-debian-onbuildext-ubuntu-onbuild

hugo模板可以参考 https://themes.gohugo.io/

Blowfish模板使用 #

  Hugo的主题主要是用了blowfish，下面主要对blowfish的使用展开简要说明

Hugo theme - blowfish
blowfish github地址

  blowfish的github主要介绍了使用git submodules和Hugo的部署方式，这里主要介绍一下如何使用上面介绍的hugo docker镜像进行部署

  1. go.mod中添加blowfish
require github.com/nunocoracao/blowfish/v2 version // indirect
  1. config/_default/module.toml文件添加：
[[imports]]
path = "github.com/nunocoracao/blowfish/v2"
  1. 将根目录引用到镜像内的/src目录下，启动docker即可

自定义浏览器角标 #

  在 favicon.io讲自己的图片生成为各种尺寸的icon，直接解压在favicon.io下载好的icon压缩包，并放在/static目录下即可

自定义ICON #

  将自定义的svg文件放在/asserts/icons目录下，为了使ICON和主题自适应，需要在svg文件中添加属性 fill=“currentColor” 如下：

<svg>
    <<path fill="currentColor" d="xxx"/>
</svg>

blowfish文档 #

  使用blowfish搭建博客，具体参考 文档