Help:Editing/ru

Следуйте правилам именования страниц вики структуры.
Help:Wiki_structure описывает как устроена вики, а также правила именования страниц.

Дополнительные ресурсы о вики-разметке
Страница Help:Editing на Mediawiki.org -- хороший источник информации по вики разметке. Справочная карта также является отличным источником информации.

Вики Проекта Fedora предъявляет лишь незначительные требования для получения доступа для редактирования. Однако необходимо ознакомиться с некоторыми правилами редактирования, прежде чем начать использовать вики, и этим правилам должны следовать все редакторы. На этой странице приведены эти принципы, а также несколько советов, которые помогут вам приступить к работе.

Этот документ разделен на три части: получение доступа к редактированию, основы вики разметки, дополнительная информация по вики разметке.

Переход по русской wiki

• Состояние перевода

• Правила оформления

• wiki разметка

• Словарь

• Участники команды локализации Fedora

• Как стать участником команды

• Статья о Russian Fedora

• План работы по переводу web-сайта Проекта Fedora

• Список полезных категорий

• Страницы на русском
  • Категория «LocalizationRussian»
  • Категория «Страницы_на_русском»

Получение доступа к редактированию

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

1. Ознакомьтесь с информацией на этой странице и других страницах, на которые она ссылается.

Основные правила, которые следует соблюдать, приведены здесь. Неспособность следовать этим принципам создает ненужную работу для других добровольцев и в результате может привести к отзыву прав редактирования.

1. Примите CLA (Лицензионное Соглашение Участника) через систему учетных записей Fedora .

Это даст Проекту Fedora возможность безоговорочно лицензировать ваш вклад в Вики согласно лицензии OPL 1.0. Это гарантирует, что ваш вклад навсегда останется свободным для общественного использования, изменения и распространения, аналогично дистрибутиву Fedora. Обратитесь к разделу ["Legal"] раздел для получения дополнительной информации. Следуйте инструкциям по подписанию соглашения на странице http://fedoraproject.org/wiki/Infrastructure/AccountSystem/CLAHowTo

Участие в поддержке Интернет-ресурсов Fedora
Если вы заинтересованы в поддержке веб-сайта или хотите влиться в команду Интернет-ресурсов Fedora, перейдите на страницу Ru_RU/Websites.

Участие в разработке документации Fedora
Информация по созданию официальной документации Fedora с помощью вики доступна на странице Создание вики-документации.

Участие в переводе вики
Если вы заинтересованы в переводе вики на русский язык, перейдите на страницу переводов вики, где координируются усилия русской команды

Правила

Существует несколько простых правил, которых необходимо придерживаться при редактировании вики. Ниже рассмотрено несколько примеров. В двух словах, будьте вежливы и пользуйтесь здравым смыслом. Игнорирование этих правил и умышленное создание проблем гарантирует запрет доступа редактирования. Если у вас возникли вопросы, их можно задать в канале IRC #fedora-websites на freenode .

Представьтесь

Прежде чем начать редактирование любой страницы, хорошо бы представиться, поэтому добавьте информацию о себе на своей вики-странице. При регистрации в вики будет автоматически создана ваша персональная страница http://fedoraproject.org/wiki/User:<ВикиИмя>, где <ВикиИмя> -- ваше имя в системе учетных записей Fedora. К персональной странице можно перейти в любое время, нажав на своем имени в правом верхнем углу страницы.

Некоторые примеры вики-страниц наших участников можно просмотреть здесь.

Старые страницы Moin
Убедительная просьба перенести существующие старые страницы с именами ИмяФамилия из Мoin в новый формат MediaWiki. Если вы совсем недавно подключились к Проекту Fedora и где-то заметили инструкции о создании персональной страницы в формате ИмяФамилия, пожалуйста, сообщите об этом участнику Ian Weller

Убедитесь, что на персональной странице указан как минимум адрес электронной почты и, если вы используете IRC, ваше имя в IRC и каналы, в которых вас можно найти.

{Anchor|AlwaysWatch}

Всегда подписывайтесь на страницы, которые вы создаете или редактируете

Важно, чтобы вы следили за изменениями страниц, которые вы создали или изменили; таким образом вы можете координировать свои усилия с другими участниками, работающими с вики. Редакторы обычно добавляют заметки при изменении страниц для передачи информации друг другу, и это помогает отслеживать изменения.

В список наблюдения страницу можно добавить на вкладке "Следить" вверху страницы, которая будет доступна после авторизации.

