summaryrefslogtreecommitdiffhomepage
diff options
context:
space:
mode:
authorAleksey Pirogov <astynax84@gmail.com>2014-10-19 09:23:10 +0400
committerAleksey Pirogov <astynax84@gmail.com>2014-10-19 09:23:10 +0400
commit9a2123c6757bd11f8723437032e823656987a011 (patch)
treeee50416213f6dc25f5f3fad17b3a3347c2d30481
parent16b1249444203485168124bfa54c66b3b1abf1ee (diff)
edits of ru-ru/markdown-ru
-rw-r--r--ru-ru/markdown-ru.html.markdown68
1 files changed, 38 insertions, 30 deletions
diff --git a/ru-ru/markdown-ru.html.markdown b/ru-ru/markdown-ru.html.markdown
index 8b2a0982..eb8e4881 100644
--- a/ru-ru/markdown-ru.html.markdown
+++ b/ru-ru/markdown-ru.html.markdown
@@ -7,27 +7,32 @@ filename: markdown-ru.md
lang: ru-ru
---
-Язык разметки Markdown создан Джоном Грубером (англ. John Gruber) и Аароном Шварцем (англ. Aaron H. Swartz) в 2004 году. Авторы задавались целью создать максимально удобочитаемый и удобный в публикации облегчённый язык разметки, пригодный для последующего преобразования в HTML (а также и в другие форматы).
+Язык разметки Markdown создан Джоном Грубером (англ. John Gruber)
+и Аароном Шварцем (англ. Aaron H. Swartz) в 2004 году.
+Авторы задавались целью создать максимально удобочитаемый
+и удобный в публикации облегчённый язык разметки,
+пригодный для последующего преобразования в HTML
+(а также и в другие форматы).
```markdown
<!-- Markdown является надмножеством HTML, поэтому любой HTML-файл является
-валидным документом Markdown, что позволяет использовать напрямую любые элементы
-HTML-разметки, такие, например, как этот комментарии.
+валидным документом Markdown, что позволяет использовать напрямую
+любые элементы HTML-разметки, такие, например, как этот комментарий.
Встроенные в документ HTML-элементы не затрагиваются парсером Markdown
и попадают в итоговый HTML без изменений. Однако, следует понимать,
-что эта жа особенность не позволяет использовать разметку Markdown внутри
+что эта же особенность не позволяет использовать разметку Markdown внутри
HTML-элементов -->
<!-- Ещё одна особенность формата Markdown состоит в том, что поддерживаемые
возможности разметки зависят от конкретной реализации парсера. В данном
-руководстве возможности, поддерживаемые лишь определёнными парсерами
+руководстве возможности, поддерживаемые лишь определёнными парсерами,
сопровождаются соответствующими примечаниями. -->
<!-- Заголовки -->
<!-- HTML-элементы от <h1> до <h6> размечаются очень просто:
-текст, который должен стать заголовком, предваряется соответствующим количеством
-символов "#": -->
+текст, который должен стать заголовком, предваряется
+соответствующим количеством символов "#": -->
# Это заголовок h1
## Это заголовок h2
### Это заголовок h3
@@ -47,7 +52,7 @@ HTML-элементов -->
<!-- Текст легко сделать полужирным и/или курсивным: -->
*Этот текст будет выведен курсивом.*
-_Также как этот._
+_Так же, как этот._
**А этот текст будет полужирным.**
__И этот тоже.__
@@ -56,15 +61,15 @@ __И этот тоже.__
**_И тут!_**
*__И даже здесь!__*
-<!-- В Github Flavored Markdown (версии Markdown, использующейся в Github
+<!-- В Github Flavored Markdown (версии Markdown, использующейся в Github,
для рендеринга Markdown-документов) текст можно сделать зачёркнутым: -->
~~Зачёркнутый текст.~~
-<!-- Параграфами являются любые строки, следующие друг за другом.
-Разделяются же параграфы - одной или несколькими пустыми строками: -->
+<!-- Абзацами являются любые строки, следующие друг за другом.
+Разделяются же абзацы одной или несколькими пустыми строками: -->
-Это параграф. Всё предельно просто.
+Это абзац. Всё предельно просто.
А тут уже параграф №2.
Эта строка всё ещё относится к параграфу №2!
@@ -72,7 +77,7 @@ __И этот тоже.__
О, а вот это уже параграф №3!
-<!-- Для втавки принудительных переносов можно использовать HTML-тэг <br/>: -->
+<!-- Для вставки принудительных переносов можно использовать HTML-тэг <br/>: -->
Принудительный <br/> перенос!
@@ -90,24 +95,24 @@ __И этот тоже.__
<!-- Списки -->
<!-- Маркированные списки размечаются вставкой в начало каждого элемента
-одного из символов "*", "+" и "-":
+одного из символов "*", "+" или "-":
(символ должен быть одним и тем же для всех элементов) -->
* Список,
* Размеченный
-* "Звёздочками"
+* Звёздочками
либо
+ Список,
+ Размеченный
-+ "Плюсами"
++ Плюсами
либо
- Список,
- Размеченный
-- "Дефисами"
+- Дефисами
<!-- В нумерованных списках каждая строка начинается
с числа и точки вслед за ним: -->
@@ -155,7 +160,7 @@ __И этот тоже.__
<!-- Github Flavored Markdown позволяет указать для блока кода синтаксис оного.
В этом случае синтаксис внутри блока будет подсвечен. Пример: -->
-\`\`\`ruby <!-- Только нужно будет убрать backslashes, оставив лишь "```ruby" -->
+\`\`\`ruby <!-- Только нужно будет убрать символы "\", оставив лишь "```ruby" -->
def foobar
puts "Hello world!"
end
@@ -174,9 +179,10 @@ end
****************
<!-- Ссылки -->
-<!-- Одной из сильных сторон Markdown можно смело считать то, как просто
-размечаются гипер-ссылки. Для создания ссылки укажите текст ссылки, заключив его в
-квадратные скобки, и сразу после - url, заключенный в "круглые" -->
+<!-- Одной из сильных сторон Markdown можно смело считать то,
+как просто размечаются гиперссылки. Для создания ссылки укажите
+текст ссылки, заключив его в квадратные скобки,
+и сразу после - url, заключенный в "круглые" -->
[Ссылка!](http://test.com/)
@@ -193,15 +199,16 @@ end
[Здесь][link1] высможете узнать больше!
А можно кликнуть [сюда][foobar], если очень хочется.
-<!-- где нибудь внизу -->
+<!-- где-нибудь внизу -->
[link1]: http://test.com/ "Круто!"
[foobar]: http://foobar.biz/ "Тоже хорошо!"
<!-- Примечания:
- Подсказка может быть заключена в одинарные кавычки вместо двойных,
- а также - в круглые скобки.
-- Сноска может находиться в любом месте документа и может иметь ID
-произвольной длины, лишь бы это ID был уникальным. -->
+ а также в круглые скобки.
+- Сноска может находиться в любом месте документа и может иметь
+идентификатор (далее ID) произвольной длины,
+лишь бы это ID был уникальным. -->
<!-- Также при разметке ссылок-сносок можно опустить ID,
если текст ссылки уникален в пределах документа: -->
@@ -227,20 +234,21 @@ end
[myimage]: relative/urls/cool/image.jpg "подсказка"
<!-- Ещё немного ссылок: -->
-<!-- Авто-ссылки -->
+<!-- Автоссылки -->
Ссылка вида <http://testwebsite.com/> эквивалентна
[http://testwebsite.com/](http://testwebsite.com/)
-<!-- Авто-ссылки для email -->
+<!-- Автоссылки для адресов электронной почты -->
<foo@bar.com>
<!-- Экранирование символов -->
-<!-- Может потребоваться вставить спец-символ в текст "как есть",
+<!-- Может потребоваться вставить спецсимвол в текст "как есть",
т.е. защитить его от обработки парсером.
-Такой символ должен быть "экранирован" с помощью обратного слэша: -->
+Такой символ должен быть "экранирован" с помощью обратной косой черты
+(символа "\"): -->
\*текст, заключённый в звёздочки!\*
@@ -249,7 +257,7 @@ end
да и синтаксис имеют не слишком удобный.
Но если очень нужно, размечайте таблицы так: -->
-| Колонка 1 | Колонка 2 | Колонка 3 |
+| Столбец 1 | Столбец 2 | Столбец 3 |
| :----------- | :----------: | -----------: |
| Выравнивание | Выравнивание | Выравнивание |
| влево | по центру | вправо |