Введение

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

И следуя этому совету частично набросал структуру курса. Я решил, что личные базы знаний нужно преподавать эволюционно, чтобы было понятно, что и откуда вытекает. А не так сразу делайте вот так, а почему именно так непонятно.

1. Файлы (*).
2. Текст (txt).
3. Гипертекст (hypertext markup language).
4. Zim (wiki markup).
5. Obsidian (markdown).

Markdown это видимо игра английских слов, в противовес markup. Ведь технически markdown это именно markup, а не markdown.

Файлы

В начале можно было рассказать как упорядочивать файлы в файловой системе.
1.1. Свалка.
1.2. Имена.
1.3. Списки.
И возможно кое-что ещё.

Свалка это по сути файлопомойка, когда файлы и папки лежат в одном месте.

В именах используются символы разделителей.
1. Пробел " ".
2. Подчёркивание "_".
3. Дефис "-".
4. Пустота "".

1. Для программирования.
а. Оптимально использовать символ подчёркивания или пустоту.
б. В случае с пробелом некоторые компиляторы могут не сработать.
в. А дефис говорят тот же Excel воспринимает не как дефис, а как минус, со всеми вытекающими.

2. Для создания сайтов.
Есть рекомендация google по созданию структуры url.
а. "Рекомендуется использовать в URL дефисы."
б. "Не рекомендуется использовать для разделения символ подчеркивания."
в. "Не рекомендуется объединять слова в URL".

Общего у них только рекомендация.
а. "Не рекомендуется использовать в URL символы, не относящиеся к кодировке ASCI".
б. Я бы лучше сказал не символы алфавита.

Но это же не универсально для других случаев. На диске вполне могут быть папки и файлы с русскими символами для русскоязычной аудитории. Они, кстати, по длине могут занимать больше, чем обычные символы, есть зависимость от файловой системы.

Ситуация становится хуже, когда люди начинают использовать прочие символы, вроде различных знаков.
1. Тогда можно получить сразу прямой отказ создавать такое имя в файловой системе.
2. Или произойдёт авария при переносе таких папок и файлов в другую файловую систему.

Текст

Раздел текст предполагал, что мы живём в славную эпоху цеттелькастен, когда у нас есть цифровые документы, но нет быстрого перехода между ними. Никлас Луман придумал некие бумажные гиперссылки.

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

1. Текстовых ссылок.
2. Номерных ссылок.
3. Гиперссылок (не существуют в txt).

Собственно раздел текст нужен главным образом для того чтобы люди поняли, что не разметкой единой живы личные базы знаний. Даже обычный текст упорядоченный особым образом может быть полезен.

Можно было бы ввести основные понятия, вроде содержимого файлов в кодировке utf8, что явно не относится ни к файловой системе, ни к разметкам. И в принципе объяснить как редактировать текст не важно есть там разметка или нет.

Гипертекст

Следующим этапом предполагалось рассказать как создать личную базу знаний используя гипертекст (html).

У этого способа огромные преимущества.

1. Практически неограниченный размер личной базы знаний. Никакая индексация структурных редакторов не затормозит её развитие.

2. База знаний доступна везде как для просмотра, так и для редактирования, то есть на десктопе, ноутбуке, смартфоне можно её открывать с помощью множества браузеров.

3. Движки браузеров так же тщательно вылизаны, что позволяет открывать огромные документы за доли секунды, чего к сожалению не позволяют другие разметки, и не потому что разметки ущербны, а потому что софт для них ущербен.

4. Гипертекст это самая полная разметка со множеством возможностей, вроде макетирования, вставки видео, стили и многое другое. Ни одна другая разметка не даст такого функционала. При этом текст можно писать вполне себе лаконично.

5. Опять же обычным браузером можно сохранять веб-страниц с изображениями и без, что позволяет сохранять чужой материал в своей личной базе знаний. Для структурных редакторов нужны особые решения вроде плагинов, а тут идеальная бесшовная интеграция (встройка).

Есть ещё интересная тема как хранить файлы документов.

1. Внутри папки с таким же именем (файлы).
name/ (обязательно)
name/name.html
Плюсы.
а. Можно удалить всё содержимое удалив лишь папку.

2. Рядом с папкой с таким же именем (html, zim).
name/ (не обязательно)
name.html
Плюсы.
а. По умолчанию используется в браузере для скачивания страниц и zim.
б. Избавляет от просмотра излишнего или даже мусорного содержимого.
Видно на скачанных страницах того же хабра, где в папке куча ненужных вещей.
в. Папка для страницы может быть и не нужна, что сэкономит на её создании.

