How to Use
Заголовок страницы
У страницы заголовок должен состоять только из альфанумерических символов, чтоб система правильно переводила урл в путь. Ни точек, ни запятых, ни кавычек, ни других специальных символов быть не должно. Иначе система не сможет найти файл.
Метаданные страницы
Это такой блок деклараций, который ставится на страницу на самый-самый верх
---
title: Сказка о золотой рыбке
author: Александр Пушкин
date: 1833-10-02
tags: ["старуха", "корыто", "изба"]
---
Нас интересуют только date
и tags
, остальные система игнорирует.
Датировка страниц
Система сортирует посты по дате последней модификации файла, а по дате создания файла сортировать не умеет. На Линуксе такая информация в метаданных не хранится. Потому автоматическая сортировка страниц по дате не представляется возможным, хотя это очень полезная функция и нужная для блога, например. Потому дату написания поста надо вставлять вручную в блок деклараций в формате YYYY-MM-DD
data: 2021-10-11
Я приделал кнопки и для сортировки по дате публикации и времени последней модификации файла. Они просто добавляет/удаляют параметр для УРЛ /public/snips.php?sort=by_date
. Если нажать, то появятся все датированные страницы, отсортированные по времени в обратном порядке
Таги
Таги вставляются в блок деклараций страницы таким образом
tags: ["таг1", "таг2", "таг3", "и так далее"]
Я б ставил таги не какие попало, а по теме для дополнительной навигации и поиска топиков. Я все еще думаю, сделать ли отдельную кнопку для топиков или одних тагов будет достатоно.
Фото-галерея
В фото-галерею картинки вставляются обычным образом кнопкой Insert image
, а потом обрамляются хтмл коммент тагами <!-- ... -->
, чтоб получилось как-то так
<!-- Веселые картинки -->
<!--
![Путин](media/putin-65843089675.jpeg)
![Фото 1](media/foto1-111564934613.jpeg)
![Фото 2](media/foto1-92102326656.jpeg)
![Фото 3](media/foto3-167125531582.jpeg)
-->
и получается галерея с лайтбоксом. Лучше код располагать в одну строчку, чтоб потом sed, который читает текст построчно для заглавных отрывков, его не разъединил. Sed читает 15 строчек от начала, или сколько поставишь в файле snips.php.
Веселые картинки - это наименование галереи. В папке media
надо сделать папку galleries
, а в ней еще одну папку Веселые картинки
, куда все свои фото из данного альбома и надо поместить. Дело в том, что такие фото в QOwnNotes, если их оставить в папке media
, отображаются как orphaned, то есть ни с чем не связанные, а поскольку их много, то реально сиротливых файлов среди этой массы и не заметишь. Проверить галерею можно командой
find ./Public -name "*.md" -exec grep "Веселые картинки" {} \;
Если ничего не будет найдено, то вся галерея осиротелая, и ее можно безболезненно стереть.
Картинки с удаленного сервера не отображаются. Оно так лучше. Если хотите показать картинку с интернета, ее сначала надо скачать, а потом вставить в QOwnNotes кнопкой Insert image
.
Поддерживается до 5 галерей на одной странице. Если хочешь больше, то добавь классов в файле gallery.css
.