Awesome Hugo - 有用なリンクまとめ

![hugo-logo.jpg](https://qiita-image-store.s3.amazonaws.com/0/285675/ac7c874f-b1a3-d6a0-517e-b3ec7e29da62.jpeg)



## Awesome Hugo

Go 言語製の静的サイトジェネレーター Hugo も Awesome リポジトリがあります。

- [budparr/awesome-hugo: A curated list of awesome things related to Hugo, The world's fastest framework for building websites.](https://github.com/budparr/awesome-hugo)

この記事では上記リポジトリからいくつかをピックアップして紹介します。



## Hugo 公式サイトへのリンク

- [Hugo - GitHub](https://github.com/gohugoio/hugo)
- [GoHugoIO - Twitter](https://twitter.com/GoHugoIO)
- [Hugo 公式サイト - gohugo.io](https://gohugo.io/) 
    - [Hugo ニュース](https://gohugo.io/news/) 
    - [Hugo ドキュメント](https://gohugo.io/documentation/) 
    - [Hugo Themes](https://themes.gohugo.io/) 
- [Hugo Discussion Forum - Discourse](https://discourse.gohugo.io/) 
- [Gitter Channel (for Hugo development discussion only)](https://gitter.im/spf13/hugo) 

Hugo Discussion Forum は [日本語トピック - Hugo Discussion](https://discourse.gohugo.io/c/japanese) もあり、日本語で Hugo について質問ができます。

Twitter では Hugo のリリースや新しい Hugo theme などの紹介がツイートされます。



## Hugo 関連ツール

### Node wrapper

- [Hugo CLI](https://www.npmjs.com/package/hugo-cli)
- [hugo-bin: Binary wrapper for Hugo](https://github.com/fenneclab/hugo-bin)

Hugo の Node ラッパーです。Node 系のツールと一緒に Hugo を管理できます。hugo-bin の方をオススメします。

### Visual Studio Code 拡張機能

- [Hugo Helper for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=rusnasonov.vscode-hugo) 

Hugo の VS Code 拡張機能です。VS Code のコマンドパレットから Hugo のコマンドを実行できるようになります。

- [Hugo Language and Syntax Support for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=budparr.language-hugo-vscode)

Hugo の VS Code 拡張機能です。`range`, `if`, `with` など Hugo テンプレートの補完とシンタックスハイライトをサポートしています。



## スターターキット

### Docker

- [Hugo を Docker 上で動作させる - Qiita](https://qiita.com/peaceiris/items/14d1a0f17dd25911e33b)

CircleCI や GitLab CI/CD で Hugo を実行したい時に使えます。

### npm

- [Victor Hugo (starter repo for using Webpack)](https://github.com/netlify/victor-hugo)
- [Hugo Webpack Boilerplate](https://github.com/vseventer/hugo-webpack-boilerplate)
- [Hugo + Gulp starter project](https://github.com/jbrodriguez/hugulp)
- [Hugo Starter with Gulp Asset Pipeline, SVG Icons, partials for global components, metadata, and social.](https://github.com/rdwatters/hugo-starter)

Webpack や Gulp で管理する Hugo プロジェクトのボイラープレートです。Hugo が SASS/SCSS のトランスコンパイルや HTML, CSS, JavaScript の圧縮(Minify)・バンドルができなかった頃は有用でしたが、これらは最新版 Hugo の標準機能で可能なことばかりなので、これから Hugo theme を作る場合は参考にする必要はありません。

### Hugo boilerplate for Netlify

- [Atlas: Hugo boilerplate](https://github.com/indigotree/atlas)

Netlify でサイトをホスティングする時に必要な設定が施されているボイラープレートです。設定方法の参考になるでしょう。

### GitHub Actions for Hugo

- [peaceiris/actions-gh-pages: GitHub Actions for deploying to GitHub Pages with Static Site Generators](https://github.com/peaceiris/actions-gh-pages)
- [peaceiris/actions-hugo: GitHub Actions for Hugo extended](https://github.com/peaceiris/actions-hugo)

`peaceiris/actions-hugo` でビルドをして `peaceiris/actions-gh-pages` で GitHub Pages へのデプロイをする CI/CD を GitHub Actions で実現できます。



## Hugo 採用事例

### Let's Encrypt

- [Let's Encrypt](https://letsencrypt.org/)
- [Let's Encrypt - GitHub](https://github.com/letsencrypt/website)

Let's Encrypt 公式サイトは Hugo で管理されています。

![lets_encrypt.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/285675/d27c7068-5ccc-da6e-8bc4-3bc9bf7233a6.jpeg)

### Netlify

- [Netlify](https://www.netlify.com/)

Netlify 公式サイトも Hugo で管理されています。Netlify と Hugo はお互いを公式サポートしており、Hugo ドキュメントは Netlify でホスティングされています。

![netlify.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/285675/84ccd975-2cc7-c1e1-390c-0f798b56fb5e.jpeg)

### Forestry

- [Forestry.io](https://forestry.io/)
- [Forestry.io - GitHub](https://github.com/forestryio/forestry.io)

Forestry 公式サイトも Hugo で管理されています。

![forestry.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/285675/b572e491-5c3b-1df6-f49b-801fddbb04ed.jpeg)

### 1Password

- [1Password](https://1password.com)

1Password 公式サイトも Hugo で管理されています。

![1password.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/285675/27405129-0b7a-6e98-1611-4b78cceb1727.jpeg)

### 日本の組織

- [補助人工心臓治療関連学会協議会](http://j-vad.jp) 
- [補助人工心臓治療関連学会協議会 インペラ部会](https://j-pvad.jp/)

Hugo を使ってサイトを構築している日本の組織の例です。

### Kubernetes

- [Kubernetes](https://kubernetes.io/)
- [Kubernetes - GitHub](https://github.com/kubernetes/website)

Kubernetes 公式サイトも Hugo で管理されています。Hugo による多言語対応の良い参考例になるでしょう。

![kubernetes.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/285675/58f24ec4-e979-8036-b1e9-dff3837fd85b.jpeg)

### Bootstrap

- [Bootstrap](https://getbootstrap.com/)
- [Bootstrap - GitHub](https://github.com/twbs/bootstrap)

最近では Bootstrap の公式サイトが Jekyll から Hugo に乗り換えています。

![bootstrap.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/285675/0c9fa91b-b03a-047c-0551-461dacb1ef30.jpeg)



## Hugo 日本語ドキュメント

最後にお知らせです。

**Hugo ドキュメントの和訳・日本語訳プロジェクト** では翻訳に協力してくださる方を募集中です。

ご興味あれば、下記リンク先の詳細をご覧ください。

- [hugojapan/hugojapan.github.io: 🇯🇵 Hugo Documentation 和訳・日本語訳プロジェクト](https://github.com/hugojapan/hugojapan.github.io)