Различия

Показаны различия между двумя версиями страницы.

--- ru:install:upgrade [2010-12-14 07:25] – создано 46.118.193.231
+++ ru:install:upgrade [2014-02-27 16:54] (текущий) – Klap-in
@@ Строка 1: / Строка 1: @@
 ====== Обновление ======
+Перед обновлением обязательно ознакомьтесь с [[ru:changes|журналом изменений]].
-Перед обновлением обязательно ознакомтесь с  [[..changes|changelog]] что бы ознакомиться с изменениями при обновлении.
+Чтобы узнать, какую версию вы используете, необходимо открыть HTML-исходник страницы, сгенерированной «Докувики», --- в нём будет строка наподобие ''%%<meta name="generator" content="DokuWiki 2005-02-06" />%%''.
-Что-бы узнать какую версию Вы используете, необходимо открыть HTML исходник страницы сгенерированной DokuWiki - это будет выглядеть на подобии ''<meta name="generator" content="DokuWiki 2005-02-06" />''.
+Самый простой способ для обновления --- выполнить следующие шаги.
-Самый простой способ для обновления выполнить следующие щаги:
+  - **Создайте полную резервную копию** (лучше лишний раз перестраховаться)
-  - **Создать полную резервную копию** (более безопасно чем потом извиняться)
     * <code>cp -a /path/to/wiki/ /path/to/wikibackup </code>
