• СправочникПоСинтаксису

• Вики — гипертекстовая среда (обычно веб-сайт) для сбора и структурирования письменных сведений. Характеризуется следующими признаками:

  • Множество авторов. Некоторые вики могут править все посетители.

  • Возможность многократно править текст посредством самой вики-среды (веб-сайта), без применения особых приспособлений на стороне редактора.

  • Проявление изменений сразу после их внесения.

  • Разделение информации на страницы, где у каждой своё название.

  • Особый язык разметки, позволяющий легко и быстро размечать в тексте структурные элементы, форматирование, гиперссылки и т. п.

  • Учёт изменений (учёт версий) текста и возможность отката к ранней версии.

• Содержание

  • Текст

  • ВикиИмена и ссылки

  • Таблицы

  • Списки

  • Макросы

1. Текст

• ВикиИмена и ссылки

• Таблицы

• Списки

• Макросы

• Как видно из определения в Вики хранится в основном текстовая информация, которую надо научиться оформлять с помощью особого языка разметки.
  Этим мы и займемся.
  Как и в любом текстовом редакторе на подобие MSWord или OpenOfficeWriter текст можно разбивать на абзацы. Это можно выполнить с помощью специального тега [[BR]].

Пример 1.1:

• Первый абзац
  [[BR]][[BR]]
  Второй абзац

Результат:

• Первый абзац

  
  
  Второй абзац

• Тегов [[BR]] можно вставлять неограниченное количество. Чем их больше, тем больше расстояние между абзацами.
  Чем больше пробелов Вы поставите перед первым предложением абзаца, тем больше будет отступ у абзаца.

• Если сравнивать дальше возможности языка Вики и текстовых редакторов то, для большей выразительности текста, Вы возможно, захотите выделить слова жирным, курсивом или даже подчеркнуть. Посмотрим сразу на пример и Вам станет понятно, как все это работает:

Пример 1.2:

• '''жирный текст'''

• ''курсив''

• __подчеркнутый текст__

• --(зачеркнутый текст)--

Результат:

• жирный текст

• курсив

• подчеркнутый текст

• зачеркнутый текст

• Потренируемся объединять различные стили. Для удобства сначала старайтесь обрамлять тегами бОльшие участки текста, потом переходите к меньшим участкам или словам. Тогда Вы не запутаетесь с тегами.

Пример 1.3:

• '''''Пример текста''' с различными стилями''

• '''''Пример текста'' с различными стилями'''

• '''Пример текста с различными ''стилями'''''

• ''Пример текста с различными '''стилями'''''

Результат:

• Пример текста с различными стилями

• Пример текста с различными стилями

• Пример текста с различными стилями

• Пример текста с различными стилями

• В меньшей степени Вам понадобится следующие возможности работы с текстом:

Пример 1.3:

• ~-маленкий-~ шрифт

• ~+большой+~ шрифт

• ^верхний^индекс

• ,,нижний,,индекс

Результат:

• маленкий шрифт

• большой шрифт

• ^{верхний}индекс

• _нижнийиндекс

• Или такие примеры: ax²+bx+c=0, C₂H₅OH.

• И лучше обособленно рассказать о двух возможностях редактирования текста. Почему я выделил их в отдельную группу? Потому что внутри этих тегов теги оформления текста (которые мы уже рассмотрели выше) не работают.

Пример 1.4:

• {{{

  • код

• }}}

• `моноширный текст`

Результат:

•   код

  моноширный текст

• Как уже было сказано ранее, что внутри тега "моноширный текст" другие теги оформления текста не работают. Но ни кто нам не мешает сделать так :

Пример 1.5:

• '''`жирный моноширный текст`'''

• ''`моноширный текст курсивом`''

• ~+`большой моноширный текст`+~

• и так далее, как подскажет Вам фантазия

Результат:

• жирный моноширный текст

• моноширный текст курсивом

• большой моноширный текст