Правьте смело

Не стесняйтесь вносить изменения. Изменения вики отслеживаются и могут быть восстановлены в случае необходимости. Однако это не значит, что можно необдуманно вносить кардинальные изменения в ключевые документы.

Более подробную информацию можно найти в Википедии.

Избегайте ненужного редактирования страниц, обсуждающих правовые вопросы

Эти страницы писались основательно, а слова тщательно подбирались. Прежде чем изменять эти документы, обычно лучше посоветоваться со специалистами. За помощью можно обратиться в Консультативный Совет Fedora (Fedora Advisory Board) (см. страницу Board).

Не публикуйте информацию запрещенного содержания

Не добавляйте информацию, которая преследуется законом. Помните, Проект Fedora управляется из США и регулируется законодательством США. Избегайте добавления ссылок и информации о программном обеспечении, которое не является свободным и открытым, так как это может накладывать дополнительные обязательства. Если вы хотите добавить информацию в виде исключения, обсудите это с командой Интернет-ресурсов . Страница Запрещенные элементы содержит примеры, которых следует избегать.

Команда Интернет-ресурсов даст вам официальный ответ по поводу добавления информации такого рода.

Будьте осторожными при редактировании ключевых руководств или страниц

Большие и важные руководства, такие как Packaging Guidelines(Руководящие принципы создания Пакетов) , в основном управляются конкретными людьми или маленькими группами. Лучше всего работать с ними когда вы чувствуете что необходимы изменения.

Важные страницы, такие как FedoraMain или Загрузка страницы, являются первыми страницами которые многие посетители видят. Изменение таких страниц нужно предоставить опытным . Если вы видите что-то на такоей странице что должно быть изменено, внесите свое предложение на обсуждение командой Websites.

Не редактируйте страницы просто чтобы редактировать

Следует избекать бессмысленных изменений. Внесение изменений в текст страницы только для того чтобы поместить свое имя в лог редактирования недопустимо. Есть много страниц (большинство, фактически) которые имеют реальные ошибки которые нужно исправить. Вместо того чтобы делать бессмысленные изменения, такие как добавление пробелов или изменение ссылок с fedoraproject.org на www.fedoraproject.org (первая предпочтительней, кстати), попробуйте найти ошибки в орфографии, грамматике или пунктуации которые можно исправить. Кроме того, при исправлении мелких ошибок помечайте редактирование как "Тривиальное редактирование" используя соответсвующий флажок прежде чем записать страницу.

Избегайте переименования страниц или перемещения содержимого без координации

Вики страницы в основном ссылаются и связаны с различными адресами. Важно чтобы вы координировали, связывая с подходящими групами, существующие страницы, прежде чем перемещать содержимое или переименовывать существующие страницы. Было бы лучше избегать этого без должного серьезного обоснования. Если вы хотите обсудить перемещение часть материала, выносите свои предложения на рассмотрение командой Websites.

Следуйте идеалам, которые Федора считает важными

Например, старайтесь сохранить рабочий стол нейтральным и удобным технически не подготовленных пользователей которые являются новичками в Линукс и Федора. Пользователи могут использовать GNOME, KDE, консоль, или какие либо другие среды. Старайтесь помнить об этом когда пишете инстракции. Будьте уверены в приверженности Федора принципам свободного и открытого обеспечения.

Подписывайте вложенные файлы

Когда вы добавляете файл в вики страницу, вы должны создать сигнатуры(detached signature) с помощью вашего GPG ключа. Некоторые файловые форматы, такие как RPM пакеты, поддерживают GPG ключи, и в этом случае вам не нужно создавать сигнатуры(detached signature) -- сигнатур в файле будет достаточно. Сигнатуры (detached signature) могут быть присоединены к странице вместе с исходным вложением, или могут быть включены в саму страницу.

GPG сигнатуры позволяют другим, кто загружает ваш файл, убедится, что он пришел от вас и не был изменен или поврежден. Они не нарушают ваших владений, они позволяют другим быть уверенными в просхождении файлов.

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

Если у вас нет GPG ключа или вы хотите узнать больше об этом, см. страницу Cryptography.

Проверяйте ваши изменения на наличие ошибок

Вне зависимости от того являетесь ли вы опытным писателем или ваш английский не слишком силен, предлагайте кому либо просмотреть сделанные изменения. Хорошо написанные документы очень важны для имиджа Федора. Даже самые лучшие писатели не застрахованы от опечаток или каких либо других ошибок. Найдите время чтобы просмотреть сделанные изменения и исправить мелкие ошибки.

