|
|
| (74 intermediate revisions by 4 users not shown) |
| Line 1: |
Line 1: |
| = Редактирование Wiki Fedora проекта =
| | {{autolang}} |
| | |
| Wiki Fedora проекта имеет низкие барьеры для редакторов. Однако, необходимо небольшое обучение чтобы начать использовать wiki, и мы подчиняемся нескольким руководящим принципам, которым должны следовать все редакторы. Эта страница содержит эти принципы и несколько советов, которые помогут вам начать редактировать Wiki.
| |
| | |
|
| |
|
| | Вики Проекта Fedora предъявляет лишь незначительные требования для получения доступа для редактирования. Однако необходимо ознакомиться с некоторыми правилами редактирования, прежде чем начать использовать вики, и этим правилам должны следовать все редакторы. На этой странице приведены эти принципы, а также несколько советов, которые помогут вам приступить к работе. |
|
| |
|
| | Этот документ разделен на три части: получение доступа к редактированию, основы вики разметки, дополнительная информация по вики разметке. |
| {{Anchor|Getting_Edit_Access}} | | {{Anchor|Getting_Edit_Access}} |
| == Получение доступа к редактированию. == | | == Получение доступа к редактированию == |
| | |
| Во избежание влияния злонамеренных пользователей, которые портят Wiki Fedora проекта, мы вынуждены немного ограничить доступ к его редактированию. Для получения прав доступа к wiki, вам необходимо сделать несколько шагов. Не беспокойтесь, любой может получить доступ.
| |
| | |
| {{ Template:message/notice | Мы работаем над такими изменениями, чтобы подтверждение CLA (Contributor License Agreement (Лицензионное Соглаiение Участника)) происходило при создании начальной учетной записи одним кликом. Это позволит значительно сократить время и усилия для того чтобы перейти к редактированию Wiki. Мы ждем выпуска Moin 1.6, который обеспечит функции, которые можно использовать для подтверждения CLA одним кликом. Сроки выпуска пока не установлены.
| |
| }}
| |
| | |
| 1. Самостоятельно ознакомьтесь с информацией на этой странице и тех на которые она ссылается.
| |
| Основные правила, которые следует соблюдать приведены здесь. Неспособность следовать этим принципам требует выполнения ненужной работы для других добровольцев и в результате может привести к отзыву привилегий редактирования.
| |
| | |
| 1. Создание учетной записи.
| |
| Первым шагом для получения прав редактирования является посещение страницы UserPreferences и создание учетной записи. Имя пользователя вашей учетной записи должно быть настоящим именем в формате WikiИмя (Например <code>ИмяФамилия</code>, <code>IvanPetrov</code>). Иногда их также называют 'Camel<code></code>Case' или 'Studly<code></code>Caps'. Этот формат необходим для wiki ссылок.
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Caution}} '''Использование вашего ''настоящего имени'' в ''правильном формате'' очень важно!'''
| |
| |-
| |
| | Мы требуем настоящих имен для идентификации и отчетности по нескольким причинам. Использование правильного формата необходимо для обеспечения корректных wiki ссылок и для поддержи некоторых других возможностей которые мы используем.
| |
| |}
| |
| | |
| 1. Согласие с CLA (Лицензионное Соглашение Участника) через [[Infrastructure/AccountSystem| Систему учетных записей Fedora ]]
| |
| | |
| Подписание CLA (Лицензионное Соглашение Участника) дает Проекту Fedora возможность лицензировать ваш вклад в wiki согласно ''[[Legal/Licenses/OPL| Open Publication License 1.0]] без оговорок''. Это гарантирует что ваш вклад навсегда останется Свободным для общественного использования, изменения, и распространения, просто как Fedora distribution. См. ["Legal"] раздел для получения дополнительной информации. Следуйте инструкциям по подписанию CLA (Лицензионное Соглашение Участника) http://fedoraproject.org/wiki/Infrastructure/AccountSystem/CLAHowTo
| |
| | |
| 1. Свяжитесь с кем-либо из Группы Редактирования EditGroup
| |
| Все перечисленные в Группе Редактирования (EditGroup) могут добавить Вас в Группу Редактирования (EditGroup). Члены этой группы имеют доступ к редактированию большинства частей wiki. Если вы уже говорили с участниками, спросите их, смогут ли они добавить вас в группу редактирования. Лучше всего чтобы вы были уже знакомы к моменту получения доступа к редактирования, но это не обязательно. Если вы не можете ни с кем связаться, вы можете зайти на канал #fedora-websites на [http://freenode.net/ freenode] . Если, по каким либо причинам это невозможно, добавьте себя сами на страницу EditGroupQueue и подождите пока кто-то из Группы Редактирования добавят вас.
| |
| | |
| Человек, который добавляет Вас, проверяет что вы находитесь в <code>cla_done</code> (согласившийся с CLA) группе с помощью through the [[Infrastructure/AccountSystem/QueryAccount| Интерфейса запроса учетных записей]] .
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Tip}} '''Участие в Fedora Websites'''
| |
| |-
| |
| | Если вы заинтересованы в поддержке веб-сайта, или хотите влиться в Fedora веб-сайт команду, пожалуйста, см. страницу ["Websites"] .
| |
| |}
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Tip}} '''Работа над Документированием Fedora'''
| |
| |-
| |
| | Информация по написанию официальных Fedora документаций используя wiki доступна на странице [[DocsProject/WritingUsingTheWiki| Написание Wiki Документаций]] .
| |
| |}
| |
| | |
| | |
| == Правила ==
| |
| | |
| Существует несколько правил которым вам необходимо следовать, как только вы изменили wiki. Ниже приводятся примеры. В общем, будьте вежливы и пользуйтесь здравым смыслом. Игнорирование этих правил создает проблемы и является дорогой к отмене доступа редактирования. Если у Вас возникли вопросы вы можете задать их на канале #fedora-websites на [http://freenode.net/ freenode] .
| |
| | |
| === Представьтесь ===
| |
| | |
| Прежде чем начать редактирование любой страницы, хорошо бы представиться, добавьте информацию о себе на своей wiki странице. После того как вы зарегистрировали ваше имя в wiki, для Вас автоматически создается персональная wiki страница расположенная по адресу <code>http://fedoraproject.org/wiki/<WikiИмя></code>, где <code><WikiИмя></code> необходимо заменить вашим именем вашей учетной записи wiki.
| |
| | |
| Например, смотри CategoryHomepage.
| |
| | |
| Удостоверьтесь, что Вы упомянуты, по крайней мере адрес Вашей электронной почты. Наши веб-мастера или другие члены сообщества могут связаться с вами относительно странице которые вы редактируете. Существует несколько способов защитить ваш электронный адрес от роботов собирающих адреса (спамеров).
| |
| | |
| * [[HelpOnMacros/MailTo| MailTo макроc]]
| |
| * [[PatrickBarnes/HTMLEncode| HTML кодирование]]
| |
| | |
| Вам можете взвесить все преимущества и недостатки каждого из них и выбрать тот, который вам больше подходит.
| |
| | |
| === Всегда подписывайтесь на страницы которые вы создаете или редактируете ===
| |
| | |
| Важно, чтобы вы следили за изменениями страниц, которые вы создали или редактировали, таким образом вы можете координировать другую работу по содержимому wiki. Wiki редакторы обычно добавляют заметки страниц для передачи информации каждому кто работает вместе, и это помогает отслеживать изменения.
| |
| | |
| Вы можете найти ссылку "Подписка" на боковой панели когда вы залогинились.
| |
| | |
| === Будьте смелыми ===
| |
| | |
| | |
| Будьте смелыми при внесении изменений. Wiki изменения отслеживаются и могут быть восстановлены в случае необходимости. Это не значит что вы не должны быть осторожными, особенно при внесении больших изменений в основные документы.
| |
| | |
| === Избегайте ненужного редактирования страниц, обсуждающих правовые вопросы. ===
| |
| | |
| Эти страницы писались основательно, а слова тщательно подбирались. Прежде чем изменять эти документы, обычно лучше посоветоваться. Вы можете обратиться в Консультативный Совет Fedora (Fedora Advisory Board) (см. ["Board"] страницу) за помощью.
| |
| | |
| === Не публикуйте информацию запрещенного содержания ===
| |
| | |
| Не добавляйте информацию которая преследуется законом. Помните Проект Fedora находится в США и у подчиняется их закона. Избегайте того чтобы добавлять ссылки или дополнительную информацию о программном обеспечении которое не является свободным и открытым (free and open source) иначе это будет преследоваться по закону. Если вы считаете что вас случай исключительный, обсудите его с командой ["Websites"] . См. ForbiddenItems страницу примеров вопросов которых следует избегать.
| |
| | |
| Доведите до сведения команды ["Websites"] такие вопросы. Если необходимо, они дадут официальный ответ.
| |
| | |
| === Будьте осторожными при редактировании ключевых руководств или страниц ===
| |
| | |
| Большие и важные руководства, такие как [[Packaging/Guidelines| Packaging Guidelines(Руководящие принципы создания Пакетов)]] , в основном управляются конкретными людьми или маленькими группами. Лучше всего работать с ними когда вы чувствуете что необходимы изменения.
| |
| | |
| Важные страницы, такие как FedoraMain или [[Distribution/Download| Загрузка]] страницы, являются первыми страницами которые многие посетители видят. Изменение таких страниц нужно предоставить опытным . Если вы видите что-то на такоей странице что должно быть изменено, внесите свое предложение на обсуждение командой ["Websites"] .
| |
| | |
| === Не редактируйте страницы просто чтобы редактировать ===
| |
| | |
| Следует избекать бессмысленных изменений. Внесение изменений в текст страницы только для того чтобы поместить свое имя в лог редактирования недопустимо. Есть много страниц (большинство, фактически) которые имеют реальные ошибки которые нужно исправить. Вместо того чтобы делать бессмысленные изменения, такие как добавление пробелов или изменение ссылок с fedoraproject.org на www.fedoraproject.org (первая предпочтительней, кстати), попробуйте найти ошибки в орфографии, грамматике или пунктуации которые можно исправить. Кроме того, при исправлении мелких ошибок помечайте редактирование как "Тривиальное редактирование" используя соответсвующий флажок прежде чем записать страницу.
| |
| | |
| === Избегайте переименования страниц или перемещения содержимого без координации ===
| |
| | |
| Вики страницы в основном ссылаются и связаны с различными адресами. Важно чтобы вы координировали, связывая с подходящими групами, существующие страницы, прежде чем перемещать содержимое или переименовывать существующие страницы. Было бы лучше избегать этого без должного серьезного обоснования. Если вы хотите обсудить перемещение часть материала, выносите свои предложения на рассмотрение командой ["Websites"] .
| |
| | |
| === Следуйте идеалам, которые Федора считает важными ===
| |
| | |
| Например, старайтесь сохранить рабочий стол нейтральным и удобным технически не подготовленных пользователей которые являются новичками в Линукс и Федора. Пользователи могут использовать GNOME, KDE, консоль, или какие либо другие среды. Старайтесь помнить об этом когда пишете инстракции. Будьте уверены в приверженности Федора принципам свободного и открытого обеспечения.
| |
| | |
| === Подписывайте вложенные файлы ===
| |
| | |
| Когда вы добавляете файл в вики страницу, вы должны создать сигнатуры(detached signature) с помощью вашего GPG ключа. Некоторые файловые форматы, такие как RPM пакеты, поддерживают GPG ключи, и в этом случае вам не нужно создавать сигнатуры(detached signature) -- сигнатур в файле будет достаточно. Сигнатуры (detached signature) могут быть присоединены к странице вместе с исходным вложением, или могут быть включены в саму страницу.
| |
| | |
| GPG сигнатуры позволяют другим, кто загружает ваш файл, убедится, что он пришел от вас и не был изменен или поврежден. Они не нарушают ваших владений, они позволяют другим быть уверенными в просхождении файлов.
| |
| | |
| Изображения и простые документы безопасно оставлять без сигнатур, но если вы добавите их вреда не будет если кто то сможет удостоверится что вы автор этого документа.
| |
| | |
| Если у вас нет GPG ключа или вы хотите узнать больше об этом, см. страницу ["Cryptography"] .
| |
| | |
| === Проверяйте ваши изменения на наличие ошибок ===
| |
| | |
| Вне зависимости от того являетесь ли вы опытным писателем или ваш английский не слишком силен, предлагайте кому либо просмотреть сделанные изменения. Хорошо написанные документы очень важны для имиджа Федора. Даже самые лучшие писатели не застрахованы от опечаток или каких либо других ошибок. Найдите время чтобы просмотреть сделанные изменения и исправить мелкие ошибки.
| |
| | |
| === Федора - это сообщество ===
| |
| | |
| При написании документов для вики или где либо еще, помните что Федора является сообществом. "Мы" являемся единой группой движущейся к общим целям. "Мы" не отличаем одну группу или класс от другого. Например: нет необходимости проводить различия между добровольцами которые работают для Red Hat и теми кто не делает этого. Все добровольцы являются частю одного сообщества. Однако существуют случаи когда классификация необходима, но ее можно провести другим способом.
| |
| | |
| === Если вы в чем то неуверены - просто спрашивайте. ===
| |
| | |
| Другие члены сообщества будут рады помоч вам. #fedora-websites кана на [http://freenode.net/ freenode] идеальное место чтобы обсудить вики или другие веб сайты Федора.
| |
| | |
| {{Anchor|Watch-Your-Pages}}
| |
| == Просматривайте Ваши страницы, а также страницы других участников ==
| |
| | |
| | |
| Две вещи позволяют Wiki быть успешным инструментом по совместному использованию открытого содержимого. Первая: возможность просмотреть содержимое за которое вы ответствнны для того чтобы убедиться что оно соответствует действительности. Second is being able to watch other content develop, grow, and occasionally need your help.
| |
| | |
| Чтобы наблюдать за страницей "подпишитесь" на нее
| |
| | |
| Направьте ваш RSS клиент чтобы извлекать из http://fedoraproject.org/wiki. необходимо подавать подходящий RSS файл.
| |
| 1. Добавьте регулярное выражение для документа над которым вы работаете [[UserPreferences| UserPreferences]] над '''Subscribed wiki pages'''. Например это выражение показывает 3 документа:
| |
| <pre>Docs/Drafts/AdministrationGuide.*
| |
| Docs/Draft/Glossary.*
| |
| Docs/Drafts/DesktopUserGuide.*
| |
| </pre>
| |
| Это выражение наблюдает за всеми изменениями в данной области:
| |
| <pre>Docs/Drafts.*
| |
| </pre>
| |
| Это выражение позволяет наблюдать за всеми изменениями на страницах [[DocsProject| DocsProject]] , включая [[Docs| Docs]] и [[Docs/Drafts| Docs/Drafts]] :
| |
| <pre>Docs.*
| |
| </pre>
| |
| | |
| == Редактируйте с помощью MoinMoin ==
| |
| | |
| [[Help:Editing| Интерактивная помощь]] может быть ценным ресурсом при изучении как редактировать ВиКи страницы. Просматривая данные страницы помощи вы можете изучить некоторые новые аккуратные приемы. Вам необходимо ознакомиться с ними хотябы один раз и они всегда будут там в качестве краткой справки при редактировании страниц. Вы можете задать вопрос о редактировании на канале #fedora-websites о [http://freenode.net/ freenode.net] .
| |
| | |
| {{Anchor|Structure_of_a_Wiki_Page}}
| |
| | |
| == Структура ВиКи страниц ==
| |
| | |
| Этот раздел описывает общую структуру Вики страницы. Придерживайтесь этих указаний для каждой Вики страницы. Существуют дополнтельные правила для официальной документации Федора, описанные в [[DocsProject/WritingUsingTheWiki| DocsProject/WritingUsingTheWiki]] ; эти правила необходимы только для писателей содержимого, чтобы следовать процедурам [[DocsProject| Fedora Documentation Project]] .
| |
| | |
| 1. Заголовок страницы является заголовком первого уровня. Окружайте его с знаком разметки заголовка <code>=</code>:
| |
| | |
| <pre>= Заголовок страницы =
| |
| </pre>
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Note}} '''Исключчения''' Страницы которые предполагается использовать '''всегда и только''' встроенными в другие страницы с помощью <code>[[Inline()] </code>-мактоса, эти страницы не начинайте с заголовка первого уровня. Структура этих не модульных подстраниц зависит от родительских и начинается с вложенного уровня родительского документа.
| |
| |}
| |
| | |
| 1. Над разделом <code>= Заголовок страницы =</code> и до <code>== Введение ==</code> , включайте макрос создающий содержание страницы :
| |
| | |
| <pre>= Заголовок страницы =
| |
| | |
| | |
| | |
| == Введение ==
| |
| </pre>
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Note}} '''Исключения''' Нет необходимости включать содержание в страницы которые достаточно коротки, страницы которые можно прочитать без прокрутки в браузере открытом на 700 пикселей ввысоту.
| |
| |}
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Note}} '''Исключение''' Целью включения содержания является удобство читателя. Если содержание мешает при чтении, удалите его.
| |
| |}
| |
| | |
| 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.) Вне зависимости от стиля, который вы используете, будьте последовательны на протяжении всего документа.
| |
| | |
| <pre>{{Anchor|Заголовок_Раздела}}
| |
| == Заголовок Раздела ==</pre>
| |
| | |
| 1. Главные страницы могут бать сгруппированы помощью сочетания Important pages can be categorizedсгруппированы by putting сочетании <code>CategoryFoo</code> внизу страницы над горизонтальной линией at the bottom of the page under a horizontal rule. Замените <code>Foo</code> на имя категории, например такой как <code>Documentation</code>.
| |
| | |
| <pre>----
| |
| [[Category:Documentation</pre>]]
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Tip}} '''Используйте выпадоющее меню при сохранении изменений страницы '''
| |
| |-
| |
| | Простым способом сгруппировать страницы пункт меню ''Make this page belong to category'' который появляется на странице Wiki редактирования.
| |
| |}
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Note}} '''Исключения''' Страницы в [[Docs/Beats| Docs/Beats]] являются '''source only''' и не включаются в категорию страниц [[CategoryDocs| CategoryDocs]] т.к. их не предполагают отображать как результат поиска документации. Если страница является источником содержимого но не является канонической или ссылкой следуя по которой можно найти эту информацию, тогда не включайте ее в категорию. Другим примером является любое содержимое под персональным NameSpace.
| |
| |}
| |
| | |
| 1. ''More to come''
| |
| | |
| {{Anchor|Quick_Tips}}
| |
| == Советы ==
| |
| | |
| These are the basic things that you need to know to edit this Wiki.
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Important}} '''Pages Written for the DocsProject Have Additional Requirements'''
| |
| |-
| |
| | For more information on drafting documentation on the Wiki, refer to [[DocsProject/WritingUsingTheWiki| Writing Wiki Documentation]] .
| |
| |}
| |
| | |
| === Учитесь на примерах ===
| |
| | |
| Одним из самых лучших способов изучить способы редактирования wiki страниц является просмотр исходников существующих страниц. Это очень просто сделать:
| |
| | |
| 1. Найдите страницу исходники которой хотите просмотреть.
| |
| 1. На навигационной панели найдите combo box that reads 'More Actions:' и нажмите его.
| |
| 1. Выберите '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.
| |
| | |
| === Ссылки ===
| |
| {{Anchor|linking}}
| |
| | |
| Создание ссылок возможно самая простая хитрая вещь в MoinMoin. Простейщая форма создания ссылок это wiki имена. Wiki имена это комбинация двух или более заглавных слов. Когда вы используете WikiИмена, нет необходимости использовать специальную разметку. Ссылка будет создана автоматически.
| |
| | |
| Во избежания создания нежелательных ссылок, вам необходимо обзнакомиться с некоторыми хитростями. Простейший способ сделать это состоит в том чтобы поставить два backticks мжежду Wiki<code></code>Словами, следующим образом: <code>Wiki<code></code>Слова</code>, которые безопасно "ломают" wiki механизм автоматического создания ссылок слов. Если вам необходимо создать ссылку на подстраницу или на станицу которая не является wiki именем, вы можете использовать синтаксис подобно этому<code>[[ProjectPage/Subpage| A Subpage of Project]] </code> или просто <code>["Pagename"] </code>.
| |
| | |
| Избегайте расстановки ссылок на другие веб-сайты впределах параграфа. Вместо этого сошлитесь на веб-сайт в тексте и напишите URL для ссылки в отдельной строке. Это гарантирует что URL достаточно удобочитаем при распечатке страницы или при преобразовании ее в другой формат. Например:
| |
| | |
| <pre>
| |
| Просмотрите Fedora Documentation Website в поисках самой свежей версии этого документа пржде чем начать.
| |
| | |
| [http://docs.fedoraproject.org/]
| |
| </pre>
| |
| | |
| Для того чтобы узнать больше об этом, см. HelpOnLinking.
| |
|
| |
|
| === Списки ===
| | {{Template:Ru_RU/SideMenu}} |
|
| |
|
| Нумерованные и маркированные списпи очень просты и полезны.
| | Во избежание влияния пользователей, которые умышленно портят Вики Проекта Fedora, мы вынуждены немного ограничить доступ к ее редактированию. Для получения прав доступа к Вики необходимо сделать несколько действий. Не беспокойтесь, любой желающий может получить доступ. |
| См. HelpOnLists для более подробной информации о ток как использовать их.
| |
|
| |
|
| === Таблицы ===
| | # Ознакомьтесь с информацией на этой и других страницах, на которые она ссылается. |
| | Основные правила, которые следует соблюдать, приведены здесь. Игнорирование этих принципов создает ненужную работу для других участников и в результате может привести к отзыву прав редактирования. |
|
| |
|
| Таблицы могут быть очень сложными, потому что они могут вести себя не так как вы ожидаете. Широкие таблицы особенно ненадежны, т.к. они будут вылазить за свои границы при просмотре в маленьком окне. Самым лучшим советом при использовании таблиц состоит в том чтобы использовать их тоглько при необходимости. Только при публикации большой последовательности маленьких записей они могут сохранить много пространства. Просто тестируйте их при использовании. Помните что одугие могут иметь более низкое разрешение чем то что используете вы. Более подробная информация изложена на странице HelpOnTables.
| | # Примите CLA (Лицензионное Соглашение Участника) через [[Infrastructure/AccountSystem| систему учетных записей Fedora ]]. |
| | Это даст Проекту Fedora возможность безоговорочно лицензировать ваш вклад в Вики согласно ''[[Legal/Licenses/OPL| лицензии OPL 1.0]]''. Это гарантирует, что ваш вклад останется '''свободным''' для общественного использования, изменения и распространения, аналогично дистрибутиву Fedora. Обратитесь к разделу [[Legal]] для получения дополнительной информации. Следуйте инструкциям по принятию соглашения на странице http://fedoraproject.org/wiki/Infrastructure/AccountSystem/CLAHowTo |
|
| |
|
| {{Anchor|Admonitions}} | | {{Admon/tip | Участие в поддержке Интернет-ресурсов Fedora | Если вы заинтересованы в поддержке веб-сайта или хотите влиться в команду Интернет-ресурсов Fedora, перейдите на страницу [[Websites/ru]].}} |
| === Примечания, советы, и другой Boxed текст ===
| |
|
| |
|
| Которые в целом известны как admonitions(замечания). Чтобы превратить параграф в замечания(admonition), введите два символа вертикальной черты (pipes) вначале и в конце параграфа, сделайте заголовок bodl face, начните заголовок с подходящего значка и добавьте дополнительную информацию во второй параграф:
| | {{Admon/tip | Участие в разработке документации Fedora | Информация по созданию официальной документации Fedora с помощью вики доступна на странице [[DocsProject/WritingUsingTheWiki| Создание вики-документации]].}} |
|
| |
|
| <pre>
| | {{Admon/tip | Участие в переводе вики | Если вы заинтересованы в переводе вики на русский язык, перейдите на страницу [[Ru_RU/План_работы_по_переводу_web-сайта_проекта_Fedora#NeedPages|переводов вики]], где координируются усилия русской команды}} |
| {| border="1" | |
| |- | |
| | {{Template:Tip}} '''Это пример заметки.''' | |
| |-
| |
| | Здесь содержится дополнительная информация о заметке.
| |
| |}
| |
| </pre>
| |
|
| |
|
| {| border="1"
| | == Этикет Вики == |
| |-
| |
| | {{Template:Tip}} '''Это заголовок обобщающий заметки.'''
| |
| |-
| |
| | Здесь содержится дополнительная информация о заметке.
| |
| |}
| |
|
| |
|
| Отступ в начального и второго параграфа на один пробел гарантирует что бокс будет правильно выровнен.
| | См. страницу описания [[Help:Wiki rules and etiquette/ru| правил редактирования Вики]]. |
|
| |
|
| Ниже приведены стандартные виды замечаний:
| | == Создание новых вики-страниц == |
|
| |
|
| * {{Template:Note}} '''Это иконка примечаний''' <code> {{Template:Note}} </code>
| | Вики Проекта Fedora доволно обширна, поэтому должна поддерживаться соответствующая иерархия и организация. Лучший способ узнать об этом -- просмотреть [[Help:Wiki structure]] и [[Help:Categories]] и ознакомиться с существующей структурой Вики. |
| * {{Template:Tip}} '''Это иконка заметок''' <code> {{Template:Tip}} </code>
| |
| * {{Template:Caution}} '''Это иконка призывающая к осторожности''' <code> {{Template:Caution}} </code>
| |
| * {{Template:Important}} '''Эта иконка о важном сообщении''' <code> {{Template:Important}} </code>
| |
| * {{Template:Warning}} '''Это иконка о предупреждении''' <code> {{Template:Warning}} </code>
| |
|
| |
|
| См. Fedora Documentation Guide для описания типов замечаний:
| | <!-- Следует избегать избыточности имен (например, <code>/Foo/FooBar/FooBarGrue</code>). Так, включение 'Fedora' в имя страницы является излишним. Основные проекты Fedora не должны содержать слово 'Project' в своем названии. Например , Проекту Интернет-ресурсов Fedora соответствует страница 'Ru_RU/Websites', а не 'Ru_RU/Fedora<code></code>Websites<code></code>Project'. |
|
| |
|
| http://fedora.redhat.com/participate/documentation-guide/s1-xml-admon.html
| | Обычно страницы должны быть сгруппированы по проектам или программам, частью которых они являются. Категории должны создаваться для различных проектов и программ и должны создаваться умеренно. Страницы, которые вы создаете, должны быть включены в категории и иметь подходящие теги. Если вы намереваетесь создать новую категорию или тег, сперва посоветуйтесь с командой [[Ru_RU/Websites|Интернет-ресурсов]]. |
|
| |
|
| === Выделение Технический Терминов === | | Если у вас есть впоросы, свободно обращайтесь к команде [[Ru_RU/Websites|Интернет-ресурсов]]. --> |
| {{Anchor|Выделение_Технических_Терминов}}
| | == Редактирование с помощью Mediawiki == |
| Используйте символ (<code><code></code>) чтобы пометить имена приложений, файлы, директории, пакеты программы, аккаунт пользователя и другие слова которые имеют технический смысл. Это отображает слова как </code>monospace (моноширным шрифтом)<code>.
| |
|
| |
|
| Используйте два single-quotes (<code>''</code>) чтобы отметить имена пунктов меню и других элементов графического интерфейса. Это отображает выделенный слова как ''italic''.
| | На странице [[Help:Wiki syntax and markup/ru]] можно найти информацию о создании страниц в формате MediaWiki. Это действительно очень просто и позволяет с легкостью создавать отформатированные страницы. |
| | |
| <pre>#!html
| |
| <div style="background: #eeeff1">
| |
| </pre>
| |
| {| border="1"
| |
| |- style="background: #22437f; color: white"
| |
| | '''''Высказывание''''' || '''''Разметка''''' || '''''Начертание''''' || '''''Пример начертания'''''
| |
| |-
| |
| | Название GUI приложения || <code> '''полужирный''' </code> || '''полужирный''' || '''Firefox'''
| |
| |-
| |
| | Файлы, каталоги || <code> <code>single backticks</code> </code> || <code>моноширный шрифт</code> || <code>/usr/bin/firefox</code>
| |
| |-
| |
| | Пакеты программ || <code> <code>single backticks</code> </code> || <code>моноширный шрифт</code> || <code>firefox-1.2.3</code>
| |
| |-
| |
| | Аккаун пользователя|| <code> <code>single backticks</code> </code> || <code>моноширный шрифт</code> || <code>username</code>
| |
| |-
| |
| | Другие слова которые имеют специальное техническое значение || <code> <code>single backticks</code> </code> || <code>моноширный шрифт</code> || <code>someJava.classname</code>
| |
| |-
| |
| | Inline содержание из конфигурационных файлов, листинг программ. || <code> <code>single backticks</code> </code> || <code>моноширный шрифт</code> || ... Затем, измените настройки <code>DefaultIcon</code> в <code>/etc/httpd/conf/httpd.conf</code> ...
| |
| |-
| |
| | Графические меню и пункты меню|| <code> ''two single-ticks'' </code> || ''курсив'' || ''Приложения > Интернет > Firefox Web Browser''
| |
| |-
| |
| | Другие GUI или Веб''''''UI элементы управления || <code> ''two single-ticks'' </code> || ''курсив'' || ... нажмите кнопку ''Подтвердить'' ...
| |
| |-
| |
| | Первый термин, словарный термин || <code> ''two single-ticks'' </code> || ''курсив'' || ... '''Firefox''' является примером ''graphical user interface'' (графический пользовательский интерфейс) or ''GUI''.
| |
| |-
| |
| | Inline команды и демоны|| <code> <code>3 фигурные скобки</code> </code> || <code>моноширный шрифт</code> || ... выполните <code>ps -ef | grep httpd</code> чтобы найти PIDs запущенных <code>httpd</code> процессов.
| |
| |-
| |
| | Keystrokes || <code> '''[Key] ''' </code> || '''[bold brackets] ''' || Нажмите клавишу'''[Enter] ''' ...
| |
| |}
| |
| <pre>#!html
| |
| </div>
| |
| </pre>
| |
| Например:
| |
| | |
| <pre>
| |
| <code>thunderbird</code> пакет устанавливает '''Mozilla Thunderbird''' e-mail приложение. Чтобы запустить '''Thunderbird''', выберите: ''Приложения > Интернет > Thunderbird Email''.
| |
| </pre>
| |
| | |
| Которое отображает:
| |
| | |
| <code>thunderbird</code> пакет устанавливает '''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>#!html
| |
| <pre>
| |
| {{{su -c "yum install awesome-application"
| |
| }}}
| |
| | |
| Enter the <code>root</code> password when prompted.
| |
| </pre>
| |
| </pre>
| |
| | |
| Которое отображает:
| |
| | |
| <pre>su -c "yum install awesome-application"
| |
| </pre>
| |
| | |
| Enter the <code>root</code> password when prompted.
| |
| | |
| {| border="1"
| |
| |-
| |
| | {{Template:Important}} '''Пользовтели НЕ ДОЛЖНЫ работать как <code>root</code>'''
| |
| |-
| |
| | Много команд требуют привилегий <code>root(администратора)</code>. Пользователи не должны заходить в свою систему как <code>root</code>, и вам необходимо запускать такие команды или с помощью <code>su -c</code> или <code>su -</code>.
| |
| |}
| |
| | |
| If the command requires elements to be quoted, nesting should be <code>" '' "</code>, with the single quote marks surrounded by one containing set of double quote marks. For example:
| |
| | |
| <pre>su -c "command -o 'Some Text' -file 'More text' foo/bar"
| |
| </pre>
| |
| | |
| === Попробуйте сами ===
| |
| Попробуйте новые вещи в [[WikiSandBox| Fedora Wiki "песочнице"]] . Здесь вы можете проверить на работоспособность много небольших примеров.
| |
| | |
| === Создание Новых Станиц в Wiki ===
| |
| | |
| Wiki Fedora Проекта очень большая, и поэтому должна поддерживаться в соответствующая иерархия и организация. Лучший способ узнать об этом состоит в том чтобы просмотреть [[HelpOnEditing/SubPages| SubPages]] и HelpOnCategories, а затем просмотреть существующие разделы wiki. | |
| | |
| Излишние имена (такие как <code>/Foo/FooBar/FooBarGrue</code>) не должны использоваться. Помните что включение 'Fedora' в имя страницы является излишним. Основной Fedora проект также не должен содержать слово 'Project' в своем названии. Например , Проекту Fedora Websites соответствует страница 'Websites', а не 'Fedora<code></code>Websites<code></code>Project'.
| |
| | |
| В основном страницы должны быть сгруппированы по проектам или программам частью которых они являются. Категории должны создаваться для различных проектов и программ и должны создавать умеренно. Большинство страниц которые вы создаете должны быть частью категории и большинство из них должны иметь подходящий тэг. Если вы намереваетесь создать новую категорию или тэг, пожалуйста сперва посоветуйтесь с командой ["Websites"] .
| |
| | |
| Если у вас есть впоросы свободно обращайтесь с ним к команде ["Websites"] .
| |
|
| |
|
| | <!-- === Попробуйте сами === |
| | Попробуйте поэкспериментировать в [[WikiSandBox| "песочнице" Вики Проекта Fedora]] . Здесь вы можете проверить работоспособность разных примеров. |
| === Важные страницы === | | === Важные страницы === |
|
| |
|
| Ключевые страницы, такие как FedoraMain (у нас сейчас FedoraPrincipal (то же самое на французском, может исправим)) следует редактировать осторожно. Изменения таких страниц должны обсуждаться в списке рассылки или на IRC прежде чем применены. Специальные страницы, такие как RecentChanges, не должны редактироваться. Некоторые части ВиКи могут иметь различные разрешения доступа (permissions). Например DocsProject имеет раздел создания новой документации которая имеет немного меньше разрешений чем другая часть ВиКи. Чтобы получить доступ к редактированию таких страниц, вам необходимо выполнить дополнительные шаги. Обычно, вы можете найти инструкции, о том как это сделать, на этих страницах. | | Ключевые страницы, такие как главная страница Проекта Fedora, следует редактировать осторожно. Изменения таких страниц должны обсуждаться в списке рассылки или на IRC. Некоторые части Вики могут иметь различные разрешения доступа. Например, [[Ru_RU/DocsProject]] включает раздел создания новой документации, доступ к которому ограничен по сравнению с остальной Вики. Чтобы получить доступ к редактированию таких страниц, необходимо выполнить дополнительные шаги. Обычно такие страницы содержат инструкции по получению доступа. --> |
| | | == Получение помощи == |
| MoinMoin имеет много важных страницы которые необходимы для его нормального функционирования. Эти страницы будут отмечены в исходниках и должны быть оставлены в покое.(These pages will generally be marked in the source and should be left alone. ) Изменение этих страниц обычно уничтожается с помощью обновления MoinMoin software.
| |
|
| |
|
| == Получение справки ==
| | Если у вас есть вопросы по редактированию Вики Проекта Fedora, обратитесь к участникам команды [[Websites/ru |Интернет-ресурсов]]. У этой команды есть IRC канал (#fedora-websites и freenode) и почтовая рассылка ([https://lists.fedoraproject.org/mailman/listinfo/websites fedora-websites-list])-- оба эти способа эффективны для получения ответов на ваши вопросы. |
|
| |
|
| Если у вас есть вопросы по редактированию ВиКи Федора Проекта, или вам нужна помощь, просто обращайтесь к любому в команде ["Websites"] . Они имеют IRC канал и почтовую рассылку (mailing list), оба эти способа эффективны для получения ответов которые вам необходимы. | | Если вы собираетесь активно редактировать Вики, рекомендуется присоединиться к команде [[Websites/ru| Интернет-ресурсов]]. |
|
| |
|
| Если вы собираетесь много редактировать Вики, вам необходимо присоединиться к команде ["Websites"] .
| | [[Category:LocalizationRussian]] |
| ----
| | [[Category:Страницы на русском]] |
| [[Category:Documentation]] | |
