Help:Wiki syntax and markup/ru

Таблицы
Таблицы должны использоваться лишь при необходимости.

Подробную информацию о работе с таблицами можно найти на сайте Mediawiki.org.

Текст IRC
Для выделения вывода IRC используйте теги  или преобразуйте его стиль в таблицу с помощью irclog2html и исправления для irclog2html.

Примечания, советы, и другое выделение текста
Которые в целом известны как замечания и используются в DocBook. Для преобразования текста используется специальный формат:

Отступ начального и второго параграфа на один пробел гарантирует, что рамка будет правильно выровнена.

Ниже приведены стандартные виды замечаний:

Примеры примечаний
Руководство по документированию Fedora содержит подробное описание типов замечаний:

http://docs.fedoraproject.org/documentation-guide/en_US/sn-xml-admon.html

Плашки
Плашки можно использовать, когда вы по каким-либо причинам не в состоянии устранить многочисленные недостатки в переводе.

Запись примеров команд
Примеры команд содержат одну или несколько команд не считая пояснений. В тексте команд не используйте название компьютера, каталога или имени пользователя, то есть информацию из переменной окружения $PS1.

Примеры команд заключите в теги :

su -c "yum install awesome-application" &lt;/pre>

Enter the  password when prompted.

Текст будет выглядеть так:

su -c "yum install super-application"

Enter the root password when prompted.

Если текст команды содержит кавычки, вложение будет выглядеть так:, где одинарные кавычки заключены в двойные. Пример:

su -c "command -o 'Какой-то текст' -file 'Еще текст' foo/bar"

При наличии целого набора команд можно предложить пользователю перейти в режим  и по завершению напомнить вернуться в обычный режим.

su - Password: service food stop cp /etc/foo.d/foo.conf /etc/foo.d/foo.conf.backup vi /etc/foo.d/foo.conf food --test-config ... service food start exit

Вывод команды
Если текст демонстрирует команду как часть вывода на экран, можно добавить строку приглашения.

$ su -c "ls -l /root" Password: total 148 -rw--- 1 root root 1961 2007-09-21 02:46 anaconda-ks.cfg -rw-r--r-- 1 root root 46725 2007-09-21 02:46 install.log -rw-r--r-- 1 root root 6079 2007-09-21 02:42 install.log.syslog -rw-r--r-- 1 root root 3699 2008-07-28 17:24 scsrun.log -rw-r--r-- 1 root root 45038 2008-01-10 10:21 upgrade.log -rw-r--r-- 1 root root 1317 2008-01-10 10:20 upgrade.log.syslog

Советы
Здесь приведены основные правила, которых стоит придерживаться при редактировании Вики.

Структура вики-страниц
Этот раздел описывает общую структуру вики-страниц. Придерживайтесь этих указаний при создании и правке вики-страниц. Существуют дополнительные правила для официальной документации Fedora, описанные на странице DocsProject/WritingUsingTheWiki ; эти правила позволяют следовать правилам оформления содержимого при  документировании Fedora.


 * Заголовок страницы является заголовком первого уровня и создается автоматически.
 * Для форматирования секций используйте знаки равенства:

Если требуется 5 уровней вложения, лучше создать новую страницу
Моя страница ==> Моя_страница Страница про одно, второе и немного третьего ==> Страница_про_одно,%2C_второе_и_немного_третьего
 * Содержание страницы генерируется автоматически и заполняется по ходу наполнения страницы.
 * Якоря для секций также генерируются автоматически. При этом пробелы и знаки препинания заменяются специальными символами:

Учитесь на примерах
Одним из лучших способов изучить способы редактирования вики-страниц является просмотр исходного кода уже существующих страниц. Это очень просто сделать:


 * 1) Найдите страницу, исходный код которой хотите просмотреть.
 * 2) Вверху страницы нажмите править.

Будет показан текст этой страницы. Это особенно ценно при изучении некоторых трюков, уже использующихся вики-авторами, что позволит применять уникальные, интересные приемы, о которых вы и не подозревали. Попробоуйте ознакомиться с кодом страницы Ru_RU (не вносите кардинальных изменений!).

Выделение технических терминов
Используйте разметку code ( моноширным шрифтом, чтобы отметить пункты меню и другие элементы графического интерфейса. Это выделяет текст курсивом.

Например:

пакет устанавливает почтовый клиент Mozilla Thunderbird. Чтобы запустить Thunderbird, выберите: Приложения > Интернет > Thunderbird Email.

Текст будет выглядеть так:

пакет устанавливает почтовый клиент Mozilla Thunderbird. Чтобы запустить Thunderbird, выберите: Приложения > Интернет > Thunderbird Email.