ДиксониЯ:

О Карском Граде и Его Горожанах

Инструменты пользователя

Инструменты сайта


диксония.wiki:руководства
Untitled

«ДиксониЯ:»

Начата 3 мая 2011 года в рамках социальной сети «Одноклассники», как группа «Диксонский Хронограф».

С 7 января 2014 года является свободно редактируемой wiki, принять участие в которой может любой зарегистрировавшийся в проекте пользователь Интернета.

Соавтору

Вики «ДиксóниЯ:» не является энциклопедией и потому её страницы открыты для публикаций в любых формах, стилях и размерах, способных удовлетворить разносторонний интерес в познании региональной истории и современности, стремящихся к объективности и достоверности повествования, через обнародование полной хронологии диксонских событий, их аналитику и биографий участников.

Авторский коллектив вики «ДиксóниЯ:» с благодарностью будет сотрудничать со всеми, кто неравнодушен к тематике данного проекта и готов способствовать его развитию, ведь каждый из нас, живших или бывавших на Диксоне, является частичкой его истории и лично причастен к некоторым событиям или может свидетельствовать о людях, принимавших в них участие. Имя или событие, вписанное Вами в это повествование, есть дань памяти и уважения жившим до нас и вместе с нами, солидарность с живущими ныне там.

Наш партнёр - сайт Диксон - остров, поселок и порт. С благословения Александра Алфеева мы можем свободно использовать материалы с этого ресурса в нашей вики.

Прежде чем стать соавтором вики «ДиксóниЯ:» внимательно изучите данное Руководство, которое мы также пишем «всем миром». Все Ваши претензии, вопросы и предложения с нетерпением ждут по адресу E-mail: dikson-khrono@yandex.ru.

Если не указано другое, то все материалы в нашей вики доступны по лицензии Creative Commons Attribution — ShareAlike (CC BY-SA) «С указанием авторства — С сохранением условий». Эта лицензия позволяет другим перерабатывать, исправлять и развивать произведение даже в коммерческих целях при условии указания авторства и лицензирования производных работ на аналогичных условиях. Эта лицензия является копилефт-лицензией. Все новые произведения, основанные на лицензированном под нею, будут иметь аналогичную лицензию, поэтому все производные будет разрешено изменять и использовать в коммерческих целях.

Руководство

Наш проект основан на CMS «DokuWiki» (Докувики) — совместимой со стандартами и лёгкой в использовании вики, предназначенной для создания разного рода баз данных, в которых все данные хранятся в простых текстовых файлах, а простой, но мощный синтаксис облегчает создание структурированных текстов и позволяет при необходимости читать файлы данных даже за пределами вики.

Как устроена страница

Каждая страница нашей вики включает стандартный набор «кнопочек» необходимых для Вашей успешной работы в проекте. Давайте разберёмся, что же это за кнопки.

Кнопки

  • В левом верхнем углу расположены логотип и название нашей вики, являющиеся ссылкой на первую страницу проекта - «Диксон, городское поселение». Справа от них находится кнопка «Войти», которая позволит Вам авторизоваться, после чего рядом с ней появится информация о пользователе вошедшем в систему.
  • Под ними расположилось окно функции внутреннего «Поиска». Тут всё просто - поиск по всей вики, а ещё ниже —
  • «Последние изменения» — это одна из самых важных функций вики. Нажав эту кнопку, Вы сможете увидеть список страниц, которые были недавно отредактированы, а также просмотреть все изменения и узнать, каковы отличия от предыдущих версий страницы.
  • «Управление медиафайлами» — позволяет загружать и использовать различные медиафайлы.
  • «Все страницы» — позволяет увидеть перечень всех страниц и пространств имён.
  • Далее под кнопочками расположена ещё одна линия, начинающаяся со слов: «Вы посетили:». После этого идёт список страниц, которые Вы недавно посетили.

Контент

Контент (англ. content — содержание) - это главная часть всей страницы, составляющая её информационное наполнение (текст, картинки, видеоролики и т.д.). Это та часть, где обрабатывается и показывается исходный код вики. «DokuWiki» предоставляет полную свободу нашей фантазии при оформлении страниц благодаря возможности использования HTML и PHP. Смотрите «Страница» для более детальной информации.

Правое меню

  • «Править страницу» — само собой разумеется, Вы можете править любую страницу в этой вики. Ведь это и является предназначением вcех вики в общем-то.
  • «История страницы» — когда кто-либо редактирует страницу, «DokuWiki» сохраняет старые версии страниц.
  • «Вернуться наверх» — ярлык, который позволит Вам вернутся наверх страницы, если она, например, слишком длинная;
  • «Ссылки сюда» —

Подвал

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

Пространство имён

В вики «ДиксóниЯ:», для упорядочивания Ваших статей и медиафайлов, следует использовать «пространства имён» или «именованные пространства».

Создание

Для создания пространства имён не нужно предпринимать каких-то специальных действий, просто используйте двоеточие «:» в наименовании файла. Часть названия после последнего двоеточия станет именем файла, а всё, что находится «до», станет именным пространством (последовательностью вложенных директорий). Если такого именного пространства ещё нет, оно создастся автоматически.

Например: запись летопись:календарь:январь означает, что статья Январь «приписана» к пространству имён Календарь относящемуся в свою очередь к пространству имён Летопись.

Удаление

Если все статьи внутри пространства имён удалены, это пространство имён логически перестаёт существовать. «DokuWiki» обычно удаляет соответствующую ему пустую директорию.

Страница

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

Создание

В вики «ДиксóниЯ:» страницы создаются так же, как в любой другой вики. Просто создайте ссылку на несуществующую страницу, перейдите по этой ссылке и щёлкните кнопку «Создать страницу». Это самый простой способ и мы рекомендуем использовать именно его. Он гарантирует, что все наши статьи будут правильно связаны друг с другом и при этом не возникнут «страницы-сироты», то есть статьи, на которые не ссылаются никакие другие источники внутри нашей вики.

Название файла необязательно должно быть идентичным названию статьи, но обязательно должно быть однозначным. Например: название файла - Диксонская обсерватория, а название статьи - «Диксон», гидрометеорологическая обсерватория первого разряда.

Существует также альтернативный способ: Вы можете ввести имя новой статьи в поле поиска, щёлкнуть кнопку «Поиск» и затем на открывшейся странице результатов поиска выбрать «Создать эту статью». Новая статья будет названа в соответствии с вашим запросом.

Если Вы используете альтернативный метод, проверьте правильность ссылок на вновь созданную статью из других статей.

Создание или редактирование статей требует, что бы у Вас были достаточные для этого права.

Удаление

Если Вы удалите весь текст и сохраните пустую страницу, «DokuWiki» удалит её и связанное с ней Имя статьи, но старые версии страницы останутся.

Редактирование

Редактирование заключается ни в чём ином, как во введении Вашего текста в окне редактирования и добавлении разметки для улучшения вида. Окно Редактора открывается нажатием кнопки «Править страницу» (если только это не вновь созданная статья).

Если Вы столкнулись с сообщением «Страница заблокирована», то помните, что в каждый момент времени редактирование статьи может производиться только одним человеком.

В процессе редактирования Вам может помочь функция Просмотра. Она позволяет взглянуть на итоговый вид статьи перед её сохранением.

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

В наименовании биографических статей в «ДиксóниЯ.Вики» следует придерживаться формата Фамилия Имя Отчество для русских имён, а для иностранных в зависимости от того, как это принято в большинстве авторитетных источников (например, в Википедии). Далее в тексте по воле автора.

В названии статьи и при первом упоминании в тексте иностранные имена собственные (имя человека, название судна и т.п.) следует писать латиницей с указанием в скобках русскоязычного варианта. Далее в тексте по воле автора.

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

Текст

  • Размер.

размер шрифта

[size=80%]размер[/size] [size=150%]шрифта[/size]
  • Цвет.

Можно изменить цвет шрифта

[color=blue]Можно изменить[/color] [color="#FF0000"]цвет шрифта[/color]

а также выделить цветом текст целиком: <hi red>красный</hi> или <hi lightblue>голубой</hi>.

<hi red>красный</hi> или <hi lightblue>голубой</hi>.

Может использоваться большое количество различных названий цветов или их кодов: Таблица html кодов цвета.

  • Индекс - подстрочный и надстрочный.
Индексы - <sub>подстрочный</sub> и <sup>надстрочный</sup>.
  • Абзац отбиваются пустой строкой. Если нужно принудительно вставить перенос строки, не создавая абзац, вставьте два обратных слэша и за ним пробел или переход к новой строке.

Просто текст с разрывом строк
Обратите внимание, что два обратных слэша действуют только в конце строки
или если за ними стоит
пробел. Если его не поставить, \\получится вот так.

Просто текст с разрывом строк\\ Обратите внимание,
что два обратных слэша действуют только в конце строки\\
или если за ними стоит\\ пробел. Если его не поставить, \\получится вот так.

Принудительные переносы следует использовать только в случае крайней необходимости.

  • Сноска. С помощью двойных скобок можно добавить сноску1).
С помощью двойных скобок можно добавить сноску((Сноска —
помещаемые внизу страницы примечание, ссылка, перевод.)).
  • Цитата

:

этот код выделяет цитируемый текст
[quote]этот код выделяет цитируемый текст[/quote]

или используя «галочки» можно создать ветку:

Я думаю, мы должны это сделать.
> Нет, мы не должны.
>> Ну, я говорю, что мы должны.
> Действительно?
>> Да!
>>> Тогда сделаем это!

Я думаю, мы должны это сделать.

Нет, мы не должны.
Ну, я говорю, что мы должны.

Действительно?

Да!
Тогда сделаем это!
  • Служебные записки. Можно оставлять служебные записки в исходном коде вики-страницы для себя и других Авторов, невидимые обычному читателю.

Пример:

Текст виден только при редактировании страницы

Текст /*  между слешем и звёздочкой */  виден только при редактировании страницы 

Можно оставлять многострочные заметки:

   /**
   * каждая 
   * новая
   * строка
   * начинается
   * со звёздочки
   */

Или так:

    /********** Текст Вашей заметки **********/
  • Диаграммы.

На страницах Вики вы можете размещать диаграммы.

Папа Мама
Сестра Я Брат

Подробнее: http://nikita.melnichenko.name/projects/dokuwiki-diagram/

Ссылки

  • Внешние ссылки распознаются автоматически: http://dikson21.narod.ru/index.html, также можно указывать текст ссылки:

Диксон - остров, поселок и порт. Адреса электронной почты тоже распознаются: <admin@диксония.рф>.

Внешние ссылки распознаются автоматически: http://dikson21.narod.ru/index.html, также можно указывать текст ссылки:
[[http://dikson21.narod.ru/index.html|Диксон - остров, поселок и порт]]. Адреса электронной почты
тоже распознаются: <admin@диксония.рф>.
  • Внутренние ссылки имеют такой же исходный код:
Можно либо просто указать [[имя страницы]], 
либо дополнительно прописать [[имя страницы|текст ссылки (название)]]. 

Можно использовать в ссылке пространства имён через двоеточие и ставить ссылки на определённый раздел через решётку (#).

  • Картинки-ссылки. Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:
[[http://www.php.net/|{{wiki:dokuwiki-128.png}}]]

Медиафайлы

  • Картинки. Редактор «DokuWiki» автоматически предложит Вам несколько вариантов загрузки картинки на страницу (размер, расположение на странице и относительно текста, отношение к ссылкам).

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

Пример:

  [{{:wiki:dokuwiki-128.png?128x128 |**Dokuwiki**}}] 

Создать фото-галерею пространства имён можно с помощью команды:

 {{gallery>пространство имён}}

Все графические файлы в выбранном пространстве имен будут добавлены в фотогалерею, но не забывайте ставить двоеточие ”:” перед названиями файлов!

Вместо того, чтобы использовать все изображения пространства имен, Вы можете указать избранные изображения:

 {{gallery>пространство имён:имя файла.jpg}}

Созданную галерею можно выровнять относительно текста с помощью пробелов (по умолчанию : центрировано):

 {{ gallery> имя файла или пространства}} (по правому краю) - пробел перед именем файла
 {{gallery>имя файла или пространства }} (выравнивание по левому краю) - пробел после имени файла
 {{ gallery> имя файла или пространства }} (выравнивание по центру) - двусторонний пробел

Вместо имени загруженного в нашу вики файла, Вы можете указать сторонний URL-адрес:

{{gallery>http://www.23hq.com/rss/schabloni}}
  • Видео. Вы можете разместить на странице любой видеоролик. В панели инструментов Редактора есть кнопка, позволяющая вставлять видео с помощью его URL-адреса. Плагин сам выполнит все необходимые настройки по умолчанию.

Можно редактировать уже опубликованные медиафайлы внося изменения в их исходный код:

 
{{Адрес?Размер|Название}} 

Адрес - URL или внутренний адрес файла, Размер - если размер не указан, то вики использует базовые настройки, но при желании Вы можете либо задать его в числовом виде (500 х 300) или использовать ключевые слова : малый (small), средний (medium) или большой (large). Название является необязательным.

Расположение всех медиафайлов на странице осуществляется аналогично процедуре приведённой в описании галереи.

Таблицы

«Dokuwiki» поддерживает упрощённый синтаксис создания таблиц.

Заголовок 1 Заголовок 2 Заголовок 3
Ряд 1 Колонка 1 Ряд 1 Колонка 2 Ряд 1 Колонка 3
Ряд 2 Колонка 1 Объединение колонок (обратите внимание на двойную вертикальную черту)
Ряд 3 Колонка 1 Ряд 2 Колонка 2 Ряд 2 Колонка 3

Нормальные ряды должны начинаться и заканчиваться вертикальной чертой — |, а заголовки «крышечкой» — ^.

^ Заголовок 1      ^ Заголовок 2         ^ Заголовок 3            ^
| Ряд 1 Колонка 1  | Ряд 1 Колонка 2     | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1  | Объединение колонок (обратите внимание на двойную вертикальную черту)  ||
| Ряд 3 Колонка 1  | Ряд 2 Колонка 2     | Ряд 2 Колонка 3        |

Чтобы объединить две соседние клетки в ряду, просто оставьте соседнюю клетку полностью пустой, как показано выше. Следите, чтобы количество разделителей клеток было одинаковым.

Вертикальные заголовки тоже можно сделать:

Заголовок 1 Заголовок 2
Заголовок 3 Ряд 1 Колонка 2 Ряд 1 Колонка 3
Заголовок 4 Объединения нет
Заголовок 5 Ряд 2 Колонка 2 Ряд 2 Колонка 3

Как легко увидеть, разделитель, стоящий перед клеткой, определяет форматирование:

|              ^ Заголовок 1       ^ Заголовок 2      ^
^ Заголовок 3  | Ряд 1 Колонка 2   | Ряд 1 Колонка 3  |
^ Заголовок 4  | Объединения нет   |                  |
^ Заголовок 5  | Ряд 2 Колонка 2   | Ряд 2 Колонка 3  |

Можно сделать вертикально объединённые ячейки добавлением трёх двоеточий ::: в объединяемые нижележащие ячейки.

Заголовок 1 Заголовок 2 Заголовок 3
Ряд 1 Колонка 1 эта ячейка объединена вертикально Ряд 1 Колонка 3
Ряд 2 Колонка 1 Ряд 2 Колонка 3
Ряд 3 Колонка 1 Ряд 2 Колонка 3

В этих ячейках не должно быть ничего, кроме синтаксиса объединения (:::).

^ Заголовок 1        ^ Заголовок 2                       ^ Заголовок 3            ^
| Ряд 1 Колонка 1    | эта ячейка объединена вертикально | Ряд 1 Колонка 3        |
| Ряд 2 Колонка 1    | :::                               | Ряд 2 Колонка 3        |
| Ряд 3 Колонка 1    | :::                               | Ряд 2 Колонка 3        |

Текст клетки таблицы можно выравнивать. Просто добавьте минимум два пробела с противоположной стороны: слева — если надо выравнять вправо, справа — если надо выравнять влево, и по два с каждой стороны — если по центру.

Таблица с выравниванием
вправо по центру влево
влево вправо по центру
xxxxxxxxxxxx xxxxxxxxxxxx xxxxxxxxxxxx
^           Таблица с выравниванием        ^^^
|        вправо|   по центру  |влево         |
|влево         |        вправо|   по центру  |
| xxxxxxxxxxxx | xxxxxxxxxxxx | xxxxxxxxxxxx |

Примечание: вертикальное выравнивание не поддерживается.

Форматируемые блоки

  • Колонки. Для создания колонок нужно указать тэг «колонки [параметры]», например, «колонки 100% 25% 25% 50%», где первый показатель - 100% - процент занимаемой всеми колонками ширины страницы, по 25% и 50% - процент ширины каждой колонки, то есть две по четверти и одна - половина ширины от данных нами 100%. Вместо указания процентов можно использовать прочерк, ширина колонки будет подобрана системой зависимо от степени наполнения. Также не обойтись без тэгов «новаяколонка» и закрывающего тэга «/колонки».

По умолчанию текст в колонках выравнивается по левому краю. Чтобы изменить способ выравнивания, следует ставить звёздочку с определённой стороны показателя.

  Пример: <колонки 100% 25% *-* *- > Это просто текст в выравниванием по левой стороне. В этом         
 случае звёздочка не нужна. <новаяколонка> А здесь текст выровнен по центру! <новаяколонка>  
 Такой же бесполезный текст, как и два предыдущих, но с выравниванием по правой стороне. 
 </колонки>

Пример:

Это просто текст в выравниванием по левой стороне. В этом случае звёздочка не нужна.

А здесь текст выровнен по центру!

Такой же бесполезный текст, как и два предыдущих, но с выравниванием по правой стороне.

  • Объявления. Можно выделять заметки, объявления, предупреждения, примечания и т.п.. Вики-синтаксис разрешён.

Если меняется название раздела, ссылки на него не меняются автоматически.

<note>
Если меняется название раздела, ссылки на него не меняются автоматически.
 </note>

Перед Вами заготовка статьи. Вы можете помочь проекту, дополнив её текстовыми, фото и видео материалами или написав полноценную статью.

<note important>
**Перед Вами [size=150%]заготовка[/size] статьи. Вы можете помочь проекту, дополнив её текстовыми, 
    фото и видео материалами или написав полноценную статью.**
  </note>

Например: запись летопись:календарь:январь означает, что статья Январь «приписана» к пространству имён Календарь относящемуся в свою очередь к пространству имён Летопись.

<note tip>
Например: запись летопись:календарь:январь означает, что статья Январь «приписана» 
к пространству имён Календарь относящемуся в свою очередь к пространству имён Летопись. 
</note>

Если Вы столкнулись с сообщением «Страница заблокирована», то помните, что в каждый момент времени редактирование статьи может производиться только одним человеком.

<note warning>
Если Вы столкнулись с сообщением «Страница заблокирована», то помните, что в каждый 
момент времени редактирование статьи может производиться только одним человеком.
 </note>
  • Бокс. Можно оформить часть текста в виде боксов: обычных прямоугольных, с закруглёнными углами, с титулами и разной ширины. Боксы поддерживают вики-разметку.
Ваш текст
<box> Ваш текст </box>

Название

Ваш текст
 <box 30% blue|Название> Ваш текст </box>
Ваш текст

Подпись или ссылка

 <box 60% round green> Ваш текст </box|Подпись или ссылка>
 

Название

Ваш текст

Подпись или ссылка

<box 100% round red|Название> Ваш текст </box|Подпись или ссылка>

А теперь разберём настройки подробнее:

<box 100% (ширина) round (закруглённые углы) red (цвет)|Название> Ваш текст </box|Подпись или ссылка>
  • 100% — ширина бокса указывается в процентах относительно страницы.
  • round — закруглённые углы. По умолчанию используется стандартный прямоугольный бокс.

Цвет (если код цвета не указан, то используется стандартный по умолчанию)

  • blue — голубой
  • red — красный
  • green — зеленый
  • orange — оранжевый

Расположение бокса на странице (по умолчанию в центре):

  • left — слева
  • right — справа

Важно помнить, что открывающий тег <box … > и все последующие коды, включая название, должны находиться на одной линии.

Неформатируемые блоки

Неформатируемые блоки можно вставлять в документ, либо начиная каждую строчку блока с двух или более пробелов (как это делалось в некоторых предыдущих примерах), либо используя тэги <code> или <file>.

Это неформатированный текст, в котором сохранены все пробелы: вот             <- так.
В принципе то же самое, но этим выделением можно показать, что цитируется содержимое файла.

Чтобы парсер полностью проигнорировал некий текст (т. е. не форматировал его), либо заключите его в тэги nowiki, либо ещё проще — в двойные знаки процента %%.

Это просто текст, в котором есть адрес http://www.splitbrain.org/ и **форматирование** — но ничего не происходит.

Это просто текст, в котором есть адрес %%http://www.splitbrain.org/%%
и %%**форматирование**%% --- но ничего не происходит.

Скачиваемые блоки кода

Используя тэги <code> или <file>, как показано выше, вы можете сделать отображаемый код доступным для загрузки. Для этого определите имя файла после кода языка вот так:

<file php myexample.php>
<?php echo "hello world!"; ?>
</file>
myexample.php
<?php echo "hello world!"; ?>

Если вам не нужна подсветка, но нужен загружаемый файл, поставьте прочерк (-) на месте кода языка: <code - myfile.foo>.

Особенность: при написании имени файла на русском языке для формирования корректного имени файла обрамляйте название файла двойными кавычками например «Фоо Бар.php».

"Фоо Бар.php"
<?php echo "hello world!"; ?>

Вставка HTML и PHP

Чистый HTML- или PHP-код можно вставлять в документ с помощью тэгов html 2) и php:

<html>
Тут вставлен <font color="red" size="+1">HTML-код</font>
</html>

Тут вставлен HTML-код

<php>
echo 'Логотип, сгенерированный PHP:';
echo '<img src="' . $_SERVER['PHP_SELF'] . '?=' . php_logo_guid() . '" alt="Логотип PHP!" />';
</php>

Логотип, сгенерированный PHP:Логотип PHP!

1) Сноска — помещаемые внизу страницы примечание, ссылка, перевод.
2) html — для строчного кода; HTML — для блочного кода
Только авторизованные участники могут оставлять комментарии.
диксония.wiki/руководства.txt · Последние изменения: 09:29 17.10.2014 — murtazaj