ПЕСОЧНИЦА - место для Ваших экспериментов!

Iteach:Форматирование текста

Материал из ИнтеВики — обучающей площадкой для проведения тренингов программы Intel
Перейти к: навигация, поиск

Содержание

Разметка форматирования текста

Вы можете форматировать вики-страницы при помощи специального языка разметки — т.н. «вики-разметки». Этот язык состоит из таких символов, как звездочки, апострофы или знак «равно», имеющих в вики специальную функцию, зависящую от их расположения в статье. Например, для того, чтобы слово было написано курсивом, необходимо заключить его в двойной апостроф — ''вот так''.


Описание Формат Результат
форматирование символов — работает везде
Наклонный текст ''Курсив'' курсив
Полужирный текст '''Полужирный''' полужирный
Полужирный и наклонный текст '''''Полужирный и курсив''''' Полужирный и курсив
Отмена форматирования wiki <nowiki>нет ''курсива''</nowiki> нет ''курсива''
оформление заголовков — работает только с новой строки
Текст с отступом

:Текст с отступом
::Двойной отступ
:::::Многократный отступ

Текст с отступом
Двойной отступ
Многократный отступ
Заголовки

разных уровней

=Уровень 1=
==Уровень 2==
===Уровень 3===
====Уровень 4====
======Уровень 5====== В статьях с четырьмя и более заголовками автоматически создаётся таблица содержания.

Использование 1-го уровня заголовков крайне нежелательно, поскольку они имеют то же самое форматирование и размер, что и названия страниц, что может вводить в заблуждение.

Уровень 1
Уровень 2
Уровень 3
Уровень 4
Уровень 5
Уровень 6
Горизонтальная линия

----


Список с маркерами
* первый
* второй
* третий
** первый в третьем
** второй в третьем

Оставляйте пустую строку между окончанием первого списка и началом следующего.

  • первый
  • второй
  • третий
    • первый в третьем
    • второй в третьем
Список с числами
# первый
# второй<br />несколько строк<br />не нарушая нумерацию
# третий
## первый в третьем
## второй в третьем
  1. первый
  2. второй
    несколько строк
    не нарушая нумерацию
  3. третий
    1. первый в третьем
    2. второй в третьем
Список определений
;элемент 1
:определение 1
;элемент  2
:определение 2-1
:определение 2-2
элемент 1
определение 1
элемент 2
определение 2-1
определение 2-2
Применение возможностей оформления списка определений для отступов текста
:Первый отступ
::Второй отступ
:::::Ещё несколько отступов

Это применение может быть спорным с точки зрения удобства.

Первый отступ
Второй отступ
Ещё несколько отступов</pre>
Смесь списка с маркерами
и списка с числами
# первый 
# второй
#* первый во втором
#* второй во втором
# третий
#; элемент определения в третьем
#: определение элемента в третьем
# четвёртый
#: four item one
#: это скорее похоже на продолжение # четыре
#: и таким образом часто используемый вместо <br />
;элемент 1
:* определение 1-1
:* определение 1-2
:
;элемент  2
:# определение 2-1
:# определение 2-2

Использование тегов #: и *: для разрыва строк в определениях может оказаться спорным.

  1. первый
  2. второй
    • первый во втором
    • второй во втором
  3. третий
    элемент определения в третьем
    определение элемента в третьем
  4. четвёртый
    four item one
    это скорее похоже на продолжение # четыре
    и таким образом часто используемый вместо
элемент 1
  • определение 1-1
  • определение 1-2
элемент 2
  1. определение 2-1
  2. определение 2-2
Предварительно отформатированный текст
 частично неформатированный тест
 оформляется с помощью '''пробела'''
 в ''начале'' строки 

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

частично неформатированный тест
оформляется с помощью пробела
в начале строки 

Абзацы

Вики игнорирует обычные переносы строк. Для начала нового абзаца оставьте пустую строку. Новую строку также можно начать с HTML-тега <br />.


HTML

В вики по умолчанию включена поддержка только некоторых HTML-тэгов, как например <code>, <div>, <span> и <font>.

Описание Формат Результат
Фиксированная ширина символов

<tt>Фиксированная ширина символов</tt>

Фиксированная ширина символов

Цитаты
текст текст текст текст текст текст текст текст текст текст 
текст текст текст текст текст текст текст текст текст текст 
<blockquote>  цитата цитата цитата цитата цитата цитата </blockquote>
текст текст текст текст текст текст текст текст текст текст 

текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст текст

цитата цитата цитата цитата цитата цитата

текст текст текст текст текст текст текст текст текст текст

Комментарии
<!--Это комментарий-->
Полностью неформатированный текст
<pre>с помощью этого тега вся разметка '''игнорируется'''</pre>
с помощью этого тега вся разметка '''игнорируется'''


