Difference between revisions of "RU/rules/wiki editing policy"

From Wiki
Jump to navigationJump to search
 
(167 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{RU/documentation/helpneeded|Перевод на русский язык.}}
+
<includeonly><section begin=rus />Введение в Wiki-редактирование<section end=rus /></includeonly>
{{DISPLAYTITLE:Политика Wiki-редактирования}}
+
<includeonly><section begin=lat />Introduction to the Wiki-editing<section end=lat /></includeonly>
[[fr:FR/Documentation/Dashboard/Wiki_Editing_Policy]]
+
<section begin=title /><noinclude>{{DISPLAYTITLE:</noinclude>Введение в Wiki-редактирование{{Doc/doc/code/tbl/titleSeparator}}Introduction to the Wiki-editing<noinclude>}}</noinclude><section end=title />{{RUkbUpToc}}
[[en:Documentation/Dashboard/Wiki_Editing_Policy]]
+
{{BreadCrumbL10n}}
 
+
{{Doc-inline}}
{{Documentation/Caution|Перед началом редактирования следует ознакомиться с [[RU/rules_and_information_policy|Положением и информационной политикой]] ресурса.}}
+
{{Caution|Перед началом редактирования страниц в зоне RU следует ознакомиться с Правилами ресурса:
 
+
* {{SecTitleRulesRus|RU/rules/mission|mission}};
 
+
* {{SecTitleRulesRus|RU/rules/information_strategy}}.
Эта статья поможет вам эффективно создавать разделы wiki-документации.
+
Все действующие инструкции перечислены на странице {{SecTitleRulesRus|RU/rules}}.
 
+
}}
Мы настоятельно рекомендуем Вам, объявлять о создании новых страниц или производстве значительных изменений в список рассылки [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org].
 
 
 
  
= Набор правил. Независимый проект =
+
Этот документ поможет более эффективно работать над Wiki-документацией.
{{Documentation/Note|В начале смотрите главный набор правил [[RU/wiki_contribution_guidelines|Wiki Contribution Guidelines (в процессе перевода)]].}}
 
  
=Перед началом редактирования=
 
  
Прежде чем вы сможете редактировать, вам нужно зарегистрироваться. Это не сложно.
+
== Об этих правилах ==
# Щёлкните по '''Log in / create account''' в правом верхнем углу экрана и введите необходимую информацию.<br> Мы рекомендуем использовать то же имя пользователя, что и на веб-сайте OpenOffice.org.
 
# Затем вам надо будет подтвердить ваш адрес электропочты.
 
  
Для входа в систему используйте точку входа вверху страницы, введите ваш логин и пароль, щёлкнув по кнопке '''Log in'''.
+
Данный документ описывает общие методы работы с системой MediaWiki, используемой в качестве технологической платформы Энциклопедии.
  
На следующем шаге расскажите Сообществу о себе. Это безвредно и создаёт комфорт для работы в Wiki.
 
#Когда вы вошли в систему, имя пользователя отображается вверху страницы <span style="color:#9F0000"> красным цветом</span>, до тех пор, пока вы не создадите свою страницу. Эта страница является вашим профилем. Щёлкните по своему имени, чтобы создать его.
 
#На вашей странице, добавьте несколько разделов, как указано ниже, в ваш профиль OpenOffice Wiki;
 
#* Несколько слов о себе;
 
#* OpenOffice и вы;
 
#* Ваш вклад;
 
#* Направления развития;
 
#* Какие планы на будущее?;
 
#* Ссылки (по желанию);
 
#* Контакты.
 
  
Это небольшой шаблон для создания профиля.
+
Данный документ отвечает на вопрос ''"как сделать"''.
  
 +
Вопросы ''"почему"'' и ''"зачем"'' освещены в Полном своде правил Энциклопедии: {{SecTitleRulesRus|RU/rules}}.
  
Следовать ему желательно, но не обязательно. Вы так же можете добавить разделы по вашему усмотрению. Этот образец предложен, чтобы профиль был единообразным у всех новых пользователей.
 
  
 
=Страницы обсуждений=
 
=Страницы обсуждений=
Line 43: Line 27:
 
Страницы обсуждений предназначены для комментирования и обсуждения статей. Каждая статья имеет свою собственную страницу обсуждений.
 
Страницы обсуждений предназначены для комментирования и обсуждения статей. Каждая статья имеет свою собственную страницу обсуждений.
  
Все важные замечания должны быть объявлены в списке рассылки [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org], дабы гарантировать, что их заметят.
+
Чтобы добавить комментарий к странице, необходимо:
 
+
# Щёлкнуть по вкладке '''Обсуждение''' вверху страницы.
Чтобы добавить комментарий к странице:
+
#* Чтобы начать новую тему в обсуждении, щёлкнуть по знаку '''[+]''' справа от вкладки '''Править''' вверху страницы, заполнить тему и записать свой комментарий в текстовом поле.
# Щёлкните по вкладке '''Обсуждение''' вверху страницы.
+
#* Чтобы добавить комментарий к существующей дискуссии, нужно создать отступ перед своим ответом (он должен быть больше, чем отступ у абзаца перед комментарием). Для этого требуется вставить одно или несколько двоеточий (<code>''':'''</code>) в начале каждого абзаца комментария. Одно двоеточие эквивалентно одному табулятору.
#* Если вы начинаете в обсуждении новую тему, щёлкните по знаку '''[+]''' справа от вкладки '''Править''' вверху страницы, заполните тему и запишите свой комментарий в текстовом поле.
+
# Подписать сообщение. Для этого нужно вставить четыре тильды подряд (<code><nowiki>~~~~</nowiki></code>). Они преобразуются в подпись и текущую дату. Это можно сделать автоматически с помощью кнопки ( http://wiki.i-rs.ru/skins/common/images/button_sig.png ) на панели инструментов.
#* Если вы хотите добавить комментарий к существующей дискуссии, то создайте отступ перед своим ответом (он должен быть больше, чем отступ у абзаца перед комментарием), для чего вставьте одно или несколько двоеточий (<code>''':'''</code>) в начале каждого абзаца вашего ответа. Одно двоеточие эквивалентно одному табулятору.
+
# По окончании, в поле '''«Описание изменений»''' ввести краткое описание сделанных изменений и щёлкнуть по кнопке '''Записать страницу'''.
# Подпишите ваше сообщение. Для этого вставьте четыре тильды подряд (<code><nowiki>~~~~</nowiki></code>). Они преобразуются в подпись и текущую дату. Это можно сделать автоматически с помощью кнопки ( http://wiki.services.openoffice.org/w/skins/common/images/button_sig.png ) на тулбаре.
 
