[asciidoc/ru] Add russian translation for asciidoc article

ru/asciidoc.md

@@ -0,0 +1,133 @@
+---
+name: AsciiDoc
+contributors:
+    - ["Ryan Mavilia", "http://unoriginality.rocks/"]
+    - ["Abel Salgado Romero", "https://twitter.com/abelsromero"]
+translators:
+    - ["Another Timur", "https://github.com/HardCoreDevMachine"]
+---
+
+AscciiDoc это язык разметки схожий с Markdown и который можно использовать везде - от книг до блогов. ССозданный в 2002 году Стюартом Рэкхэмом, этот язык прост, но допускает множество настроек.
+
+Заголовки документа
+
+Заголовки опциональны, но не могут быть пустыми строками и он должен быть смещен от содержимого по крайней мере на одну пустую строку
+
+Только заголовки
+
+```asciidoc
+= Заголовок документа
+
+Первое предложение в документе.
+```
+
+Заголовки и авторы
+
+```asciidoc
+= Document Title
+Первый и последний <[email protected]>
+
+Начало документа.
+```
+
+Множество авторов
+
+```asciidoc
+= Document Title
+Иззи Хендс <[email protected]>; Эдвард Кенуэй <[email protected]>; Чёрная борода <[email protected]>
+
+Start of a doc with multiple authors.
+```
+
+Revision Line (requires an author line)
+
+```asciidoc
+= Заголовок V1
+Человек картофан <[email protected]>
+v1.0, 2016-01-13
+
+Эта статья о чипсах и она будет забавной.
+```
+
+Параграфы
+
+```asciidoc
+Тебе ничего не требуется особенного для обозначения параграфа
+
+Добавь пустую строку между параграфами что бы разделить их.
+
+Для создания пустой строки добавь а +
+И ты сделаешь пустую строку
+```
+
+Форматирование текстаF
+
+```asciidoc
+_нижнее подчёркивание создаёт курсив_
+*звёздочки можно выделить для жирного текста*
+*_Так же можно совмещать_*
+`используйте галочки для обозначения моноширинного текста`
+`*Жирный моноширинный текст*`
+```
+
+Секции заголовков
+
+```asciidoc
+= Уровень 0 (Может использоваться только в заголовке документа)
+
+== Уровень 1 <h2>
+
+=== Уровень 2 <h3>
+
+==== Уровень 3 <h4>
+
+===== Уровень 4 <h5>
+```
+
+Lists
+
+Для создания не нумерованного списка используются звёзды.
+
+```asciidoc
+* foo
+* bar
+* baz
+```
+
+Для нумерованного списка используются точки.
+
+```
+. Элемент 1
+. Элемент 2
+. Элемент 3
+```
+
+Можно создавать вложенный список нумеро.
+
+```asciidoc
+* foo 1
+** foo 2
+*** foo 3
+**** foo 4
+***** foo 5
+
+. foo 1
+.. foo 2
+... foo 3
+.... foo 4
+..... foo 5
+```
+
+## Further Reading
+
+There are two tools to process AsciiDoc documents:
+Есть два инструмента для обработки AsciiDoc документов:
+
+1. [AsciiDoc](http://asciidoc.org/): Оригинальная реализация на Python доступная в основных Linux дистрибутивах. Реализация стабильно и развивается.
+2. [Asciidoctor](http://asciidoctor.org/): Альтернативная реализация на Ruby, которая так же может использовать Java или JavaScript. В активной разработке и направлен на расширения синтаксиса AsciiDoc новыми возможностями и форматами вывода.
+
+Полезные материалы касающиеся `Asciidoctor`:
+
+* [Перевод Markdown в AsciiDoc](http://asciidoctor.org/docs/user-manual/#comparison-by-example): параллельное сравнение общих элементов Markdown и AsciiDoc.
+* [Стартовая инструкция](http://asciidoctor.org/docs/#get-started-with-asciidoctor): руководства по установке и быстрому запуску для создания простых документов.
+* [Пользовательская инструкция](http://asciidoctor.org/docs/user-manual/): полное руководство в одном документе, содержащее, в частности, ссылки на синтаксис, примеры, инструменты рендеринга и многое другое.