Помощь по работе с Wiki разметкой

Материал из FLProgWiki
Перейти к: навигация, поиск

Моя первая страница

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

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

Примем предложение системы и перейдём по ссылке Создать страницу. Итак, мы попали в поле редактирования страницы. Давайте напишем здесь предложение:


У нас получилось создать страницу! Теперь задача минимум - изучить основную

Wiki-разметку, чтобы красиво оформлять свои знания.


и нажмём расположенную внизу кнопку записать страницу. И опять маленькая победа — страница создана. Самая простенькая, но зато своими силами!

Азбука Wiki-разметки

В предыдущем подразделе у нас получилось создать простую страницу и даже разместить в ней некоторый текст. Но, согласитесь, просто размещать текст без форматирования можно и в простом текстовом редакторе. Нас категорически не устраивает размещать статьи в стиле "печатной машинки", следовательно, нужно научиться форматировать текст. Это проще простого: Форматирование "мышкой"

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

   Выделяем слово или словосочетание.
   Щёлкаем на кнопке из палитры кнопок для соответствующего типа форматирования.

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

Полужирное начертание '''Пингвин'''

Курсивное начертание ''Пингвин''

Внутренняя ссылка [[Пингвин]]

Содержание. Заголовки и подзаголовки

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

=Заголовок1=

==Подзаголовок1==

===Подподзаголовок1===

====И так далее1====

=Заголовок2=

==Подзаголовок2==

===Подподзаголовок2===

====И так далее2====

=Заголовок3=

==Подзаголовок3==

===Подподзаголовок3===

====И так далее3====

=Заголовок4=

==Подзаголовок4==

===Подподзаголовок4===

====И так далее4====

=Заголовок5=

==Подзаголовок5==

===Подподзаголовок5===

====И так далее5====


Получается содержание как у этой статьи

Каждый из элементов содержания является ссылкой на ту часть страницы, названием которой является. Таким образом, можно быстро и легко "путешествовать" по готовому документу, щёлкая мышкой на заголовке нужного раздела.

Вставка изображений на страницу

Загрузить изображения на страницу очень просто. Достаточно щёлкнуть на кнопке вставки изображения на панели форматирования.

После этого система автоматически создаст тег [[Изображение:Example.jpg]]. Здесь Example.jpg — целевое имя файла. Например, есть необходимость в размещении на вики некого изображения, которое называется medved.png. Следовательно, целевое имя файла должно быть medved.png вместо Example.jpg После записи страницы содержание тега [[Изображение:medved.png]] превратится в ссылку вида Изображение:Medved.рng, щёлкнув по которой, автоматически попадаем в форму загрузки файла.

Нажав кнопку Обзор, выбираем заготовленный файл и нажимаем Загрузить файл. После загрузки перейдём на страницу и увидим на ней загруженную картинку. Также рисунок можно снабдить надписью, изменить его размер и положение (посередине, слева или справа).

Примечание: Если в вики-разметке после вставки тега с рисунком продолжать писать текст, то после сохранения страницы он будет располагаться слева или справа от рисунка в зависимости от расположения последнего. Это не всегда удобно. Иногда требуется расположить текст ниже рисунка. Для этого можно использовать тег <br clear="all">.

Создание внутренних и внешних ссылок

Как это выглядит Что надо набрать
В программе FLProg применяется Язык программирования FBD.
  • Первая буква точки назначения автоматически делается большой.
  • Внутренние пробелы автоматически представляются как подчёркивания (набор подчёркивания имеет тот же эффект, что и набор пробела, но не рекомендуется).

Таким образом, приведённая выше ссылка ведёт на http://elref.ru/wiki/index.php?title=%D0%AF%D0%B7%D1%8B%D0%BA_%D0%BF%D1%80%D0%BE%D0%B3%D1%80%D0%B0%D0%BC%D0%BC%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F_FBD, которая является статьёй с названием «Язык программирования FBD».


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

Пример: В вики есть описание языка прграммирования FBD .

В программе FLProg применяется [[Язык программирования FBD]].


В вики есть описание [[Язык программирования FBD|языка прграммирования FBD]].

Та же ссылка, но с другим именем: Просто FBD. [[Язык программирования FBD|Просто FBD]]
Окончания сливаются со ссылкой: Язык программирования FBDой [[Язык программирования FBD]]ой
Медведи на улицах Москвы — это страница,

которая ещё не создана.

Вы можете создать её, кликнув на ссылке.

[[Медведи на улицах Москвы]] — это страница,

которая ещё не создана.

