hugo-book优化

hugo-book优化

技巧

hugo环境搭建 #

  • 安装homebrew
    • 首先设置网络环境,复制终端代理命令到终端
    • 然后复制官网的指令到终端
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    
  • 安装hugo
    brew install hugo
    
  • 安装hugo-book主题
    hugo new site book
    cd book
    
    • 官网下载最新hugo-book主题
    • 复制主题文件夹到book/themes文件夹下
    cp -R themes/hugo-book/exampleSite/content.en/* ./content
    
    • 编辑hugo.toml里面添加theme = ‘hugo-book’
  • 一般指令
    hugo
    hugo server
    hugo version
    

hugo-book主题修改 #

  • 文件_main.scss中添加下列代码(位于themes/book/assets中)
.book-menu>nav{
  box-shadow: gray 1px 1px 3px;
}
  • 添加bilibili.html(文件位于themes/hugo-book/layouts/shortcodes内)
  • 添加audio.html(文件位于themes/hugo-book/layouts/shortcodes内)
  • 添加music.html(文件位于themes/hugo-book/layouts/shortcodes内)
  • 添加html.html(文件位于themes/hugo-book/layouts/shortcodes内)
  • 添加hide.html(文件位于themes/hugo-book/layouts/shortcodes内)

hugo-book中英文搜索 #

  • 复制zh.yaml文件里面的内容到en.yaml中
  • 修改themes/hugo-book/i18n/zh.yaml配置文件,主要看id: bookSearchConfig这项配置,文件具体内容如下:
id: bookSearchConfig
translation: |
  {
    encode: false,
    tokenize: function(str) {
        return str.replace(/[\x00-\x7F]/g, '').split('');
    }
  }
  • 参考https://github.com/alex-shpak/hugo-book/issues/357 中韩国大佬 yeonns 的做法,尝试了下解决了我的问题。
  • 将id: bookSearchConfig 内容修改如下即可:
id: bookSearchConfig
translation: |
  {
    split: " "
  }