Введение

Запущенный в прошлом году Хаб Злонова со временем стал моим основным онлайн-ресурсом для хранения базы нормативно-правовых актов (НПА) Российской Федерации по информационной безопасности.

Выбранный для Хаба движок сайта (генератор статических сайтов Quartz 4 ) создаёт его из хранилища Obsidian - приложения для ведения персональной базы знаний и создания заметок в формате markdown-файлов.

Само же хранилище (в английской терминологии Obsidian - vault) со всеми добавленными НПА доступно в открытом доступе в виде репозитория на отечественной платформе для хранения исходного кода GitFlic: https://gitflic.ru/project/zlonov/laws

Думаю, для имеющих нужный опыт пользователей дальнейшие пояснения не требуются, а для удобства остальных приведу краткую инструкцию.

Пошаговая инструкция

1. Установить приложение GitHub Desktop для работы с git-репозиториями в графическом интерфейсе: https://desktop.github.com/download/ либо можно пользоваться командной строкой .
2. Установить приложение Obsidian: https://obsidian.md/download
3. С помощью GitHub Desktop (либо командой git clone https://gitflic.ru/project/zlonov/laws.git) клонировать локально репозиторий: https://gitflic.ru/project/zlonov/laws.git . Размер репозитория ~730 МБ.
4. Открыть локально клонированную папку с репозиторием в Obsidian как новое хранилище.

Скриншоты

Итоговый результат

Хранилище в виде графа на текущий момент выглядит примерно вот так:

Все НПА разбиты по типам (папкам) - Федеральные законы, Постановления Правительства РФ и так далее. Папка reviews содержит обзоры законодательства от Аналитического центра УЦСБ (очень далеко не все, конечно, только некоторые недавние), а в collections собраны подборки (коллекции) по отдельным темам (тегам).

Карточка каждого НПА содержит его полное наименование, тематические теги, соответствующие ссылки, при наличии - изменяемые или изменяющие документы, а также - обзоры, встроенные тексты документов в формате PDF для быстрого просмотра и другую информацию.

Дополнительно

• Для удобства работы некоторые присутствующие в хранилище служебные файлы, необходимые для корректной работы сайта, и папка с PDF-файлами скрыты в боковой панели с помощью специально созданного пользовательского CSS-файла hide_some_notes.css. При желании, естественно, это можно отключить.
• Просмотр граф преднастроен в том числе для отображения другим цветом тегов, коллекций и обзоров. Граф, если что, сбрасывается в формат по умолчанию одним кликом.
• Если свойство date у НПА будет отображаться в неправильном формате, измените его тип на корректный.

Скриншот про тип даты

Заключение

База обновляется примерно раз в месяц - как раз, как выходят обзоры законодательства моих коллег из УЦСБ.

Если планируете периодически получать обновления из репозитория, сохраняйте свои изменения/заметки отдельно, чтобы не потерять их.

Несмотря на использование формата максимально совместимого с Obsidian, все карточки НПА создаются отдельным скриптом, который корректно проставляет связи и оформляет их однобразно, так что не получится просто так включить в репозиторий предлагаемые коммиты.

Но возникающие идеи и предложения в любом случае присылайте - если это поможет улучшить/дополнить/усовершенствовать базу, постараюсь реализовать.