Внешняя ссылка: FLprog Внешняя ссылка: [http://flprog.ru FLprog]
Или просто укажите URL: http://www.flprog.ru.
  • В URL все символы должны находиться в диапазонах: A-Z a-z 0-9 ._\/~%-+&#?!=()@ \x80-\xFF. Если URL содержит другие символы, их следует преобразовать: например, ^ следует записывать как %5E (чтобы можно было просматривать в ASCII).
Или просто укажите URL: http://www.flprog.ru.
Указать e-mail можно так: name@example.com
  • Этот адрес приведён для примера, не используйте его.
Указать e-mail можно так: [mailto:name@example.com name@example.com]

Создание таблиц

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

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

Простейшая таблица

Любая таблица в wiki-стиле начинается с фигурной скобки { с последующей вертикальной чертой | и заканчивается вертикальной чертой | с закрывающей фигурной скобкой }. Каждая ячейка строки начинается с вертикальной черты |, после которой пишется её содержание.

Пример

Исходный код таблицы с одной строкой

{|

|Ячейка 1

|Ячейка 2

|Ячейка 3

|}

Будет выглядеть так

Ячейка 1 Ячейка 2 Ячейка 3

Для введения следующей строки после вертикальной черты ставится штрих «-». Таким образом можно вводить любое количество строк.

Пример

Исходный код таблицы в две строки

{|

|Ячейка 1*1

|Ячейка 2*1

|Ячейка 3*1

|-

|Ячейка 1*2

|Ячейка 2*2

|Ячейка 3*2

|}

Будет выглядеть так


Ячейка 1*1 Ячейка 2*1 Ячейка 3*1
Ячейка 1*2 Ячейка 2*2 Ячейка 3*2

Пример

Таблица в три строки пишется так

{|

|Ячейка 1*1

|Ячейка 2*1

|Ячейка 3*1

|-

|Ячейка 1*2

|Ячейка 2*2

|Ячейка 3*2

|-

|Ячейка 1*3

|Ячейка 2*3

|Ячейка 3*3

|}

Будет выглядеть так


Ячейка 1*1 Ячейка 2*1 Ячейка 3*1
Ячейка 1*2 Ячейка 2*2 Ячейка 3*2
Ячейка 1*3 Ячейка 2*3 Ячейка 3*3

Табличные рамки

Вид рамки описывается в первой строке, сразу после {|. Не забудьте, что между ними и атрибутом должен быть пробел.

Толщина линий рамки задаётся атрибутом border=n, где «n» — толщина линии:

Пример

Исходный код таблицы

{| border=1

|Ячейка 1*1

|Ячейка 2*1

|Ячейка 3*1

|-

|Ячейка 1*2

|Ячейка 2*2

|Ячейка 3*2

|-

|Ячейка 1*3

|Ячейка 2*3

|Ячейка 3*3

|}

Будет выглядеть так

Ячейка 1*1 Ячейка 2*1 Ячейка 3*1
Ячейка 1*2 Ячейка 2*2 Ячейка 3*2
Ячейка 1*3 Ячейка 2*3 Ячейка 3*3

Изменять оформление рамки таблицы также можно с помощью атрибута class.

Заголовки

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

Пример

Для последней таблицы код может быть таким

{| border=1

!Первый столбец

!Второй столбец

!Третий столбец

|-

!Первая строка

|Ячейка 2*1

|Ячейка 3*1

|-

!Вторая строка

|Ячейка 2*2

|Ячейка 3*2

|-

!Третья строка

|Ячейка 2*3

|Ячейка 3*3

|}


Таблица будет выглядеть так

Первый столбец Второй столбец Третий столбец
Первая строка Ячейка 2*1 Ячейка 3*1
Вторая строка Ячейка 2*2 Ячейка 3*2
Третья строка Ячейка 2*3 Ячейка 3*3

Запись в одну строку

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

Пример

Для последней таблицы код может быть таким

{| border=1

!Первый столбец||Второй столбец||Третий столбец

|-

|Ячейка 1*1||Ячейка 2*1||Ячейка 3*1

|-

|Ячейка 1*2||Ячейка 2*2||Ячейка 3*2

|-

|Ячейка 1*3||Ячейка 2*3||Ячейка 3*3

|}

Таблица будет выглядеть так

Первый столбец Второй столбец Третий столбец
Ячейка 1*1 Ячейка 2*1 Ячейка 3*1
Ячейка 1*2 Ячейка 2*2 Ячейка 3*2
Ячейка 1*3 Ячейка 2*3 Ячейка 3*3

Объединение ячеек

В wiki-стиле, как и в HTML, имеется возможность объединять несколько ячеек как по вертикали, так и по горизонтали. Для объединения по вертикали применяется атрибут rowspan=n, где «n» — число ячеек, которые должна объединить данная ячейка. Этот атрибут вписывается перед содержанием объединяющей ячейки.

Пример Вертикальное объединение двух ячеек пишется так:

{| border=1

|Ячейка 1

|rowspan=2 |Ячейка 2, объединяет два ряда таблицы

|Ячейка 3

|-

|Ячейка 4

|Ячейка 5

|}

Выглядеть это будет так

Ячейка 1 Ячейка 2, объединяет два ряда таблицы Ячейка 3
Ячейка 4 Ячейка 5

Для объединения по горизонтали используется атрибут colspan=n.

Пример

Объединение по горизонтали

{| border=1

|Ячейка 1

|colspan=2 |Ячейка 2, объединяет два столбца

|-

|Ячейка 3

|Ячейка 4

|Ячейка 5

|

Выглядит это так

Ячейка 1 Ячейка 2, объединяет два столбца
Ячейка 3 Ячейка 4 Ячейка 5

Wiki-разметка

Wiki-разметка позволяет создавать и цветные и вложенные таблицы а также таблицы с названием и фиксировнной шириной. Помимо таблиц поддерживается масса возможностей. Обзор тегов вики-разметки можно найти по ссылке: http://ru.wikipedia.org/wiki/Википедия:Как_править_статьи.

Источники

Основная информация взята с http://docs.altlinux.org/current/modules/mediawiki/index.html