Блог Александра Башкирова

ИТ и бизнес, компьютеры и ПО, фото, программирование и просто мысли…
Этот сайт в основном посвящен тому, что мне интересно вне работы. Ведется в порядке хобби.
Все изложенное на сайте - мое частное оценочное мнение и не может быть истолковано иначе.
Со всеми вытекающими из этого последствиями.

dokuwiki

Подписаться на эту метку по RSS

Заметки про Dokuwiki

Просмотров: 2506Комментарии: 0
Alib.spb.ru

В качестве базы знаний я использую дома Dokuwiki. Всем хорошая вещь:)

А тут, спустя пару лет, узнал, что можно использовать достаточно легко, такую вещь, как боковую панель. И создается она не просто - а очень просто. Достаточно в требуемом пространстве имен создать страницу с именем sidebar - как она становится сайдбаром))) ну и еще одна фишка. Если в сайдбар выводить часто меняющийся контент, то имеет смысл прописать туда макрос ~~NOCACHE~~ - он запретит кеширование садбара.

ПС. Этот макрос в принципе запрещает кеширование любой страницы, на которой он расположен.

ПСС. Пост для памяти :)

Dokuwiki установка и настройка для домашней базы знаний

Просмотров: 12862Комментарии: 0
Alib.spb.ruLinux
Итак, для коллекционирования всякого разного информационного хлама поставил себе dokuwiki. 

Установка, кстати, проста до безобразия: создаешь хост, папку, туда распаковываешь скачанный с https://www.dokuwiki.org архив, запускаешь install.php, вводишь простые параметры, - и все. Можно работать. Кстати, Dokuwiki не требует БД.
Загрузка, кстати, у dokuwiki сделана прикольно: идешь на http://download.dokuwiki.org/, выбираешь опции, и получаешь собранный “под тебя” пакет. То есть не вытаскиваешь ничего ненужного, все только нужное.

Почему именно dokuwiki? (Я, кстати, постоянно “на автомате” пытаюсь написать docuwiki). Потому, что нужно “для дома”, возможностей - масса (список плагинов, например, тут: https://www.dokuwiki.org/plugins, тем - тут: https://www.dokuwiki.org/ru:template). Ну и потому что это определенный “мэйнстрим”. То есть нужен был движок, на который потрачу не более пары часов, легкий в освоении… Бегло почитав сравнения в сети, остановился на нем.
Да, я одно время пытался использовать “сайты гугла” в качестве вики, но быстро разочаровался. Дело в том, что никаких “плюшек” в них не предусмотрено. Хочешь подсветку синтаксиса? Ручками! Хочешь выделение текста блоком … ээ… в общем, не выйдет. Хочешь свою тему? Неее, только те, что предустановлены. Итого - решил не связываться.

Для начала, решил залить новый шаблон (скачал этот: https://www.dokuwiki.org/template:codowik). Шаблоны ставятся до безобразия просто: скопировал файлы из архива в /lib/tpl - и шаблон появился в настройках. По-моему, круто и изящно. Чтобы окончательно в это увериться, установил шаблон taratasy  (https://www.dokuwiki.org/template:taratasy) и все прошло также без вопросов.
Кстати, остановился в итоге на теме Breeze - https://www.dokuwiki.org/template:breeze - более похожая на “нормальные” сайты (все-таки, “типичное вики” у меня вызывает небольшой ступор)

Затем, поставил пару доп.плагинов:
Плагинов, как я говорил - масса. Так что настроить можно все что угодно. Народ на этом движке говорят даже блоги делает :)

Работа в dokuwiki, кстати, для новичка достаточно простая. надо лишь помнить о том, что есть 2 сущность: пространство имен (namespace) и имя страницы. 
Пространство имен - это такая глобальная штука, которая является объединителем для множества страниц одной темы. Ну, то есть это некий отдаленный аналог каталогов ФС. Подробно о пространстве имен: https://www.dokuwiki.org/ru:namespaces
Чтобы создать страницу в текущем пространстве имен, достаточно сослаться ([[page-name]]) на нее или попытаться найти в поиске.
Ссылки на другое пространство имен идут через : - например wiki:syntax

Хорошая статья для освоения синтаксиса wiki: http://blog.engexp.ru/create-documentation/sozdanie-texnicheskoj-dokumentacii-v-dokuwiki-sintaksis-chast-2/

Что на выходе? Достаточно симпатичная и гибкая база знаний. Легко бекапится (достаточно скопировать каталог с установкой). Легко разворачивается “обратно” (также - копированием и минимальными настройками апача). Вещь :)
И, самое главное - легко осваивается.

Ну и скриншотик: