Для работы на Путеводителе Вы должны быть авторизованы.

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

Внимание!
Ваши страницы и правки проходят модерацию. Потенциально опасный код JavaScript, HTML, PHP и т.д. удаляется автоматически. Спам не имеет смысла - у ссылок аттрибут rel="nofollow". Для тестирования чего-либо используйте песочницу (откроется в новом окне) и нажмите в ней Править.

Создание страницы

Создать новую страницу можно несколькими способами:

  • Отредактировать подходящую уже существующую страницу, вставив ссылку на новую страницу. После сохранения страницы появится ссылка красного цвета, пройдя по которой нужно нажать на кнопку «Создать страницу»1).
  • Ввести имя новой страницы в поле Искать на Путеводителе (внизу страницы), в результатах поиска нажать на кнопку «Создать страницу»2)

Основные Правила

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

  • Старайтесь форматировать текст различными элементами списков, разделителями и т.п., закачивайте и размещайте изображения и обязательно их называйте и помещайте в рамку по этому примеру:
[{{:адрес картинки|текст|текст}}]
  • При копировании текстов с других сайтов, следует заменять некоторые слова на синонимы, чтобы уменьшить возможность конфликта с поисковыми системами на предмет копирования текстов.
  • Как можно чаще используйте функцию внутренних ссылок на панели инструментов, для создания системы ссылок ведущих с вашей страницы на соответствующие страницы Апельсин.Путеводителя и обратно.
  • Почаще используйте полужирный шрифт -В- и курсив -I-
  • Путеводитель также поддерживает bbcode разметку, часто используемую на форумах.
  • Четко следуйте инструкциям использования заголовков H1, H2, H3, H4, H5, описанным ниже.

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


В заголовке страницы нужно использовать функцию H1 на панели инструментов. H1 разрешается использовать только один раз:

====== страна, город или отель в H1 ====== 
текст...

страна, город или отель в H1

текст…


Это примеры использования функций H2, H3, H4, H5. Количество заголовков 2,3,4,5 должно быть в разумных пределах:

===== дополнительная информация в H2 =====
текст...

==== дополнительная информация в H3 ====
текст...

=== дополнительная информация в H4 ===
текст...

== дополнительная информация в H5 ==
текст...

дополнительная информация в H2

текст…

дополнительная информация в H3

текст…

дополнительная информация в H4

текст…

дополнительная информация в H5

текст…

Конструкции форматирования

Путеводитель поддерживает выделение текста жирным шрифтом, курсивом, подчеркнутый текст и вывод текста моноширинным шрифтом. Все эти конструкции можно объединить.

Путеводитель поддерживает выделение текста **жирным шрифтом**, //курсивом//, 
__подчеркнутый текст__ и вывод текста ''моноширинным шрифтом''. 
Все эти конструкции можно **__//''объединить''//__**.

Также можно использовать подстрочный и надстрочный индексы.

Также можно использовать <sub>подстрочный</sub> и <sup>надстрочный</sup> индексы.

Ещё можно зачеркнуть текст.

Ещё можно <del>зачеркнуть текст</del>.

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

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

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

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

Почаще используйте такие формы объявлений:

<note>
текст
</note>

<note important>
текст
</note>

<note tip>
текст
</note>

<note warning>
текст
</note>

Ссылки

Ссылки в Апельсин.Путеводителе бывают разные, и создавать их можно тоже по-разному.

Внешние

Внешние ссылки распознаются автоматически: http://www.google.com или просто www.google.com — также можно указывать текст ссылки: Это ссылка на Google. Адреса электронной почты тоже распознаются: andi@splitbrain.org.

