## Please edit system and help pages ONLY in the master wiki!
## For more information, please see MoinMoin:MoinDev/Translation.
##master-page:HelpOnFormatting
##master-date:2010-05-13T11:55:27Z
#acl -All:write Default
#format wiki
#language ru

= Форматирование =

<<TableOfContents>>

Данная страница описывает аспекты форматирования текста в синтаксисе вики-разметки МойнМойн (который является основным для МойнМойн, но не единственным). Для информации о других поддерживаемых языках разметки см. ПомощьПоПарсерам.

== Основы ==

 * Для разделения параграфов используется одна или более пустых строк.
 * Для переноса строк внутри параграфа используется [[ПомощьПоМакроКомандам|макрокоманда]] `<<BR>>`

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

||<rowbgcolor="#ffffcc"> '''Разметка''' || '''Результат'''             || '''Примечания'''                                                      ||
||  `''курсив''`                        || ''курсив''                  || Текст обрамляется двумя одинарными кавычками.                         ||
||  `'''полужирное начертание'''`       || '''полужирное начертание''' || Текст обрамляется тремя одинарными кавычками.                         ||
||  {{{`моноширинный шрифт`}}}          || `моноширинный шрифт`        || Текст обрамляется апострофами. Разметка внутри них игнорируется.      ||
||  `{{{код}}}`                         || {{{код}}}                   || [[#code_example|Пример использования.]] Разметка внутри игнорируется. ||
||  `__подчёркивание__`                 || __подчёркивание__           ||                                                                       ||
||  `^верхний^индекс`                   || ^верхний^индекс             ||                                                                       ||
||  `,,нижний,,индекс`                  || ,,нижний,,индекс            ||                                                                       ||
||  `~-уменьшенный шрифт-~`             || ~-уменьшенный шрифт-~       ||                                                                       ||
||  `~+увеличенный шрифт+~`             || ~+увеличенный шрифт+~       ||                                                                       ||
|| `--(перечёркивание)--`               || --(перечёркивание)--        || Появилось в версии МойнМойн 1.5                                       ||

== Задание цвета текста ==

Задание цвета текста поддерживается внутри таблиц без использования дополнительных макрокоманд (см. ПомощьПоТаблицам).

Также возможно установить и использовать макрокоманду: [[MoinMoin:MacroMarket/Color2|Color2]].

== Подсветка синтаксиса ==

Существует несколько способов вставить код с подсветкой синтаксиса:
 1. Указать в начале блока кода имя [[ПомощьПоПарсерам|парсера]]: `{{{#!имя_пармера`
 1. Внедрить прикреплённый файл с поддерживаемым расширением (например, `.py`) при помощи `inline:`
 1. Добавить в начале страницы [[ПомощьПоИнструкциям|инструкцию указания формата страницы]]: `#format имя_пармера`

[[#color_code_example|Пример использования.]]

МойнМойн содержит специальный парсер, называемый [[ПомощьПоПарсерам#highlight|highlight]], который основан на [[http://pygments.org/|Pygments]]. Он может использоваться для подсветки синтаксиса большого количества языков программирования, конифгурационных файлов и других видов текстовых файлов.

Для просмотра списка поддерживаемых языков см. ПомощьПоПарсерам.

== Примеры ==

=== Смешивание ''курсива'' и '''полужирного начертания''' ===
<<Anchor(italic_bold_example)>>

||<rowbgcolor="#ffffcc" width="50%"> '''Разметка'''                           || '''Результат'''                                                          ||
|| `'''''Полужирное начертание''' в начале фрагмента, набранного курсивом''`  || '''''Полужирное начертание''' в начале фрагмента, набранного курсивом''  ||
|| `'''''Курсив'' в начале фрагмента с полужирным начертанием'''`             || '''''Курсив'' в начале фрагмента с полужирным начертанием'''             ||
|| `'''В конце фрагмента с полужирным начертанием — ''курсив'''''`            || '''В конце фрагмента с полужирным начертанием — ''курсив'''''            ||
|| `''В конце фрагмента, набранного курсивом — '''полужирное начертание'''''` || ''В конце фрагмента, набранного курсивом — '''полужирное начертание''''' ||

=== Верхний и нижний индексы ===

'''Разметка:'''
{{{
''a''^2^ `+` ''b''^2^ `=` ''c''^2^, H,,2,,O.
}}}
'''Результат:'''
{{{#!wiki
''a''^2^ `+` ''b''^2^ `=` ''c''^2^, H,,2,,O.
}}}

=== Код ===
<<Anchor(code_example)>>

'''Разметка:'''
{{{{
{{{
10 PRINT "Hello, world!"
20 GOTO 10
}}}
}}}}
'''Результат:'''
{{{{#!wiki
{{{
10 PRINT "Hello, world!"
20 GOTO 10
}}}
}}}}

==== Вложенные блоки кода ====

Как сказано на странице ПомощьПоПарсерам, можно использовать несколько уровней вложенности блоков, ограниченных фигурными скобками:

'''Разметка:'''
{{{{{
{{{{ 
Это — блок неформатированного текста.
{{{ с использованием фигурных скобок }}}
}}}}
}}}}}
'''Результат:'''
{{{{{#!wiki
{{{{
Это — блок неформатированного текста.
{{{ с использованием фигурных скобок }}}
}}}}
}}}}}

==== Подсветка синтаксиса ====
<<Anchor(color_code_example)>>

'''Разметка:'''
{{{{
{{{#!highlight python
from colors import palette

palette.colorize('python')
}}}
}}}}
'''Результат:'''
{{{{#!wiki
{{{#!highlight python
from colors import palette

palette.colorize('python')
}}}
}}}}
