Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

*** empty log message ***

  • Loading branch information...
commit 6a47401943409ea9dfd2f78aa74e4165a6eedd46 1 parent d327788
dlnsk authored
Showing with 360 additions and 0 deletions.
  1. +142 −0 lang/ru/help/advanced_markdown.html
  2. +218 −0 lang/ru/help/markdown.html
142 lang/ru/help/advanced_markdown.html
View
@@ -0,0 +1,142 @@
+<h2>Дополнительные возможности Markdown</h2>
+
+<div id="Main">
+
+<div class="article">
+<p>В этой статье рассматриваются некоторые дополнительные возможности, которые позволят вам максимально использовать возможности формата Markdown. Если вы чувствуете что описаные здесь возможности сейчас вам не нужны, то пропустите этот документ и возвращайтесь к нему тогда, когда они вам понадобятся.</p>
+
+<ul>
+
+<li><a href="#linebreaks">Перенос строк</a></li>
+<li><a href="#hr">Горизонтальные линии</a></li>
+<li><a href="#image_links">Картинка со ссылкой</a></li>
+<li><a href="#embedded">Использование HTML</a></li>
+<li><a href="#preformatted">Отмена форматирования</a></li>
+<li><a href="#special_char">Использование специальных символов</a></li>
+<li><a href="#further">Официальная информация</a></li>
+</ul>
+
+<h2><a id="linebreaks">Перенос строк</a></h2>
+
+<p>В некоторых текстах, например в поэзии, необходимо иметь возможность разделять абзац на несколько строк. Использование клавиши Enter не даст ожидаемого эффекта, т.к. по-умолчанию отдельные строки соединяются вместе чтобы текст выглядел как цельный абзац.</p>
+
+<p><strong><code>Люблю грозу в начале мая,<br />
+Когда весенний первый гром,<br />
+Как бы резвяся и играя,<br />
+Грохочет в небе голубом.</code></strong></p>
+
+<p>В приведенном выше стихотворении новую строку начинали используя клавишу Enter, однако в результате эти переносы будут проигнорированы:</p>
+
+<p>Люблю грозу в начале мая,
+Когда весенний первый гром,
+Как бы резвяся и играя,
+Грохочет в небе голубом.</p>
+
+<p>Однако если вы закончите строку двумя символами "пробел", то заставите следующую начаться с новой строки:</p>
+
+<p>Люблю грозу в начале мая,<br />
+Когда весенний первый гром,<br />
+Как бы резвяся и играя,<br />
+Грохочет в небе голубом.</p>
+
+<h2><a id="hr">Горизонтальные линии</a></h2>
+
+<p>Создать горизонтальную линию можно поместив три или больше звездочек (*), минусов (-) или подчеркиваний (_) на отдельной строке.</p>
+
+<p>Такая строка создаст линию:</p>
+
+<p><strong><code>***</code></strong></p>
+
+<p>но вы можете разделять символы пробелами, чтобы сделать линию более очевидной в процессе редактирования документа.</p>
+
+<p><strong><code>* * * * *</code></strong></p>
+
+<p><strong><code>-------------------------</code></strong></p>
+
+<p><strong><code>_ _ _ _ _</code></strong></p>
+
+<p>Каждая из приведенных выше строк даст одинаковый результат. Вот такой:</p>
+
+<hr />
+
+<h2><a id="image_links">Картинка со ссылкой</a></h2>
+
+<p>В документе 'Форматирование текста с помощью Markdown' уже были приведены инструкции для создания web-ссылок и вставки картинок. Однако вы можете совместить две эти возможности и создать картинку, которая является еще и ссылкой на какую-нибудь страницу в сети.</p>
+
+<p><strong><code>[Поисковая система Google][google]</code></strong></p>
+
+<p><strong><code>![Логотип Google][logo]</code></strong></p>
+
+<p>Выше приведены обычная ссылка и обычное изображение. Вы можете поместите картинку туда где указан текст ссылки, например:</p>
+
+<p><strong><code>[![Логотип Google][logo]][google]</code></strong></p>
+
+<p>Нужно не забывать что приведенные выше ссылки должны быть определены где-либо в документе:</p>
+
+<p><strong><code>[logo]: http://www.google.com/images/logo.gif</code></strong><br />
+<strong><code>[google]: http://www.google.com/ "щелкните, чтобы посетить Google.com"</code></strong></p>
+
+<p>Такое совмещение создает картинку, щелчок по которой переместит вас по указанной ссылке:</p>
+
+<p><a href="http://www.google.com/" title="щелкните, чтобы посетить Google.com"><img src="http://www.google.com/images/logo.gif" alt="Логотип Google" /></a></p>
+
+<p>Такая техника может использоваться для создания коллекции уменьшеных картинок, которые, в свою очередь, ссылаются на полноразмерные копии.</p>
+
+<h2><a id="embedded">Использование HTML</a></h2>
+
+<p>Если вы являетесь специалистом в HTML, то можете обнаружить, что Markdown не дает вам всех возможностей, которые вы бы хотели. К счастью Markdown разрабатывался с учетом этого и позволяет вставлять теги HTML непосредственно в форматируемый текст.</p>
+
+<p><strong><code>* &lt;small&gt;мелкий текст&lt;/small&gt;</code></strong><br />
+
+<strong><code>* &lt;big&gt;крупный текст&lt;/big&gt;</code></strong> </p>
+
+<ul>
+<li><small>мелкий текст</small> </li>
+<li><big>крупный текст</big> </li>
+</ul>
+
+<p>Имейте в виду что HTML-разметка со-существует с разметкой Markdown. Это освобождает вас от необходимости использовать HTML для основных элементов оформления, таких как параграфы, списки и т.п., однако всеже предоставляет всю мощь HTML в специфических ситуациях.</p>
+
+<h2><a id="preformatted">Отмена форматирования</a></h2>
+
+<p>Если, в отличии от предыдущей главы, вы хотите, чтобы введенные теги HTML отображались в точности как вы их написали, а не использовались в оформлении текста, то начните каждую строку с четырех пробелов.</p>
+
+<pre><code>&lt;p&gt;Абзац с тегами &lt;b&gt;HTML&lt;/b&gt; отображается без изменений&lt;/p&gt;
+</code></pre>
+
+<p>Кроме того, это используется для отображения текста программ:</p>
+
+<pre><code>for (int i=0; i&lt;5; i++) {
+ print "Command-line arguments: (@ARGV)\n";
+}
+</code></pre>
+
+<p>Т.к. подобное форматирование часто используется для отображения листингов компьютерных программ, а также текстов, которые могут содержать символы, используемые Markdown для оформления документов, то для этих сторок форматирование Markdown отключено:</p>
+
+<pre><code>В обычном состоянии это слово было бы **полужирным**.
+</code></pre>
+
+<p>О том как использовать специальные символы в обычном тексте читайте в следующей главе.</p>
+
+<h2><a id="special_char">Использование специальных символов</a></h2>
+
+<p>Если вы хотите отобразить любой из специальных символов Markdown вместо того, чтобы использовать его для форматирования, просто поставьте перед ним символ обратной косой черты (\). Сама косая черта не отображается, однако следующий за ней символ будет показан как есть.</p>
+
+<p><strong><code>\*звездочки, а не курсив\*</code></strong></p>
+
+<p>превращается в</p>
+
+<p>*звездочки, а не курсив*</p>
+
+<p>в отличии от</p>
+
+<p><strong><code>*курсив, а не звездочки*</code></strong></p>
+
+<p>которое даст</p>
+
+<p><em>курсив, а не звездочки</em></p>
+
+<h2><a id="further">Официальная информация</a></h2>
+
+<p>Система форматирования Markdown не является иключительно частью Moodle. Этот формат используется во многих других системах публикации информации в Сети. Вы можете найти более подробную информацию о Markdown на официальном сайте <a href="http://daringfireball.net/projects/markdown/">http://daringfireball.net/projects/markdown/</a></p>
+</div></div>
218 lang/ru/help/markdown.html
View
@@ -0,0 +1,218 @@
+<h2>Форматирование текста с помощью Markdown</h2>
+
+<div id="Main">
+
+<div class="article">
+<p>Markdown расширяет возможности простого текстового формата доступного в Moodle позволяя Вам легко выделить текст (полужирный, курсив), добавить структуру (списки, заголовки) и списки (на картинки или другие ресурсы сети). Вы можете использовать Markdown во многих местах системы, просто выберите его из выпадающего списка <strong>Форматирование</strong>, который находится под текстовой областью, предназначенной для ввода текста.</p>
+
+<ul>
+<li><a href="#concepts">Основная концепция</a></li>
+<li><a href="#emphasis">Выделение текста</a></li>
+<li><a href="#headings">Заголовки</a></li>
+<li><a href="#lists">Списки</a></li>
+<li><a href="#quotes">Цитирование</a></li>
+<li><a href="#links">Web-ссылки</a></li>
+<li><a href="#images">Картинки</a></li>
+<li><a href="#advanced">Дополнительные возможности</a></li>
+</ul>
+
+<h2><a id="concepts">Основная концепция</a></h2>
+
+<p>Чтобы ввести текст, пишите его в текстовом поле. Нажимайте клавишу Enter дважды в конце каждого параграфа, чтобы оставить пустую строку между двумя параграфами, иначе весь текст будет отображаться как один параграф.</p>
+
+<h2><a id="emphasis">Выделение текста</a></h2>
+
+<p>C помощью Markdown Вы можете использовать три вида выделения: <em>курсив</em>, <strong>полужирный</strong> или <strong><em>полужирный курсив</em></strong>. Достичь этого можно окружив необходимый для выделения текст звездочками, например:</p>
+
+<p><strong><code>*курсив*</code></strong> -> <em>курсив</em> <br />
+<strong><code>**полужирный**</code></strong> -> <strong>полужирный</strong> <br />
+<strong><code>***полужирный курсив***</code></strong> -> <strong><em>полужирный курсив</em></strong></p>
+
+<p>Выделение можно применять к отдельному слову, нескольким словам или части слова:</p>
+
+<p><strong><code>к *одному* слову</code></strong> -> к <em>одному</em> слову <br />
+<strong><code>***к нескольким словам***</code></strong> -> <strong><em>к нескольким словам</em></strong> <br />
+<strong><code>к**части**слова</code></strong> -> к<strong>части</strong>слова</p>
+
+<p>Символ подчеркивания (_) может использоваться для этой же цели наравне со звездочками.</p>
+
+<h2><a id="headings">Заголовки</a></h2>
+
+<p>Markdown позволяет Вам использовать заголовки в тексте. Доступны шесть уровней заголовков, однако обычно в тексте не используют больше трех. Например, в тексте который вы сейчас читаете используется всего два уровня заголовков.</p>
+
+<p>Вы можете создать заголовок начав строку с одного или большего количества символов "решетка" (#). Одна "решетка" создаст самый большой и важный заголовок, а шесть - самый маленький.</p>
+
+<p><strong><code># Название главы</code></strong> <br />
+<strong><code>## Название темы</code></strong> <br />
+<strong><code>### Подзаголовок</code></strong> <br />
+и т.д.</p>
+
+<p>Первые два уровня заголовков могут быть созданы альтернативным способом. Это позволит лучше выделить их в исходной текстовой версии документа (но результат будет точно такой же как и в предыдущем способе). Альтернатива заключается в использовании символа равно (=) или тире (-) на следующей строке:</p>
+
+<p><strong><code>Название главы</code></strong> <br />
+ <strong><code>==============</code></strong></p>
+
+<p><strong><code>Название темы</code></strong> <br />
+ <strong><code>-------------</code></strong> </p>
+
+<h2><a id="lists">Списки</a></h2>
+
+<h3>Маркированные списки</h3>
+
+<p>Вы можете создавать маркированные списки начиная каждую строку звездочкой и отделяя ее от текста пробелом. Имейте в виду, что пробел важен и его нельзя забывать!</p>
+
+<p><strong><code>* первый пункт</code></strong> <br />
+<strong><code>* второй пункт</code></strong> <br />
+<strong><code>* третий пункт</code></strong> </p>
+
+<p>даст</p>
+
+<ul>
+<li>первый пункт</li>
+<li>второй пункт</li>
+<li>третий пункт</li>
+</ul>
+
+<h3>Нумерованные списки</h3>
+
+<p>Аналогично, вы можете создавать и нумерованные списки начиная каждую строку с числа, после которого должны следовать "точка", "пробел" и текст данного пункта.</p>
+
+<p><strong><code>1. первый пункт</code></strong> <br />
+<strong><code>2. второй пункт</code></strong> <br />
+<strong><code>3. третий пункт</code></strong></p>
+
+<p>даст</p>
+
+<ol>
+<li>первый пункт</li>
+<li>второй пункт</li>
+<li>третий пункт</li>
+</ol>
+
+<h3>Вложенные списки</h3>
+
+<p>Вы можете делать вложенные маркированный и нумерованные списки, а также смешивать их в одной структуре:</p>
+<b>
+<pre>
+* первый маркированный пункт
+ * маркированный подпункт
+ * маркированный подпункт 2
+* второй маркированный пункт
+ 1. первый нумерованный пункт
+ 1. нумерованный подпункт
+ 2. второй нумерованный пункт
+</pre>
+</b>
+
+<p>даст</p>
+
+<ul>
+<li>первый маркированный пункт
+<ul>
+<li>маркированный подпункт</li>
+<li>маркированный подпункт 2 </li>
+</ul></li>
+<li>второй маркированный пункт
+<ol>
+<li>первый нумерованный пункт
+<ol>
+<li>нумерованный подпункт </li>
+</ol></li>
+<li>второй нумерованный пункт</li>
+</ol></li>
+</ul>
+
+<h2><a id="quotes">Цитирование</a></h2>
+
+<p>Вы можете указать что часть текста является цитатой начав каждую строку с угловой скобки (>). Этот символ выбран по той причине, что многие почтоые программы используют именно его для выделения цитат. Результатом цитирования будет выделение абзаца отступом справа и слева.</p>
+
+<p><strong><code>&gt; Это процитированный абзац</code> <br />
+<code>&gt; разделенный на две строки</code></strong> </p>
+
+<p>даст</p>
+
+<blockquote>
+ <p>Это процитированный абзац
+ разделенный на две строки</p>
+</blockquote>
+
+<p>Вы можете немного упростить себе задачу используя только одну угловую скобку в начале первой строки абзаца</p>
+
+<p><strong><code>&gt; Все это по-прежнему один</code> <br />
+<code>абзац, который был разделен</code> <br />
+<code>на несколько строк.</code></strong></p>
+
+<p>даст</p>
+
+<blockquote>
+ <p>Все это по-прежнему один
+ абзац, который был разделен
+ на несколько строк.</p>
+</blockquote>
+
+<h2><a id="links">Web-ссылки</a></h2>
+
+<p>Есть два способа создать ссылку на какой-либо web-ресурс: первый - поместить ссылку прямо в текст. Заключите текст который пользователь должен видеть и который будет выглядеть как ссылка в квадратные скобки, а URL страницы в круглые так, чтобы комплекты скобок были написаны слитно. Также вы можете добавить дополнительное описание, заключив его в кавычки и поместив после URL.</p>
+
+<p><strong><code>Это [пример ссылки](http://example.com/ "Дополнительное описание") помещенной в предложение.</code></strong></p>
+
+<p>даст </p>
+
+<p>Это <a href="http://example.com/" title="Дополнительное описание">пример ссылки</a> помещенной в предложение.</p>
+
+<p>Если описание определено, то оно отображается во всплывающей подсказке. Подведите курсор мыши к ссылке и через секунду подсказка появится.</p>
+
+<p>Второй способ удобен для длинных ссылок. Чтобы не загромождать текст вы можете вставлять их подобно сноскам. Добавьте короткий идентификатор с помощью второй пары квадратных скобок (идентификатор может быть поясняющим словом, фразой или числом).</p>
+
+<p><strong><code>Это [пример ссылки][пс] помещенной в предложение.</code></strong></p>
+
+<p>Затем, в любом месте документа (предпочтительней всего сразу после абзаца или вместе с другими ссылками в конце документа) вы можете указать URL, связав его с идентификатором, например:</p>
+
+<p><strong><code>[пс]: http://example.com/ "Дополнительное описание"</code></strong></p>
+
+<p>Результат второго способа будет точно такой же, как и у первого. Это просто организационно более правильный способ создания документа упрощающий его редактирование в будущем (особенно, если вы работаете не один).</p>
+
+<p>И последнее. Если вы хотите, чтобы ссылка представляла из себя сам URL, то просто поместите его в угловые скобки:</p>
+
+<p><strong><code>Посетите &lt;http://moodle.org/&gt; сейчас!</code></strong></p>
+
+<p>и получим:</p>
+
+<p>Посетите <a href="http://moodle.org">http://moodle.org</a> сейчас!</p>
+
+<h2><a id="images">Картинки</a></h2>
+
+<p>Картинки помещаются на страницу точно таким же образом, как и web-ссылки, но предваряются восклицательным знаком. 'Подпись' предназначена для пользователей, которые, по разным причинам, не смогут увидить картинку, т.е. она должна описывать ее содержимое. Кроме того, подпись полезна во время редактирования документа, для напоминания или подсказки того, что за картинка будет отображена в данном месте.</p>
+
+<p>'Дополнительное описание' отображается во всплывающей подсказке тогда, когда пользователь подводит указатель мыши к картинке и может использоваться в качестве дополнительного пояснения.</p>
+
+<p><strong><code>![подпись](/path/img.jpg "Дополнительное описание")</code></strong></p>
+
+<p>И, так же как и web-ссылки, вы можете разместить ссылки на рисунки в одном месте вашего документа подобно сносками. Просто дайте каждой картинке уникальное имя:</p>
+
+<p><strong><code>![подпись][photo]</code></strong></p>
+
+<p>и в любом месте вашего документа сопоставьте это имя с файлом картинки:</p>
+
+<p><strong><code>[photo]: /url/to/img.jpg "Дополнительное описание"</code></strong></p>
+
+<p>Вот пример команды и того, что с ее помощью получится:</p>
+
+<p><strong><code>![Логотип Google](http://www.google.com/images/logo.gif "Поисковая машина Google")</code></strong></p>
+
+<p><img src="http://www.google.com/images/logo.gif" alt="Логотип Google" title="Поисковая машина Google" /></p>
+
+<p>'Подпись' очень важна для картинки, она будет отображаться браузером в том случае если ссылка оказалась неверной или картинка временно недоступна, а также, если пользователь отключил отображение картинок в своем браузере:</p>
+
+<p><strong><code>![подпись несуществующей картинки](http://example.com/intentionally.broken.link "Эта картинка никогда не будет отображена")</code></strong></p>
+
+<p>даст (результат сильно зависит от вашего браузера)</p>
+
+<p><img src="http://example.com/intentionally.broken.link" alt="подпись несуществующей картинки" title="Эта картинка никогда не будет отображена" /></p>
+
+<h2><a id="advanced">Дополнительные возможности</a></h2>
+
+<p>Небольшое описание, которое вы прочитали - только введение в возможности формата Markdown. Из этого документа вы узнали о том, что используется наиболее часто. Однако, с помощью Markdown вы можете достичь значительно более впечатляющих результатов (особенно если знаете основы HTML). Дополнительные возможности описаны в отдельном документе.</p>
+<p align="right"><a href="help.php?file=advanced_markdown.html">Узнать о дополнительных возможностях Markdown</a></p>
+</div>
+</div>
Please sign in to comment.
Something went wrong with that request. Please try again.