# По окончании в поле '''"Описание изменений"''' введите краткое описание сделанных вами изменений и щёлкните по кнопке '''Записать страницу'''.
 
  
Более подробная информация о создании обсуждений приведена в статье [http://www.mediawiki.org/wiki/Help:Talk_pages Mediawiki help about talk pages].
+
Более подробная информация о создании обсуждений приведена в статье [http://www.mediawiki.org/wiki/Help:Talk_pages/ru Help:Talk pages/ru].
 
 
=Структура раздела [[Documentation|Документация (en)]] в Wiki=
 
 
 
Раздел '''"Документация"''' это только часть большой Wiki OpenOffice.org. Проект '''doc.oo.o''' пытается представить информацию в этом разделе так, чтобы она была легко доступна и хорошо структурирована для упрощения навигации как пользователей, так и участников
 
 
 
Все страницы документации имеют вложенные страницы. Страницы, представляющие собой разделы, имеют подстраницы. Это иерархическое представление, на подобии файловой системы. Каждая вложенная страница позволяет вернуться на предыдущую.
 
 
 
Текущая структура выглядит следующим образом:
 
 
 
wiki.services.openoffice.org/wiki/Documentation
 
    |
 
    +---Dashboard
 
    +---Administration Guide
 
    +---FAQ
 
    +---How Tos
 
    +---OOoAuthors User Manual
 
    +---OOo3 User Guides
 
    +---Tutorials
 
    +---Samples, Templates and Clipart
 
    +---Setup Guide
 
    +---BASIC Guide
 
    +---Building Guide
 
    +---DevGuide
 
    +---Reference
 
 
 
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
 
|-
 
!Subpage!!Description
 
|-
 
|[[Documentation/Dashboard]]
 
|Раздел высокого уровня, отслеживающий подпроекты и создаваемое ими содержание.
 
|-
 
|[[Documentation/Administration Guide]]
 
|Руководство по установке и администрированию OpenOffice.org в сети.
 
|-
 
|[[Documentation/FAQ]]
 
|Сборник часто задаваемых вопросов.
 
|-
 
|[[Documentation/How Tos]]
 
|Сборник ссылок на статьи "Как сделать".
 
|-
 
|[[Documentation/OOoAuthors User Manual]]
 
|Сборник документации и руководств пользователя по OpenOffice.org 2.x с ресурса OOoAuthors
 
|-
 
|[[Documentation/OOo3 User Guides]]
 
|Сборник документации и руководств пользователя по OpenOffice.org 3.x с ресурса OOoAuthors
 
|-
 
|[[Documentation/Tutorials]]
 
|Сборники обучающих материалов.
 
|-
 
|[[Documentation/Samples, Templates and Clipart]]
 
|Страница подпроекта шаблонов для бизнеса и личного использования (черновик)
 
|-
 
|[[Documentation/Setup Guide]]
 
|Страница подрпоекта по процессу установки OpenOffice.org (в разработке)
 
|-
 
|[[Documentation/BASIC Guide]]
 
|Введение в программирование на OpenOffice.org BASIC
 
|-
 
|[[Documentation/Building Guide]]
 
|Руководство по разработке пользовательских приложений {{OOo}} из исходных текстов.
 
|-
 
|[[Documentation/DevGuide]]
 
|Руководство по программированию {{OOo}}, использоую технологию UNO (Universal Network Objects).
 
|-
 
|[[Documentation/Reference]]
 
|Сборник справочных материалов. Ссылки на эту страницу ('''Reference Lists''')отображаются на главной странице проекта документации.
 
|}
 
  
 
=Создание новых страниц=
 
=Создание новых страниц=
  
{{Documentation/Caution | Перед созданием страницы убедитесь, что по данной теме уже не создана страница.}}
+
{{Caution | Перед созданием страницы необходимо убедиться, что по данной теме уже не создана страница.}}
  
* Если новая страница является подстраницей у существующей страницы, просто перейдите к существующей странице и создайте ссылку на новую страницу. После сохранения страницы, щёлкните по созданной ссылке и начните писать вашу новую страницу.
+
* Если новая страница является подстраницей у существующей страницы, достаточно перейти к этой существующей странице и создать в ней ссылку на новую страницу. После сохранения можно щёлкнуть по созданной ссылке и приступить к заполнению новой страницы.
* Если вам необходимо создать совершенно новую самостоятельную страницу, вы можете использовать wiki-URL для создания новой страницы.Для этого в браузере в строке URL введите что-то вроде этого: <br>
+
* Для создания совершенно новой самостоятельной страницы можно использовать wiki-URL. Для этого в браузере в строке URL нужно ввести строку вида: <br>
 
  <tt><nowiki> http://wiki.services.openoffice.org/wiki/</nowiki><span style="color:#9F0000">национальная_языковая_страница</span>/<span style="color:#9F0000">'''''имя_новой_страницы'''''</span></tt>
 
  <tt><nowiki> http://wiki.services.openoffice.org/wiki/</nowiki><span style="color:#9F0000">национальная_языковая_страница</span>/<span style="color:#9F0000">'''''имя_новой_страницы'''''</span></tt>
:Когда вы создаёте страницу таким образом, вы должны соблюдать существующее дерево wiki-страниц. То есть, если страница относится к какому-либо разделу, то в своём имени она должна содержать имя этого раздела. Например, если создаётся страница в проекте '''"qa"''' (контроль качества) в русской языковой зоне, в браузере в строке URL введите: <br>
+
:При создании страницы таким образом, необходимо учитывать существующее дерево wiki-страниц. То есть если страница относится к какому-либо разделу, то в своём имени она должна содержать имя этого раздела. Например, если создаётся страница в проекте '''"qa"''' (контроль качества) в русскоязычной языковой зоне, в браузере в строке URL нужно ввести: <br>
 
  <tt><nowiki> http://wiki.services.openoffice.org/wiki/</nowiki><span style="color:#9F0000">RU</span>/<span style="color:#9F0000">'''''qa'''''</span>/<span style="color:#9F0000">'''''имя_новой_страницы'''''</span></tt>  
 
  <tt><nowiki> http://wiki.services.openoffice.org/wiki/</nowiki><span style="color:#9F0000">RU</span>/<span style="color:#9F0000">'''''qa'''''</span>/<span style="color:#9F0000">'''''имя_новой_страницы'''''</span></tt>  
* Рекомендуемый метод заключается в предварительном поиске нужной информации (поле '''Поиск''' на странице слева), и если требуемая страница не найдена (не существует), будет предложено создать данную страницу щелчком по ссылке "Создать страницу" на странице результатов поиска.
+
* Рекомендуемый метод заключается в предварительном поиске нужной информации (поле '''Поиск''' на странице слева), и если требуемая страница не найдена (не существует), будет предложено создать данную страницу щелчком по ссылке «Создать страницу» на странице результатов поиска.
  
{{Documentation/Note | Создание страниц напрямую через URL допустимо только если затем будут добавлены ссылки на эту страницу с других страниц. В противном случае эта страница окажется "потерянной" в wiki.}}
+
{{Note | Создание страниц напрямую через URL допустимо только если затем будут добавлены ссылки на эту страницу с других страниц. В противном случае эта страница окажется «потерянной» в wiki.}}
  
{{Documentation/Tip|В [[RU|русской языковой зоне]] существует дополнительное [[RU/instructions_for_writing_articles|Положение о национальной языковой странице RU и информационная политика]], обязательное к исполнению.}}
+
{{Tip|Подробные правила изложены в разделе {{SecTitleRulesRus|RU/rules}} и обязательны к исполнению.}}
  
Дополнительная информация по созданию новых статей приведена в [http://www.mediawiki.org/wiki/Help:Starting_a_new_page Документации Mediawiki по созданию новых статей [en]].
+
Дополнительная информация по созданию новых статей приведена в [http://www.mediawiki.org/wiki/Help:Starting_a_new_page/ru Документации Mediawiki по созданию новых статей].
  
=Использование категорий=
+
==Использование категорий==
  
Категории, в которые включена страница, как правило, перечислены в нижнем колонтитуле страницы. Щёлкните по категории и вы перейдёте к просмотру страницы заголовков страниц, которые отнесены к данной категории. Таким образом, категории являются тегом (меткой) для страниц, с помощью которого вы даёте возможность просмотреть тематически связанные страницы. В одну категорию может быть собрано большое количество страниц.
+
{{Note|Из-за проблемы "процентного кодирования" нелатинских символов в URL, механизм категорий в Энциклопедии не используется для пользовательской навигации и поиска информации.  
  
Для добавления страницы в категорию, добавьте ссылку <tt><nowiki>[[Category:''Имя_Категории'']]</nowiki></tt> в конце страницы.
+
Категориям в Энциклопедии отводится вспомогательная техническая роль.}}
  
Категория уже должна существовать. В противном случае будет создана новая категория, оторванная от общей структуры категорий wiki.
+
Категории, в которые включена страница, как правило, перечислены в нижнем колонтитуле страницы. Щелчок по категории ведёт к просмотру страницы заголовков страниц, которые отнесены к данной категории. Таким образом, категории являются тегом (меткой) для страниц, с помощью которого возможно просмотреть тематически связанные страницы.
  
{{Documentation/Caution|Не создавайте дубликаты категорий по одной теме. Имена категорий должны быть уникальными. В противном случае станет весьма затруднительно использовать систему категорий для поиска информации в wiki.}}
+
Для добавления страницы в категорию необходимо добавить ссылку <tt><nowiki>[[Category:''Имя_Категории'']]</nowiki></tt> в конце страницы.
  
Дополнительная информация по категориям находится в [http://www.mediawiki.org/wiki/Help:Categories документации MediaWiki].
+
{{Note|В Энциклопедии крайне не рекомендуется ручное категоризирование страниц. На каждой странице помещается шаблон подвала, в котором уже указана необходимая категория. Подробнее: {{SecTitleRulesRus|RU/rules/templates}}.}}
  
Простой пример того, как использовать категории в книгах Wiki:
+
Категория уже должна существовать. В противном случае будет создана новая категория, оторванная от общей структуры категорий wiki.
# Создайте категорию с именем текущего раздела.
 
# Добавьте новую метку категории для всех страниц этой главы.
 
# Добавить теги категория для книги на вновь созданной странице категории.
 
  
Читатель может просматривать книгу категории. Книга категории включает все части книги. Если читатель щёлкнет по части категории, он увидит все страницы части в алфавитном порядке.
+
{{Caution|Не нужно создавать дубликаты категорий по одной теме. Имена категорий должны быть уникальными. В противном случае станет весьма затруднительно использовать систему категорий для поиска информации в wiki.}}
  
Не добавляйте категорию и её подкатегории на одну wiki-страницу. Дополнительная информация по категориям и подкатегориям в [http://meta.wikimedia.org/wiki/Help:Category#Category_considerations документации MediaWiki].
+
Возможно использовать шаблоны для добавления общих категорий для больших групп страниц, и это является предпочтительным. Более того, при изменении шаблона (добавлении/удалении категории в шаблоне) соответствующим образом изменится страница, на которой он задействован&nbsp;— категория будет добавлена/удалена.
  
<!-- Следующий отрывок не соответствует действительности, поэтому перевод изменён.
+
=Шаблоны=
You can use Templates to add a common category to a large group of pages, but it is not recommended. It may appear to save time, but "adding or deleting a category tag in the template does not add or delete the listings on the category page of pages that use the template, until some edit is made in the page that uses the template."  For more information, see the MediaWiki Help:Category section on [http://meta.wikimedia.org/wiki/Help:Category#Using_templates_to_populate_categories Using templates to populate categories].
 
-->
 
Вы так же можете использовать шаблоны для добавления общих категорий для больших групп страниц, и это является предпочтительным. Более того, при изменении шаблона (добавлении \ удалении категории в шаблоне), соответствующим образом изменится страница, на которой он задействован - категория будет добавлена \ удалена.
 
  
=Шаблоны=
+
Рекомендуется обратиться к [http://www.mediawiki.org/wiki/Help:Templates/ru документации на MediaWiki]
  
Обратитесь к документации на [http://www.mediawiki.org/wiki/Help:Templates mediawiki]
+
==Добавление нового шаблона документов==
 +
Если в шаблоне предусмотрен вывод какого-либо текста (кроме названий продуктов и торговых марок), то в имени шаблона также должна присутствовать ''базовая страница языка'', как об этом говорилось выше.
  
==Adding a new Documentation Template==
+
Если шаблон не выводит текст, и, без каких-либо изменений, может задействоваться на разных национальных страницах, то код языка в его имени опускается.
<section begin=addingtemplate />
 
* Если вы создаёте новый шаблон для использовании, допустим, в разделе wiki Документация, назовите его как дочернюю страницу '''Документация'''.
 
** некорректно: <tt>новый_шаблон</tt>
 
** корректно: <tt>Документация/новый_шаблон</tt>
 
  
В имени шаблона так же должна присутствовать ''базовая страница языка'', как об этом говорилось выше.
 
  
Полностью имя шаблона выглядит так:
+
* Для того чтобы все шаблоны собрать в одну категорию, необходимо добавить к шаблону собственную категорию, которая, при этом, не будет влиять на категоризацию страницы, на которой будет применён шаблон. Данная категория помещается между тегами <code><nowiki><noinclude></nowiki></code>. Подробнее об этом изложено в документации: [http://meta.wikimedia.org/wiki/Help:Template#Noinclude.2C_includeonly.2C_and_onlyinclude MediaWiki help: Template (en)].
<tt>Template:RU/Документация/новый_шаблон</tt>
 
  
* Для того, чтобы все шаблоны собрать в одну категорию, добавьте к шаблону собственную категорию, которая, при этом, не будет влиять на категоризацию страницы, на которой будет применён шаблон. Данная категория помещается между тегами <code><nowiki><noinclude></nowiki></code>. Подробнее об этом изложено в документации: [http://meta.wikimedia.org/wiki/Help:Template#Noinclude.2C_includeonly.2C_and_onlyinclude MediaWiki help: Template].
+
* Созданный шаблон нужно добавить в одну из нижеприведённых инструкций, описывающих соответствующую серию шаблонов.  
  
* Созданный шаблон добавьте в список шаблонов, приведённый ниже.
+
В именах шаблонов (URL) не действует запрет на использование заглавных букв, как на прочих страницах Энциклопедии, поскольку эти URL используются только внутри кода статей.
<section end=addingtemplate />
 
 
{{Spacer|30}}
 
{{Spacer|30}}
  
Line 195: Line 97:
 
!style="width:25%" | Где использовать
 
!style="width:25%" | Где использовать
 
!style="width:70%" | Пример использования
 
!style="width:70%" | Пример использования
 
|-
 
| [[Template:Documentation/Banner]]
 
| Вставляет "Банер" Проекта Документации в верхний правый угол страницы
 
{{RU/code|25|<nowiki>{{Documentation/Banner}}</nowiki>}}
 
| [[Image:Docbanner.png]]
 
 
|-
 
| [[Template:Documentation/OOo]]
 
| Отображает логотип OpenOffice.org
 
{{RU/code|25|<nowiki>{{Documentation/OOo}}</nowiki>}}
 
| {{Documentation/OOo}}
 
 
|-
 
| [[Template:Documentation/PDF]]
 
| Отображает логотип PDF
 
{{RU/code|25|<nowiki>{{Documentation/PDF}}</nowiki>}}
 
| {{Documentation/PDF}}
 
 
|-
 
| [[Template:Documentation/PRODUCTNAME]]
 
| Переменная для вывода названия продукта '''OpenOffice.org'''.
 
{{RU/code|25|<nowiki>{{Documentation/PRODUCTNAME}}</nowiki>}}
 
| {{Documentation/PRODUCTNAME}}
 
  
 
|-  
 
|-  
 
| [[Template:Documentation/hbar]]  
 
| [[Template:Documentation/hbar]]  
 
| Используется для рисования горизонтальных баров, для простых гистограмм  
 
| Используется для рисования горизонтальных баров, для простых гистограмм  
{{RU/code|25|<nowiki>{{Documentation/hbar|width=100|bg=#3333FF}}</nowiki><br><nowiki>{{Documentation/hbar|width=57|bg=#33FF33}}</nowiki><br><nowiki>{{Documentation/hbar|width=112|bg=#FF3333}}</nowiki>}}
+
{{Tlp|Documentation/hbar|<nowiki>width=100</nowiki>|<nowiki>bg=#3333FF</nowiki>}}<br>
 +
{{Tlp|Documentation/hbar|<nowiki>width=57</nowiki>|<nowiki>bg=#33FF33</nowiki>}}<br>
 +
{{Tlp|Documentation/hbar|<nowiki>width=112</nowiki>|<nowiki>bg=#FF3333</nowiki>}}
 
|  
 
|  
 
{{Documentation/hbar|width=100|bg=#3333FF}} {{Documentation/hbar|width=57|bg=#33FF33}} {{Documentation/hbar|width=112|bg=#FF3333}}  
 
{{Documentation/hbar|width=100|bg=#3333FF}} {{Documentation/hbar|width=57|bg=#33FF33}} {{Documentation/hbar|width=112|bg=#FF3333}}  
 
|-
 
| [[Template:RU/documentation/beingedited]]
 
| Устанавливайте данный знак на странице, которую в настоящее время редактируете, чтобы избежать конфликта изменений.
 
Используйте этот шаблон при выполнении больших изменений в статье, создание которых растягиваются более чем на один сеанс редактирования. Не забудьте добавить имя и дату "замок", добавив <tt><code><nowiki>~~~~</nowiki></code></tt> в качестве параметра шаблона:
 
{{RU/code|25|<nowiki>{{RU/documentation/beingedited|~~~~}}</nowiki>}}
 
| {{RU/documentation/beingedited|[[User:Fpe|Fpe]] 17:54, 7 February 2008 (CET)|1}}
 
 
|-
 
| [[Template:RU/documentation/needsrework]]
 
| Отметка для статей, нуждающихся в дополнительной проверке на стилистическое оформление и точность содержания.
 
{{RU/code|25|<nowiki>{{RU/documentation/needsrework}}</nowiki>}}
 
| {{RU/documentation/needsrework|1}}
 
 
|-
 
| [[Template:RU/documentation/helpneeded]]
 
| Отметка для статей, нуждающихся в проверке орфографии.
 
{{RU/code|25|<nowiki>{{RU/documentation/helpneeded|Проверка орфографии}}</nowiki>}}
 
| {{RU/documentation/helpneeded|Проверка орфографии|1}}
 
 
|-
 
| [[Template:RU/documentation/checkedaccuracy]]
 
| Отметка для статей, которые были проверены на точность.
 
Следует, в качестве параметров, указать свой логин, имя и дату проверки:
 
{{RU/code|25|<nowiki>{{RU/documentation/checkedaccuracy|rail|Р. А. Алиев|17 мая 2010}}</nowiki>}}
 
| {{RU/documentation/checkedaccuracy|rail|Р. А. Алиев|17 мая 2010}}
 
 
|-
 
| [[Template:RU/documentation/outdated]]
 
| Указывает, что статья устарела.
 
{{RU/code|25|<nowiki>{{RU/documentation/outdated}}</nowiki>}}
 
| {{RU/documentation/outdated|1}}
 
 
|-
 
| [[Template:RU/documentation/draftpage]]
 
| Метка для страниц, которые находятся в процессе создания (стадия Черновика).
 
{{RU/code|25|<nowiki>{{RU/documentation/draftpage}}</nowiki>}}
 
| {{RU/documentation/draftpage|1}}
 
 
|-
 
| [[Template:RU/documentation/imported]]
 
| Отметка для статей, взятых из другого источника, с указанием автора и ссылкой на оригинал.
 
{{RU/code|25|<nowiki>{{RU/documentation/imported|Имя автора|Имя переводчика}}</nowiki>}}
 
| {{RU/documentation/imported|Имя автора|Имя переводчика}}
 
 
|-
 
| [[Template:Documentation/Windows]]
 
| Отображение логотипа Windows для ввода Windows-зависимого контента.
 
{{RU/code|25|<nowiki>{{Documentation/Windows|Windows-зависимый контент}}</nowiki>}}
 
| {{Documentation/Windows| Windows-зависимый контент}}
 
 
|-
 
| [[Template:Documentation/Linux]]
 
| Отображение логотипа Linux для ввода Linux-зависимого контента.
 
{{RU/code|25|<nowiki>{{Documentation/Linux|Linux-зависимый контент}}</nowiki>}}
 
| {{Documentation/Linux| Linux-зависимый контент}}
 
 
|-
 
| [[Template:Documentation/OSX]]
 
| Отображение логотипа Apple/OSX для ввода OSX-зависимого контента.
 
{{RU/code|25|<nowiki>{{Documentation/OSX | Mac related content}}</nowiki>}}
 
| {{Documentation/OSX | Mac-зависимый контент}}
 
  
 
|-  
 
|-  
 
| [[Template:Bug]]  
 
| [[Template:Bug]]  
 
| Ссылки на вопрос (баг) в Issuezilla.
 
| Ссылки на вопрос (баг) в Issuezilla.
{{RU/code|25|<nowiki>{{Bug|123456}}</nowiki>}}  
+
{{Tlp|Bug|123456}}
 
| {{Bug|123456}}
 
| {{Bug|123456}}
  
 
|-  
 
|-  
| [[Template:Documentation/Note]]  
+
| [[Template:HeaderBlock]]
| Применяется для примечаний, для концентрации внимания. Например, объяснений и комментариев.
+
| Оформительский шаблон.
{{RU/code|25|<nowiki>{{Documentation/Note|Это примечание}}</nowiki>}}
+
Предназначен для оформления самых важных ссылок в виде подобия кнопки.
| {{Documentation/Note|Это примечание}}
+
{{Tlp|HeaderBlock|<nowiki>[[RU]]</nowiki>}}
 
+
| {{HeaderBlock|[[RU]]}}  
|-
 
| [[Template:Documentation/Tip]]  
 
| Применяется для выделения не критичной информации - например, для привлечения внимания к клавиатурным комбинациям.
 
{{RU/code|25|<nowiki>{{Documentation/Tip|Правый щелчок мышью для вызова контекстного меню}}</nowiki>}}  
 
| {{Documentation/Tip|Правый щелчок мышью для вызова контекстного меню}}
 
 
 
|-
 
| [[Template:Documentation/Caution]]  
 
| Примется для предупреждений, для потенциально опасной информации, например, влекущую потерю данных.
 
{{RU/code|25|<nowiki>{{Documentation/Caution|Стирание файла может его уничтожить.}}</nowiki>}}
 
| {{Documentation/Caution|Стирание файла может его уничтожить.}}
 
  
 
|-  
 
|-  
| [[Template:RU/documentation/seealso]] и [[Template:RU/documentation/devguide/seealso]]  
+
| Template:*TOC
|'''DevGuide''' / '''Смотри также''' используются в Руководстве для разработчиков и должны быть исключены из создаваемых PDF и ODT книг.
+
| Несколько видов оглавлений, основанных на [[Template:MasterTOC]], используемых в руководствах.  
{{RU/code|25|<nowiki>{{RU/documentation/seealso|
+
| См. например, [[Template:Documentation/BASICGuideTOC|Basic Guide TOC]]
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 
}}</nowiki>}}
 
| {{RU/documentation/seealso|
 
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 
}}
 
  
 
|-  
 
|-  
| [[Template:RU/fromforum]]
+
| [[Template:MasterTOC]]  
| Отметка для статей, написанных по мотивам обсуждений на форуме community.i-rs.ru
+
| Это базовый шаблон для создания оглавлений. Для использования нужно кликнуть на имени шаблона.
{{RU/code|25|<nowiki>{{RU/fromforum}}</nowiki>}}
 
| {{RU/fromforum}}
 
 
 
|-
 
| [[Template:Documentation/Abstract]]
 
| Для краткого обобщения содержания главы руководства. Добавляется в верхнюю часть руководств.
 
{{RU/code|25|<nowiki>{{Documentation/Abstract|Abstract Text}}</nowiki>}}
 
| См. например, [[Documentation/Administration Guide/Customizing|this Administration Guide Chapter]]
 
 
 
|-
 
| Template:Documentation/*TOC
 
| Несколько видов оглавлений, основанных на [[Template:Documentation/MasterTOC]], используемых в руководствах.
 
| См. например, [[Template:Documentation/BASICGuideTOC/v2|Basic Guide TOC]]
 
 
 
|-
 
| [[Template:Documentation/MasterTOC]]  
 
| Это базовый шаблон для создания оглавлений. Для использования, кликните на имя шаблона.
 
 
|
 
|
 
|-
 
| [[Template:RU/documentation/oooversion]]
 
| Этот шаблон используется для вставки на странице окна с номером версии {{OOo}}.
 
{{RU/code|25|<nowiki>{{RU/documentation/oooversion|3.3.x}}</nowiki>}}
 
| {{RU/documentation/oooversion|3.3.x}}
 
 
|-
 
| [[Template:RU/documentation/oooproversion]]
 
| Этот шаблон используется для вставки на странице окна с номером версии {{OOoPro}}.
 
{{RU/code|25|<nowiki>{{RU/documentation/oooproversion|3.3.x}}</nowiki>}}
 
| {{RU/documentation/oooproversion|3.3.x}}
 
 
|-
 
| [[Template:RU/documentation/sign]]
 
| Этот шаблон используется для вставки в статью подписи с именем автора.<br>Первый параметр - логин автора.<br>Второй параметр - имя, которое будет отображено в подписи.
 
{{RU/code|25|<nowiki>{{RU/documentation/sign|NGarbuz|Н. Е. Гарбуз}}</nowiki>}}
 
| {{RU/documentation/sign|NGarbuz|Н. Е. Гарбуз}}
 
 
|-
 
| [[Template:RU/documentation/signyear]]
 
| Этот шаблон используется для вставки в статью подписи с именем автора и датой создания статьи.<br>Первый параметр - логин автора.<br>Второй параметр - имя, которое будет отображено в подписи.<br>Третий параметр - дата, выводимая в подписи.
 
{{RU/code|25|<nowiki>{{RU/documentation/signyear|NGarbuz|Н. Е. Гарбуз|2009}}</nowiki>}}
 
| {{RU/documentation/signyear|NGarbuz|Н. Е. Гарбуз|2009}}
 
 
|-
 
| [[Template:RU/documentation/signtrans]]
 
| Этот шаблон используется для вставки в статью подписи с именем переводчика и датой создания статьи.<br>Первый параметр - логин переводчика.<br>Второй параметр - имя, которое будет отображено в подписи.<br>Третий параметр - дата, выводимая в подписи.
 
{{RU/code|25|<nowiki>{{RU/documentation/signtrans|Ivan|И. И. Иванов}}</nowiki>}}
 
| {{RU/documentation/signtrans|NGarbuz|Н. Е. Гарбуз}}
 
 
|-
 
| [[Template:RU/documentation/signtransyear]]
 
| Этот шаблон используется для вставки в статью подписи с именем переводчика и датой создания статьи.<br>Первый параметр - логин переводчика.<br>Второй параметр - имя, которое будет отображено в подписи.<br>Третий параметр - дата, выводимая в подписи.
 
{{RU/code|25|<nowiki>{{RU/documentation/signtransyear|NGarbuz|Н. Е. Гарбуз|2009}}</nowiki>}}
 
| {{RU/documentation/signtransyear|NGarbuz|Н. Е. Гарбуз|2009}}
 
 
|-
 
| [[Template:OOoPro]]
 
| Этот шаблон используется для вставки в статью названия сборки '''OpenOffice.org pro''' в любом месте текста.
 
{{RU/code|25|<nowiki>{{OOoPro}}</nowiki>}}
 
| {{OOoPro}}
 
 
|-
 
| [[Template:OOo]]
 
| Этот шаблон используется для вставки в статью названия '''OpenOffice.org''' в любом месте текста.
 
{{RU/code|25|<nowiki>{{OOo}}</nowiki>}}
 
| {{OOo}}
 
  
 
|}
 
|}
Line 399: Line 136:
 
=Изображения и графика=
 
=Изображения и графика=
  
Вот основные правила для картинок
+
Вот основные правила для картинок.
  
 
* Заголовок картинки должен быть уникальным и информативным. Имя файла так же должно иметь смысл, например '''scr_writer_conf_slovar.png''' отлично подойдёт для скриншота('''scr''') окна настройки('''conf''') словаря('''slovar''') в OOo Writer('''writer''').
 
* Заголовок картинки должен быть уникальным и информативным. Имя файла так же должно иметь смысл, например '''scr_writer_conf_slovar.png''' отлично подойдёт для скриншота('''scr''') окна настройки('''conf''') словаря('''slovar''') в OOo Writer('''writer''').
* Загружать картинки лучше в их оригинальном разрешении, если это возможно. Wiki автоматически создаёт уменьшенные картинки, которые в последствии можно вставлять в статьи
+
* Загружать картинки лучше в их оригинальном разрешении, если это возможно. Wiki автоматически создаёт уменьшенные картинки, которые в последствии можно вставлять в статьи.
 
* Рекомендуется отредактировать картинку так, чтобы сделать основную её часть более заметной. Например: подчеркнуть красной линией нужную команду в меню.
 
* Рекомендуется отредактировать картинку так, чтобы сделать основную её часть более заметной. Например: подчеркнуть красной линией нужную команду в меню.
* Всегда помните о том, что статью с вашим изображением могут перевести на другой язык. Избегайте подписей и сносок на самой картинке, это упростит процедуру перевода.
+
* Всегда необходимо помнить о том, что статью с этим изображением могут перевести на другой язык. Поэтому желательно избегать подписей и сносок на самой картинке, это упростит процедуру перевода.
* Форматы: JPG для фотографий, SVG для значков, логотипов и т.п., PNG - для снимков экрана. Запрещяется использовать BMP. (Paint давно поддерживает другие форматы)
+
* Форматы: JPG для фотографий, SVG для значков, логотипов и т.&nbsp;п., PNG&nbsp;— для снимков экрана. Запрещается использовать BMP. (Paint давно поддерживает другие форматы)
  
  
Перед вставкой в статью, картинку необходимо загрузить на сервер. Для этого, на боковой панели, существует ссылка '''"Загрузить файл"''' в разделе '''инструменты'''. На странице описания картинке укажите кратко, что содержится на ней, отдельно обратите внимание на авторские права на изображение, если это необходимо.
+
Перед вставкой в статью картинку необходимо загрузить на сервер. Для этого на боковой панели существует ссылка '''«Загрузить файл»''' в разделе '''инструменты'''. На странице описания картинки необходимо кратко сформулировать, что содержится на ней, а также акцентировать внимание на авторских правах на изображение, если это необходимо.
  
  
Line 415: Line 152:
  
 
* Имя: имя файла загруженной картинки.
 
* Имя: имя файла загруженной картинки.
* Предпр.: thumb - создать уменьшенню копию и поместить в обрамление; none - вставить как есть.
+
* Предпр.: thumb&nbsp;— создать уменьшенную копию и поместить в обрамление; none&nbsp;— вставить как есть.
* Положение: положение картинки на странице, left - слева с обтеканием; right - справа с обтеканием; none - картинка расположится слева, без обтекания.
+
* Положение: положение картинки на странице, left&nbsp;— слева с обтеканием; right&nbsp;— справа с обтеканием; none&nbsp;— картинка расположится слева, без обтекания.
* Размер: максимальная ширина картинки в px. Если изображение больше этого значения, то обо будет смасштабировано, если меньше, то останется как есть.
+
* Размер: максимальная ширина картинки в px. Если изображение больше этого значения, то оно будет смасштабировано, если меньше, то останется как есть.
  
  
Если не указано положения и размера, то изображение будет расположено справа в виде маленькой картинки.
+
Если не указаны положение и размер, то изображение будет расположено справа в виде маленькой картинки.
  
 
  <nowiki>Например:[[Image:'''LoadSaveOptions.png'''|thumb|left|250px|Окно настройки OOo]]</nowiki>
 
  <nowiki>Например:[[Image:'''LoadSaveOptions.png'''|thumb|left|250px|Окно настройки OOo]]</nowiki>
Line 426: Line 163:
 
[[Image:LoadSaveOptions.png|thumb|left|250px|Окно настройки OOo]]
 
[[Image:LoadSaveOptions.png|thumb|left|250px|Окно настройки OOo]]
  
  * How to handle image and table numbering?
+
 
 +
  * Как управлять нумерацией изображений и таблиц?  
  
 
=Расстановка ссылок=
 
=Расстановка ссылок=
  
Хотя окно редактирования предлагает помощь в создании внутренних и внешних ссылок, просмотрите [http://www.mediawiki.org/wiki/Help:Links MediaWiki страницу помощи по ссылкам (en)] для лучшего понимания того, как ссылки работают в Wiki.
+
Хотя окно редактирования предлагает помощь в создании внутренних и внешних ссылок, рекомендуется просмотреть [http://www.mediawiki.org/wiki/Help:Links/ru MediaWiki страницу помощи по ссылкам] для лучшего понимания того, как ссылки работают в Wiki.
  
Возможно, вам пригодится страница помощи MediaWiki [http://meta.wikimedia.org/wiki/Help:Wikitext_examples#Links examples примеры ссылок (en)].
+
Возможно, также будет полезной страница помощи MediaWiki [http://meta.wikimedia.org/wiki/Help:Wikitext_examples#Links примеры ссылок (en)].
  
При создании текста ссылки следуйте руководствам [[Documentation/Dashboard/Help_Style_Guide#Using_Links | using links (en)]] по стилю.
+
При создании текста ссылки необходимо следовать руководству по стилю [[Documentation/Dashboard/Help_Style_Guide#Using_Links | using links (en)]].
  
 
=Основные работы по редактированию=
 
=Основные работы по редактированию=
 
 
 
 
Редактирование возможно только после входа под своим именем. Вы можете редактировать сразу всю страницу, нажав на вкладке '''править''' на самом верху. Но обычно удобнее редактировать отдельные разделы страницы, нажав на ссылку '''[править]''' справа от заголовка раздела. При редактировании, просьба соблюдать принятые [[Documentation/Dashboard/Help_Style_Guide|стили оформления (en)]] в целях обеспечения единства стилей всех статей. Перед сохранением изменений, нажмите кнопку '''"Предварительный просмотр"'''.
+
Редактирование возможно только после входа под своим именем. Редактировать можно сразу всю страницу, щёлкнув по вкладке '''править''' на самом верху. Но обычно удобнее редактировать отдельные разделы страницы, щёлкнув по ссылке '''[править]''' справа от заголовка раздела. При редактировании, просьба соблюдать принятые [[Documentation/Dashboard/Help_Style_Guide|стили оформления (en)]] в целях обеспечения единства стилей всех статей. Перед сохранением изменений, рекомендуется использовать кнопку '''«Предварительный просмотр»'''.
  
  
Line 447: Line 185:
 
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
 
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
 
|-
 
|-
| {{RU/documentation/outdated|1}}
+
| {{Tlp|OutDated|RU}}
| Эта метка означает, что статья полностью устарела и требует переработки.
+
| Эта метка означает, что статья устарела и информация из неё актуальна только для предыдущих версий офиса.  
|-
+
| {{HelpNeeded|RU|Проверка орфографии|1}}
| {{RU/documentation/helpneeded|Проверка орфографии|1}}
+
| Если статья частично устарела или содержит неточную информацию, эта метка будет знаком просьбы о помощи в редактировании.
| Если статья частично устарела или содержит неточную информацию, вы обнаружите эту метку как знак просьбы о помощи в редактировании.
 
 
|-
 
|-
| {{RU/documentation/needsrework|1}}
+
| {{NeedsRework|RU|1}}
| Вы можете найти набор страниц, отмеченных таким знаком, если нажмете на ссылку [[:Category:Требуют доработки|Страницы, требующие доработки]] на главной странице [[RU|Wiki\RU]].
+
| Набор страниц, отмеченных таким знаком, может быть найден по ссылке [[:Category:Требуют доработки|Страницы, требующие доработки]] на главной странице [[RU|Wiki\RU]].
 
|}
 
|}
  
Выбрав страницу, над которой хотите поработать,
+
Выбрав страницу для редактирования, необходимо:
  
#проверьте, что описанные инструкции все еще действуют для текущей версии OpenOffice.org.
+
#проверить, что описанные инструкции всё ещё действуют для текущей версии {{OOo}};
#войдите в систему и сделайте необходимые исправления.
+
#войти в систему и сделать необходимые исправления.
  
Удобно работать в двух вкладках браузера: одна вкладка - для чтения описанных инструкций, вторая - для редактирования.
+
Удобно работать в двух вкладках браузера: одна вкладка&nbsp;— для чтения описанных инструкций, вторая&nbsp;— для редактирования.
  
Закончив редактирование, удалите метку (или метки) о том, что статья требует редактирования, и поставьте отметку "Проверена формальная точность" (как описано в [[RU/wiki_editing_policy#.D0.A1.D0.BF.D0.B8.D1.81.D0.BE.D0.BA_.D1.81.D1.83.D1.89.D0.B5.D1.81.D1.82.D0.B2.D1.83.D1.8E.D1.89.D0.B8.D1.85_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.BE.D0.B2_.D0.B4.D0.BE.D0.BA.D1.83.D0.BC.D0.B5.D0.BD.D1.82.D0.B0.D1.86.D0.B8.D0.B8|Шаблонах]] предыдущего раздела). Затем нажмите кнопку '''Записать страницу'''.
+
Закончив редактирование, нужно удалить метку (или метки) о том, что статья требует редактирования, и поставить отметку «Проверена формальная точность» (как описано в [[RU/wiki_editing_policy#.D0.A1.D0.BF.D0.B8.D1.81.D0.BE.D0.BA_.D1.81.D1.83.D1.89.D0.B5.D1.81.D1.82.D0.B2.D1.83.D1.8E.D1.89.D0.B8.D1.85_.D1.88.D0.B0.D0.B1.D0.BB.D0.BE.D0.BD.D0.BE.D0.B2_.D0.B4.D0.BE.D0.BA.D1.83.D0.BC.D0.B5.D0.BD.D1.82.D0.B0.D1.86.D0.B8.D0.B8|Шаблонах]] предыдущего раздела). Затем щёлкнуть кнопку {{Button|Записать страницу}}.
  
 
==Исправление незначительных ошибок и опечаток==
 
==Исправление незначительных ошибок и опечаток==
  
Если вы обнаружили незначительные ошибки типа опечаток, просто войдите в систему и отредактируйте статью. Перед тем как нажать кнопку '''Записать страницу''', поставьте галочку в пункте '''Малое изменение'''.
+
При обнаружении незначительных ошибок типа опечаток, достаточно просто войти в систему и отредактировать статью. Перед тем как щёлкнуть кнопку {{Button|Записать страницу}}, желательно поставить галочку в пункте '''Малое изменение'''.
  
 
==Исправление картинок и снимков экрана==
 
==Исправление картинок и снимков экрана==
  
Для редактирования графики в Wiki, нажмите правой кнопкой мыши на картинке и выберите пункт  '''Сохранить изображение как...'''. После редактирования картинки на своем компьютере, вернитесь на страницу Wiki, нажмите на картинку и на странице описания изображения выберите пункт '''Загрузить новую версию этого файла'''.
+
Для редактирования графики в Wiki необходимо щёлкнуть правой кнопкой мыши по картинке и выбрать пункт  '''Сохранить изображение как…'''. После редактирования картинки на своем компьютере нужно вернуться на страницу Wiki, щёлкнуть по картинке и на странице описания изображения выбрать пункт '''Загрузить новую версию этого файла'''.
  
Если вы сделали новую версию снимка экрана, просто нажмите на соответствующий снимок экрана Wiki и выберите пункт '''Загрузить новую версию этого файла''' на странице описания изображения.
+
Чтобы загрузить новую версию снимка экрана, нужно щёлкнуть на соответствующий снимок экрана Wiki и выбрать пункт '''Загрузить новую версию этого файла''' на странице описания изображения.
  
 
==Стилевые и языковые исправления==
 
==Стилевые и языковые исправления==
  
 
Статьи, требующие стилевых и языковых исправлений, можно узнать по следующим меткам:
 
Статьи, требующие стилевых и языковых исправлений, можно узнать по следующим меткам:
{{RU/documentation/helpneeded|Проверка орфографии|1}}
+
{{HelpNeeded|RU|Проверка орфографии|1}}
{{RU/documentation/needsrework|1}}
+
{{NeedsRework|RU|1}}
Набор статей, имеющих последнюю метку, вы можете получить, нажав на ссылку [[:Category:Требуют доработки| Страницы, требующие доработки]] на главной странице [[RU|Wiki/RU]].
+
Набор статей, имеющих последнюю метку, можно получить, нажав на ссылку [[:Category:Требуют доработки| Страницы, требующие доработки]] на главной странице [[RU|Wiki/RU]].
  
Чтобы улучшить такую статью, войдите в систему, нажмите ссылку редактирования и внесите соответствующие изменения. Затем удалите метку (или метки) и нажмите кнопку '''Записать страницу'''.
+
Чтобы улучшить такую статью, необходимо войти в систему, щёлкнуть по ссылке редактирования и внести соответствующие изменения. Затем удалить метку (или метки) и щёлкнуть кнопку {{Button|Записать страницу}}.
  
 
==Ссылки на локализованные страницы==
 
==Ссылки на локализованные страницы==
Line 489: Line 226:
 
* Ссылки между страницами на разных языках можно делать, используя синтаксис ссылок Interwiki <tt><nowiki>[[ISO_Lang_code:Page_Title]]</nowiki></tt>. <br> Например,
 
* Ссылки между страницами на разных языках можно делать, используя синтаксис ссылок Interwiki <tt><nowiki>[[ISO_Lang_code:Page_Title]]</nowiki></tt>. <br> Например,
 
:<tt><nowiki>[[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]]</nowiki></tt>
 
:<tt><nowiki>[[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]]</nowiki></tt>
:добавляет ссылку на китайский перевод первой страницы Руководства разработчика.   Эта ссылка показывается в левом столбце под заголовком "на других языках". При добавлении новых локализаций более практичным будет воспользоваться шаблонами Wiki.
+
:добавляет ссылку на китайский перевод первой страницы Руководства разработчика. Эта ссылка показывается в левом столбце под заголовком «на других языках». При добавлении новых локализаций более практичным будет воспользоваться шаблонами Wiki.
* В Руководстве разработчика мы используем шаблон для создания ссылок на страницы переводов. <br> Синтаксис Wiki следующий:
+
* В Руководстве разработчика используется шаблон для создания ссылок на страницы переводов. <br> Синтаксис Wiki следующий:
 
:<tt><nowiki>{{Documentation/DevGuideLanguages|Page_Title}}</nowiki></tt>
 
:<tt><nowiki>{{Documentation/DevGuideLanguages|Page_Title}}</nowiki></tt>
:Page_Title - это имя текущей страницы Wiki. <br>
+
:Page_Title&nbsp;— это имя текущей страницы Wiki. <br>
 
:Например,
 
:Например,
 
:<tt><nowiki>{{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org/Developers Guide}}</nowiki></tt>
 
:<tt><nowiki>{{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org/Developers Guide}}</nowiki></tt>
 
:добавит ссылки на локализованные страницы для первой страницы Руководства разработчика.  <br>
 
:добавит ссылки на локализованные страницы для первой страницы Руководства разработчика.  <br>
:Если вы хотите увидеть ссылку на локализацию на свой язык страниц Wiki Руководства разработчика, просто добавьте свой язык в шаблон
+
:Чтобы увидеть ссылку на локализацию на свой язык страниц Wiki Руководства разработчика, нужно просто добавить свой язык в шаблон
 
:[[Template:Documentation/DevGuideLanguages]]
 
:[[Template:Documentation/DevGuideLanguages]]
 
:Например, для немецкого языка необходимо добавить
 
:Например, для немецкого языка необходимо добавить
 
:<tt><nowiki>[[nl:NL/{{{1}}}]]</nowiki></tt>
 
:<tt><nowiki>[[nl:NL/{{{1}}}]]</nowiki></tt>
:Убедитесь, что шаблон корректно работает для каждой из переведенных страниц.
+
:Необходимо убедиться, что шаблон корректно работает для каждой из переведённых страниц.
  
 
==Проверка содержимого==
 
==Проверка содержимого==
  
==Удаление спама / удаление страниц==
+
==Локализация контента==
 
 
Если вы обнаружили спам, то пошлите сообщение по адресу [mailto:dev@website.openoffice.org dev@website.openoffice.org].
 
 
 
Также существует [[Special:Listusers/sysop|список администраторов Wiki (en)]] (пользователей, которые могут удалять страницы Wiki). Если вы считаете, что какие-то страницы Wiki должны быть удалены, вы можете либо послать сообщение кому-нибудь из этого списка, либо - что лучше - добавить отметку Wiki <tt><nowiki>{{delete}}</nowiki></tt> в любом месте страницы, которая должна быть удалена. Это переведет страницу в разряд "Кандидатов на удаление", и страница будет удалена WikiBot или каким-либо из пользователей, имеющих привилегии администратора.
 
 
 
=Working on FAQs=
 
 
 
{{RU/documentation/beingedited|[[User:Denis0.ru|Denis0.ru]] 08:01, 21 May 2010 (UTC)}}
 
 
 
Every question together with its answer is displayed on one single wiki page.
 
 
 
If you want to insert a new FAQ entry, that is, a pair of a question together with the corresponding answer:
 
<ol>
 
<li> Select a FAQ section on the main page of the Documentation Wiki. In Writer and Calc you have to select another subpage until you reach a final FAQ section.</li>
 
<li> Scroll down to the Insert New FAQ listbox.</li>
 
<li> Replace the text in the listbox after the last slash '/' with your question.</li>
 
<li> Click '''Add New FAQ'''<br>A new wiki page will be created and preloaded with a template for a Q/A pair: </li>
 
 
 
<source lang="text">
 
{{{DISPLAYTITLE: (INSERT FAQ TITLE)}}
 
 
 
<section begin=question/>
 
<INSERT QUESTION>
 
<section end=question/>
 
 
 
<section begin=answer/>
 
<INSERT ANSWER>
 
<section end=answer/>
 
 
 
[[Category:Documentation/FAQ/<INSERT FAQ SECTION>]]
 
 
 
</source>
 
 
 
<li> Replace <tt>(INSERT FAQ TITLE)</tt> with the title of the FAQ to be displayed on the page. This may be a short version of the question or the question itself.</li>
 
<li> Replace <tt><INSERT QUESTION></tt> with the actual question.</li>
 
<li> Replace <tt><INSERT ANSWER></tt> with the actual answer.</li>
 
<li> Replace <tt><INSERT FAQ SECTION></tt> with the current FAQ section name. This category assignment determines where this wiki page will appear. Please use the following section names:</li>
 
 
 
{|class="prettytable sortable"
 
|-
 
!FAQ section !!section name in category
 
|-valign=top
 
|General||General
 
|-valign=top
 
|Installation||Installation
 
|-valign=top
 
|Word Processing||Writer
 
|-valign=top
 
|Automatic Functions||Writer/AutomaticFunctions
 
|-valign=top
 
|Document Management||Writer/DocumentManagement
 
|-valign=top
 
|Formatting Pages and Docs||Writer/FormattingPagesAndDocuments
 
|-valign=top
 
|Formatting Text||Writer/FormattingText
 
|-valign=top
 
|Graphics, Frames & Objects||Writer/GraphicsFramesObjects
 
|-valign=top
 
|Indexes, Tables of Contents||Writer/IndexToc
 
|-valign=top
 
|Printing and Mail Merge||Writer/Printing
 
|-valign=top
 
|Spreadsheets||Calc
 
|-valign=top
 
|Drawings||Draw
 
|-valign=top
 
|Presentations||Impress
 
|-valign=top
 
|Formula Editor||Formula
 
|-valign=top
 
|Database||Databases
 
|-valign=top
 
|Macros||Macros
 
|}
 
<li>Click '''Save Page'''.</li>
 
</ol>
 
 
 
=Working on How Tos=
 
If you want to create a new How To
 
# Go to the [[Documentation/How_Tos | How Tos section]] and open the edit window.
 
# Identify the adequate subsection and enter the title of your How To as a link.
 
# Click '''Save Page''' to make the link visible.
 
# Click the link to your How To and start writing by using the rules of the [[Documentation/Dashboard/Help_Style_Guide | style guide]]. If you are not sure about how to implement the style guide, have a look at the Writer How To [[Documentation/How_Tos/Getting_a_Picture_into_the_Gallery | Getting a Picture Into the Gallery]].
 
 
 
{{Documentation/Note|Always put the licence link at the end of your article: Simply insert <tt><nowiki>{{PDL1}}</nowiki></tt>. }}
 
 
 
You can also create How Tos by writing a new page like <tt>Documentation/How Tos/''Page Name''</tt> with one or more specific categories. The newly created How To page will then be assigned to the corresponding How To sections. The available categories for that are the following:
 
* <tt><nowiki>[[Category:Documentation/How Tos/Installation]]</nowiki></tt>
 
* <tt><nowiki>[[Category:Documentation/How Tos/Writer]]</nowiki></tt>
 
* <tt><nowiki>[[Category:Documentation/How Tos/Impress]]</nowiki></tt>
 
* <tt><nowiki>[[Category:Documentation/How Tos/Calc]]</nowiki></tt>
 
* <tt><nowiki>[[Category:Documentation/How Tos/Database]]</nowiki></tt>
 
 
 
 
 
If you want to revise existing How Tos, watch for the label "This article needs to be checked for accuracy and style."
 
* Test whether the described procedures are still valid for the current version of OpenOffice.org,
 
* check whether the rules of the style guide are applied,
 
* check for grammar and spelling mistakes,
 
and make the necessary corrections in the edit window.
 
 
 
When you have finished, mark the page with the label "Checked for technical accuracy" as described in the [[Documentation/Dashboard/Wiki_Editing_Policy#List_of_Existing_Documentation_Templates | Templates]] section above, and click '''Save page'''.
 
 
 
Do not forget to notify [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org] about your work on the How Tos.
 
 
 
=Working on Guides=
 
Currently, there are the following guides on the wiki:
 
* [[Documentation/Administration_Guide|The Administration Guide]]
 
* [[Documentation/BASIC_Guide|The BASIC  Programming Guide]]
 
* [[Documentation/Building_Guide|The Building Guide (OO.o from source)]]
 
* [[Documentation/DevGuide/OpenOffice.org_Developers_Guide|The Developer's Guide]]
 
* [[Documentation/OOoAuthors_User_Manual|The User Guides for OpenOffice.org 2.x]]
 
* [[Documentation/OOo3_User_Guides|The User Guides for OpenOffice.org 3.x]]
 
 
 
If you want to work on the User Guides for OpenOffice.org please contact the [http://www.oooauthors.org OOoAuthors group].
 
 
 
There is some help available about [[Documentation/DevGuide/Contributing_to_the_Developers_Guide|Contributing to the Developer's Guide]] which may also be useful for the Administration Guide and the BASIC Programming Guide.
 
 
 
=Localizing Content=
 
  
{{#lst:Help:Translating|translating}}
+
Для локализации материалов вики на с других языков, разработаны {{SecTitleRulesRus|RU/rules/translating}}.
  
  
 +
{{Doc-inline-end}}
 
----
 
----
  
 
{{PDL1}}
 
{{PDL1}}
  
[[Category:Help]]
+
{{RUrulesBottom}}
[[Category:How to]]
 
[[Category:Guidelines]]
 
[[Category:Localization]]
 
[[Category:Documentation/Dashboard]]
 

Latest revision as of 12:09, 10 October 2011


CardCatalog.png

Содержание

Documentation caution.png Перед началом редактирования страниц в зоне RU следует ознакомиться с Правилами ресурса:

Все действующие инструкции перечислены на странице Правила Энциклопедии.

Этот документ поможет более эффективно работать над Wiki-документацией.


Об этих правилах

Данный документ описывает общие методы работы с системой MediaWiki, используемой в качестве технологической платформы Энциклопедии.


Данный документ отвечает на вопрос "как сделать".

Вопросы "почему" и "зачем" освещены в Полном своде правил Энциклопедии: Правила Энциклопедии.


Страницы обсуждений

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

Чтобы добавить комментарий к странице, необходимо:

  1. Щёлкнуть по вкладке Обсуждение вверху страницы.
    • Чтобы начать новую тему в обсуждении, щёлкнуть по знаку [+] справа от вкладки Править вверху страницы, заполнить тему и записать свой комментарий в текстовом поле.
    • Чтобы добавить комментарий к существующей дискуссии, нужно создать отступ перед своим ответом (он должен быть больше, чем отступ у абзаца перед комментарием). Для этого требуется вставить одно или несколько двоеточий (:) в начале каждого абзаца комментария. Одно двоеточие эквивалентно одному табулятору.
  2. Подписать сообщение. Для этого нужно вставить четыре тильды подряд (~~~~). Они преобразуются в подпись и текущую дату. Это можно сделать автоматически с помощью кнопки ( button_sig.png ) на панели инструментов.
  3. По окончании, в поле «Описание изменений» ввести краткое описание сделанных изменений и щёлкнуть по кнопке Записать страницу.

Более подробная информация о создании обсуждений приведена в статье Help:Talk pages/ru.

Создание новых страниц

Documentation caution.png Перед созданием страницы необходимо убедиться, что по данной теме уже не создана страница.
  • Если новая страница является подстраницей у существующей страницы, достаточно перейти к этой существующей странице и создать в ней ссылку на новую страницу. После сохранения можно щёлкнуть по созданной ссылке и приступить к заполнению новой страницы.
  • Для создания совершенно новой самостоятельной страницы можно использовать wiki-URL. Для этого в браузере в строке URL нужно ввести строку вида:
 http://wiki.services.openoffice.org/wiki/национальная_языковая_страница/имя_новой_страницы
При создании страницы таким образом, необходимо учитывать существующее дерево wiki-страниц. То есть если страница относится к какому-либо разделу, то в своём имени она должна содержать имя этого раздела. Например, если создаётся страница в проекте "qa" (контроль качества) в русскоязычной языковой зоне, в браузере в строке URL нужно ввести:
 http://wiki.services.openoffice.org/wiki/RU/qa/имя_новой_страницы 
  • Рекомендуемый метод заключается в предварительном поиске нужной информации (поле Поиск на странице слева), и если требуемая страница не найдена (не существует), будет предложено создать данную страницу щелчком по ссылке «Создать страницу» на странице результатов поиска.
Documentation note.png Создание страниц напрямую через URL допустимо только если затем будут добавлены ссылки на эту страницу с других страниц. В противном случае эта страница окажется «потерянной» в wiki.
Tip.png Подробные правила изложены в разделе Правила Энциклопедии и обязательны к исполнению.

Дополнительная информация по созданию новых статей приведена в Документации Mediawiki по созданию новых статей.

Использование категорий

Documentation note.png Из-за проблемы "процентного кодирования" нелатинских символов в URL, механизм категорий в Энциклопедии не используется для пользовательской навигации и поиска информации.

Категориям в Энциклопедии отводится вспомогательная техническая роль.

Категории, в которые включена страница, как правило, перечислены в нижнем колонтитуле страницы. Щелчок по категории ведёт к просмотру страницы заголовков страниц, которые отнесены к данной категории. Таким образом, категории являются тегом (меткой) для страниц, с помощью которого возможно просмотреть тематически связанные страницы.

Для добавления страницы в категорию необходимо добавить ссылку [[Category:''Имя_Категории'']] в конце страницы.

Documentation note.png В Энциклопедии крайне не рекомендуется ручное категоризирование страниц. На каждой странице помещается шаблон подвала, в котором уже указана необходимая категория. Подробнее: (Разраб.) Инструкция. Шаблоны, общие для всех национальных языковых страниц.

Категория уже должна существовать. В противном случае будет создана новая категория, оторванная от общей структуры категорий wiki.

Documentation caution.png Не нужно создавать дубликаты категорий по одной теме. Имена категорий должны быть уникальными. В противном случае станет весьма затруднительно использовать систему категорий для поиска информации в wiki.

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

Шаблоны

Рекомендуется обратиться к документации на MediaWiki

Добавление нового шаблона документов

Если в шаблоне предусмотрен вывод какого-либо текста (кроме названий продуктов и торговых марок), то в имени шаблона также должна присутствовать базовая страница языка, как об этом говорилось выше.

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


  • Для того чтобы все шаблоны собрать в одну категорию, необходимо добавить к шаблону собственную категорию, которая, при этом, не будет влиять на категоризацию страницы, на которой будет применён шаблон. Данная категория помещается между тегами <noinclude>. Подробнее об этом изложено в документации: MediaWiki help: Template (en).
  • Созданный шаблон нужно добавить в одну из нижеприведённых инструкций, описывающих соответствующую серию шаблонов.

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

Список существующих шаблонов документации

Это список шаблонов документации и примеров их использования
Имя шаблона Где использовать Пример использования
Template:Documentation/hbar Используется для рисования горизонтальных баров, для простых гистограмм

{{Documentation/hbar|width=100|bg=#3333FF}}
{{Documentation/hbar|width=57|bg=#33FF33}}
{{Documentation/hbar|width=112|bg=#FF3333}}

Template:Bug Ссылки на вопрос (баг) в Issuezilla.

{{Bug|123456}}

Issue 123456  
Template:HeaderBlock Оформительский шаблон.

Предназначен для оформления самых важных ссылок в виде подобия кнопки. {{HeaderBlock|[[RU]]}}

Template:*TOC Несколько видов оглавлений, основанных на Template:MasterTOC, используемых в руководствах. См. например, Basic Guide TOC
Template:MasterTOC Это базовый шаблон для создания оглавлений. Для использования нужно кликнуть на имени шаблона.


Изображения и графика

Вот основные правила для картинок.

  • Заголовок картинки должен быть уникальным и информативным. Имя файла так же должно иметь смысл, например scr_writer_conf_slovar.png отлично подойдёт для скриншота(scr) окна настройки(conf) словаря(slovar) в OOo Writer(writer).
  • Загружать картинки лучше в их оригинальном разрешении, если это возможно. Wiki автоматически создаёт уменьшенные картинки, которые в последствии можно вставлять в статьи.
  • Рекомендуется отредактировать картинку так, чтобы сделать основную её часть более заметной. Например: подчеркнуть красной линией нужную команду в меню.
  • Всегда необходимо помнить о том, что статью с этим изображением могут перевести на другой язык. Поэтому желательно избегать подписей и сносок на самой картинке, это упростит процедуру перевода.
  • Форматы: JPG для фотографий, SVG для значков, логотипов и т. п., PNG — для снимков экрана. Запрещается использовать BMP. (Paint давно поддерживает другие форматы)


Перед вставкой в статью картинку необходимо загрузить на сервер. Для этого на боковой панели существует ссылка «Загрузить файл» в разделе инструменты. На странице описания картинки необходимо кратко сформулировать, что содержится на ней, а также акцентировать внимание на авторских правах на изображение, если это необходимо.


Загруженные картинки размещаются на странице с помощью следующего тега:

[[Image:<имя>|<предпр.>|<положение>|<размер в px>|<надпись>]]
  • Имя: имя файла загруженной картинки.
  • Предпр.: thumb — создать уменьшенную копию и поместить в обрамление; none — вставить как есть.
  • Положение: положение картинки на странице, left — слева с обтеканием; right — справа с обтеканием; none — картинка расположится слева, без обтекания.
  • Размер: максимальная ширина картинки в px. Если изображение больше этого значения, то оно будет смасштабировано, если меньше, то останется как есть.


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

Например:[[Image:'''LoadSaveOptions.png'''|thumb|left|250px|Окно настройки OOo]]
Окно настройки OOo


* Как управлять нумерацией изображений и таблиц? 

Расстановка ссылок

Хотя окно редактирования предлагает помощь в создании внутренних и внешних ссылок, рекомендуется просмотреть MediaWiki страницу помощи по ссылкам для лучшего понимания того, как ссылки работают в Wiki.

Возможно, также будет полезной страница помощи MediaWiki примеры ссылок (en).

При создании текста ссылки необходимо следовать руководству по стилю using links (en).

Основные работы по редактированию

Редактирование возможно только после входа под своим именем. Редактировать можно сразу всю страницу, щёлкнув по вкладке править на самом верху. Но обычно удобнее редактировать отдельные разделы страницы, щёлкнув по ссылке [править] справа от заголовка раздела. При редактировании, просьба соблюдать принятые стили оформления (en) в целях обеспечения единства стилей всех статей. Перед сохранением изменений, рекомендуется использовать кнопку «Предварительный просмотр».


Исправление несоответствующей действительности, неточной или устаревшей информации

Информация, не являющаяся актуальной, обычно отмечается одним из следующих знаков:

{{OutDated|RU}} Эта метка означает, что статья устарела и информация из неё актуальна только для предыдущих версий офиса.

Documentation needshelp.png Эта статья нуждается в помощи:


Проверка орфографии

 

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

Edit-find-replace.png Эта статья должна быть проверена на точность и соответствие стилю.

Набор страниц, отмеченных таким знаком, может быть найден по ссылке Страницы, требующие доработки на главной странице Wiki\RU.

Выбрав страницу для редактирования, необходимо:

  1. проверить, что описанные инструкции всё ещё действуют для текущей версии OpenOffice.org;
  2. войти в систему и сделать необходимые исправления.

Удобно работать в двух вкладках браузера: одна вкладка — для чтения описанных инструкций, вторая — для редактирования.

Закончив редактирование, нужно удалить метку (или метки) о том, что статья требует редактирования, и поставить отметку «Проверена формальная точность» (как описано в Шаблонах предыдущего раздела). Затем щёлкнуть кнопку  Записать страницу .

Исправление незначительных ошибок и опечаток

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

Исправление картинок и снимков экрана

Для редактирования графики в Wiki необходимо щёлкнуть правой кнопкой мыши по картинке и выбрать пункт Сохранить изображение как…. После редактирования картинки на своем компьютере нужно вернуться на страницу Wiki, щёлкнуть по картинке и на странице описания изображения выбрать пункт Загрузить новую версию этого файла.

Чтобы загрузить новую версию снимка экрана, нужно щёлкнуть на соответствующий снимок экрана Wiki и выбрать пункт Загрузить новую версию этого файла на странице описания изображения.

Стилевые и языковые исправления

Статьи, требующие стилевых и языковых исправлений, можно узнать по следующим меткам:

Documentation needshelp.png Эта статья нуждается в помощи:


Проверка орфографии

 


Edit-find-replace.png Эта статья должна быть проверена на точность и соответствие стилю.

Набор статей, имеющих последнюю метку, можно получить, нажав на ссылку Страницы, требующие доработки на главной странице Wiki/RU.

Чтобы улучшить такую статью, необходимо войти в систему, щёлкнуть по ссылке редактирования и внести соответствующие изменения. Затем удалить метку (или метки) и щёлкнуть кнопку  Записать страницу .

Ссылки на локализованные страницы

  • Ссылки между страницами на разных языках можно делать, используя синтаксис ссылок Interwiki [[ISO_Lang_code:Page_Title]].
    Например,
[[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]]
добавляет ссылку на китайский перевод первой страницы Руководства разработчика. Эта ссылка показывается в левом столбце под заголовком «на других языках». При добавлении новых локализаций более практичным будет воспользоваться шаблонами Wiki.
  • В Руководстве разработчика используется шаблон для создания ссылок на страницы переводов.
    Синтаксис Wiki следующий:
{{Documentation/DevGuideLanguages|Page_Title}}
Page_Title — это имя текущей страницы Wiki.
Например,
{{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org/Developers Guide}}
добавит ссылки на локализованные страницы для первой страницы Руководства разработчика.
Чтобы увидеть ссылку на локализацию на свой язык страниц Wiki Руководства разработчика, нужно просто добавить свой язык в шаблон
Template:Documentation/DevGuideLanguages
Например, для немецкого языка необходимо добавить
[[nl:NL/{{{1}}}]]
Необходимо убедиться, что шаблон корректно работает для каждой из переведённых страниц.

Проверка содержимого

Локализация контента

Для локализации материалов вики на с других языков, разработаны Принципы перевода страниц.



Content on this page is licensed under the Public Documentation License (PDL).









К началу страницы