Ссылки

  1. внутренние ссылки на страницы того же вики-проекта
  2. внешние ссылки на веб-сайты
  3. интервики-ссылки (ссылки на другие вики-проекты)
  4. меж-языковые ссылки на другие языковые разделы того же самого вики-проекта

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

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

Как ссылаться

Внутренняя ссылка [[Заглавная_Страница]] Заглавная_страница
Ссылка с разделителем (piped link) [[Заглавная_страница|какой-то текст]] какой-то текст
Внешняя ссылка http://dastx.net http://dastx.net
Внешняя ссылка,
с описанием (именованная)
[http://dastx.net DASTX] DASTX
Внешняя ссылка,
безымянная (нумерованная)
[http://dastx.net] [1]
Ссылка на раздел текущей страницы (anchor link) [[#Как ссылаться]] #Как ссылаться
Ссылка на раздел другой страницы (anchor link) [[Справка:Справка по редактированию#раздел]] Справка:Справка по редактированию
Ссылка на категорию [[:Категория:Справка]] Категория:Справка
Внутренняя ссылка на изображение [[Изображение:Vostok1-1-.jpg]] Vostok1-1-.jpg
Ссылка на e-mail [mailto:info@example.org напиши мне] напиши мне
Перенаправление #REDIRECT [[Заглавная_страница]] Заглавная_страница

Более сложные варианты

Ссылка с разделителем (piped link), с отличающимися названием и текстом [[Main Page|<span title="какое-то название">какой-то текст</span>]] какой-то текст
Внешняя ссылка,
на страницу того же проекта, безымянная
[http://{{SERVERNAME}}/pagename] [2]
Ссылка на e-mail,
с описанием и подстановкой темы сообщения
[mailto:info@example.org?Subject=URL%20Encoded%20Subject контактная информация] контактная информация



Как избежать автоматического создания внешней ссылки

По умолчанию, если в тексте статьи встречается адрес в формате URL, он автоматически преобразуется во внешнюю ссылку.

Чтобы избежать этого эффекта, поместите адрес URL между тэгами <nowiki>, как в этом примере:

<nowiki>http://mediawiki.org</nowiki>

Таблицы

На страницах вики можно использовать таблицы, созданные как с помощью табличных тэгов HTML, так и используя специальную вики-разметку. Использование html-тэгов описано в сети достаточно подробно и здесь обсуждаться не будет. Преимущества вики-разметки состоит в том, что таблица обозначается символами, и при редактировании представить себе структуру таблицы удобнее, чем при использовании тэгов.

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

Вики-разметка таблиц

{| начало таблицы
|+ заголовок таблицы, необязательно; только один на таблицу, между началом таблицы и первой строкой
|- строка таблицы, в первой строке необязательно -- движок вики сам подставит первую строку
! заглавная ячейка, необязательно. Последовательность заглавных ячеек можно записывать на одной строке, с двойными разделителями (!!) или начинать с новой строки, каждую со своим знаком (!).
| ячейка данных, требуется! Последовательность заглавных ячеек можно записывать на одной строке, с двойными разделителями (||) или начинать с новой строки, каждую со своим знаком (|).
|} конец таблицы
  • Вышеприведенные знаки должны начинаться с новой строки, кроме двойных || и !! для последовательности ячеек.
  • Атрибуты XHTML. Каждый знак разметки, кроме конца таблицы, может иметь при себе один или несколько атрибутов XHTML.
    • У ячеек и заголовка (| или ||, ! или !!, и |+) есть содержимое. Содержимое от атрибутов тэга отделяется вертикальной чертой (|). Содержимое может располагаться в той же строке или в следующих строках.
    • У меток таблицы и строки таблицы ({| и |-) нет содержимого. Не ставьте вертикальную черту (|) после их необязательных атрибутов! Если вы по ошибке поставите черту после атрибутов таблицы или строки, парсер удалит её и последний атрибут, если он был рядом с ошибочной чертой.
  • Содержимое может располагаться а) за знаком ячейки в той же строке после необязательных XHTML атрибутов или б) на строках под знаком ячейки. Содержимое, использующее вики-разметку, которая должна сама начинаться с новой строки, например, списки, заголовки или вложенные таблицы, разумеется, должно начинаться с новой строки.


Простая таблица

Обычная

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

Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{|
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое
|}

Альтернатива

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

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

В эту таблицу можно было бы добавить HTML атрибуты, но для простоты обойдёмся без них.

Апельсин Яблоко и т.д.
Хлеб Булка и т.д.
Масло Мороженое и т.д.
{|
|  Апельсин  ||   Яблоко  ||   и т.д.
|-
|    Хлеб    ||    Булка  ||   и т.д.
|-
|    Масло   || Мороженое ||   и т.д.
|}

С HTML атрибутами

Вы можете добавить HTML атрибуты, чтобы таблица смотрелась лучше

border="1"
Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| border="1"
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}
align="center" border="1"
Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| align="center" border="1"
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}
align="right" border="1"

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

Апельсин Яблоко 12,333.00
Хлеб Булка 500.00
Масло Мороженое 1.00
{| border="1"
|Апельсин
|Яблоко
|align="right"|12,333.00
|-
|Хлеб
|Булка
|align="right"|500.00
|-
|Масло
|Мороженое
|align="right"|1.00
|}

Можно использовать атрибуты в отдельных строках.

Апельсин Яблоко 12,333.00
Хлеб Булка 500.00
Масло Мороженое 1.00
{| border="1"
|Апельсин
|Яблоко
|align="right"|12,333.00
|-
|Хлеб
|Булка
|align="right"|500.00
|- style="font-style:italic;color:green;"
|Масло
|Мороженое
|align="right"|1.00
|}

cellspacing="0" border="1"

Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| cellspacing="0" border="1"
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}
cellpadding="20" cellspacing="0" border="1"
Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| cellpadding="20" cellspacing="0" border="1"
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}

С HTML атрибутами и стилями CSS

Стили CSS можно использовать вместе с другими HTML атрибутами или отдельно. style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"

Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| style="color:green;background-color:#ffffcc;" cellpadding="20" cellspacing="0" border="1"
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}

Таблица с заголовками TH

Для создания TH (заглавной ячейки таблицы в HTML) используйте ! вместо |. Заглавная ячейка обычно выделяется жирным и центрирована по умолчанию.

Заголовки столбцов

В каждом столбце
Вкусно Вкуснее
Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| border="1" cellpadding="20" cellspacing="0"
!Вкусно
!Вкуснее
|-
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}
Colspan="2"
Вкусные
Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| border="1" cellpadding="20" cellspacing="0"
! colspan="2"|Вкусные
|-
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}

