Различия

Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.

Ссылка на это сравнение

faq [2013/12/09 16:56]
qwerty
faq [2013/12/09 17:56] (текущий)
graf_mur старая ревизия восстановлена (2009/10/14 14:07)
Строка 1: Строка 1:
 ====== FAQ (Ответы на часто задаваемые вопросы) ====== ====== FAQ (Ответы на часто задаваемые вопросы) ======
- 
  
 ===== Редактирование ===== ===== Редактирование =====
  
 +  * Это полностью редактируемый сайт. Для того, чтобы принять участие в работе надо нажать на кнопку **"​Править"​** рядом с интересующим вас фрагментом или кнопку **"​Править страницу"​** в левом верхнем углу.
 +  * Некоторые страницы становятся доступны только после {{actionlink>​login|регистрации на этом сайте}}. После этого вы сможете {{actionlink>​login|войти на сайт}} (кнопка внизу страницы).
 +  * Документы поделены на две логические части - собственно **текст** и **обсуждение**. В первой части находится содержимое документа,​ а вторая предназначена для комментариев и ведения дискуссий.
 +  * Вы можете использовать различное <​hi>​форматирование</​hi>​ - выделять **жирным**,​ //​курсивом//,​ __подчёркиванием__,​ оформлять текст в виде таблиц,​ или нумерованных и ненумерованных списков. Более подробную информацию вы можете получить в [[wiki:​syntax|документации по синтаксису]] и опробовать полученные знания [[playground:​playground|в специальном разделе]].
  
-    * Это полностью редактируемый ​сайт. Для того, чтобы принять участие в работе надо нажать ​на кнопку **"​Править"​** ​ рядом с интересующим вас фрагментом или кнопку **"​Править ​страницу"​** ​ в левом верхнем углу. +==== Как создать новую страницу ====
-    * Некоторые страницы становятся доступны только после [[:​actionlink-login?​media=actionlink-login|регистрации на этом сайте]]. После этого вы сможете [[:​actionlink-login?​media=actionlink-login|войти на сайт]] (кнопка внизу страницы). +
-    * Документы поделены на две логические части - собственно **текст** ​ и **обсуждение**. В первой части находится содержимое документа,​ а вторая предназначена для комментариев и ведения дискуссий. +
-    * Вы можете использовать различное <​hi>​форматирование</​hi>​ - выделять **жирным**,​ //​курсивом//,​ __подчёркиванием__,​ оформлять текст в виде таблиц,​ или нумерованных и ненумерованных списков. Более подробную информацию вы можете получить в [[:​wiki:​syntax|документации по синтаксису]] и опробовать полученные знания [[:​playground:​playground|в специальном разделе]].+
  
 +Обычный для DokuWiki способ - ввести имя новой страницы в поле для поиска,​ в результатах поиска нажать на кнопку «Создать страницу».
 +}}
 +Другой способ - ввести имя страницы после URL. Например:​ http://​mysite.ru/​ Новый шедевр
  
-==== Как создать новую страницу? ====+Система сообщит,​ что такая страница ещё не существует. После этого нужно нажать ​на кнопку "​Создать ​страницу".
  
 +Самый грамотный способ - создать страницу,​ связанную с другими страницами сайта. Для этого нужно отредактировать подходящую уже существующую страницу,​ вставив ссылку на новую страницу. После сохранения страницы появится ссылка красного цвета, пройдя по которой нужно нажать на кнопку «Создать страницу».
  
-Обычный для DokuWiki способ - ввести имя ​новой страницы в поле ​для поиска, в результатах поиска нажать на кнопку ​«Создать страницу»}} Другой ​способ - ввести имя страницы после URL. Например: [[http://​mysite.ru/​|http://​mysite.ru/​]] Новый шедевр+А просто кнопка «Создать ​страницу» добавляется с помощью плагина. Но он подглючивает в разных браузерах. И кроме ​кнопки требует ввода ​названия ​страницыИ созданная страница получается непривязанной к другим (страница-одиночка).
  
 +==== Имена страниц ====
  
-Система сообщит, что такая страница ещё не существуетПосле ​этого нужно нажать на кнопку "Создать страницу".+Имена страниц в **DokuWiki** автоматически преобразуются в нижний регистр. Допустимыми символами являются буквы, цифры и специальные символы "​.",​ "​-"​ и "​_"​((На самом деле, для пользователя только "​." ​и "​-"​ могут быть полезныт. к. в случае с "​_"​ будет непонятно, добавлены они пользователем или системой;​ см. следующее предложение в тексте.)) (допускаются только внутри имён((Если эти символы встретятся в начале или конце имени, они будут ликвидированы.))). Все остальные специальные символы (не буквы и не цифры) преобразуются в подчёркивания((или в дефисы, если вы изменили параметр **config:​sepchar** ​в конфигурационном файле.)). Двоеточия используются для определения или, при необходимости, создания [[namespaces|пространств имён]].((Вы можете получить сообщение об ошибке "​Доступ запрещён", если попытаетесь использовать ​двоеточие в имени страницы; это будет результатом непреднамеренной попытки создать ​пространство имён и/​или ​страницу ​там, где вы не имеете права этого делать.))
  
 +Когда включен параметр конфигурационного файла **config:​deaccent** (включен по умолчанию) местные и акцентированные символы преобразуются в их ASCII-эквиваленты (''​ü''​ превращается в ''​ue''​) или просто теряют акценты (''​á''​ превращается в ''​a''​).
  
-Самый грамотный способ - создать страницу,​ связанную с другими страницами сайта. Для этого нужно отредактировать подходящую уже существующую страницу,​ вставив ссылку на новую страницу. После сохранения страницы появится ссылка красного цвета, пройдя по которой нужно нажать на кнопку «Создать страницу».+An implicit constraint on length and beginning of pagenames is set by [[backlinks]] (first three characters must be letters).
  
 +Большинство темплейтов,​ в т. ч. темплейт по умолчанию,​ выводят полное имя страницы и название пространства имён в строке пути в верхнем левом углу страницы. ​
  
-А просто кнопка «Создать ​страницу» добавляется с помощью плагина. Но он подглючивает в разных браузерах. И кроме кнопки требует ввода названия ​страницы. И созданная ​страница получается непривязанной к другим (страница-одиночка).+==== Имена страниц и пространства имён ====
  
 +Пространства имён можно представлять себе как каталоги,​ а страницы − как файлы внутри них.
  
-==== Имена страниц ​====+Например, расположение ​страницы с именем ''​a:​b:​c''​ в дереве пространств имён может быть изображено следующим образом:​
  
 +<​file>​
  
-Имена страниц в **DokuWiki** ​ автоматически преобразуются в нижний регистр. Допустимыми символами являются буквы, цифры и специальные символы "​.",​ "​-"​ и _ckgedit_QUOT__"​((На самом деле, для пользователя только "​."​ и "​-"​ могут быть полезны,​ т. к. в случае с _ckgedit_QUOT " будет непонятно,​ добавлены они пользователем или системой;​ см. следующее предложение в тексте.)) (допускаются только внутри имён((Если эти символы встретятся в начале или конце имени, они будут ликвидированы.)) ). Все остальные специальные символы (не буквы и не цифры) преобразуются в подчёркивания((config:​sepchar)) . Двоеточия используются для определения или, при необходимости,​ создания [[:​namespaces|пространств имён]].((Вы можете получить сообщение об ошибке "​Доступ запрещён",​ если попытаетесь использовать двоеточие в имени страницы;​ это будет результатом непреднамеренной попытки создать пространство имён и/или страницу там, где вы не имеете права этого делать.)) Когда включен параметр конфигурационного файла **config:​deaccent** ​ (включен по умолчанию) местные и акцентированные символы преобразуются в их ASCII-эквиваленты (''​ü'' ​ превращается в ''​ue''​) или просто теряют акценты (''​á'' ​ превращается в ''​a''​). An implicit constraint on length and beginning of pagenames is set by [[:​backlinks|backlinks]] (first three characters must be letters). Большинство темплейтов,​ в т. ч. темплейт по умолчанию,​ выводят полное имя страницы и название пространства имён в строке пути в верхнем левом углу страницы. ==== Имена страниц и пространства имён ==== Пространства имён можно представлять себе как каталоги,​ а страницы − как файлы внутри них. Например,​ расположение страницы с именем ''​a:​b:​c'' ​ в дереве пространств имён может быть изображено следующим образом:  ​корневое пространство имён (всегда существует) | +– пространство имён '​a'​ | +– пространство имён '​b'​ | +– страница '​c'  ​ +   корневое пространство имён (всегда существует) 
-Внутри любого простанства имён могут одновременно существовать как страница,​ так и вложенное пространство имён с тем же самым именем. Возвращаясь к предыдущему примеру,​ можно изобразить страницу с именем ''​a:​b'' ​ следующим образом: ​ корневое пространство имён (всегда существует) | +– пространство имён '​a'​ | +– пространство имён '​b'​ | | | +– страница '​c' ​| +– страница '​b'​ pagename (не смотря на существование пространства имён '​b'​) ​  +     | 
-Это не приводит к конфликтам,​ поскольку DokuWiki всегда считает последнюю лексему в имени страницы (часть имени после последнего двоеточния) как собственно имя страницы,​ а все остальные лексемы − как названия пространств имён * В записи ''​a:​b:​c'',​ ''​a'' ​ и ''​b'' ​ − названия пространства имён, а ''​c'' ​ − имя страницы. * В записи ''​a:​b'',​ ''​a'' ​ − название пространства имён, а ''​b'' ​ − имя страницы. ==== Какими внешними редакторами рекомендуется пользоваться?​ ==== **Внимание! Никогда не используйте** ​ программу **MS Notepad** ((4))) для редактирования файлов в **UTF-8** ​ кодировке! Эта программа вставляет тройку символов в самое начало файла (EF BB BF), по которым определяет,​ что это UTF-8 кодировка,​ что иногда приводит к сбоям в PHP скриптах и порче разметки сайтов. Конечно,​ эти символы не есть личная придумка Microsoft - это один из способов отмечать UTF-8 документы. Но MS Notepad **не умеет** ​ сохранять документы **без** ​ этого **префикса**. Используйте правильные редакторы,​ например Notepad++ (Опция «Кодировать в UTF-8 без BOM»), или встроенные в FAR, либо в Total Comander. ====+     +-- пространство имён '​a'​ 
 +           | 
 +           +-- пространство имён '​b'​ 
 +                 
 +                 ​+-- страница '​c'​
  
 +</​file>​
  
-{{http://​www.haikupedia.ru/​lib/​images/​smileys/​icon_exclaim.gif?​direct&​}} Удаление страниц ==== Если при редактировании страницы удалите всё её содержимое,​ то соответствующая страница ​будет также удалена (однако будет доступна в «истории изменений»). ==== Как удалить символы, которые вставляются при редактировании файла в его начало?​ ==== Такая ​ситуация происходит при редактировании плагином к Total Commandery (SynPlus). Потом нормальные редакторы (NotePad++) их не видят. Решение:​ открыть текстовый файл в любом шестнадцатиричном редакторе (hex-редактор) и удалить первые три символа. Для этого можно использовать ​встроенный редактор из FAR Manager. ==== Можно ли нескольким пользователям одновременно редактировать разные секции одной и той же страницы? ==== В DokiWiki данные хранятся в обычных файлах (одна страница - один файл). Поэтому блокировки происходят на уровне файлов, а не на уровне отдельных ​разделов файла, как это сделано,​ например в MediaWiki, которые хранят свой текст в базе данных. Совместную (в смысле одновременную) работу в DokuWiki организовать не получится. Для этого надо использовать специальные платформы, которые ​изменения пользователей транслируют в реальном времени всем участникам. В скайпе,​ например,​ есть такие приложения (плагиныдля совместной ​правки документов и рисования картинок. Реально несколько курсоров одновременно работают. ==== Оформление текста с помощью ​заметок ​и «боксов» ==== Любой ​текст (заметку,​ цитату) на странице можно красиво выделить. Например вот так: <​note>​ Самый простой вариант </​note>​ ''<​note>​ Самый простой вариант </​note>''​ +Внутри любого простанства имён могут одновременно ​существовать как страницатак и вложенное ​пространство ​имён с тем ​же самым именем.  
-<note tip>​Это текст заметки</​note> ​''​<note tip>​Это текст заметки</​note>​  +Возвращаясь к предыдущему примеру, можно изобразить страницу с именем ''​a:b''​ следующим образом:
-<note important>​ Или вот такой текст</​note> ​''​<note important>​ Или вот такой текст</​note>​  +
-Или вывести текст предупреждения: <note warning>​Никогда,​ **никогда не используйте** ​ программу **MS Notepad** ((5)))</​sup>​ для редактирования файлов в **UTF-8** ​ кодировке!</​note>​ ''<​note warning>​Никогда, **никогда не используйте** ​ программу **MS Notepad** <​sup>​((6))) для редактирования файлов в **UTF-8** ​ кодировке!</​note>​  +
-Также можно выделить текст с помощью "​бокса"​<​box>​Данный плагин позволяет оформлять «боксы» в самых различных цветовых комбинациях. </​box>​ ''<​box>​Такой код вставляется для простого бокса</​box>​  +
-<box 80% round orange|Заголовок>​ таких</​box>​ ''<​box 80% round orange|Заголовок>​ таких</​box>​  +
-<box 50% left blue>​вот таких синеньких пятидесятипроцентных с "​подвалом"</​box|Подвал>​ \\  \\  \\ ''<​box 50% left blue>​вот таких синеньких пятидесятипроцентных с __''​GESHI_QUOT__подвалом__ GESHI_QUOT__</​box|Подвал>​  +
-<box 60% round #f99 #fc9 #fcc #​f60|Заголовок>​или даже вот таких</​box|Подвал>​+
  
 +<​file>​
 +
 +   ​корневое пространство имён (всегда существует)
 +     |
 +     +-- пространство имён '​a'​
 +           |
 +           +-- пространство имён '​b'​
 +           ​| ​    |
 +           ​| ​    +-- страница '​c'​
 +           |
 +           +-- страница '​b'​ pagename (не смотря на существование пространства имён '​b'​)
 +
 +</​file>​
 +
 +Это не приводит к конфликтам,​ поскольку DokuWiki всегда считает последнюю лексему в имени страницы (часть имени после последнего двоеточния) как собственно имя страницы,​ а все остальные лексемы − как названия пространств имён
 +
 +  * В записи ''​a:​b:​c'',​ ''​a''​ и ''​b''​ − названия пространства имён, а ''​c''​ − имя страницы.
 +  * В записи ''​a:​b'',​ ''​a''​ − название пространства имён, а ''​b''​ − имя страницы.
 +
 +==== Какими внешними редакторами рекомендуется пользоваться?​ ====
 +
 +:!: **Внимание! Никогда не используйте** программу **MS Notepad**((он же Блокнот)) для редактирования файлов в **UTF-8** кодировке!
 +
 +Эта программа вставляет тройку символов в самое начало файла (EF BB BF), по которым определяет,​ что это UTF-8 кодировка,​ что иногда приводит к сбоям в PHP скриптах и порче разметки сайтов.
 +
 +Конечно,​ эти символы не есть личная придумка Microsoft - это один из способов отмечать UTF-8 документы. Но MS Notepad **не умеет** сохранять документы **без** этого **префикса**.
 +
 +Используйте правильные редакторы,​ например Notepad++ (Опция «Кодировать в UTF-8 без BOM»), или встроенные в FAR, либо в Total Comander. ​
 +
 +==== Удаление страниц ====
 +
 +Если при редактировании страницы удалите всё её содержимое,​ то соответствующая страница будет также удалена (однако будет доступна в "​истории изменений"​).
 +
 +==== Как удалить символы,​ которые вставляются при редактировании файла в его начало?​ ====
 +
 +Такая ситуация происходит при редактировании плагином к Total Commandery (SynPlus). Потом нормальные редакторы (NotePad++) их не видят.
 +
 +Решение:​ открыть текстовый файл в любом шестнадцатиричном редакторе (hex-редактор) и удалить первые три символа. Для этого можно использовать встроенный редактор из FAR Manager.
 +
 +==== Можно ли нескольким пользователям одновременно редактировать разные секции одной и той же страницы?​ ====
 +
 +В DokiWiki данные хранятся в обычных файлах (одна страница - один файл). Поэтому блокировки происходят на уровне файлов,​ а не на уровне отдельных разделов файла, как это сделано,​ например в MediaWiki, которые хранят свой текст в базе данных.
 +
 +Совместную (в смысле одновременную) работу в DokuWiki организовать не получится. Для этого надо использовать специальные платформы,​ которые изменения пользователей транслируют в реальном времени всем участникам. В скайпе,​ например,​ есть такие приложения (плагины) для совместной правки документов и рисования картинок. Реально несколько курсоров одновременно работают.
 +
 +==== Оформление текста с помощью заметок и "​боксов"​ ====
 +
 +Любой текст (заметку,​ цитату) на странице можно красиво выделить. Например вот так:
 +
 +<​note>​ Самый простой вариант </​note> ​
 +
 +<​code><​note>​ Самый простой вариант </​note></​code>​
 +
 +<note tip>​Это текст заметки</​note>​
 +
 +<​code><​note tip>​Это текст заметки</​note></​code>​
 +
 +<note important>​ Или вот такой текст</​note>​
 +
 +<​code><​note important>​ Или вот такой текст</​note></​code> ​
 +
 +Или вывести текст предупреждения:​
 +
 +<note warning>​Никогда,​ **никогда не используйте** программу **MS Notepad**((он же Блокнот)) для редактирования файлов в **UTF-8** кодировке!</​note>​
 +
 +<​code><​note warning>​Никогда,​ **никогда не используйте** программу **MS Notepad**((он же Блокнот)) для редактирования файлов в **UTF-8** кодировке!</​note></​code>​
 +
 +Также можно выделить текст с помощью "​бокса":​
 +
 +<​box>​Данный плагин позволяет оформлять «боксы» в самых различных цветовых комбинациях. </​box>​
 +
 +<​code><​box>​Такой код вставляется для простого бокса</​box></​code>​
 +
 +<box 80% round orange|Заголовок>​ таких</​box>​
 +
 +<​code><​box 80% round orange|Заголовок>​ таких</​box></​code>​
 +
 +<box 50% left blue>​вот таких синеньких пятидесятипроцентных с "​подвалом"</​box|Подвал>​\\
 +
 +\\
 +\\
 +<​code><​box 50% left blue>​вот таких синеньких пятидесятипроцентных с "​подвалом"</​box|Подвал></​code>​
  