• Если Вы программист, то Вам наверно будет интересно не просто вывод кода программы, а вывод с подсветкой синтаксиса. Для этого необходимо использовать теги в виде трех фигурных скобок, но записать так - {{{#!язык_программирования. В стандартной поставке поддерживаются следующие языки программирования: C/C++, Java, Pascal, Python, XML/XSLT/!DocBook.

Пример 1.6:

• {{{#!python

• from colors import palette

• palette.colorize('python')

• }}}

Результат:

•    1  from colors import palette
     2  palette.colorize('python')
  

• Любой большой текст стилистически принято разбивать на главы. Вы можете использовать пять уровней оформления заголовков:

Пример 1.7:

• = Первый уровень =

• == Второй уровень ==

• === Третий уровень ===

• ==== Четвертый уровень ====

• ===== Пятый уровень =====

Результат:

Первый уровень

Второй уровень

Третий уровень

Четвертый уровень

Пятый уровень

• А также красиво отделять главы одна от другой с помощью горизонтальных линий разной толщины (как это сделано в этом документе для отделения примеров):

Пример 1.8:

• --- не является горизонтальной линией

• ----

• -----

• ------

• -------

• --------

• ---------

• ----------

• -------------------- толщины свыше 10 тире не существует

Результат:

• --- не является горизонтальной линией

толщины свыше 10 тире не существует

2. ВикиИмена и ссылки

• Текст

• Таблицы

• Списки

• Макросы

• "ВикиИмена" — слова специального вида, используемые для создания ссылок на страницы сайта. Их структура – Большая буква, одна или более маленьких букв, снова большая буква (или цифра), далее любое количество других букв или цифр.
  Если такая страница с таким именем есть в системе, то имя автоматически станет ссылкой на эту страницу; если нет то написанное имя "подкрасится" серым цветом, по клику на которое, Вам будет предложено создать новую страницу с названием, совпадающим с ВикиИменем. Есть еще один способ записи ссылок на страницы, рассмотрим оба:

Пример 2.1:

• Моя первая ссылка на ВикиСтраницу

• Моя первая ссылка на ["ВикиСтраницу"]

Результат:

• Моя первая ссылка на ВикиСтраницу

• Моя первая ссылка на ВикиСтраницу

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

• 
  Еще существeт такое понятие как "Вложенная Страница". Рассмотрим пример ссылки http://имя_сайта/страница/страница1. "Страница1" является вложенной ссылкой по отношению к "Страница". Эта вложенность может быть настолько глубокой, насколько это Вам необходимо. Рассмотрим пример записи вложенных ссылок:

Пример 2.2:

• Моя первая ссылка на ВикиСтраница/ВложеннаяСтраница

• Моя первая ссылка на ["ВикиСтраница/ВложеннаяСтраница"]

Результат:

• Моя первая ссылка на ВикиСтраница/ВложеннаяСтраница

• Моя первая ссылка на ВикиСтраница/ВложеннаяСтраница

• Если Вы нашли интересный материал на просторах интернета и хотите поделиться с ним в своей статье, то можно дать ссылку на него следующим образом:

Пример 2.3:

• Моя первая внешняя ссылка http://gcc.gnu.org

Результат:

• Моя первая внешняя ссылка http://gcc.gnu.org

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

Пример 2.4:

• [:ХайджинКинOla:Отчет по поставщику Хайджин Кинетикс - остатки Ola]

Результат:

• Отчет по поставщику Хайджин Кинетикс - остатки Ola

• Наведите курсор на ссылку в примере и посмотрите какой реальный адрес у этой ссылки.
  Тоже применимо и к внешним ссылкам на другие сайты:

Пример 2.5:

• [http://gcc.gnu.org Пример ссылки на внешний сайт]

Результат:

• Пример ссылки на внешний сайт

• Если Вы хотите вставить какой либо файл в Вашу статью, будь то картинка или созданный в иной программе, то используйте ссылки следующего вида:

Пример 2.6:

• attachment:kartinka.png

Результат:

• В Вашей статье так же можно дать ссылку на файл, находящийся на внешнем сайте:

Пример 2.7:

• http://gcc.gnu.org/img/gccegg-65.png

Результат:

• И напоследок, про Вики Имена, если Вы хотите написать слово похожее на ВикиИмя, но не хотите, что была создана ссылка на страницу с данным именем, то напишите следующим образом:

Пример 2.8:

• !ВикиСтраница

Результат:

• ВикиСтраница

3. Таблицы

• Текст

• ВикиИмена и ссылки

• Списки

• Макросы

• Любая информация будь то цифры или какая-нибудь текстовая информация лучше воспринимается если преподносится в виде таблицы. Таблица состоит из ячеек, которые в свою очередь расположены в строках и столбцах. Рассмотрим простейший пример таблицы:

Пример 3.1:

• ||столбец1_строка1||столбец2_строка1||

• ||столбец1_строка2||столбец2_строка2||

Результат:

• столбец1_строка1	столбец2_строка1
  столбец1_строка2	столбец2_строка2

• Таблица в примере 3.1 смотрится как-то "куцо" не правда ли? Ширина ячеек и таблицы в целом зависит от текста, находящегося в ячейках. А если у Вас не дай бог будет такая таблица ?

Пример 3.2:

• ||абра кадабра||три||

• ||0||еще одна абра кадабра записанная в данной ячейке||

Результат:

• абра кадабра	три
  0	еще одна абра кадабра записанная в данной ячейке

• Чтобы Ваши таблицы выглядели более менее достойно есть параметры управления: шириной таблицы, шириной ячейки, и расположением текста в ячейках (выравнивание по левому / правому / верхнему / нижнему краю, по центру). Рассмотрим все по порядку.
  Ширина таблицы указывается всегда в первой ячейки таблицы в процентном соотношении ко всей странице, при этом ширина столбцов будет рассчитываться из максимальной ширины текста расположенного в ячейке столбца:

Пример 3.3:

• ||<tablewidth="100%">абра кадабра||три||

• ||0||еще одна абра кадабра записанная в данной ячейке||

• ||<tablewidth="100%">еще одна абра кадабра записанная в данной ячейке||три||

• ||0||абра кадабра||

Результат:

• абра кадабра	три
  0	еще одна абра кадабра записанная в данной ячейке

  еще одна абра кадабра записанная в данной ячейке	три
  0	абра кадабра

• Помните в первой части про теги форматирования текста говорилось "чем больше пробелов Вы поставите перед первым предложением абзаца, тем больше будет отступ у абзаца." Тоже распространяется и на таблицы: чем больше вы поставите пробелов, тем больше отступ будет у таблицы. При этом общая (полезная) площадь таблицы уменьшается !!!

Пример 3.4:

• ||таблица1||

  • ||таблица2||

Результат:

• таблица1

  • таблица2

• Но перейдем к дальнейшему облагораживанию таблиц Если Вам необходимо, чтобы столбцы имели определенную ширину, то необходимо поступить точно также как при определении ширины таблицы. Ширина ячейки рассчитывается в процентном соотношении, но уже по отношению к ширине всей таблицы.
  Естественно ширина остальных столбцов будет исходить из ширины таблицы за вычетом тех столбцов, где ширина указана непосредственно.
  Ширина столбцов, где ширина не будет указана явно также рассчитываются из ширины текста заполняющего ячейки столбцов. Лучше всего записывать "константу ширины столбца" в первой ячейке столбца.

Пример 3.5:

• ||<tablewidth="100%" width="50%">абра кадабра||три||

• ||0||еще одна абра кадабра записанная в данной ячейке||

Результат:

• абра кадабра	три
  0	еще одна абра кадабра записанная в данной ячейке

• Как Вы уже заметили что все "указания" для форматирования таблицы записываются между символами "<...>". Если Вы хотите записать несколько тегов форматирования в одной ячейке, то, как показано в примере 3.5 это выполняется только в одних "скобках".
  
  Рассмотрим теги форматирования текста внутри ячейки:

Пример 3.6:

• ||<tablewidth="100%" width="30%" (>слева||<^>сверху||<v>снизу||

• ||<width="30%" )>справа||

• ||<width="30%" :>по центру||

Результат:

• слева	сверху	снизу
  справа
  по центру

• Т.е. тег <(> - указывает расположение текста слева, <)> - справа, <:> - по центру, <^> - сверху, <v> - снизу (по умолчанию текст всегда расположен по левому краю в середине ячейки). Внутри ячейки также можно использовать любые теги форматирования текста (рассмотренные в первой части) включая разделитель [[BR]].
  Но как, Вы спросите, мне удалось объединить ячейки? Чтобы Вас не вводить в заблуждение я в примере убрал некоторые теги намеренно. Теперь как раз наступило время рассмотреть их, применив, что мы уже знаем:

Пример 3.7:

• ||<tablewidth="60%" colspan=2 :>'''Заголовок таблицы'''||

• ||<width="5%" rowspan=2>1[[BR]]2||первая ячейка||

• ||вторая ячейка||

Результат:

• Заголовок таблицы
  1 2	первая ячейка
  	вторая ячейка

• Т.е. тег <colspan=x> объединяет ячейки по горизонтали, <rowspan=x> по вертикале, число указывает количество объединяемых ячеек, начиная с той где расположен тег.
  
  Но можно поступить немного по другому - записать так "||||" (без пробела), при этом произойдет автоматическое объединение двух ячеек. В справочнике по Вики показано как объединять две ячейки, но кто сказал, что так нельзя поступить и с большим количеством Записать текст необходимо в последней объединяемой ячейке. Текст выставляется по умолчанию по центру ячейки (что для меня остается загадкой , но удобно для заголовков). Так, на мой взгляд, будет более наглядно:

Пример 3.8:

• ||||||||<tablewidth="50%">'''Заголовок таблицы'''||

• ||1||2||3||

• ||4||5||6||

Результат:

• Заголовок таблицы
  1	2	3
  4	5	6

• Чтобы Ваши таблицы выглядели еще красивее можно определенные ячейки закрасить цветом. Для этого необходимо использовать тег <bgcolor="#XXXXXX">

Пример 3.9:

• ||<bgcolor="#FF0000">красный||<bgcolor="#00FF00">зеленый||<bgcolor="#0000FF">синий||

Результат:

• красный

  зеленый

  синий

• В теге <bgcolor="#XXXXXX"> запись #XXXXXX - это цвет в шестнадцатеричной системе счисления в формате RGB (Red-Красный Green-Зеленый Blue-Синий). Цвет может изменяться от 0 до 255 в десятичной системе счисления или от 00 до FF в шестнадцатеричной системе счисления.
  Для простого перевода используйте Калькулятор, в ОС MS Windows (поменяв его Вид->Инженерный). Для того чтобы перевести число выставьте систему счисления Десятичную (Dec, горячая клавиша F6) и наберите число, затем поменяйте систему счисления на Шестнадцатеричную (Hex, горячая клавиша F5).
  Существую еще тег для заливки всей таблицы. Он очень удобен для оттенения всей таблицы по отношению к тексту.

Пример 3.10:

• ||<tablebgcolor="#FFFFE0">ячейка1||ячейка2||ячейка3||

• ||||||ячейка4||

Результат:

• ячейка1	ячейка2	ячейка3
  ячейка4

• Расскажу Вам по секрету что для меня создание таблиц было сплошной головной болью, пока я не разработал для себя методику, упрощающую эту процедуру. Для того чтобы нарисовать таблицу я сразу подсчитываю необходимое количество столбцов и строк (даже если мне потом объединять некоторые ячейки). На пример, мне необходимо создать таблицу 5х3, я сразу рисую пустые ячейки, разделяя их пробелом (можно даже для собственного удобства нумеровать ячейки):

• || || || || || ||

• || || || || || ||

• || || || || || ||

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

• ||ячейка1   ||0       ||три||пять||четыре||

• ||триста три||тридцать||4  ||6   ||456   ||

• ||356       ||10 руб. ||12 ||77  ||11    ||

• После того как таблица заполнена и отредактирована как Вам необходимо, можно убрать лишние пробелы:

• ||ячейка1||0||три||пять||четыре||

• ||триста три||тридцать||4||6||456||

• ||356||10 руб.||12||77 ||11||

  ячейка1	0	три	пять	четыре
  триста три	тридцать	4	6	456
  356	10 руб.	12	77	11

• Согласитесь что в последнем примере после того как убрали пробелы таблица трудно читаема.

4. Списки

• Текст

• ВикиИмена и ссылки

• Таблицы

• Макросы

• Списки необходимы для улучшения восприятия перечисляемых типов. Они в Вики разделяются на: не нумерованные, нумерованные, буквенные.
  Пример не нумерованных списков:

Пример 4.1:

• Купить:

  • . хлеб

  • . молоко

• Купить:

  • * колбасу

  • * яйца

Результат:

• Купить:
  • хлеб
  • молоко
  Купить:
  • колбасу
  • яйца

• Ненумерованные списки выглядят как то скучно, можно немного оживить их:

Пример 4.2:

• Купить:

  • . (./) машину

  • . {*} квартиру

  • . {OK} билеты для отпуска

Результат:

• Купить:

  • машину

  • квартиру

  • билеты для отпуска

• Перейдем к нумерованным спискам. Они могут быть пронумерованы: арабскими цифрами (которыми мы пользуемся в повседневной жизни), римскими цифрами (могут быть прописные и малые). При нумеровании списка можно задать значение, с которого будет начинаться список (естественно значение указывается в начале списка).

Пример 4.3:

• Завоевать:

  • 1. Понедельник

    • I. доверие близких

    • I. доверие друзей:

    •   ...

      • i.#10 Абрам

      • i. Гавриил

      • i. Евграф

  • 2. Вторник

    • I. девушку:

      • * Агнесса

      • * Евгения

      • * Майя

    • I. весь мир

    • I. галактику (перед сном)

Результат:

• Завоевать:
  1. Понедельник
     1. доверие близких
     2. доверие друзей:
        • ..
        10. Абрам
        11. Гавриил
        12. Евграф
  2. Вторник
     1. девушку:
        • Агнесса
        • Евгения
        • Майя
     2. весь мир
     3. галактику (перед сном)

• Как видно из примера 4.3 списки могут быть вложенными и объединяться в более сложные структуры.
  Обязательно соблюдайте количество отступов для правильной нумерации списков.
  
  И на последок рассмотрим списки пронумерованные буквами. Они могут быть прописными и малыми (используется только английский алфавит).

Пример 4.4:

• Купить:

  • A. хлеб

  • A. молоко

• Купить:

  • a. колбасу

  • a. яйца

Результат:

• Купить:
  1. хлеб
  2. молоко
  Купить:
  1. колбасу
  2. яйца

5. Макросы

• Текст

• ВикиИмена и ссылки

• Таблицы

• Списки

• Корректный перевод термина с английского — «макрокоманда», слово же «макрос» получило распространение благодаря использованию в локализованных продуктах американской корпорации Microsoft.

  
  Рассмотрим пока два макроса, облегчающих жизнь при создании статей в Вики.
  Первый макрос будет очень полезен, если Вы используете заголовки рассмотренные ранее. Вставьте [[TableOfContents([maxdepth])]] в начале текста, после строк начинающихся со знака "#" и у Вас появится автоматическое содержание.
  Если Вы, на пример, решили сами создать свое содержание, то Вам поможет второй макрос. С помощью данного макроса можно самим создавать ссылки внутри страницы на интересующий Вас текст.

Пример 5.1:

• [#1 Текст]

• ***

• [[Anchor(1)]]

• === 1. Текст ===

Результат:

• Текст

• Нажмите на ссылку "Текст" в примере 5.1 и Вы переместитесь в раздел 1. Текст.

  
  
  Формат макроса:

  • [#уникальный_идентификатор текст_ссылки] — сама ссылка

  • [[Anchor(уникальный_идентификатор)]] — то куда Вы переместитесь

  
  Также можно использовать ссылки на другие страницы. Формат макроса будет практически идентичен:

  • [:ВикиИмя_страницы#уникальный_идентификатор:текст_ссылки] — сама ссылка

  • [[Anchor(уникальный_идентификатор)]] — то куда Вы переместитесь