Zim

Но в итоге я в очередной раз прихожу к мысли, а зачем мне Zim, если гипертекст лучше. Это как в сказке, всё в html не то и не это, пока её не прорекламируешь явно выявив преимущества.

— А много ль корова даёт молока?
— Не выдоишь за день — устанет рука.
Старик посмотрел на корову свою:
— Зачем я, Бурёнка, тебя продаю?
— Корову свою не продам никому.
— Такая скотина нужна самому!

В чём заключается проблема структурных редакторов и прочего софта. Дело в том, что по мере роста данных они очень быстро начинают тормозить и приходить в негодность.

1. Структурные редакторы основанные на базах данных тормозят из-за того, что не умеют оптимально работать с базами данных.
2. Структурные редакторы основанные на файлах тормозят из-за индексации.

Хоть Zim и основан на файлах, но индексацию он всё же проводит. Более того, даже древовидная структура папок и файлов зависит от индексации, что в конечном итоге очень и очень плохо сказывается на производительности и адекватности отображения элементов.

Obsidian

Меня здесь на форуме спрашивали как-то про Obsidian. Я тогда ничего не мог ответить, но в Zim есть возможность массово преобразовать его wiki разметку в markdown.

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

Разница в том, что у Zim есть отдельный запуск индексации и так же он это делает по мере работы. А Obsidian всё это делает при запуске программы.

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

И кто-то скажет, а у меня работает. Правильно, потому что ваша личная база знаний пока слишком маленькая. И дело не просто в том, что Zim или Obsidian плохие, просто я пробовал некоторые другие структурные редакторы, и там точка отказа наступает ещё быстрее.

Индексация

Дочитав до этого момента кто-то может подумать, что статья была о курсе по созданию личной базы знаний, но на самом деле речь только про индексацию. Индексация в структурных редакторах заставляет задуматься над использованием чистого html написанного вручную.

Его можно редактировать чем угодно.
1. Текстовым редактором (Notepad++, Kate).
2. Специализированным редактором (Adobe DreamWeaver).
3. Браузером (Chrome, Firefox).

Главное здесь в том, что никакой индексации гарантированно не будет, что позволит вырасти личной базе знаний больше, чем несколько тысяч файлов без угрозы производительности.

Файлов может быть сколько угодно, десятки тысяч, сотни тысяч, миллионы, десятки миллионов, сотни миллионов. Может даже миллиарды, если вам хватит места на диске. Просто не стоит недооценивать объём занимаемых данных, даже если это просто текст без видео и даже изображений.

А то, что нужно менять ссылки при изменении пути не так страшно, как и ручная замена содержимого по шаблону. В конце концов это управляемый процесс, а вот длительная индексация или её сбой довольно неприятны.

Заключение

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

Следующим этапом попробую преобразовать личную базу знаний в html, может быть даже в ручном режиме. Хотя в тот же Obsidian она преобразовалось довольно хорошо в файлы *.md, но там и требования к разметке были ниже.

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

@echo off
cls
echo ----- CREATE FOLDERS -----
set dir=d:/git/folder
cd /D "%dir%"
for /l %%i in (0,1,99999) do md %%i

<!DOCTYPE html>
<html lang="ru">
<head>
  <meta charset="UTF-8">
  <link rel="stylesheet" href="style.css">
  <title>test</title>
</head>
<body>

<header>
  <nav>
    <a href="../../pkb.html">личная база знаний</a> /
    <a href="../concepts.html">понятие</a> /
    <a href="test.html">тест</a>
  </nav>
</header>

<main>
  <h1>Основная статья</h1>

  Добро пожаловать в создание документации.

  <article>
    <h2>Мой день на пляже</h2>

    <p>Сегодня на пляже я получил много удовольствия.</p>

    <iframe src="https://www.youtube.com/embed/uQotvEi4-Zw"></iframe>
  </article>

  <article>
    <h2>Записи игрока</h2>

    <p>Здорово было бы играть каждый день в HOTS.</p>

    <iframe src="https://www.youtube.com/embed/9y8ernq88-s"></iframe>
  </article>
</main>

<footer>
  &nbsp;
</footer>

</body>
</html>

body {
  color: White;
  background: Black;
}

a {
  color: DeepSkyBlue;
}