-<​code>​ 
 <box 60% round #f99 #fc9 #fcc #​f60|Заголовок>​или даже вот таких</​box|Подвал>​ <box 60% round #f99 #fc9 #fcc #​f60|Заголовок>​или даже вот таких</​box|Подвал>​
-</​code>​ 
  
 +<​code><​box 60% round #f99 #fc9 #fcc #​f60|Заголовок>​или даже вот таких</​box|Подвал></​code>​
 +
 +==== Выделение текста цветом ====
 +
 +
 +Плагин **color** позволяют выделять и раскрашивать сам текст:
 +
 +<color blue>​использовать</​color>​ <color blue/​lightblue>​цветной</​color>​ <color red/​lightgrey>​текст</​color>​ - http://​www.dokuwiki.org/​plugin:​color
 +
 +<​code><​color blue>​использовать</​color></​code>​
 +<​code><​color blue/​lightblue>​цветной</​color></​code>​
 +<​code><​color red/​lightgrey>​текст</​color></​code>​
 +
 +
 +===== Проблемы =====
  
-==== Выделение текста цветом ==== Плагин **color** ​ позволяют выделять и раскрашивать сам текст: <color blue>​использовать</​color>​ <color blue/​lightblue>​цветной</​color>​ <color red/​lightgrey>​текст</​color>​ - [[http://​www.dokuwiki.org/​plugin:​color|http://​www.dokuwiki.org/​plugin:​color]] 
  
 +==== Периодически при создании страницы появляется ошибка Writing /​var/​www/​html/​dokuwiki/​data/​meta/​%D1%81%D1%81%.meta failed ====
  
-<​code>​ +Ошибка ​сохранения файла. обратитесь к администратору ресурса.
-<color blue>использовать</​color>​ +
-</​code>​+
  
 +==== Не могу создать страницу с длинным названием (более 47 символов) ====
  
-<​code>​ +Скорее всего это из-за того, что у вас используется прямая запись имен страниц (без транслитерации). В таком случае на каждую букву кириллицы в URL добавляется шесть знаков (например %D1%81 - это одна буква). А имя файла не может быть длиннее 256 символов. Итого получается в самом худшем случае 42 символа. И операционка не может создать нужный файл, что приводит к ошибке.
-<color blue/​lightblue>​цветной</​color>​ +
-</​code>​+
  
 +Для исправления надо в настройках DokuWiki установить опцию - «Использовать полную транслитерацию в именах страниц».
  
-<​code>​ +==== Как сделать, чтобы в навигации статья отображалась не в виде «транслитерации»,​ а с русским названием?​ ====
-<color red/​lightgrey>​текст</​color>​ +
-</​code>​+
  
 +Если вы хотите,​ чтобы в навигационной строке отображалось: ​
  
 +**//Вы посетили:​ » Инсталляция DokuWiki//​**
  
 +вместо:​
  
- ​__ ​+**//Вы посетили:​ » Instaliacia DokuWiki//​**
  
 +Для этого в тексте страницы должен быть использован хоть один заголовок первого уровня. Если такого заголовка нет, то DokuWiki подставляет исходное (транслитерированное) название страницы.
  
-   __+==== Если хочется знать больше ====
  
 +Узнать больше о особенностях работы с **DokuWiki** можно на [[http://​www.dokuwiki.ru|русской сайте DokuWiki]] или у [[http://​www.dokuwiki.org/​dokuwiki|отцов-основателей]]

Свои инструменты