Внешние ссылки распознаются автоматически: http://www.google.com или
просто www.google.com --- также можно указывать текст ссылки:
[[http://www.google.com|Это ссылка на Google]]. Адреса электронной почты
тоже распознаются: <andi@splitbrain.org>.

Внутренние

Внутренние ссылки создаются посредством квадратных скобок. Можно либо просто указать Имя Страницы, либо дополнительно прописать Текст ссылки. Имена Wiki-страниц автоматически переводятся в нижний регистр, спецсимволы использовать нельзя.

Внутренние ссылки создаются посредством квадратных скобок.
Можно либо просто указать [[ИмяСтраницы]], либо дополнительно прописать
[[ИмяСтраницы|Текст ссылки]]. Имена Wiki-страниц автоматически 
переводятся в нижний регистр, спецсимволы использовать нельзя.

Можно использовать в ссылке пространства имён через двоеточие.

Можно использовать в ссылке [[ru:namespaces|пространство имён]] через двоеточие.

Ставить ссылки на определённый раздел тоже можно. Просто добавьте через решётку имя раздела. Ссылка на этот раздел.

Ссылка на [[syntax#внутренние|этот раздел]].

Примечания:

  • Ссылки на существующие страницы отображаются иначе, чем ссылки на несуществующие
  • Апельсин.Путеводитель по умолчанию не использует CamelCase для автоматического создания ссылок, но эту возможность можно включить в файле wiki:config. Проверка: Если Апельсин.Путеводитель — ссылка, значит эта возможность включена.
  • Если меняется название раздела, ссылки на него не меняются автоматически. Так что не очень полагайтесь на ссылки на разделы.

Картинки-ссылки

Совместив синтаксис ссылки и картинки, можно вставить в текст картинку, которая будет внутренней или внешней ссылкой:

[[http://www.php.net|{{wiki:dokuwiki-128.png}}]]

Учтите: форматирование картинок это единственная синтаксическая конструкция, которую можно использовать в тексте ссылки.

Сноски

С помощью двойных скобок можно добавить сноску3).

С помощью двойных скобок можно добавить сноску ((Это сноска)).

Картинки и другие файлы

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

Обязательно называйте изображения и помещайте в рамку по этому примеру:

Название картинки
[{{:адрес картинки|текст|текст}}]

Файлы

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

С помощью фигурных скобок можно вставлять в текст внешние и внутренние картинки. По желанию можно указать их размер.

Нормальный размер:

Отмасштабированная до заданной ширины:

Отмасштабированная до заданных размеров:

Отмасштабированная внешняя картинка:

Нормальный размер: {{wiki:dokuwiki-128.png}}
Отмасштабированная до заданной ширины: {{wiki:dokuwiki-128.png?50}}
Отмасштабированная до заданных размеров: {{wiki:dokuwiki-128.png?200x50}}
Отмасштабированная внешняя картинка: {{http://de3.php.net/images/php.gif?200x50}}

Поставив слева или справа пробел можно задать выравнивание картинки:

{{wiki:dokuwiki-128.png }}
{{ wiki:dokuwiki-128.png}}
{{ wiki:dokuwiki-128.png }}

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

Название картинки

{{ wiki:dokuwiki-128.png |Название картинки}}

Узнать, как вставить картинку со ссылкой можно в разделе выше.

Списки

Апельсин.Путеводитель поддерживает нумерованные и ненумерованные списки. Чтобы создать элемент списка, поставьте в начале строки два пробела и потом * в случае ненумерованного списка, или - в случае нумерованного.

  • Это список
    • Второй элемент списка
      • Можно сделать вложенный список
    • Ещё один элемент
  1. Тот же список, только нумерованный
  2. Ещё элемент
    1. Чем больше пробелов в начале, тем глубже вложенность
  3. Всё просто
  * Это список
    * Второй элемент списка
      * Можно сделать вложенный список
    * Ещё один элемент

  - Тот же список, только нумерованный
  - Ещё элемент
    - Чем больше пробелов в начале, тем глубже вложенность
  - Всё просто

Таблицы

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

Заголовок 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 |

Примечание: Вертикальное объединение (rowspan) не поддерживается.

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

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

HTML и PHP

Любой потенциально опасный HTML, Javascript и/или PHP код вырезается.

Дополнительные возможности

Оглавление

Код Описание
~~NOTOC~~ Если этот код присутствует на странице, оглавление не будет создано

Советы и Отзывы

Чтобы отключить систему Советов и Отзывов:

~~DISCUSSION~~
~~DISCUSSION:off~~

Чтобы закрыть дискуссию:

~~DISCUSSION:closed~~

Автолинковка

На той странице куда поведут ссылки прописать:

{{autolink>ЛЮБЫЕ СЛОВА|анкоры|разделенные|pipe}}

На той странице где будут установлены ссылки прописать:

<autolink>
Текст на странице... текст... текст...

И конечно прописать текст ЛЮБЫЕ СЛОВА или любые слова. |Текст может быть заключен в таблицу| ЛЮБЫЕ СЛОВА, **но** в этом случае обязателен пробел до первого \||
</autolink>

Анотации к картинкам

{{aimg> image.png?320x240 |Название картинки}}

@10,30,60,60|Название анотации
Текст...
Форматы координат:
top,left,width,height.

{{<aimg}}

Bbcode разметка

Обычное форматирование:

[b]bold text[/b]
[i]italic text[/i]
[u]underline[/u]
[s]deleted[/s]
[m]monospace[/m]

Ссылки и изображения:

[url=http://www.kaffeehaus.ch]Esthers Kaffeehaus Blog[/url]
[email]apelsin@aplsin.travel[/email]
[img]http://www.dokuwiki.org/lib/exe/fetch.php?w=&h=&cache=cache&media=wiki%3Adokuwiki-128.png[/img]

Маркеры и списки:

[list][*]item 1[*]item 2[*]item 3[/list]
[list=1][*]item 1[*]item 2[*]item 3[/list]  attribute: 1, a, A, i or I

Размер шрифтов и цвет:

[size=90%]smaller text[/size]               attribute: numeric value (px, em, %, ...) or keywords like small
[color=red]colored text[/color]             attribute: color name, #fff[fff] or rgb(255,255,255)
1) Вариант наиболее правильный, так как новая страница получается связанной с уже существующими
2) Таким образом будет заведена страница, на которую нет ссылок с других страниц. Она будет доступна только через список всех страниц или через поиск по всему сайту
3) Это сноска