Hugo is one of the most popular open-source static site. На примере сайта оршанской группы пользователей Linux Николай рассказал о том, как перевести сайт с динамического php-варианта на Hugo, показал некоторые особенности этой системы.

1. Hugo
генератор статичных сайтов
Николай Сасковец
shurph@gmail.com
github.com/shurph
twitter.com/shurph
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

2. staticgen.com
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

3. Hugo
* проект стартовал в 2013 году
активно развивается
** меньше 1мс/1страница
меньше 1с на весь сайт
свежий* и быстрый**
генератор статичных сайтов
написанный на Golang
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

4. Кто использует Hugo
и кто спонсирует
Используют
●
Linode Docs
●
Let's Encrypt
●
1Password Support
Спонсируют
●
Linode
●
Forestry
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

5. Кто разрабатывает Hugo
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

6. Возможности Hugo
●
Шаблоны
●
Компоненты
●
Постраничная
разбивка
●
«Таксономия» (теги)
●
YAML, JSON, TOML
для конфигурации
●
Markdown для
текста
●
«короткие коды»
как расширение
Markdown
(shortcodes)
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

7. Установка
или
просто скачайте бинарник
под вашу платформу
github.com/gohugoio
sudo apt-get install hugo
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

8. Создание нового сайта
hugo new site example2018
cd example2018/
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

9. Создание нового сайта
git init
git submodule add
> https://github.com/budparr/gohugo-theme-ananke.git
> themes/ananke
echo 'theme = "ananke"' >> config.toml
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

10. Генерация сайта
hugo
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

11. Существующий сайт
git clone https://github.com/shurph/orsha-lug-hugo.git
cd orsha-lug-hugo/
git submodule init
git submodule update
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

12. Структура «исходника» сайта.
├── archetypes
│ └── default.md
├── config.yaml
├──────────────────────────── content
├── layouts ├── article
│ └── partials │ └── *
│ └── footer.html └── post
│ └── *
├──────────────────────────── static
│ ├─────────────── archive
└── themes ├── favicon.ico ├── images
└── beautifulhugo ├── forum │ └── *
├─ ... │ └── * └── *
└─ layouts ├── .htaccess
├─ ... ├── images
└─ partials │ └── *
├─ footer.html ├── robots.txt
└─ * ├── sitemap_forum.xml
└── sitemap_index.xml
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

13. <ul class="list-inline text-center footer-links">
{{ range .Site.Data.beautifulhugo.social.social_icons }}
{{- if isset $.Site.Author .id }}
<li><a href="{{ printf .url (index $.Site.Author .id)
}}">{{ .title }}</a></li>
{{- end -}}
{{ end }}
{{ if .RSSLink }}
<a href="{{ .RSSLink }}" title="RSS">RSS</a>
{{ else }}
No RSS, sorry
{{ end }}
</ul>
{{- partial "footer_custom.html" . }}
Пример шаблона
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

14. ---
title: "Начало положено"
date: 2008-07-08T20:36:10+03:00
tags: ["lug", "linux", "orsha"]
categories: ["cat1", "cat2"]
---
Всем привет
===========
**Вот так** мы провели _этот день_:
И немного видео:
{{< youtube d0NxgHQmKdA >}}
Пример markdown-страницы
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

15. Вставка видео с ютуба:
{{< youtube d0NxgHQmKdA >}}
Вставка фотографий из instagram:
{{< instagram BWNjjyYFxVx >}}
Вставка gist из github:
{{< gist spf13 7896402 "img.html" >}}
Подсветка кода:
{{< highlight go >}}
// какой-то код на Go, например:
archetypeFilename := findArchetype(ps, kind, ext)
{{< /highlight >}}
... и многое другое
Что умеют shortcodes
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo

16. # TOML:
baseurl = "https://orsha.linux.by/"
title = "Orsha LUG"
theme = "beautifulhugo"
[[menu.main]]
name = "Форум"
url = "/forum/"
weight = -1
[[menu.main]]
name = "Статьи"
url = "/article/"
weight = 2
Конфигурационный файл
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo
# YAML:
baseURL: "https://orsha.linux.by/"
title: "Orsha LUG"
theme: "beautifulhugo"
metaDataFormat: "yaml"
menu:
main:
- Name: "Форум"
Weight: -1
URL: "/forum/"
- Name: "Статьи"
Weight: 2
URL: "/article/"

17. Ссылки
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo
- Сайт Orsha LUG
https://orsha.linux.by/
- Исходники сайта
https://github.com/shurph/orsha-lug-hugo
- Документация Hugo
http://gohugo.io/getting-started/
- Темы оформления для Hugo
https://themes.gohugo.io/

18. Hugo
генератор статичных сайтов
2018-03-31, Линуксовка MLUG, Николай Сасковец <shurph@gmail.com>, github.com/shurph/orsha-lug-hugo
Николай Сасковец
shurph@gmail.com
github.com/shurph
twitter.com/shurph
FIN!