Romych в 09:53, 9 лютого 2020

2020-02-09T09:53:55Z

Нова сторінка

←[[Hugo]]

Особенности и дополнительные возможности нашего форка https://github.com/zinadesign/hugo

Инструкция по установке: https://bitbucket.org/zinadz/zina.design/wiki/Home

== Что еще сделать ==

Убирать лишние тэги <nowiki><p></nowiki> вокруг <code>.Summary</code>: [https://github.com/spf13/hugo/issues/1217 Summaries generated with explicit <nowiki></nowiki> tag are wrapped in extra <nowiki><p></nowiki> tag · Issue #1217 · spf13/hugo]

== Установка zina-hugo ==

Сначала установить последнюю версию golang из исходников:

<source lang="bash">
cd /opt && \
sudo wget https://storage.googleapis.com/golang/go1.7.4.linux-amd64.tar.gz && \
sudo tar -xf go1.7.4.linux-amd64.tar.gz && \
sudo rm go1.7.4.linux-amd64.tar.gz && \
cd go && \
sudo mkdir /opt/go_work && \
sudo chmod -R 777 /opt/go_work && \
sudo sh -c 'printf "export GOROOT=/opt/go\nexport GOPATH=/opt/go_work\nexport PATH=\$PATH:/opt/go/bin:/opt/go_work/bin" > /etc/profile.d/go.sh' && \
source /etc/profile
</source>

Установка форка zina-hugo:

<source lang="bash">
go get -v github.com/zinadesign/hugo && \
go get -u -v github.com/kardianos/govendor && \
cd $GOPATH/src/github.com/zinadesign/hugo && \
govendor sync && \
go install
</source>

Обновление установленного z-hugo:

<source lang="bash">
go get -u -v github.com/zinadesign/hugo
</source>

Для деплоя в облако Google:

<source lang="bash">
sudo apt-get install gcc python-dev python-setuptools python-virtualenv
virtualenv venv
venv/bin/pip install -r deploy_requirements.txt
</source>

sudo apt-get install gcc python-dev python-setuptools
sudo easy_install -U pip
sudo pip uninstall crcmod
sudo pip install -U crcmod

== Таксономия с иерархией ==

[https://bitbucket.org/zinadz/zina.design/issues/14/---------------------- #14]

Иерархия задается в <code>config.yaml</code>:

<source lang="yaml">
Params:
terms_hierarchy:
site:
shop:
corporate-site:
promo-site:
small-site:
personal-site:
identity:
logo:
brand-book:
</source>

Вывод в шаблоне <code>layouts/taxonomy/category.terms.html</code>:

<source lang="go">
{{ .TaxonomyTerms .Data.Plural "weight" }}
</source>

или в шаблонах <code>layouts/partials/</code>:

<source lang="go">
{{ .TaxonomyTerms "types" "weight" }}
</source>

Сортировка терминов таксономии:

<source lang="go">
{{ .TaxonomyTerms "types" "weight" }}
{{ .TaxonomyTerms "types" "title" }}
{{ .TaxonomyTerms "types" "date" }}
</source>

По умолчанию никак не сортирует. Способ сортировки передается вторым параметром.

* weight — если не задан, то 0
* title — если не задан, то название термина

<div class="note">
Предыдущий код:

<source lang="go">
{{ $category_pages := dict }}
{{ range $.Site.AllPages }}
{{ add_to_map $category_pages .URL .Title }}
{{ end }}
<ul>
{{ range $cat, $tax := .Site.Taxonomies.categories }}
{{ $page_url := print "/categories/" ($cat | urlize) "/" }}
{{ $page_title := index $category_pages $page_url | default (replace $cat "-" " " | title) }}
<li><a class="cat-line title" href="{{ $page_url }}">{{ $page_title }}</a></li>
{{ end }}
</ul>
</source>
</div>

== Breadcrumbs ==

[https://bitbucket.org/zinadz/zina.design/issues/10/breadcrumbs #10]

Шаблон: <code>layouts/partials/breadcrumbs.html</code>

<source lang="go">
<div class="breadcrumbs">
{{ $breadcrumbs := .Breadcrumbs }}
{{ range $breadcrumb := $breadcrumbs }}
<span class="breadcrumbs__el">
<a href="{{ $breadcrumb.URL }}">{{ $breadcrumb.Title }}</a>
<span class="breadcrumbs__terminator">→</span>
</span>
{{ end }}
</div>
</source>

== add_to_map — функция для добавления элементов в словарь ==

Добавлена функция <code>add_to_map</code> — позволяет добавлять новые элементы в словарь.

Пример использования. Сохраняем все страницы в словарь затем достаем оттуда title по url:

<source lang="go">
{{ $category_pages := dict }}
{{ range $.Site.AllPages }}
{{ add_to_map $category_pages .URL .Title }}
{{ end }}
{{ range $key, $value := .Data.Terms.ByCount }}
{{ $page_url := print "/" $data.Plural "/" ($value.Name | urlize) "/" }}
{{ $page_title := index $category_pages $page_url | default (replace $value.Name "-" " " | title) }}
<li><a href="{{ $page_url }}">{{ $page_title }}</a> <span class="silver">({{ $value.Count }})</span></li>
{{ end }}
</source>

== findPageByUrl — функция для получения страницы по url ==

Добавлена функция для получения страницы по url:

<source lang="go">
{{ $page := .Site.Pages.findPageByUrl "/test/" }}
</source>

== titlePage — перебор переменных и вывод с ограничением длины ==

<source lang="go">
{{ titlePage 60 .Params.title_title .Params.title_h1 .Title .Site.Title }}
</source>

Функция <code>titlePage</code> по очереди проверит перечисленные переменные (<code>.Params.title_title</code>, <code>.Params.title_h1</code>, <code>.Title</code>, <code>.Site.Title</code>), возьмет первую, имеющую значение, обрежет до длины 60 символов и добавит в конце троеточие.

== truncatechars — обрезка строки ==

<source lang="go">
{{ truncatechars 60 .Title }}
</source>

Функция <code>truncatechars</code> в этом примере примет значение переменной <code>.Title</code>, обрежет до 60 символов и выведет ее.

== Баг с сортировкой при weight=0 ==

Исправлен: [https://bitbucket.org/zinadz/zina.design/issues/15/weight-0 #15]

[[Категория:Hugo]]

Hugo-on-Steroids - Історія редагувань

Romych в 09:53, 9 лютого 2020