Заголовки строк

По умолчанию
Фрукт Апельсин Яблоко
Еда Хлеб Булка
Добавка Масло Мороженое
{| border="1" cellpadding="20" cellspacing="0"
!Фрукт
|Апельсин
|Яблоко
|-
!Еда
|Хлеб
|Булка
|-
!Добавка
|Масло
|Мороженое 
|}
Выравнивание вправо

Заголовки строк, выровненные вправо, можно сделать так:

Фрукт Апельсин Яблоко
Еда Хлеб Булка
Добавка Масло Мороженое
{| border="1" cellpadding="20" cellspacing="0"
!align="right" |Фрукт
|Апельсин
|Яблоко
|-
!align="right" |Еда
|Хлеб
|Булка
|-
!align="right" |Добавка
|Масло
|Мороженое 
|}

Заглавие таблицы

Заглавие наверху таблицы можно добавить так:

Продукты
Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| border="1" cellpadding="20" cellspacing="0"
|+Продукты
|-
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}

В заглавие тоже можно добавить атрибуты.

Продукты
Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| border="1" cellpadding="20" cellspacing="0"
|+align="bottom" style="color:#e76700;"|''Продукты''
|-
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}

Заголовки H1, H2, H3 и т.д.

HTML-заголовки H1, H2, H3, H4 и т.д. могут быть созданы с помощью обычной вики-разметки со знаками ==равенства== и должны быть целиком в одну строку.

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

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

Вкуснейшие

Апельсин Яблоко
Хлеб Булка
Масло Мороженое
{| border="3"  cellpadding="20" cellspacing="0"
|colspan="2"|
====Вкуснейшие====
|-
|Апельсин
|Яблоко
|-
|Хлеб
|Булка
|-
|Масло
|Мороженое 
|}

Предупреждение

Отрицательные числа

Отрицательные числа или знак минус (обозначающий отсутствие какого-либо значения) может нарушить таблицу, если ячейка начинается с новой строки (|-6), потому что это воспринимается вики как начало новой строки в таблице, а не новой ячейки. Чтобы избежать такой проблемы, ставьте пробел перед минусом (| -6) или воспользуйтесь внутристроковой разметкой (||-6).

Конвертор HTML to Wiki

Если у вас имеются статьи написанные в HTML разметке, то имеется возможность безболезненно перевести её в Wiki разметку. В этом поможет ресурс http://toolserver.org/~diberri/cgi-bin/html2wiki/index.cgi в большое окно вставляем статью в HTML, в опциях выбираем Wiki dialect: MediaWiki , нажимаем кнопку "Convert HTML to wiki markup" и вуаля, получаем код с wiki разметкой.

Персональные инструменты
Образовательная галактика Intel Программа Intel 'Обучение для будущего' Программа 'Учимся с Intel' Летописи России Инициативы Intel в образовании