Fedora - это сообщество

При написании документов для вики или где либо еще, помните что Федора является сообществом. "Мы" являемся единой группой движущейся к общим целям. "Мы" не отличаем одну группу или класс от другого. Например: нет необходимости проводить различия между добровольцами которые работают для Red Hat и теми кто не делает этого. Все добровольцы являются частью одного сообщества. Однако существуют случаи когда классификация необходима, но ее можно провести другим способом.

Если вы в чем то неуверены - просто спрашивайте.

Другие члены сообщества будут рады помоч вам. #fedora-websites кана на freenode идеальное место чтобы обсудить вики или другие веб сайты Федора.

Просматривайте Ваши страницы, а также страницы других участников

Две вещи позволяют Wiki быть успешным инструментом по совместному использованию открытого содержимого. Первая: возможность просмотреть содержимое за которое вы ответствнны для того чтобы убедиться что оно соответствует действительности. Second is being able to watch other content develop, grow, and occasionally need your help.

Чтобы наблюдать за страницей "подпишитесь" на нее

Направьте ваш RSS клиент чтобы извлекать из http://fedoraproject.org/wiki. необходимо подавать подходящий RSS файл. 1. Добавьте регулярное выражение для документа над которым вы работаете UserPreferences над Subscribed wiki pages. Например это выражение показывает 3 документа:

Docs/Drafts/AdministrationGuide.*
Docs/Draft/Glossary.*
Docs/Drafts/DesktopUserGuide.*

Это выражение наблюдает за всеми изменениями в данной области:

Docs/Drafts.*

Это выражение позволяет наблюдать за всеми изменениями на страницах DocsProject , включая Docs и Docs/Drafts  :

Docs.*

Редактируйте с помощью MoinMoin

Интерактивная помощь может быть ценным ресурсом при изучении как редактировать ВиКи страницы. Просматривая данные страницы помощи вы можете изучить некоторые новые аккуратные приемы. Вам необходимо ознакомиться с ними хотябы один раз и они всегда будут там в качестве краткой справки при редактировании страниц. Вы можете задать вопрос о редактировании на канале #fedora-websites о freenode.net .

Структура ВиКи страниц

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

1. Заголовок страницы является заголовком первого уровня. Окружайте его с знаком разметки заголовка =:

= Заголовок страницы =

