Комментарии 34
Небольшое пожелание на будущее, если проект будет развиваться: поднимите демо-сервер, чтобы можно было потыкать не устанавливая себе.
И, учитывайте, что не все современные браузеры её поддерживают в принципе (FF Quantum, к примеру, не поддерживает и для меня это один из аргументов против перехода).
Ну, это уже ровно 100,501-й проект такого рода. :) Почти все из них недописаны и забрасываются автором спустя 1-2 месяца. Если на GitHub посчитать количество проектов типа «блокнот с markdown», то они наверное окажутся в первой десятке.
Можно не только сохранять знания, тегировать контент и расскладывать по категориям, но и тестировать команду на усвоение этих знаний (тесты с рейтингами и геймификацией ^))
Кстати, уже существует вполне себе продвинутый организатор заметок с markdown: Dropbox Paper. Я недавно на него перешел с Zim Wiki. Zim Wiki всем устраивает, кроме того, что не поддерживает синтаксис Markdown. Надоело постоянно переключаться между 3-4 видами языков разметки или запоминать массу различных сочетаний клавиш (хуже всего Asana, которая используется у нас в компании).
Между тем есть wiki.js, которая как раз написана на JavaScript, работает на Node.js и позволяет хранить базу знаний команды в markdown. Является OpenSource. Используем в компании — есть несколько известных багов, неприятных, но не критичных.
Столкнулся с тем что markdown не хватает для таких нужд, в данный момент начал использовать reStructuredText — он довольно похож на markdown но возможностей больше.
Подкупили 2 возможности
- с помощью include собирать один файл из кучи более мелких
- постоитель таблиц на основе csv
В качестве редактора использую ReText, после чего Sphinx и можно и на github pages и в виде статичного html для сайта и даже в docx перегнать.
второй вариант — Jupyter notebook
Zim хорош, но для меня в нем фатальный недостаток: неимоверно раздражает свой язык разметки вместо markdown, ни на что не похожий. Постоянно пишут markdown, чертыхаюсь, пытаюсь вспомнить синтаксис zim. Надоело.
Кстати, структура каталогов Zim каким-то образом сломала синхронизацию с yandex.диском. Он мне начал постоянно удалять несколько заметок (хорошо, что я регулярно делаю бэкапы).
Я убедился, что это именно Яндекс.Диск, подробно описал все в репорте Яндексу 2 или 3 года назад. Сначала несколько месяцев игнор. Потом все-таки создали тикет, но без какого-либо движения. Теперь насколько я понимаю, они просто тихо убили клиент для Linux — последняя версия для Linux 3 или 4 летней давности.
Так и не узнаю, что это было: при создании некоторых заметок в Zim, они просто удалялись Яндекс.Диском при синхронизации. Причем даже если в командной строке создать текстовый файл типа: touch ~/Yandex.Disk/Notes/Work/Client1/todo.txt.
Я доверяю Яндекс не меньше, чем кому-либо еще. Да и продукты у них, в общем хорошие. С диском обидная для меня ситуация, но мало у кого есть силы, чтобы поддерживать клиентов для всех платформ. У Google Drive клиента для Linux вообще никогда не было.
Так что пользуюсь клиентом Яндекс.Диска для Android, а на ноуте web-интерфейсом.
Как варинт, еще вот проект: blog.getpelican.com.
Добавлю свои пять копеек.
Выбирал систему для базы знаний. сначала смотрел на языки разметки и платформы сборки документации.
Из самых интересных нашел:
gohugo.io
asciibinder.org
awestruct.org
Но остановился на Xwiki, так она наиболее ынтырпрайзная. Да изучать разметку аналитики и техниписатели не хотят.
Markdown база знаний (или блог, или документация проекта)