====== DokuWiki на Debian, Ubuntu и производных дистрибутивах ======

Пакет Debian для DokuWiki существует в официальном репозитории Debian и может быть установлен с помощью обычных инструментов Debian (например, ''apt'').

Однако мы обычно не рекомендуем устанавливать DokuWiki как пакет Debian по нескольким причинам:

  * Пакет устарел, поскольку использует старую версию DokuWiki, что делает его несовместимым со многими новыми плагинами.
  * Пакет использует другую структуру каталогов, что может вызвать проблемы с некоторыми плагинами и сделать некоторую общую документацию неприменимой.
  * Пакет заменяет некоторые внутренние библиотеки DokuWiki версиями пакетов Debian, что снова может привести к несовместимости.

=====Пакет DokuWiki Debian=====
Подробную информацию об официальном пакете вы можете найти в следующих источниках:

  * [[http://packages.debian.org/dokuwiki|Обзор пакета Dokuwiki]]
  * [[http://packages.qa.debian.org/dokuwiki|Технический обзор и новости]]
  * [[http://bugs.debian.org/dokuwiki|Сообщения об ошибках]]

===== Установка =====

Все, что нужно знать написано [[https://wiki.debian.org/DokuWiki|здесь]]. Дополнительные сведения об установке и настройке «Докувики» на Debian см. [[debian_ubuntu_extras]]..

==== Далее Конфигурация "DokuWiki" с помощью диспетчера конфигурации ====

Смотреть ->[[wiki:config]], наиболее близких вариантов [[wiki:config:userewrite|используйте rewrite(?)]]  и [[wiki:config:useslash|используйте slash]]

Каталог менеджер расширений не перезаписываемый. Если вы хотите использовать эту функцию, установите [[plugin:extension#file_permissions|соответствующие разрешения]].

==== lighttpd ====

  apt-get update	 
  apt-get install lighttpd	 
  apt-get install php5-cgi php5 dokuwiki	 

  lighty-enable-mod fastcgi fastcgi-php dokuwiki	 
  /​etc/​init.d/​lighttpd force-reload	 
Если DokuWiki mod(?) не загружается, вам  надо будет создать ссылку на конфигурационный файл lighttpd.conf. См. [[wiki:install:lighttpd]]

==== nginx ====

Вставьте в ''/etc/nginx/sites-enabled/default''
<code>
    # serve static files from nginx
    location ~ ^/dokuwiki/lib/.+\.(css|gif|js|png)$ {
        root /usr/share;
        expires 30d;
    }
    location = /dokuwiki/install.php {
        deny all;
    }
    location = /dokuwiki {
        rewrite ^ /dokuwiki/ permanent;
    }
    location = /dokuwiki/ {
        rewrite ^ /dokuwiki/doku.php last;
        expires 30d;
    }
    location ~ ^/dokuwiki/(|lib/(exe|plugins/[^/]+)/)[^/]+\.php {
        root /usr/share;
        fastcgi_pass unix:/var/run/php5-fpm.sock;
        include        fastcgi_params;
        # from Debian Jessie, replace the previous include by
        include snippets/fastcgi-php.conf;
    }
    location /dokuwiki/ {
        deny all;
    }
</code>


==== Apache ====

<code bash>
sudo apt-get install php5 libapache2-mod-php5 php5-mcrypt dokuwiki
</code>

После двух ответов «да», PHP установится сама.

Если вы просто видите надпись «это работает!» на странице или что-то аналогичное, убедитесь, что страница по умолчанию - index.html был удален из каталога сайта. 

Если у вас все еще остались проблемы, то также попробуйте переместить index.php в начальный каталог индекса, это позволит убедиться что файл index.php работал сначала:

<code bash>
sudo nano /etc/apache2/mods-enabled/dir.conf
</code>
//Примечание: nano это просто текстовый редактор, используйте, как вам удобно.//

Добавьте index.php к началу индексных(?) файлов. Теперь страница  должна выглядеть так:
<code>
<IfModule mod_dir.c>
          DirectoryIndex index.php index.html index.cgi index.pl index.php index.xhtml index.htm
</IfModule>
</code>

Все, что нужно сделать уже сделано в рамках пакета " Dokuwiki " и он встроен в режимы постинсталляции. 
Файл /etc/dokuwiki/apache.conf связывал(?):

<code bash>
ls -l /etc/apache2/conf-available/
lrwxrwxrwx 1 root root   25 Apr  5  2014 dokuwiki.conf -> /etc/dokuwiki/apache.conf

ls -l /etc/apache2/conf-enabled/
lrwxrwxrwx 1 root root   32 Apr  5  2014 dokuwiki.conf -> ../conf-available/dokuwiki.conf
</code>

В файле конфигурации  Apache  (dokuwiki .conf или apache. conf), смените псевдоним разрешите просмотр с localhost 127.0.0.1::1 для вас;  (по умолчанию разрешен только просмотр из хоста dokuwiki ) и «разрешите просмотр для всех» что позволит просмотр с любого удаленного хоста.
====Рекомендуемая настройка====
Вместо того чтобы полагаться на пакет Debian, рекомендуется просто установить веб-сервер и PHP через менеджер пакетов и установить DokuWiki из исходников.

Для простой настройки Apache mod_php это может быть так же просто, как показано ниже:

  - Подготовьте систему, скачайте и распакуйте последнюю версию DokuWiki:
<code bash>
$> sudo apt update
$> sudo apt install php libapache2-mod-php php-xml php-json php-mbstring php-zip php-intl php-gd
$> sudo systemctl restart apache2.service
$> wget https://download.dokuwiki.org/src/dokuwiki/dokuwiki-stable.tgz
$> tar xzvf dokuwiki-stable.tgz
$> sudo mv dokuwiki-*a /var/www/html/dokuwiki
$> sudo chown -R www-data:www-data /var/www/html/dokuwiki
</code>
  - **Необязательно**\\ Если вы используете брандмауэр, разрешите HTTP-трафик. Для несложного брандмауэра (ufw) команда будет такой:<code bash>
sudo ufw allow 'Full'
</code>
  - Откройте в своем веб-браузере страницу ''http://localhost/dokuwiki/install.php'', чтобы настроить новую установку DokuWiki.