Меню Рубрики

Установка dokuwiki с нуля

Rockwood

Hello Ontario

Как установить DokuWiki на домашний вэб-сервер

Dokuwiki – это Вики, которая не требует базы данных MySQL и оперирует только текстовыми файлами. Незаменимая в хозяйстве вещь. Как чайник хранит свои записи? Раскидает документы по разным форматам по разным папкам, а потом и забудет про них. Однако записи, заметки, рецепты и тд. можно хранить культурно, организованно, компактно в одном месте. Конечно есть специальный софт и все такое, но домашнюю вики можно достичь из любой точки земного шара и даже показать друзьям, куда они могут в частности вставлять свои добавления и коллаборировать в целом. Это веб-сайт.

Dokuwiki – элегантный, аккуратный и простой в обращении веб-сайт.

Установка

Сначала надо установить веб-сервер. Как это сделать на Линуксе, я объяснил тут. А как установить Линукс – тут.

Линукс – тоже очень удобная вещь для домашнего пользования. Если у вас нет каких-то специфических запросов к Ms. Windows, я б вам посоветовал поставить себе Линукс.

Итак, идем на сайт DokuWiki и скачиваем свежую копию.

При помощи atool разархивируем

Двигаем папку dokuwiki в /var/www/html и меняем permissions:

В идеале разрешения должны быть следующие:

для папки data

для содержимого папки data:

Потом в браузере открываем install.php:

Если Файерфокс покажет пустую страницу, нажмите комбинацию (forse reload):

Иногда почему-то форс релоуд не помогает, а Гугл Хром показывает Error 500 . Тогда надо перезагрузить Апачи.

Зарегистрируйся как суперюзер.

Удаляем install.php в целях безопасности, чтоб кто-нибудь через интернет не смог его открыть и сбить все настройки:

Теперь в браузере просто вводим адрес:

и попадаем на страницу логин. Вводим наши данные:

и попадаем на страницу Start. Она физически еще не существует.

Первые шаги

Нажимаем справа на кнопку:

и попадаем в DW Edit. DW Edit – это текстовый редактор маркапа Dokuwiki. Пишем в двойных квадратных скобках:

Это гиперссылка к странице Привет. Сохраняем и и попадаем обратно на страницу Старт.

Страница Привет еще не существует, поэтому ссылка к ней отображается красным цветом.

Нажимаем на ссылку Привет и попадаем в новый топик. Его еще нет.

Опять нажимаем справа на кнопку:

И опять и попадаем в DW Edit. Пишем что-нибудь.

Чтоб добавить к тексту картинку, нажимаем на кнопку

и попадаем в Медия Файлы.

Нажимаем на кнопку Select Files. Открывается диалог выбора файла.

Выбираем файл и нажимаем кнопку Upload.

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

Insert. Картинка вставлена.

Сохраняем и смотрим статью, которую мы только что сделали.

Если мы теперь пойдем на страницу Start, то увидим, что ссылка Привет стала зеленой.

DW Edit не очень удобный редактор, хотя и полезный. Поэтому мы установим привычный визивиг – FCK Edit. Это плагин, который надо скачать. Говорят, что нашли в его коде, какие-то ужасные баги, которые угрожают безопасности, это все ерунда. Мы сами не будем баловаться и свой пароль никому не скажем.

Переименовываем папку fckgLite-master в fckg:

Двигаем папку fckg в Dokuwiki и меняем permissions:

Теперь если мы перезагрузим Dokuwiki в браузере, то получим FCK Edit.

Однако FCK Edit и DW Edit можно при желании переключать:

Еще один важный момент. Новая Dokuwiki пишет параграф в одну строчку, игнорируя line breaks: Нам нужен еще один плагин для окончаний линий – xbr. На сайте Dokuwiki много всяких плагинов, но этот вроде уже установлен заранее. Если нет, скачайте с сайта Dokuwiki xbr Plugin – файл Chris–S-dokuwiki-plugin-xbr-7ab976f.zip или подобный, разархивируйте, переименуйте папку в xbr и поместите ее в директорию /var/www/html/dokuwiki/lib/plugins.

