[Fedora-documentation] Рекомендации по оформлению статей
Степан Федосеев
Пн Янв 31 18:31:25 MSK 2011
Вот, думаю самое основное. :)
По тексту выделять курсивом имена собственные, назмания програм, а также
различные примечания, параметры и значения: ''Gnome'', ''Nautilus'',
''--all'', ''Уровень 1'' и т.д.
Клавиши и их сочетания указывать в <угловых скобках> и выделять курсивом:
''<Esc>'', ''<Alt>+<F2>'' и т.д.
Команды и их вывод указывать в тегах <pre></pre>, либо просто начинать
строку с пробела: <pre>ls -la | grep -i "Ви"</pre>
Пути к файлам, команды по тексту и маленькие куски кода помещать между
<code></code>: <code>/etc/yum.repos.d/</code>, <code>su -c "cat >
привет_мир"</code> и т.д.
При указании последовательности меню, использовать форму: ''Приложения ->
Мультимедия -> Мой самый любимый плеер''
При конце статьи желательно указывать список источников(если это копипаст).
Так же крайне не желательно использование жаргонизмов и сленга в тексте
статьи. К примеру "видюха" вместо "видеокарты", "юрез" вместо
"пользователя" и т.д.
Подробная информация о списке рассылки Fedora-documentation