{{Admon/note | Исключчения | Страницы которые предполагается использовать всегда и только встроенными в другие страницы с помощью [[Inline()] -мактоса, эти страницы не начинайте с заголовка первого уровня. Структура этих не модульных подстраниц зависит от родительских и начинается с вложенного уровня родительского документа.}}

1. Над разделом = Заголовок страницы = и до == Введение == , включайте макрос создающий содержание страницы :

= Заголовок страницы  =

== Введение ==

Исключения
Нет необходимости включать содержание в страницы которые достаточно коротки, страницы которые можно прочитать без прокрутки в браузере открытом на 700 пикселей ввысоту.

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

1. Ключевые разделы можно использовать для как "якоря" для удобного создания ссылок.(Key sections can use an anchor for prettier linking.) Использование заголовка раздела как "якорь" с подчеркиванием, делает URL легкочитаемым(Using the section title as the anchor with underscores makes for an easy to read URL.) Вне зависимости от стиля, который вы используете, будьте последовательны на протяжении всего документа.

{{Anchor|Заголовок_Раздела}}
== Заголовок Раздела ==

1. Главные страницы могут бать сгруппированы помощью сочетания Important pages can be categorizedсгруппированы by putting сочетании CategoryFoo внизу страницы над горизонтальной линией at the bottom of the page under a horizontal rule. Замените Foo на имя категории, например такой как Documentation.

----
[[Category:Documentation

]]

Используйте выпадоющее меню при сохранении изменений страницы
Простым способом сгруппировать страницы пункт меню Make this page belong to category который появляется на странице Wiki редактирования.

Исключения
Страницы в Docs/Beats являются source only и не включаются в категорию страниц CategoryDocs т.к. их не предполагают отображать как результат поиска документации. Если страница является источником содержимого но не является канонической или ссылкой следуя по которой можно найти эту информацию, тогда не включайте ее в категорию. Другим примером является любое содержимое под персональным NameSpace.

1. More to come

Советы

These are the basic things that you need to know to edit this Wiki.

Pages Written for the DocsProject Have Additional Requirements
For more information on drafting documentation on the Wiki, refer to Writing Wiki Documentation .

Учитесь на примерах

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

1. Найдите страницу исходники которой хотите просмотреть.
2. На навигационной панели найдите combo box that reads 'More Actions:' и нажмите его.
3. Выберите 'Show Raw Text'.

Wiki покажет открытый текст этой страницы. Это особенно важно для изучения некоторых трюков использующихся wiki редакторами до вас. This is particularly valuable for learning some of the clever trick s used by wiki editors ahead of you. Эти 'трюки' особенно ценны, потому что они позволяют вам делать уникальные, интересный и мощные вещи которые вы даже не считали что они возможны. Вы можете попробовать это на любой странице подобной FedoraMain.

Ссылки

Создание ссылок возможно самая простая хитрая вещь в MoinMoin. Простейщая форма создания ссылок это wiki имена. Wiki имена это комбинация двух или более заглавных слов. Когда вы используете WikiИмена, нет необходимости использовать специальную разметку. Ссылка будет создана автоматически.

Во избежания создания нежелательных ссылок, вам необходимо обзнакомиться с некоторыми хитростями. Простейший способ сделать это состоит в том чтобы поставить два backticks мжежду WikiСловами, следующим образом: WikiСлова, которые безопасно "ломают" wiki механизм автоматического создания ссылок слов. Если вам необходимо создать ссылку на подстраницу или на станицу которая не является wiki именем, вы можете использовать синтаксис подобно этому A Subpage of Project или просто ["Pagename"] .

Избегайте расстановки ссылок на другие веб-сайты впределах параграфа. Вместо этого сошлитесь на веб-сайт в тексте и напишите URL для ссылки в отдельной строке. Это гарантирует что URL достаточно удобочитаем при распечатке страницы или при преобразовании ее в другой формат. Например:

Просмотрите Fedora Documentation Website в поисках самой свежей версии этого документа пржде чем начать.

[http://docs.fedoraproject.org/] 

Для того чтобы узнать больше об этом, см. HelpOnLinking.

Списки

Нумерованные и маркированные списпи очень просты и полезны. См. HelpOnLists для более подробной информации о ток как использовать их.

Таблицы

Таблицы могут быть очень сложными, потому что они могут вести себя не так как вы ожидаете. Широкие таблицы особенно ненадежны, т.к. они будут вылазить за свои границы при просмотре в маленьком окне. Самым лучшим советом при использовании таблиц состоит в том чтобы использовать их тоглько при необходимости. Только при публикации большой последовательности маленьких записей они могут сохранить много пространства. Просто тестируйте их при использовании. Помните что одугие могут иметь более низкое разрешение чем то что используете вы. Более подробная информация изложена на странице HelpOnTables.

Примечания, советы, и другой Boxed текст

Которые в целом известны как admonitions(замечания). Чтобы превратить параграф в замечания(admonition), введите два символа вертикальной черты (pipes) вначале и в конце параграфа, сделайте заголовок bodl face, начните заголовок с подходящего значка и добавьте дополнительную информацию во второй параграф:

{{Admon/tip | Это пример заметки. | Здесь содержится дополнительная информация о заметке.}}

Это заголовок обобщающий заметки.
Здесь содержится дополнительная информация о заметке.

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

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

• Это иконка примечаний
• Это иконка заметок
• Это иконка призывающая к осторожности
• Эта иконка о важном сообщении
• Это иконка о предупреждении

См. Fedora Documentation Guide для описания типов замечаний:

http://fedora.redhat.com/participate/documentation-guide/s1-xml-admon.html

Выделение Технических Терминов

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

Используйте два single-quotes () чтобы отметить имена пунктов меню и других элементов графического интерфейса. Это отображает выделенный слова как italic.

#!html
<div style="background: #eeeff1">

Высказывание	Разметка	Начертание	Пример начертания
Название GUI приложения	полужирный	полужирный	Firefox
Файлы, каталоги	single backticks	моноширный шрифт	/usr/bin/firefox
Пакеты программ	single backticks	моноширный шрифт	firefox-1.2.3
Аккаунт пользователя	single backticks	моноширный шрифт	username
Другие слова которые имеют специальное техническое значение	single backticks	моноширный шрифт	someJava.classname
Inline содержание из конфигурационных файлов, листинг программ.	single backticks	моноширный шрифт	... Затем, измените настройки DefaultIcon в /etc/httpd/conf/httpd.conf ...
Графические меню и пункты меню	two single-ticks	курсив	Приложения > Интернет > Firefox Web Browser
Другие GUI или Веб'UI элементы управления	two single-ticks	курсив	... нажмите кнопку Подтвердить ...
Первый термин, словарный термин	two single-ticks	курсив	... Firefox является примером graphical user interface (графический пользовательский интерфейс) or GUI.
Inline команды и демоны	3 фигурные скобки	моноширный шрифт	grep httpd чтобы найти PIDs запущенных httpd процессов.
Комбинации клавиш	[Key]	[bold brackets]	Нажмите клавишу[Enter] ...

#!html
</div>

Например:

<code>thunderbird</code> пакет устанавливает '''Mozilla Thunderbird''' e-mail приложение. Чтобы запустить '''Thunderbird''', выберите: ''Приложения > Интернет > Thunderbird Email''.

Которое отображает:

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

Запись примеров команд

Примером команд является одна или последовательность команд за исключением текста пояснений. Example commands are one or more commands set apart from the body of the explanation. Do not use prompt symbols or any other content that shows machine name, user, directory, etc. (which are details set in the $PS1 environment variable.)

Заключите любой пример команды тройными фигурными скобками, на первой строке команды три открывающие фигурные скобки и три закрывающие фигурные скобки за командой:

<pre>
su -c "yum install awesome-application"
</pre>

Enter the <code>root</code> password when prompted.

Которое отображает:

su -c "yum install awesome-application"

Enter the root password when prompted.

Пользовтели НЕ ДОЛЖНЫ работать в качестве пользователя root
Много команд требуют привилегий root(администратора). Пользователи не должны заходить в свою систему как root, и вам необходимо запускать такие команды или с помощью su -c или su -.

If the command requires elements to be quoted, nesting should be " ", with the single quote marks surrounded by one containing set of double quote marks. For example:

su -c "command -o 'Some Text' -file 'More text' foo/bar"

Попробуйте сами

Попробуйте новые вещи в Fedora Wiki "песочнице" . Здесь вы можете проверить на работоспособность много небольших примеров.

Создание Новых Станиц в Wiki

Wiki Fedora Проекта очень большая, и поэтому должна поддерживаться в соответствующая иерархия и организация. Лучший способ узнать об этом состоит в том чтобы просмотреть SubPages и HelpOnCategories, а затем просмотреть существующие разделы wiki.

Излишние имена (такие как /Foo/FooBar/FooBarGrue) не должны использоваться. Помните что включение 'Fedora' в имя страницы является излишним. Основной Fedora проект также не должен содержать слово 'Project' в своем названии. Например , Проекту Fedora Websites соответствует страница 'Websites', а не 'FedoraWebsitesProject'.

В основном страницы должны быть сгруппированы по проектам или программам частью которых они являются. Категории должны создаваться для различных проектов и программ и должны создавать умеренно. Большинство страниц которые вы создаете должны быть частью категории и большинство из них должны иметь подходящий тэг. Если вы намереваетесь создать новую категорию или тэг, пожалуйста сперва посоветуйтесь с командой Websites.

Если у вас есть впоросы свободно обращайтесь с ним к команде Websites.

Важные страницы

Ключевые страницы, такие как FedoraMain (у нас сейчас FedoraPrincipal (то же самое на французском, может исправим)) следует редактировать осторожно. Изменения таких страниц должны обсуждаться в списке рассылки или на IRC прежде чем применены. Специальные страницы, такие как RecentChanges, не должны редактироваться. Некоторые части ВиКи могут иметь различные разрешения доступа (permissions). Например DocsProject имеет раздел создания новой документации которая имеет немного меньше разрешений чем другая часть ВиКи. Чтобы получить доступ к редактированию таких страниц, вам необходимо выполнить дополнительные шаги. Обычно, вы можете найти инструкции, о том как это сделать, на этих страницах.

MoinMoin имеет много важных страницы которые необходимы для его нормального функционирования. Эти страницы будут отмечены в исходниках и должны быть оставлены в покое.(These pages will generally be marked in the source and should be left alone. ) Изменение этих страниц обычно уничтожается с помощью обновления MoinMoin software.

Получение справки

Если у вас есть вопросы по редактированию Вики Проекта Fedora, или вам нужна помощь, обратитесь к участникам команды Ru_RU/Websites. У этой команды есть IRC канал и почтовая рассылка -- оба эти способа эффективны для получения ответов на ваши вопросы.

Если вы собираетесь много редактировать Вики, вам необходимо присоединиться к команде Ru_RU/Websites.