Нам остается лишь переключить способ отображения страниц.

Идем Admin > Configuration Settings:

Находим опцию Renderer to use for main (xhtml) wiki output и переключаем xhtml на XBR. Сохраняем.

И, о чудо! Линия встала в столбик.

Теперь, чтоб смотреть наш сайт в интернете, нам надо получить доменное имя.

источник

Как развернуть DokuWiki on Ubuntu 18.04 Server

Буду поднимать привычную и уже давно используемую DokuWiki (Текущий релиз: Release 2018-04-22a «Greebo» ) на своем железе (HP MicroServer Gen8) для организации персональной базы знаний без доступа на всеобщее обозрении, а все то что выложено на блогах: www.ekzorchik.ru пусть остается, как есть, хотя несколькими днями назад я заикнулся, что буду использовать MediaWiki — я поторопился. Раз у меня есть опыт в количестве 3 лет ежедневного использования, то лучше будет использовать уже привычное, чем все новое и с нуля.

Читайте также:  Установка заднего крыла приора

А все самое интересное и расширенное у себя, наработки, ежедневные отчеты по работе, выводы.

Из репозитария Mercurial выкачиваю скрипт посредством которого происходит базовая настройка Ubuntu 18.04 Server на дальнейшую работу по разворачиванию различных сервисов необходимых мне.

$ hg clone ssh://IP&DNS://home/ekzorchik/dproject

$ sudo apt-get install apache2 libapache2-mod-php7.2 -y

$ echo «ServerName localhost» | sudo tee -a /etc/apache2/apache2.conf

$ sudo sed -i ‘s/None/All/g’ /etc/apache2/apache2.conf

$ tar zxf dokuwiki-stable.tgz

$ sudo mv dokuwiki-2018* /var/www/html/wiki

$ sudo chown -R www-data:www-data /var/www/html/dokuwiki/

$ sudo systemctl restart apache2

Открываю браузер и в строке адреса указываю: http://172.33.33.25/wiki/install.php

  • Изменяю язык: Choose your language: ru
  • Название вики: tips_db_home
  • Разрешить ограничение прав доступа: отмечаю галочкой
  • Суперпользователь: ekzorchik
  • Полное имя: ekzorchik
  • Эл. Адрес: support@ekzorchik.ru
  • Пароль: 712mbddr@
  • Повторите: 712mbddr@
  • Исходная политика прав доступа: Закрывая вики
  • Тип лицензии: Не отображать информацию о лицензии.
  • Отправлять раз в месяц анонимную пользовательскую информацию разработчикам «Докувики: снимаю галочку

и нажимаю «Сохранить», после установщик сообщает:

Конфигурация прошла успешно. Теперь вы можете удалить файл install.php. Переходите к своей новой «Докувики» ( http://172.33.33.25/wiki/doku.php? >).

И меня встречает привычный интерфейс по использованию DokuWiki:

Завершаю установку чисткой более не нужных файлов:

$ sudo rm /var/www/html/wiki/install.php

$ sudo rm -Rf /var/www/html/wiki/data/pages/playground/

$ sudo rm -Rf /var/www/html/wiki/data/pages/wiki/

$ sudo rm -Rf /var/www/html/wiki/data/pages/start.txt

Далее мне для использования нужна возможность импорта составленных заметок из пакета LibreOffice Write в DokuWiki которую я использовал в системе Ubuntu Trusty Desktop:

$ sudo apt-get install php-pear php7.2-xsl unzip php7.2-zip -y

$ sudo mkdir -p /var/www/html/wiki/lib/plugins/odt2dw

$ sudo mv dokuwiki-plugin-odt2dw-master/* /var/www/html/wiki/lib/plugins/odt2dw/

$ sudo chown -R www-data:www-data /var/www/html/wiki/

http://IP&DNS — user&pass — Управление — Управление дополнениямиУстановленные плагины и вижу, что добавленный плагин успешно включился в процесс:

Если перейти к созданию документа, то нажав на иконку с именованием текущей вики: « tips_db_hom e», мастер предлагает через «Обзор» загрузить файл в формате odt (я так обычно сохраняю свои наработки при написании через LibreOffice Writer, и не важно какая сейчас операционная система используется, пакет LibreOffice — это мой основной рабочий инструмент), а после нажимаю «Загрузить». Если как и раньше в Ubuntu Trusty видим ошибку загрузки: « odt2dw : er_class_xsltProcessor : Fatal error : Unable to initialize XsltProcessor object », то:

$ sudo nano /etc/php/7.2/apache2/php.ini

$ sudo systemctl restart apache2

Так одна ошибка пропала, а теперь следом появилась другая « odt2dw : er_class_zipArchive : Fatal error : Unable to initialize ZipArchive object », в этом случае Вы скорее всего не правильно написал путь до xsl.so, его писать не нужно он сам подставляет полный путь, нужно сделать лишь как указано выше у меня.

$ sudo systemctl restart apache2

После документы с расширением odt успешно импортируются в DokuWiki.

На этом я остановлюсь, описывать какие плагины использую я не стану, каждый под себя выбирает необходимое. До новых заметок, с уважением автор блога Олло Александр aka ekzorchik.

Используйте прокси ((заблокировано роскомнадзором, используйте vpn или proxy)) при использовании Telegram клиента:

Поблагодари автора и новые статьи

Карта МКБ: 4432-7300-2472-8059
Yandex-деньги: 41001520055047

Большое спасибо тем кто благодарит автора за практические заметки небольшими пожертвованиями. С уважением, Олло Александр aka ekzorchik.

источник

Знакомство с wiki-системой DokuWiki 0

Программное обеспечение

Статья была опубликована 1 мая 2013 года в 12:00, а последний раз правилась 9 апреля 2015 года в 11:33.

Обзор свободной вики-системы с веб-интерфейсом DokuWiki, написанной на PHP и использующей файлы в качестве базы данных.

Примечание: эта статья была впервые опубликована в электронном издании «Open Source» от журнала «Системный администратор» и размещена на nixp.ru по согласованию с редакцией.

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

Но движков Wiki много, хотя, конечно же, у всех на слуху MediaWiki, лежащая в основе Wikipedia и многих других сходных ресурсов. У меня был опыт работы с MediaWiki — казалось, что достаточно взять и установить. Но после инсталляции я решил попробовать что-нибудь другое. Выбор пал на DokuWiki (www.dokuwiki.org), которой впоследствии и было отдано предпочтение. На что способна DokuWiki и почему мне она понравилась, я и расскажу в этой статье.

Читайте также:  Установка бортового компьютера газель cummins

Первые шаги после установки

Как и MediaWiki, DokuWiki — это PHP-приложение. Оно устанавливается в выбранный каталог сайта, после чего можно начинать работу. А вот существенное отличие от MediaWiki — использование обычных текстовых файлов (вместо СУБД вроде MySQL или PostgreSQL) для хранения данных. Это делает каталог установки DokuWiki полностью самодостаточным. Вы можете просто взять его и перенести в другое место (на другой сайт) или упаковать в архив резервную копию.

При «первом запуске» DokuWiki предлагает установку, настройку разных параметров. Сначала идёт активация ACL (Access Control List) для разграничения прав пользователей. Если ACL выключить, то все посетители wiki смогут без регистрации править её содержимое. С включённым ACL анонимы править не могут, а зарегистрированные пользователи будут иметь те права, которыми вы их наделите. ACL — это еще и графический интерфейс для управления пользователями, но удобнее и быстрее вносить правки в файл настройки /conf/acl.auth/php. В нем отдельным группам или пользователям задаются права доступа для всех или отдельных страниц. Например:

Это значит, что для всех страниц (*) пользователь doom имеет доступ уровня 16. Уровни (или режимы) доступа — это числа от 0 до 16 с определённым шагом. Каждый уровень добавляет к предыдущему одну новую возможность: чтения, записи, создания и так далее. Вот список уровней:

  • 0 — ничего;
  • 1 — чтение;
  • 2 — правка существующих статей;
  • 4 — создание новых статей;
  • 8 — загрузка файлов (картинок);
  • 16 — удаление статей.

Таким образом, уровень 16 — это почти администратор.

Имя пользователя пишется в файле настроек как есть, а название группы надо предварять «@», например: @ALL, @user. Чтобы включить ACL, надо в файле /conf/local.php написать:

Добавление пользователей в группам осуществляется в файле /conf/users.auth.php, синтаксис которого очевиден, так что не буду вдаваться в подробности.

Перед началом написания статей в Wiki, надо настроить важную опцию кодировки имен файлов. Это делается либо через веб-интерфейс (Управление -> Параметры DokuWiki -> fnencode), либо в конфигурационном файле /conf/local.php, строкой:

В последнем случае после правки файла настройки надо будет перезайти в вашу Wiki. Опция fnencode задает кодировку, в которой сохраняются имена файлов в наборе символов, отличном от ASCII. Поскольку названия файлов и названия статей взаимосвязаны, ваши статьи с русскими названиями будут записаны под именами файлов с русскими названиями. Поэтому оптимально выбрать для них UTF-8.

Вообще все настройки можно править через файл настроек. Отличие от графического интерфейса лишь в том, что нет локализованных предупреждений и подсказок. Предупреждения появляются, например, при отключении ACL, т.к. в результате выполнения этой операции из интерфейса «пропадет» администраторское меню.

Из важных параметров, на которые стоит обратить внимание в первую очередь, еще выделю разве что размер загружаемого в wiki файла (в байтах) — fetchsize. Остальное правится по мере необходимости.

Вопреки бытующему мнению, что DokuWiki медлительнее, чем MediaWiki, из-за отсутствия взаимодействия с СУБД, DokuWiki всё же быстрее подготавливает страницы для отображения в браузере — это ощущается просто во время работы с вики. Быстро работает поиск по названиям статей. Не так быстро, как при обращении к СУБД, работает поиск по подстроке, неполному слову. (Прим. ред.: Впрочем, очевидно, что скорость работы будет во многом зависеть от размеров базы знаний.)

Для правки статей DokuWiki оснащена приятным редактором с панелью инструментов. Текст в процессе правки время от времени сохраняется автоматически в виде черновика, что весьма удобно. Синтаксис подобен MediaWiki, но с рядом косметических отличий. Например, жирный текст, в DokuWiki отмечается:

Пустые строки служат отметками новых абзацев. Простой «перевод строки» пропускается. Чтобы сделать жесткий перевод строки в нужном месте, надо написать: «\\» (без кавычек, конечно), после чего сделать новую строку или поставить пробел. Очень просто создавать сноски — заключаем текст в двойные скобки, и он автоматически нумеруется и становится сноской. Например:

Читайте также:  Установка пластиковых панелей на пластиковый профиль

DokuWiki поддерживает создание сносок ((Сноска — пояснение внизу страницы)), что позволяет облегчить основной текст.

В этом случае при отображении страницы после слова «сносок» будет поставлено приподнятое по вертикали число, обозначающее номер сноски. Нажав на него мышью, пользователь перенесется в конец страницы, где и увидит текстовое пояснение сноски, а именно, например, «1) Сноска — пояснение внизу страницы».

Ряд функций, присущих MediaWiki внутренне, в DokuWiki реализован через плагины — например, выравнивание текста или «редиректы». Впрочем, то же справедливо и в обратную сторону: движок MediaWiki лишен некоторых функций, встроенных в DokuWiki. Подробное сравнение можно увидеть на сайте www.wikimatrix.org.

Мне очень нравится встроенная в DokuWiki подсветка синтаксиса языков программирования. В самом названии этого wiki-движка очевидна его направленность — разработка документации, в том числе технической. При помощи плагинов можно добавлять в статьи диаграммы, а также формулы, записанные в LaTeX. Картинки вставляются встроенными средствами, для HTML5-видео (ogv) и звука нужны плагины.

Для отображения на странице исходного кода на каком-либо языке программирования, используются теги code и file. Внутри этих тегов сохраняется всё исходное форматирование (пробелы, переносы строк…). Чтобы включить дополнительно подсветку синтаксиса, надо указать язык. Например:

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

При этом, «example01.php» и будет именем файла, с которым будет сформирована ссылка для скачивания.

Подсветка каких языков программирования поддерживается в DokuWiki? Для этого используется движок GeSHi (http://qbnz.com/highlighter/), так что зависит от его способностей, а они впечатляют. Раз уж речь зашла о программировании, замечу, что DokuWiki позволяет вставлять в свои вики-страницы рабочий код на PHP и HTML, тем самым предоставляя возможность неограниченного расширения возможностей вашей Wiki. В целях безопасности такая возможность, однако, отключена. Для включения встроенного PHP в файл надо /conf/local.php поместить:

В DokuWiki есть поддержка таблиц с весьма простым синтаксисом. Вот красноречивый пример таблицы с двумя рядами по три колонки/ячейки в каждом:

Возможности DokuWiki можно развивать с помощью плагинов и шаблонов. Плагины устанавливаются прямо из веб-интерфейса на странице «Управление плагинами». Настройки же плагинов доступны в том же разделе, что и общие настройки wiki. Физически плагины устанавливаются в каталог /lib/plugins (исходника вашей wiki). А тексты статей хранятся в обычных текстовых файлах в каталоге /data/pages. Плагины расширяют синтаскис DokuWiki и её возможности — например, появляются функции построения диаграмм, вставки видео на HTML5, дискуссий к каждой статье, экспорта в ODT, отображения карт и многого другого.

Есть также скачиваемые шаблоны — их можно рассматривать как темы оформления. Конечно же, любой шаблон или плагин можно править по своему усмотрению после установки (в любом текстовом редакторе). Некоторые плагины требуют дополнительных действий для своей установки — например, правки шаблонов. Это бывает нужно, чтобы поместить на страницу какую-нибудь кнопку, нажатие которой вызывает функции плагина к жизни.

Технологиям, подобным DokuWiki, надо давать оценки с двух разных точек зрения: администратора и пользователя. Для пользователя, DokuWiki — это быстрое средство коллективной работы над текстами справочного характера. Интерфейс весьма интуитивен и имеет локализацию на русском языке. Совокупность интерфейса и синтаксиса DokuWiki не вызывает недоумения даже у тех пользователей, которые ранее имели лишь шапочное знакомство с более популярной MediaWiki.

С точки зрения администратора, DokuWiki также весьма удобна, особенно в случаях, когда правка wiki должна осуществляться «группой доверенных лиц», а остальные посетители wiki выступают в роли читателей. Конечно, никто не мешает вам настроить wiki для всеобщей правки безо всяких ограничений. Некоторых администраторов беспокоит «нетрадиционность» движка DokuWiki — использование файлов вместо СУБД. Но мнение о «нетрадиционности» — от незнания технологий, стоящих за wiki-движками помимо MediaWiki: без СУБД успешно работают MoinMoin, TWiki, UseMod, PmWiki… Впрочем, эта тема, скорее, для ведения священной войны, которую я развивать не хочу. Избираемое решение той или иной задачи лежит, мне кажется, больше в области личных предпочтений администратора, нежели в объективных суждениях о той или иной технологии. Всегда полезно собственноручно установить ряд сходных продуктов, протестировать их и сравнить возможности и быстродействие.

источник