Wiki-разметка
Данная страница создана с помощью вики-разметки.
Подобные страницы теперь можете создавать и Вы.
При написании текстов страничек используется специальная Wiki-разметка, базовый синтаксис которой описывается ниже. Внимательно прочитайте эту страничку до конца, прежде чем приступать к написанию своих собственных страничек. Разметка несложная, но необходима небольшая практика.
Заголовки
При написании текстов Вы можете использовать заголовки 5 уровней. Каждый заголовок должен быть окружен знаками равно "=" (от 2 до 6 знаков). Чем больше знаков равно "=", тем более вложенным будет заголовок.
Пример
== Заголовок первого уровня == === Заголовок второго уровня === ==== Заголовок третьего уровня ====
Результат
Заголовок первого уровня
Заголовок второго уровня
Заголовок третьего уровня
Постарайтесь вводить заголовки в текст статьи последовательно, т.е. чтобы за заголовком 1-го уровня шел заголовок 2-го уровня, а не 3-го или тем более 4-го. Старайтесь грамотно выстраивать логическую структуру текста.
Абзацы
Для создания абзаца достаточно просто начать писать текст. Пустая строка начинает новый абзац. Можно делать переносы строк - они не будут считаться новыми абзацами, а будут склеены с предыдущей строкой.
Пример
Это первый абзац в одну строку. А это второй абзац, в котором был сделан перенос,\\ но который при этом все равно остался одним абзацем
Результат
Это первый абзац в одну строку.
А это второй абзац, в котором был сделан перенос,
но который при этом все равно остался одним абзацем
Вы можете принудительно переносить строки (например, для публикации стихов), указывая в конце строки двойной обратный слеш.
Пример
Я помню чудное мгновенье:\\ Передо мной явилась ты\\ Как мимолетное виденье,\\ Как гений чистой красоты...
Результат
Я помню чудное мгновенье:
Передо мной явилась ты
Как мимолетное виденье,
Как гений чистой красоты...
Если в конце строки указать больше, чем два обратных слеша, то в этом случае каждый дополнительный слеш вставит дополнительную пустую строку.
Верхние/нижние индексы
Пример
x<sup>2</sup> H<sub>2</sub>O
Результат
x2
H2O
Списки
Как известно, списки бывают маркированные и нумерованные. Для того, чтобы создать маркированный список, начните строку со звездочки "*". Чем больше звездочек, тем глубже уровень вложенности элемента списка.
Пример
* Первый пункт маркированного списка * Второй пункт маркированного списка * Третий пункт маркированного списка
Результат
- Первый пункт маркированного списка
- Второй пункт маркированного списка
- Третий пункт маркированного списка
Для создания нумерованного списка вместо звездочки необходимо использовать решетку "#".
Пример
# Первый пункт нумерованного списка # Второй пункт нумерованного списка
Результат
- Первый пункт нумерованного списка
- Второй пункт нумерованного списка
Кроме этого, Вы можете создавать смешанные списки. Например, создав основной уровень списка нумерованным, а вложенные подуровни маркированными. Разметка при этом будет выглядеть следующим образом.
Пример
# Первый уровень нумерованного списка #* Второй уровень маркированного списка #* Второй уровень маркированного списка # Первый уровень нумерованного списка
Результат
- Первый уровень нумерованного списка
- Второй уровень маркированного списка
- Второй уровень маркированного списка
- Первый уровень нумерованного списка
Создание отступов
Если Вам необходимо сделать отступ в тексте, скажем, для цитирования сообщения, то начните строку с двоеточия. Чем больше двоеточий, тем больше отступ.
Пример
: Этот абзац будет показан с небольшим отступом :: А этот абзац будет показан с еще большим отступом
Результат
- Этот абзац будет показан с небольшим отступом
- А этот абзац будет показан с еще большим отступом
Определения терминов
Очень часто, когда Вы пишите какую-нибудь серьезную статью, возникает необходимость создания небольшого глоссария. В рамках Wiki-разметки очень легко создать список терминов с их расшифровкой. Для этого используется следующий синтаксис.
Пример
; Термин : Определение
Результат
- Термин
- Определение
Логическое выделение слов или фраз
Для логического выделения в тексте Вы можете использовать два (для выделения наклонным) или три (для выделения полужирным шрифтом) апострофа. Если Вам необходимо выделить что-то в тексте, написанном полужирным начертанием, то используйте пять апострофов
Пример
''Этот текст будет выделен наклонным шрифтом'' '''А этот уже полужирным''' '''Выделяем '''''слово''''' в полужирном тексте'''
Результат
Этот текст будет выделен наклонным шрифтом
А этот уже полужирным
Выделяем слово в полужирном тексте
Разделительная линия
Когда текст слишком длинный и его невозможно структурировать при помощи заголовков, можно использовать горизонтальную линию. Для того, чтобы создать разделительную логическую линию, напишите в начале строке четыре или более дефисов.
Пример
----
Результат
Ссылки
Для того чтобы поставить ссылку на какую-либо страничку, достаточно указать ее идентификатор и через вертикальную черту - название страницы в нужной форме, заключив всю конструкцию в двойные квадратные скобки. Если такая страничка существует, то ссылка сразу будет работать. Если же страничка пока еще не существует, то при нажатии на такую ссылку Вы перейдете к форме создания новой страницы.
Пример
[[9|Gerz Clock]] Подробная информация приведена на [[9|страничке о заставке]]
Результат
Gerz Clock
Подробная информация приведена на страничке о заставке
Если Вы создаете новую страницу, то в качестве идентификатора поставьте 0. Вы можете изменить текст ссылки, чтобы учесть нужный падеж или склонение. В качестве идентификатора страницы могут использоваться только цифры.
Внешние ссылки
Внешние ссылки - это обычные HTML-ссылки, которые используются для ссылки на внешние ресурсы. Для создания внешней ссылки Вы можете либо просто начать написание ссылки с протокола, либо использовать более сложную конструкцию (если Вам необходимо дать название для ссылки).
Пример
http://www.gerz-inc.com/ [http://www.gerz-inc.com/ Gerz, Inc.]
Результат
http://www.gerz-inc.com/
[http://www.gerz-inc.com/ Gerz, Inc.]
Таким же образом можно делать ссылку и на электронный адрес. Если Вы просто укажете E-mail на страничке, то он автоматически будет преобразован в работащую ссылку, при щелчке на которой запустится почтовый клиент по умолчанию. Ссылка на электронный адрес также поддерживает более сложный формат, позволящий задать текст ссылки:
Пример
name@example.com [mailto:name@example.com Напишите нам письмо]
Результат
name@example.com
[mailto:name@example.com Напишите нам письмо]
Ссылка на профиль пользователя
У каждого зарегистрированного пользователя сайта есть свой профиль. Чтобы быстро вставить ссылку на профиль пользователя, необходимо использовать одну из следующих конструкций:
Пример
[[Profile:1]] [[Profile:1|Страничка Гришина Евгения]]
Результат
Гришин Евгений
Страничка Гришина Евгения
После префикса Profile: указывается идентификатор пользователя, который состоит только из цифр. При использовании первой конструкции, в качестве текста ссылки будут использованы фамилия и имя пользователя профиля. Чтобы указать текст ссылки вручную, поставьте вертикальную черту и введите описание.
Комментарии
Для добавления на страничку раздела с комментариями используйте следующий синтаксис:
Пример
[[Comments:0]]
За префиксом Comments: следует идентификатор страницы. Если указан 0, то будут отображены комментарии оставленные к текущей странице, иначе - продублированы комментарии со страницы с указанным номером.
Чтобы указать количество выводимых комментариев, добавьте параметр Count:15 после вертикальной черты. В этом случае, если число комментариев превысит указанное число, снизу появится кнопка для отображения скрытых комментариев. При нажатии на неё, дополнительно отобразится ещё 10 комментариев. Это количество тоже можно регулировать параметром More:10.
Пример
[[Comments:0|Count:15]] [[Comments:0|Count:15|More:5]]
По умолчанию, параметры Count и More равны 10.
Пример работы комментариев можно увидеть в самом конце страницы.
Заметки
Для добавления на страничку раздела с заметками используйте следующий синтаксис:
Пример
[[Notes:0]]
За префиксом Notes: следует идентификатор страницы. Если указан 0, то будут отображены заметки оставленные к текущей странице, иначе - продублированы со страницы с указанным номером.
Дополнительные параметры для заметок:
- Title:Заметки : Заголовок раздела с заметками
- Readonly:0 : 0 - Добавлять заметки может любой желающий. 1 - Только владелец
- Length:100 : Количество выводимых символов из заметки
- Count:10 : Количество выводимых заметок
- More:10 : Количество дополнительно выводимых заметок, при нажатии на кнопку "показать ещё"
Пример
[[Notes:0|Count:15]] [[Notes:0|Count:15|More:5|Title:Новости|Length:250]]
Использование изображений
Прежде чем использовать изображение на страничке, Вам необходимо его предварительно подготовить и загрузить на сайт. Это делается при помощи команды "Загрузить файл" в правом меню. Поддерживаются изображения 4-х графических форматов: GIF, JPEG, PNG и SWF (Flash).
Для того чтобы вставить в текст страницы иллюстрацию, Вам необходимо использовать такую же конструкцию, как и при создании обычной внутренней ссылки, но она должна начинаться с префикса Image:
Пример
[[Image:10]]
В качестве идентификатора изображения используется идентификатор файла загруженного на сайт. Идентификаторы файлов, которые Вы загрузили на сайт можно найти на страничке Мои файлы
Изображение может быть выровнено влево или вправо, а также отцентрировано. При выборе выравнивания влево или вправо, автоматически включается режим обтекания изображения текстом. Для выбора нужного способа выравнивания используйте одно из следующих ключевых слов: left, right, center.
Пример
[[Image:10|left]] [[Image:10|right]] [[Image:10|center]]
Вы можете указать альтернативный текст для вставляемой иллюстрации, просто указав его последним в списке атрибутов. Более того, это рекомендуется делать всегда, т.к. позволит понять, что нарисовано на картинке без необходимости загружать изображение. Это важно для тех людей, которые отключают показ картинок, а также для текстовых браузеров.
Пример
[[Image:10|Описание изображения]]
По умолчанию изображение показывается точно в таком виде, в котором Вы его загрузили на сайт. Можно улучшить внешний вид иллюстрации, создав вокруг изображения рамку. Это делается при помощи атрибута frame.
Пример
[[Image:10|frame]]
Для вывода уменьшенной копии изображения используйте атрибут thumbnail.
Пример
[[Image:10|thumbnail]]
Кроме того, если для иллюстрации был определен пояснительный текст и добавлен атрибут alt, то он будет показан под изображением в качестве описания.
Пример
[[Image:10|left|frame|thumbnail|alt|Описание изображения]]
Результат
Использование загружаемых файлов
Как и в случае с изображениями, если Вы желаете выложить на страничке какой-нибудь файл для скачивания, его необходимо предварительно загрузить. Это делается при помощи команды "Загрузить файл" в правом меню. Для ссылки в тексте странички на загруженный файл используется следующая конструкция:
Пример
[[File:10]]
Вы также можете написать пояснительный текст к загружаемому файлу и он будет использован в качестве текста ссылки.
Пример
[[File:95|Архив с примерами]]
Результат
Заметьте, что если Вы желаете только дать ссылку на изображение, а не показывать его на страничке, то можете использовать конструкцию, приведенную выше, ссылаясь на изображение, как на обычный файл.
Неформатированный текст
Для того чтобы напечатать неформатированный текст, Вам достаточно начать строку с пробела. Данная возможность очень полезна, если Вы, например, желаете проиллюстрировать текст статьи программным кодом:
Результат
reset($blocks);
while (list($id, $block) = each($blocks)) {
if ($block["type"] == "code") {
$text .= "<pre>n";
$text .= $block["content"];
$text .= "</pre>n";
} else {
$text .= "<p>n";
$text .= $block["content"];
$text .= "</p>n";
}
}
return $text;
Создание таблиц
Таблица создается очень просто - достаточно начать строку с вертикальной черты или восклицательного знака. Использование в качестве левой границы восклицательного знака вместо вертикальной черты обозначает, что данная ячейка является заголовком и должна быть выделена.
Пример
!Имя !Фамилия !Должность ! Год рождения | |Иван |Иванов |Директор | 1966 | |Семен |Семенов |Бухгалтер | 1958 | |Мария |Петрова |Секретарь | 1980 |
Результат
| Имя | Фамилия | Должность | Год рождения |
|---|---|---|---|
| Иван | Иванов | Директор | 1966 |
| Семен | Семенов | Бухгалтер | 1958 |
| Мария | Петрова | Секретарь | 1980 |
Для выравнивания содержимого ячеек используются следующие правила. Для выравнивания по левому краю текст в ячейке должен начинаться вплотную к левой вертикальной черте, а между текстом и правой чертой должен быть, как минимум, один пробел. То же самое и для выравнивания текста по правому краю, только пробел должен быть слева от текста, а сам он должен быть прижат к правому краю. Если текст окружен пробелами с обеих сторон, то он будет отцентрирован.
|Влево | По центру | Вправо|
Если пробелы отсутствуют как слева, так и справа от текста, то выравнивание в ячейке будет соответствовать выравниванию по умолчанию.
Вы можете объединять несколько ячеек по горизонтали. Для этого достаточно поставить после содержимого ячейки не одну вертикальную черту, а столько, сколько ячеек справа будут объединены с данной ячейкой. При этом пробелов между вертикальными чертами быть не должно.
Пример
|Имя Фамилия ||Должность | Год рождения | |Иван |Иванов |Директор | 1966 | |Семен |Семенов |Бухгалтер | 1958 | |Мария |Петрова |Секретарь | 1980 |
Результат
| Имя Фамилия | Должность | Год рождения | |
| Иван | Иванов | Директор | 1966 |
| Семен | Семенов | Бухгалтер | 1958 |
| Мария | Петрова | Секретарь | 1980 |
Вы можете указать дополнительные параметры таблицы в первой строке описания. Закрывающей вертикальной черты быть не должно. Поддерживаются следующие параметры:
- 350px или 100% - указывает ширину таблицы в пикселах или процентах
- highlight - задает подсветку нечетных строк в таблице
- left, center, right - задает выравнивание таблицы по левому краю, по центру или по правому краю
|100%|highlight
Вы можете указать для таблицы заголовок, описывающий данные, представленные в ней. Для этого в первой строке описания, где задаются атрибуты таблицы, разместите ее заголовок в качестве последнего атрибута.
Пример
|100%|highlight|Штатное расписание нашей фирмы |Имя Фамилия ||Должность | Год рождения | |Иван |Иванов |Директор | 1966 | |Семен |Семенов |Бухгалтер | 1958 | |Мария |Петрова |Секретарь | 1980 |
Результат
| Имя Фамилия | Должность | Год рождения | |
| Иван | Иванов | Директор | 1966 |
| Семен | Семенов | Бухгалтер | 1958 |
| Мария | Петрова | Секретарь | 1980 |
Использование XHTML-кода
В редких случаях, когда возможностей описанной выше wiki-разметки недостаточно, можно использовать при написании страничек обычный XHTML-код. Для этого используется специальная пара тегов
Пример
<nowiki> <div style="background-color: black;"> <p>Печатаем некий текст на чёрном фоне.</p> </div> </nowiki>
Результат
Печатаем некий текст на чёрном фоне.
Любой код внутри этих тегов никак не обрабатывается и выводится в браузер точно в том виде, в котором был введен. Использовать данную возможность требуется очень осторожно и, в большинстве случаев, крайне не рекомендуется.
Комментарии
