path: root/russian/devel/website/htmlediting.wml

#use wml::debian::template title="Использование HTML на веб-страницах Debian" BARETITLE=true
#use wml::debian::common_tags
#use wml::debian::acronyms
#use wml::debian::toc
#use wml::debian::translation-check translation="b2595631761ec70fe18145ffa27080c0d5a5dd69" maintainer="Lev Lamberov"

<p>
Настоящая страница является черновиком.
</p>

<toc-display/>

<toc-add-entry name="preface">Предисловие</toc-add-entry>

<p>Эта страница предназначается редакторам и переводчикам; она помогает создавать страницы с правильно расставленными тегами,
содержит советы об использовании тегов и том, как создавать новые страницы и
упростить процесс их перевода.</p>


<toc-add-entry name="general">Некоторые общие советы</toc-add-entry>
<p>Для новых страниц или переводов существует следующий список общих советов:</p>
<dl>
<dt>не используйте длинных строк</dt>
<dd>
Строки в файлах wml и других файлах должны умещаться в
окно обычного терминала. Это упрощает редактирование в vi, улучшает поиск и
упрощает перевод. Также это важно потому, что разрешать конфликты в длинных
строках немного сложнее.
</dd>
<dt>по возможности помещайте теги на отдельные строки</dt>
<dd>
Большинство тегов HTML можно поместить на отдельные строки. Некоторые из таких тегов &mdash; &lt;div&gt;,
&lt;p&gt;, &lt;table&gt;, &lt;ul&gt;. Для облегчения работы переводчиков
следует помещать на отдельные строки все теги, которые можно разместить таким образом. В противном случае
переводчики могут случайно удалить теги и забыть восстановить их
после перевода.
</dd>
<dt>не используйте пробелы или переносы строк в строчных тегах</dt>
<dd>Некоторые теги создают символ пробела, если поместить их на отдельные строки. Одним из
таких тегов является тег &lt;q&gt; для небольших цитирований и кавычек. Вы можете лишь отделить такие теги
только как целую строку вместе с содержимым. Либо в дальнейшем в HTML-странице может появиться
пробел между содержимым и тегом. Между словами в этих тегах вы можете
вставлять столько переносов строк или пробелов, сколько пожелаете.
</dd>
</dl>

<toc-add-entry name="abbreviations">Сокращения и акронимы</toc-add-entry>
<p>
Для сокращений и акронимов следует использовать HTML-тег &lt;acronym&gt;.
Имеется две причины, почему использование тега &lt;abbr&gt; не рекомендуется:
Во-первых,
не все браузеры поддерживают этот тег. Во-вторых, существуют противоречащие определения того,
что такое акроним и что такое сокращение.
</p>
<p>
Акроним добавляется на страницу следующим синтаксисом:
<code>&lt;acronym lang="код языка" title="Полное определение
акронима"&gt;АКРОНИМ&lt;/acronym&gt;</code>. Атрибут title содержит произносимые слова
целиком. Если акроним составлен из первых букв слов, эти буквы
в атрибуте title должны быть строчным. Атрибут lang нужен только, если акроним
или сокращение относится к иностранному языку.
</p>
<p>
В шаблонах wml содержится набор готовых акронимов,
для использования на вашей странице вам нужно добавить строку использования
<code>acronyms</code> в файл wml. Например, тег wml для DD (разработчик Debian) &mdash;
&lt;acronym_DD /&gt;.
</p>

<toc-add-entry name="citations">Цитирование и кавычки</toc-add-entry>
<p>
Для разных языков существуют разные правила
цитирования и кавычек. Если у вас имеется короткое строчное цитирование, то вам следует использовать тег
&lt;q&gt;.
Отрисовка содержимого управляется языком CSS. Теги &lt;q&gt; не
должны содержать пробелы или символы переноса строк между открывающим или закрывающим тегом и
содержимым.
</p>
<p>
Для более длинных цитирований используется тег &lt;blockquote&gt;. Тег &lt;blockquote&gt;
охватывает один или больше параграфов текста, которые помечены &lt;p&gt;.
Пожалуйста, не используйте теги &lt;blockquote&gt; для центрирования блока текста,
не являющегося цитированием. Блоки цитирования существуют исключительно для цитат и
в дальнейшем будут отрисованы специфическим кодом CSS.
</p>
<p>
В HTML имеется также тег &lt;cite&gt;. Тег &lt;cite&gt; не используется для
цитирования самого текста. Он используется для указания источника цитаты. Это может быть
имя человека, слова которого цитируются. Тег добавляется в качестве атрибута
к тегу &lt;blockquote&gt; как URL.
</p>

<toc-add-entry name="code">Названия программ и код</toc-add-entry>
<p>
Для названий программ и компьютерного кода существует тег &lt;code&gt;. Браузеры
обычно знают об отображении кода и названий программ, но отрисовка
также может быть изменена CSS. Использовать вместо этого тега тег &lt;tt&gt;
не будет хорошей идеей, поскольку последний ничего не говорит о содержимом.
</p>

<toc-add-entry name="samp">Примеры вывода компьютера</toc-add-entry>
<p>
Для отображения вывода компьютера на экране существует специальный тег &lt;samp&gt;. Если
у вас имеется более большой блок вывода компьютера, вам следует также
заглянуть в файл CSS, возможно для этого имеется специальный класс.
</p>

<toc-add-entry name="kbd">Ввод с клавиатуры</toc-add-entry>
<p>Если у вас имеются примеры, в которых пользователь должен набрать что-то на
клавиатуре, используйте тег &lt;kbd&gt;. См. также главу
о <a href="#var">переменных</a> о том, как помечать изменяемые части при вводе.
</p>

<toc-add-entry name="var">Переменные</toc-add-entry>
<p>
Иногда необходимо выделить переменный ввод, например
специальный IP-адрес или имя пользователя, который
передаётся программе из командной строки. Для такого переменного ввода используется
тег &lt;var&gt;.
</p>

<toc-add-entry name="pre">Заранее отформатированное содержание</toc-add-entry>
<p>
Тег &lt;pre&gt; используется только для заранее отформатированного текста. Длина строки, проблемы и
другие нюансы будут сохранены. Этот тег не может содержать большинство
других тегов HTML.
</p>

<toc-add-entry name="img">Изображения</toc-add-entry>
<p>
Если нужно добавить изображения на страницу, нет необходимости добавлять неправильный
атрибут border=0. Но если это возможно, следует добавить
размер изображения и
атрибут <code>alt</code>. Размер, если он отсутствует, добавляется wml, но для этого требуется
время при компиляции. Атрибут <code>alt</code> должен содержать что-то, что сообщает пользователям,
использующим браузер lynx, и слепым людям, что находится на этом изображении.
</p>

<toc-add-entry name="links">Ссылки</toc-add-entry>
<p>
Если вы хотите в документации поставить ссылку на страницу на <code>https://www.debian.org</code>,
то используйте переменные, определённые для каждого языка в файле <code>.wmlrc</code>. Например, URL в теге <br />
<code>&lt;a href="https://www.debian.org/devel/website/htmlediting"&gt;htmlediting&lt;/a&gt;</code><br />
следует заменить на переменную <tt>DEVEL</tt> следующим образом: <code>&lt;a href="&#36;(DEVEL)/website/htmlediting"&gt;htmlediting&lt;/a&gt;</code>.
</p>

# <toc-add-entry name=""></toc-add-entry>