-  - [[http://splitbrain.org/go/dokuwiki|Загрузить]] и распаковать новую версию. Дальнейшие инструкции для Linux среды. Для Windows и других, смотрите [[unpacking]].
+  - [[http://download.dokuwiki.org/|Загрузите]] и распакуйте новую версию. Дальнейшие инструкции для среды Linux. Для MS Windows и других ОС см. cтатью «[[unpacking|Извлечение „ДокуВики“ из tgz-архива]]».
     - **Полностью** загрузите dokuwiki tarball в выбранный подкаталог:
       * <code>cd ~
 wget http://.../dokuwiki-xxxx-xx-xx.tgz
 </code>
-      * Распакуйте ''dokuwiki-xxxx-xx-xx.tgz'':
+      * Распакуйте ''dokuwiki-xxxx-xx-xx.tgz'':\\ <code>tar -xzvf dokuwiki-xxxx-xx-xx.tgz</code>
-      * <code>tar -xzvf dokuwiki-xxxx-xx-xx.tgz</code>
+      * После чего скопируйте (загрузите) все файлы в подкаталог со старой версией «ДокуВики», перезаписав все существующие файлы:\\ <code>'cp' -rf dokuwiki-xxxx-xx-xx/{*,.??*} /path/to/wiki/</code>
-      * После чего скопируйте/загрузите все файлы в подкаталог со старой версией DokuWiki перезаписав все существующие файлы:
+        * Кавычки нужны для работы команды в том случае, если ''cp'' является алиасом на ''cp -i''
-      * <code>'cp' -rf dokuwiki-xxxx-xx-xx/{*,.??*} /path/to/wiki/</code>
+        * Шаблон ''.??*'' указывает на необходимость обработки скрытых файлов (например, .htaccess.dist), которые тоже будут скопированы.
-        * Кавычки нужны для работы команды в случае если cp есть алиасом на cp -i
+    - **Или** загрузите прямо в свой подкаталог «ДокуВики»:
-        * Шаблон .??* указывает на необходимость обработки скрытых файлов (пример: .htaccess.dist) которые то-же будут скопированы.
-    - **Или** загрузите прямо в Ваш dokuwiki's подкаталог:
       * <code>cd /path/to/wiki/
 wget http://.../dokuwiki-xxxx-xx-xx.tgz
 </code>
-      * Распакуйте его в dokuwiki корневой директории перезаписав все существующие файлы:
+      * Распакуйте его в корневой директории «ДокуВики», перезаписав все существующие файлы:\\ <code>tar -xzvf dokuwiki-xxxx-xx-xx.tgz --strip-components=1</code>
-      * <code>tar -xzvf dokuwiki-xxxx-xx-xx.tgz --strip-components=1</code>
+      * Удалите загруженный архив:\\ <code>rm dokuwiki-xxxx-xx-xx.tgz</code>
-      * Удалите загруженный архив:
+  - Проверьте [[ru:changes|журнал изменений]].
-      * <code>rm dokuwiki-xxxx-xx-xx.tgz</code>
+  - Удалите install.php: rm www/install.php
-  - Проверьте [[..changes|Changelog]]
+  - Удалите старые файлы, которые более не используются. Ниже приведен полный список таких файлов по версиям.
-  - Удалите install.php  : rm www/install.php
+  - Скорректируйте [[ru:install:permissions|права доступа]], если это необходимо, включая новые подкаталоги в папке ''data/''.
-  - Удалите старые файлы, которые более не используются (Ниже приведен полный список таких файлов по версиям.)
+  - Сравните свой файл ''.htaccess'' с полученным ''.htaccess.dist'' на предмет возможных изменений.
-  - Скорректируйте [[install:permissions | права]] если это необходимо; включая новые подкаталоги в ''data/''
+  - Обновите плагины (plugins) и шаблоны (template).
-  - Сравните ваш .htaccess с полученным .htaccess.dist на предмет возможных изменений
+  - Установите кэш в состояние несоответствия путём touching ''conf/local.php'' (типа, пересохраните конфигурацию).
-  - обновите плагины (plugins) и шаблоны (template)
+  - Возможно потребуется обновление индекса. См. [[ru:cli#indexer.php|утилиты командной строки]].
-  - установите кеш в состояние не соответствия путем touching ''conf/local.php'' (типа пересохранить конфигурацию).
-  - возможно потребуется обновление индекса; смотрите [[:cli#indexer.php|Утилиты командной строки]]
-Описанные действия безопасны если вы всегда придерживаетесь изменений в локальных версия конфигурационных файлов (типа ''conf/local.php'' вместо ''conf/dokuwiki.php''). DokuWiki не будет переписывать эти файлы. Если Вы всегда испольуете плагин [[plugin:config|config manager]] это безопасный путь для сохранения в local.php.
+Описанные действия безопасны, если вы всегда придерживаетесь изменений в локальных версия конфигурационных файлов (типа, ''conf/local.php'' вместо ''conf/dokuwiki.php''). «ДокуВики» не будет переписывать эти файлы. Если вы всегда используете [[plugin:config|плагин менеджера конфигурации]] --- это безопасный путь для сохранения в local.php.
-===== Удаленны файлы =====
+===== Удалённые файлы =====
-Это список файлов удаленных в соответствующих релизах. После проверки на наличие их в существующей установке - просто удалите их.
+Это список файлов, удалённых в соответствующих релизах. После проверки на наличие их в существующей установке и просто удалите их.
 <file - removeold.txt>
+# удалено в 2011-05-25
+conf/words.aspell.dist
+lib/styles/style.css
 # удалено в 2010-11-07
 inc/lang/ar/subscribermail.txt
@@ Строка 282: / Строка 281: @@
 </file>
-Люди имеющие shell доступ к серверу просто скопировать текст выше и вставить в файл на сервере, после чего выполнить следующие команды для проверки и удаления всех этих файлов. Будут удалены лишние файлы. Я исполью имя файла /tmp/removeold.txt для хранения списка файлов загруженных с этого сайта.
+Люди, имеющие shell-доступ к серверу, могут просто скопировать текст выше и вставить в файл на сервере, после чего выполнить следующие команды для проверки и удаления всех этих файлов. Будут удалены лишние файлы. Я исполью имя файла ''/tmp/removeold.txt'' для хранения списка файлов, загруженных с этого сайта.
-<code>
+<code>grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -f</code>
-grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -f
-</code>
-Если вы параноик, замените "rm -f" на "ls -la" что бы увидеть удаленные файлы.
+Если вы «параноик», замените "rm -f" на "ls -la", чтобы увидеть удалённые файлы.
 Для удаленния каталогов и файлов используйте:
-<code>
-grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -fd
-</code>
-Однако, некоторые системы могут не поддерживать "rm -d" опцию для удаления подкаталогов. В этом случае вы должны использоват рекурсивное удаление (обязательно проверьте что будет удаляться, что бы избежать удаления лишней информации):
+<code>grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -fd</code>
-<code>
-grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -fr
+Однако некоторые системы могут не поддерживать опцию "rm -d" для удаления подкаталогов. В этом случае вы должны использовать рекурсивное удаление (обязательно проверьте, что будет удаляться, чтобы избежать удаления лишней информации):
-</code>
+<code>grep -Ev "^($|#)" /tmp/removeold.txt | xargs -n 1 rm -fr</code>
+Ниже приведен скрипт «Питона», который оптимизирует весь этот процесс:
-Ниже приведен python скрипт который оптимизирует весь этот процесс
 <code>
 import os
@@ Строка 315: / Строка 311: @@
 			pass
 </code>
 ===== Решение проблем =====
-Если встретились некоторые несовместимости [[..:DokuWiki's]] после обновления, удалите кеш-файлы в ''data/cache/''. Вам может так-же потребоваться обновление кеша браузера  (Shift-F5 или Ctrl-Shift-R в большинстве браузеров).
+Если встретились некоторые несовместимости в «[[ru:dokuwiki|ДокуВики]]» после обновления, удалите кэш-файлы в папке ''data/cache/''. Вам может также потребоваться обновление кэша браузера --- Shift + F5 или Ctrl + Shift + R в большинстве браузеров.
 Соответствующие страницы:
-  * [[config:updatecheck]] -- информация о наличии новых версий
+  * [[ru:config:updatecheck]] --- информация о наличии новых версий;
-  * [[faq:toolbar]] -- Quickbuttons и JavaScript проблемы
+  * [[ru:faq:toolbar]] ([[faq:toolbar|англ.]]) --- быстрые кнопки и JavaScript-проблемы;
-  * [[faq:searchindex]] -- Если поиск не дает результата.
+  * [[ru:faq:searchindex]] ([[faq:searchindex|англ.]]) --- если поиск не дает результата.
 ===== Альтернативные пути =====
@@ Строка 329: / Строка 326: @@
 Тут приводится несколько альтернативных путей обновления, представленных пользователями. Которые, правда, могут быть слегка устаревшими.
-  * [[.:diffupgrade|Обновление путем создания diffs]]
+  * [[diffupgrade|Обновление путём создания diff-файла]].
-  * [[http://apscatalog.com/1/splitbrain.org/dokuwiki/|Обновления используя APS]] - Кто-нибудь это пробовал?
+  * [[http://apscatalog.com/1/splitbrain.org/dokuwiki/|Обновления, используя APS]] --- кто-нибудь это пробовал?
-  * Обновление используя [[install:downloader|DokuWiki Downloader]]
+  * Обновление при использовании [[ru:install:downloader|загрузчика «ДокуВики»]]:
-    * Загрузите {{http://github.com/splitbrain/dokuwiki-downloader/raw/master/dokuwiki-downloader.php|Скрипт загрузчик}} в корневую директорию dokuwiki.
+    * загрузите {{http://github.com/splitbrain/dokuwiki-downloader/raw/master/dokuwiki-downloader.php|скрипт-загрузчик}} в корневую директорию «ДокуВики»;
-    * удалите doku.php
+    * удалите файл ''doku.php'';
-    * Убедитесь, что все файлы доступны на запись Веб-серверу.
+    * убедитесь, что все файлы доступны для записи веб-серверу;
-    * Запустите загрузчик как обычно.
+    * запустите загрузчик как обычно (из адресной строки браузера);
-    * Пропустите шаг установки и удалите install.php (Даже если продолжить как установку (install.php) вы увидите предупреждение, о обнаружении уже установленной dokuwiki)
+    * пропустите шаг установки и удалите ''install.php'' (Даже если продолжить как установку, вы увидите предупреждение об обнаружении уже установленной «Докувики»);
-    * Все!
+    * всё!