Реализация «Rich CSS Tooltip» в Hugo

Разработка
19 февраля 2022 г.

Мигрировал блог с Pelican на Hugo, в надежде, что теперь писать посты буду чаще. В надежде!

В процессе миграции не удержался, и прикрутил всплывающие CSS подсказки ПримерТекст может содержать теги со стилями. И даже изображения:
с HTML содержимым. Опять же, в надежде, что они мне пригодятся. Но удовольствие от процесса я уже получил, поэтому опишу как я это сделал.

html-hint

Всё просто, я импортировал библиотеку html-hint в свой scss сборник. Примерно вот таким вот способом (строка 1):

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
@import "../../node_modules/html-hint/dist/html-hint";

.hint--html {
    display: inline;
}

.hint__content {
    display: table;

    padding: 1rem;
    min-width: 30vw;
    left: unset !important;
    right: 50%;
    margin-left: 0;
    margin-right: 0;

    color: var(--foreground-color);
    background: var(--background-color);

    border: 1px solid var(--foreground-color);

    font-size: 1em;

    & .hint--title {
        display: block;

        margin-bottom: .4em;

        font-weight: bold;
        font-size: 1.1em;
    }
}

@media screen and (max-width: 600px) {
    .hint__content {
        min-width: 80vw;
        left: unset !important;
        right: unset;
        transform: unset !important;
    }
}

.hint--element {
    display: inline;

    text-decoration: underline dotted var(--dim-color);
    font-style: italic;

    cursor: pointer;
}

Затем немного подправил отображение подсказки (3-50).

В репозитории не было собранных минифицированных файлов, поэтому пришлось подключить к сборке сайта nodejs. Перед сборкой нужно запустить:

> npm install --save html-hint

Hugo shortcode

Создаём новый файл layouts/shortcodes/tooltip.html, который будет содержать разметку для наших подсказок:

<span class="hint--html hint--bottom">
    <span class="hint__element">{{- .Get "element" | safeHTML }}</span>
    <span class="hint__content">
        {{ with .Get "title" }}<span class="hint__title">{{- . -}}</span>{{ end }}
        {{- .Inner | safeHTML -}}
    </span>
</span>{{- "" -}}

Вставка подсказки в текст публикаций

Вставляем нашу подсказку в публикацию с помощью следующей конструкции:

{{< tooltip element="элемент с подсказкой" title="Заголовок в подсказке" >}}
Текст <b>в подсказке</b> с использованием <i style="color:red">HTML тегов</i>.
{{< /tooltip >}}

Результат:

элемент с подсказкой Заголовок в подсказке Текст в подсказке с использованием HTML тегов.

При наведении отобразится подсказка с HTML содержимым.

Реализация «Rich CSS Tooltip» в Hugo

html-hint

Hugo shortcode

Вставка подсказки в текст публикаций

Цикл: Блог на Hugo