[markdown/ru] Updating to reflect changes in the English file

This commit is contained in:
Andre Polykanine A.K.A. Menelion Elensúlë 2016-03-15 01:09:25 +02:00
commit 04796bcd2f

View File

@ -2,55 +2,77 @@
language: markdown language: markdown
contributors: contributors:
- ["Dan Turkel", "http://danturkel.com/"] - ["Dan Turkel", "http://danturkel.com/"]
- ["Jacob Ward", "http://github.com/JacobCWard/"]
translators:
- ["Pirogov Alexey", "http://twitter.com/alex_pir"] - ["Pirogov Alexey", "http://twitter.com/alex_pir"]
- ["Andre Polykanine", https://github.com/Oire"]
filename: markdown-ru.md filename: markdown-ru.md
lang: ru-ru lang: ru-ru
--- ---
Язык разметки Markdown создан Джоном Грубером (англ. John Gruber) Язык разметки Markdown создан Джоном Грубером (англ. John Gruber)
и Аароном Шварцем (англ. Aaron H. Swartz) в 2004 году. в 2004 году.
Авторы задавались целью создать максимально удобочитаемый Авторы задавались целью создать максимально удобочитаемый
и удобный в публикации облегчённый язык разметки, и удобный в публикации облегчённый язык разметки,
пригодный для последующего преобразования в HTML пригодный для последующего преобразования в HTML
(а также и в другие форматы). (а также и в другие форматы).
Также реализации Markdown варьируют в зависимости от парсера.
В этом руководстве будет указано, какие функции универсальны для языка,
а какие зависят от конкретного парсера.
- [HTML-элементы](#html-elements)
- [Заголовки](#headings)
- [Простейшая стилизация текста](#simple-text-styles)
- [Абзацы](#paragraphs)
- [Списки](#lists)
- [Блоки кода](#code-blocks)
- [Горизонтальный разделитель](#horizontal-rule)
- [Ссылки](#links)
- [Изображения](#images)
- [Разное](#miscellany)
## HTML-элементы
Markdown является надмножеством HTML, поэтому любой HTML-файл является
корректным документом Markdown.
```markdown ```markdown
<!-- Markdown является надмножеством HTML, поэтому любой HTML-файл является <!-- Это позволяет использовать напрямую
валидным документом Markdown, что позволяет использовать напрямую
любые элементы HTML-разметки, такие, например, как этот комментарий. любые элементы HTML-разметки, такие, например, как этот комментарий.
Встроенные в документ HTML-элементы не затрагиваются парсером Markdown Встроенные в документ HTML-элементы не затрагиваются парсером Markdown
и попадают в итоговый HTML без изменений. Однако, следует понимать, и попадают в итоговый HTML без изменений. Однако следует понимать,
что эта же особенность не позволяет использовать разметку Markdown внутри что эта же особенность не позволяет использовать разметку Markdown внутри
HTML-элементов --> HTML-элементов -->
<!-- Ещё одна особенность формата Markdown состоит в том, что поддерживаемые ## Заголовки
возможности разметки зависят от конкретной реализации парсера. В данном
руководстве возможности, поддерживаемые лишь определёнными парсерами,
сопровождаются соответствующими примечаниями. -->
<!-- Заголовки --> HTML-элементы от <h1> до <h6> размечаются очень просто:
<!-- HTML-элементы от <h1> до <h6> размечаются очень просто:
текст, который должен стать заголовком, предваряется текст, который должен стать заголовком, предваряется
соответствующим количеством символов "#": --> соответствующим количеством символов "#":
```markdown
# Это заголовок h1 # Это заголовок h1
## Это заголовок h2 ## Это заголовок h2
### Это заголовок h3 ### Это заголовок h3
#### Это заголовок h4 #### Это заголовок h4
##### Это заголовок h5 ##### Это заголовок h5
###### Это заголовок h6 ###### Это заголовок h6
```
Markdown позволяет размечать заголовки <h1> и <h2> ещё одним способом:
<!-- Markdown позволяет размечать заголовки <h1> и <h2> ещё одним способом: --> ```markdown
Это заголовок h1 Это заголовок h1
================ ================
А это заголовок h2 А это заголовок h2
------------------ ------------------
```
<!-- Простейшая стилизация текста --> ## Простейшая стилизация текста
<!-- Текст легко сделать полужирным и/или курсивным: --> Текст легко сделать полужирным и/или курсивным:
```markdown
*Этот текст будет выведен курсивом.* *Этот текст будет выведен курсивом.*
_Так же, как этот._ _Так же, как этот._
@ -60,44 +82,58 @@ __И этот тоже.__
***Полужирный курсив.*** ***Полужирный курсив.***
**_И тут!_** **_И тут!_**
*__И даже здесь!__* *__И даже здесь!__*
```
<!-- В GitHub Flavored Markdown (версии Markdown, использующейся в GitHub, В Github Flavored Markdown, стандарте, который используется в Github,
для рендеринга Markdown-документов) текст можно сделать зачёркнутым: --> текст также можно сделать зачёркнутым:
```markdown
~~Зачёркнутый текст.~~ ~~Зачёркнутый текст.~~
```
<!-- Абзацами являются любые строки, следующие друг за другом. ## Абзацы
Разделяются же абзацы одной или несколькими пустыми строками: -->
Это абзац. Всё предельно просто. Абзацами являются любые строки, следующие друг за другом.
Разделяются же абзацы одной или несколькими пустыми строками:
А тут уже параграф №2. ```markdown
Эта строка всё ещё относится к параграфу №2! Это абзац. Я печатаю в абзаце, разве это не прикольно?
А тут уже абзац №2.
Эта строка всё ещё относится к абзацу №2!
О, а вот это уже параграф №3! О, а вот это уже абзац №3!
```
<!-- Для вставки принудительных переносов можно использовать HTML-тэг <br/>: --> Для вставки принудительных переносов можно завершить абзац двумя дополнительными пробелами:
Принудительный <br/> перенос! ```markdown
Эта строка завершается двумя пробелами (выделите, чтобы увидеть!).
<!-- Цитаты размечаются с помощью символа ">": --> Над этой строкой есть <br />!
```
Цитаты размечаются с помощью символа «>»:
```markdown
> Это цитата. В цитатах можно > Это цитата. В цитатах можно
> принудительно переносить строки, вставляя ">" в начало каждой следующей строки. А можно просто оставлять достаточно длинными, и такие длинные строки будут перенесены автоматически. > принудительно переносить строки, вставляя «>» в начало каждой следующей строки. А можно просто оставлять их достаточно длинными, и такие длинные строки будут перенесены автоматически.
> Разницы между этими двумя подходами к переносу строк нет, коль скоро > Разницы между этими двумя подходами к переносу строк нет, коль скоро
> каждая строка начинается с символа ">" > каждая строка начинается с символа «>»
> А ещё цитаты могут быть многоуровневыми: > А ещё цитаты могут быть многоуровневыми:
>> как здесь >> как здесь
>>> и здесь :) >>> и здесь :)
> Неплохо? > Неплохо?
```
<!-- Списки --> ## Списки
<!-- Маркированные списки размечаются вставкой в начало каждого элемента Маркированные списки размечаются вставкой в начало каждого элемента
одного из символов "*", "+" или "-": одного из символов «*», «+» или «-»:
(символ должен быть одним и тем же для всех элементов) --> (символ должен быть одним и тем же для всех элементов)
```markdown
* Список, * Список,
* Размеченный * Размеченный
* Звёздочками * Звёздочками
@ -113,167 +149,207 @@ __И этот тоже.__
- Список, - Список,
- Размеченный - Размеченный
- Дефисами - Дефисами
```
<!-- В нумерованных списках каждая строка начинается В нумерованных списках каждая строка начинается
с числа и точки вслед за ним: --> с числа и точки вслед за ним:
```markdown
1. Первый элемент 1. Первый элемент
2. Второй элемент 2. Второй элемент
3. Третий элемент 3. Третий элемент
```
<!-- Заметьте, нумеровать элементы корректно необязательно. Достаточно указать Заметьте, нумеровать элементы корректно необязательно. Достаточно указать
любое число в начале каждого элемента и рендер пронумерует элементы сам! любое число в начале каждого элемента, и парсер пронумерует элементы сам!
Правда, злоупотреблять этим не стоит :) --> Правда, злоупотреблять этим не стоит :)
```markdown
1. Первый элемент 1. Первый элемент
1. Второй элемент 1. Второй элемент
1. Третий элемент 1. Третий элемент
<!-- (Этот список будет отрендерен так же, как и предыдущий!) --> ```
(Этот список будет отображён так же, как и предыдущий!)
<!-- Списки могут быть вложенными: --> Списки могут быть вложенными:
```markdown
1. Введение 1. Введение
2. Начало работы 2. Начало работы
3. Примеры использования 3. Примеры использования
* Простые * Простые
* Сложные * Сложные
4. Заключение 4. Заключение
```
<!-- Блоки с исходным кодом --> Можно даже делать списки задач. Блок ниже создаёт HTML-флажки.
<!-- Фрагменты исходного кода выделяются очень просто - каждая строка блока должна иметь отступ в четыре пробела либо в один символ табуляции -->
```markdown
Для отметки флажка используйте «x»
- [ ] Первая задача
- [ ] Вторая задача
Этот флажок ниже будет отмечен
- [x] Задача была завершена
```
## Блоки кода
Фрагменты исходного кода (обычно отмечаемые тегом `<code>`) выделяются просто:
каждая строка блока должна иметь отступ в четыре пробела либо в один символ табуляции.
```markdown
Это код, Это код,
причём - многострочный причём многострочный
```
<!-- Дополнительные отступы в коде следует делать с помощью четырёх пробелов: --> Вы также можете делать дополнительные отступы, добавляя символы табуляции
или по четыре пробела:
```markdown
my_array.each do |item| my_array.each do |item|
puts item puts item
end end
```
<!-- Иногда бывает нужно вставить фрагмент кода прямо в строку текста, Иногда бывает нужно вставить фрагмент кода прямо в строку текста,
не выделяя код в блок. Для этого фрагменты кода нужно обрамлять не выделяя код в блок. Для этого фрагменты кода нужно обрамлять
символами "`": --> символами «`»:
Например, можно выделить имя функции `go_to()` прямо посреди текста. ```markdown
Ваня даже не знал, что делает функция `go_to()`!
```
<!-- GitHub Flavored Markdown позволяет указать для блока кода синтаксис оного. В Github Flavored Markdown для блоков кода можно использовать
В этом случае синтаксис внутри блока будет подсвечен. Пример: --> специальный синтаксис:
\`\`\`ruby <!-- Только нужно будет убрать символы "\", оставив лишь "```ruby" --> <pre>
<code class="highlight">&#x60;&#x60;&#x60;ruby
def foobar def foobar
puts "Hello world!" puts "Привет, мир!"
end end
\`\`\` <!-- И здесь тоже backslashes нужно убрать, т.е. оставить "```" --> &#x60;&#x60;&#x60;</code></pre>
<-- Обратите внимание: фрагмент, указанный выше, не предваряется отступами, Во фрагменте, приведённом выше, отступ не требуется.
поскольку GitHub сам в состоянии определить границы блока - по строкам "```" --> Кроме того, Github подсветит синтаксис языка, указанного после \`\`\`
<!-- Горизонтальный разделитель (<hr />) --> ## Горизонтальный разделитель
<!-- Разделители добавляются вставкой строки из трёх и более
(одинаковых) символов "*" или "-": -->
Разделители (`<hr>`) добавляются вставкой строки из трёх и более
(одинаковых) символов «*» или «-», с пробелами или без них:
```markdown
*** ***
--- ---
- - - <!-- между символами допустимы пробелы --> - - -
**************** ****************
```
<!-- Ссылки --> ## Ссылки
<!-- Одной из сильных сторон Markdown можно смело считать то,
Одной из сильных сторон Markdown можно смело считать то,
как просто размечаются гиперссылки. Для создания ссылки укажите как просто размечаются гиперссылки. Для создания ссылки укажите
текст ссылки, заключив его в квадратные скобки, текст ссылки, заключив его в квадратные скобки,
и сразу после - url, заключенный в "круглые" --> и сразу после — URL-адрес, заключенный в круглые
```markdown
[Ссылка!](http://test.com/) [Ссылка!](http://test.com/)
```
Также для ссылки можно указать всплывающую подсказку (`title`), используя
кавычки внутри круглых скобок:
<!-- Также для ссылки можно указать всплывающую подсказку: --> ```markdown
[Ссылка!](http://test.com/ "Ссылка на Test.com") [Ссылка!](http://test.com/ "Ссылка на Test.com")
```
Относительные пути тоже возможны:
<!-- В url можно использовать относительные пути: --> ```markdown
[Перейти к музыке](/music/). [Перейти к музыке](/music/).
```
<!-- Markdown позволяет размечать ссылку в виде сноски: --> Markdown также позволяет размечать ссылку в виде сноски:
[Здесь][link1] высможете узнать больше! <pre><code class="highlight">&#x5b;<span class="nv">Щёлкните эту ссылку</span>][<span class="ss">link1</span>] для подробной информации!
А можно кликнуть [сюда][foobar], если очень хочется. &#x5b;<span class="nv">Также посмотрите эту ссылку,</span>][<span class="ss">foobar</span>] если хотите.
<!-- где-нибудь внизу --> &#x5b;<span class="nv">link1</span>]: <span class="sx">http://test.com/</span> <span class="nn">"Круто!"</span>
[link1]: http://test.com/ "Круто!" &#x5b;<span class="nv">foobar</span>]: <span class="sx">http://foobar.biz/</span> <span class="nn">"Нормально!"</span></code></pre>
[foobar]: http://foobar.biz/ "Тоже хорошо!"
<!-- Примечания: `Title` также может быть в одинарных кавычках или круглых скобках, а также
- Подсказка может быть заключена в одинарные кавычки вместо двойных, отсутствовать вовсе. Ссылки на сноски могут быть в любом месте документа,
а также в круглые скобки. а идентификаторы могут быть какими угодно, лишь бы они были уникальными.
- Сноска может находиться в любом месте документа и может иметь
идентификатор (далее ID) произвольной длины,
лишь бы это ID был уникальным. -->
<!-- Также при разметке ссылок-сносок можно опустить ID, Существует также неявное именование, когда ссылка является идентификатором.
если текст ссылки уникален в пределах документа: -->
Ссылка на [Google][]. <pre><code class="highlight">&#x5b;<span class="nv">Это</span>][] ссылка.
[google]: http://google.com/ &#x5b;<span class="nv">это</span>]: <span class="sx">http://thisisalink.com/</span></code></pre>
<!-- Правда, эта возможность не очень распространена. --> Правда, эта возможность не очень распространена.
<!-- Изображения --> ## Изображения
<!-- Разметка изображений очень похожа на разметку ссылок. Разметка изображений очень похожа на разметку ссылок.
Нужно всего лишь добавить "!" перед ссылкой! --> Нужно всего лишь добавить перед ссылкой восклицательный знак!
```markdown
![Альтернативный текст для изображения](http://imgur.com/myimage.jpg "Подсказка") ![Альтернативный текст для изображения](http://imgur.com/myimage.jpg "Подсказка")
```
Изображения тоже могут быть оформлены, как сноски.
<!-- Изображения тоже могут быть оформлены, как сноски: --> <pre><code class="highlight">!&#x5b;<span class="nv">Это альтернативный текст.</span>][<span class="ss">myimage</span>]
![Альтернативный текст][myimage] &#x5b;<span class="nv">myimage</span>]: <span class="sx">relative/urls/cool/image.jpg</span> <span class="nn">"Если нужна подсказка, её можно добавить"</span></code></pre>
## Разное
![То же изображение ещё раз][myimage] ### Автоссылки
[myimage]: relative/urls/cool/image.jpg "подсказка"
<!-- Ещё немного ссылок: -->
<!-- Автоссылки -->
```markdown
Ссылка вида <http://testwebsite.com/> эквивалентна Ссылка вида <http://testwebsite.com/> эквивалентна
[http://testwebsite.com/](http://testwebsite.com/) [http://testwebsite.com/](http://testwebsite.com/)
```
<!-- Автоссылки для адресов электронной почты --> ### Автоссылки для адресов электронной почты
```markdown
<foo@bar.com> <foo@bar.com>
```
<!-- Экранирование символов --> ### Экранирование символов
<!-- Может потребоваться вставить спецсимвол в текст "как есть", ```markdown
т.е. защитить его от обработки парсером. Я хочу напечатать *текст, заключённый в звёздочки*, но я не хочу,
Такой символ должен быть "экранирован" с помощью обратной косой черты чтобы он был курсивным. Тогда я делаю так:
(символа "\"): --> \*Текст, заключённый в звёздочки\*
```
\*текст, заключённый в звёздочки!\* ### Клавиши на клавиатуре
В Github Flavored Markdown для представления клавиш на клавиатуре
вы можете использовать тег `<kbd>`.
<!-- Таблицы --> ```markdown
<!-- Таблицы официально поддерживаются только в GitHub Flavored Markdown, Ваш компьютер завис? Попробуйте нажать
<kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd>
```
### Таблицы
Таблицы официально поддерживаются только в GitHub Flavored Markdown,
да и синтаксис имеют не слишком удобный. да и синтаксис имеют не слишком удобный.
Но если очень нужно, размечайте таблицы так: --> Но если очень нужно, размечайте таблицы так:
```markdown
| Столбец 1 | Столбец 2 | Столбец 3 | | Столбец 1 | Столбец 2 | Столбец 3 |
| :----------- | :----------: | -----------: | | :----------- | :----------: | -----------: |
| Выравнивание | Выравнивание | Выравнивание | | Выравнивание | Выравнивание | Выравнивание |
| влево | по центру | вправо | | влево | по центру | вправо |
```
Или более компактно
<!-- Или более компактно --> ```markdown
Столбец 1|Столбец 2|Столбец 3
Колонка 1|Колонка 2|Колонка 3
:--|:-:|--: :--|:-:|--:
Выглядит|это|страшновато... Выглядит|это|страшновато...
<!-- Ну вот и всё! -->
``` ```
Ну вот и всё!
За более подробной информацией обращайтесь к [статье](http://daringfireball.net/projects/markdown/syntax) Джона Грубера о синтаксисе Markdown. За более подробной информацией обращайтесь к [статье](http://daringfireball.net/projects/markdown/syntax) Джона Грубера о синтаксисе Markdown.
Также часто бывает полезной отличная ["шпаргалка"](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) по Markdown от Adam Pritchard. Также часто бывает полезной отличная ["шпаргалка"](https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet) по Markdown от Адама Притчарда.
Если вдруг встретите ошибки в переводе или же захотите его дополнить, делайте pull requests - авторы всегда рады обратной связи!