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

From Wiki
Jump to navigationJump to search
(Примеры кода переоформлены с помощью нового шаблона)
 
(236 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
{{RU/documentation/beingedited|[[User:Sancho|Санчо]] 16:55, 4 April 2010 (UTC)}}
+
<includeonly><section begin=rus />Введение в Wiki-редактирование<section end=rus /></includeonly>
−
{{RU/documentation/helpneeded|Перевод на русский язык.}}
+
<includeonly><section begin=lat />Introduction to the Wiki-editing<section end=lat /></includeonly>
−
{{Documentation/Banner}}
+
<section begin=title /><noinclude>{{DISPLAYTITLE:</noinclude>Введение в Wiki-редактирование{{Doc/doc/code/tbl/titleSeparator}}Introduction to the Wiki-editing<noinclude>}}</noinclude><section end=title />{{RUkbUpToc}}
−
{{RU/documentation/draftpage}}
+
{{BreadCrumbL10n}}
−
{{DISPLAYTITLE:Политика Wiki-редактирования}}
+
{{Doc-inline}}
−
[[fr:FR/Documentation/Dashboard/Wiki_Editing_Policy]]
+
{{Caution|Перед началом редактирования страниц в зоне RU следует ознакомиться с Правилами ресурса:
−
[[en:Documentation/Dashboard/Wiki_Editing_Policy]]
+
* {{SecTitleRulesRus|RU/rules/mission|mission}};
 +
* {{SecTitleRulesRus|RU/rules/information_strategy}}.
 +
Все действующие инструкции перечислены на странице {{SecTitleRulesRus|RU/rules}}.
 +
}}
  
−
Эта статья поможет вам эффективно создавать разделы wiki-документации.
+
Этот документ поможет более эффективно работать над Wiki-документацией.
  
−
Мы настоятельно рекомендуем Вам, объявлять о создании новых страниц или производстве значительных изменений в список рассылки [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org].
 
  
 +
== Об этих правилах ==
  
−
= Project-independent ruleset =
+
Данный документ описывает общие методы работы с системой MediaWiki, используемой в качестве технологической платформы Энциклопедии.
−
{{Documentation/Note|В начале смотрите главный набор правил [[OOo_Wiki_Contribution_Rules]]}}
 
  
−
=Перед началом редактирования=
 
  
−
Прежде чем вы сможете редактировать, вам нужно зарегистрироваться. Это не сложно.
+
Данный документ отвечает на вопрос ''"как сделать"''.
−
# Щёлкните по '''Log in / create account''' в правом верхнем углу экрана и введите необходимую информацию.<br> Мы рекомендуем использовать то же имя пользователя, что и на веб-сайте OpenOffice.org.
 
−
# Затем вам надо будет подтвердить ваш адрес электропочты.
 
  
−
Для входа в систему используйте точку входа вверху страницы, введите ваш логин и пароль, щёлкнув по кнопке '''Log in'''.
+
Вопросы ''"почему"'' и ''"зачем"'' освещены в Полном своде правил Энциклопедии: {{SecTitleRulesRus|RU/rules}}.
  
−
Next step could be to tell the Community about yourself. There is definitely no harm and it is a good way of getting comfortable with the Wiki.
 
−
#When you are logged in, your username shows at the top of the page, <span style="color:#9F0000"> in red,</span> until you create your user page. Click on your username to do that.
 
−
#On your page, add some sections as given below, as it is your profile on the OpenOffice Wiki;
 
−
#* About yourself
 
−
#* OpenOffice and you
 
−
#* Your contributions
 
−
#* Work in progress
 
−
#* Any future plans?
 
−
#* Reference (optional)
 
−
#* Contact
 
  
−
So, this is somewhat a template, for creating a profile.
+
=Страницы обсуждений=
−
You may or may not need to follow this template, you may have sections of your choice. This is done to make a profile in a uniform way for all the new users.
 
  
−
=Adding Comments=
+
Страницы обсуждений предназначены для комментирования и обсуждения статей. Каждая статья имеет свою собственную страницу обсуждений.
  
−
Important comments should be announced on the mailing list [mailto:dev@documentation.openoffice.org dev@documentation.openoffice.org] to be sure that they get noticed.
+
Чтобы добавить комментарий к странице, необходимо:
 +
# Щёлкнуть по вкладке '''Обсуждение''' вверху страницы.
 +
#* Чтобы начать новую тему в обсуждении, щёлкнуть по знаку '''[+]''' справа от вкладки '''Править''' вверху страницы, заполнить тему и записать свой комментарий в текстовом поле.
 +
#* Чтобы добавить комментарий к существующей дискуссии, нужно создать отступ перед своим ответом (он должен быть больше, чем отступ у абзаца перед комментарием). Для этого требуется вставить одно или несколько двоеточий (<code>''':'''</code>) в начале каждого абзаца комментария. Одно двоеточие эквивалентно одному табулятору.
 +
# Подписать сообщение. Для этого нужно вставить четыре тильды подряд (<code><nowiki>~~~~</nowiki></code>). Они преобразуются в подпись и текущую дату. Это можно сделать автоматически с помощью кнопки ( http://wiki.i-rs.ru/skins/common/images/button_sig.png ) на панели инструментов.
 +
# По окончании, в поле '''«Описание изменений»''' ввести краткое описание сделанных изменений и щёлкнуть по кнопке '''Записать страницу'''.
  
−
To add a comment to a page
+
Более подробная информация о создании обсуждений приведена в статье [http://www.mediawiki.org/wiki/Help:Talk_pages/ru Help:Talk pages/ru].
−
# Click the '''Discussion''' tab on the top of the page.
 
−
#* If you are starting a new topic click on the '''+''' sign to the right of the '''edit''' tab at the top, fill in the subject line and write your comment in the main text box.
 
−
#* If you want to add a comment to an existing discussion leave it after the existing comments and indent it by putting one or more colons (<code>:</code>) at the beginning of each paragraph.
 
−
# Sign your username with four tildes (<code><nowiki>~~~~</nowiki></code>). You can do this automatically with the '''signature with timestamp''' button ( http://wiki.services.openoffice.org/w/skins/common/images/button_sig.png ) on the toolbar.
 
−
# Click '''Save Page'''.
 
  
−
To learn more about comments see the [http://www.mediawiki.org/wiki/Help:Talk_pages Mediawiki help about talk pages]
+
=Создание новых страниц=
  
−
=Structure of the [[Documentation]] Section of the Wiki=
+
{{Caution | Перед созданием страницы необходимо убедиться, что по данной теме уже не создана страница.}}
  
−
The Documentation section is only part of the large OpenOffice.org Wiki. The doc.oo.o project
+
* Если новая страница является подстраницей у существующей страницы, достаточно перейти к этой существующей странице и создать в ней ссылку на новую страницу. После сохранения можно щёлкнуть по созданной ссылке и приступить к заполнению новой страницы.
−
tries to present the information in this section in a way that it is easily accessible and
+
* Для создания совершенно новой самостоятельной страницы можно использовать wiki-URL. Для этого в браузере в строке URL нужно ввести строку вида: <br>
−
has a structure that allows straightforward navigation for both users and contributors.
+
<tt><nowiki> http://wiki.services.openoffice.org/wiki/</nowiki><span style="color:#9F0000">национальная_языковая_страница</span>/<span style="color:#9F0000">'''''имя_новой_страницы'''''</span></tt>
 +
:При создании страницы таким образом, необходимо учитывать существующее дерево 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>
 +
* Рекомендуемый метод заключается в предварительном поиске нужной информации (поле '''Поиск''' на странице слева), и если требуемая страница не найдена (не существует), будет предложено создать данную страницу щелчком по ссылке «Создать страницу» на странице результатов поиска.
  
−
All documentation pages are subpages of the main Documentation page. A further substructure
+
{{Note | Создание страниц напрямую через URL допустимо только если затем будут добавлены ссылки на эту страницу с других страниц. В противном случае эта страница окажется «потерянной» в wiki.}}
−
presents sections as subpages containing further subpages. Think of it as a hierarchical
 
−
representation, just like a file system. Every subpage is automatically linked back to the main page.
 
  
−
The current wiki page tree looks like this:
+
{{Tip|Подробные правила изложены в разделе {{SecTitleRulesRus|RU/rules}} и обязательны к исполнению.}}
  
−
wiki.services.openoffice.org/wiki/Documentation
+
Дополнительная информация по созданию новых статей приведена в [http://www.mediawiki.org/wiki/Help:Starting_a_new_page/ru Документации Mediawiki по созданию новых статей].
−
    |
 
−
    +---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
 
−
|High-level tracking of documentation sub-projects and content deliverables
 
−
|-
 
−
|Documentation/Administration Guide
 
−
|Guide that describes how to administer an OpenOffice.org network installation
 
−
|-
 
−
|Documentation/FAQ
 
−
|Collection of FAQs.
 
−
|-
 
−
|Documentation/How Tos
 
−
|Link collection of How Tos
 
−
|-
 
−
|Documentation/OOoAuthors User Manual
 
−
|Collection of OpenOffice.org 2.x User Guides from OOoAuthors
 
−
|-
 
−
|Documentation/OOo3 User Guides
 
−
|Collection of OpenOffice.org 3 User Guides from OOoAuthors
 
−
|-
 
−
|Documentation/Tutorials
 
−
|Tutorial collections from different contributors
 
−
|-
 
−
|Documentation/Samples, Templates and Clipart
 
−
|Sub-project page in order to provide usable templates for business and personal use (draft)
 
−
|-
 
−
|Documentation/Setup Guide
 
−
|Sub-project page in order to provide a guide through the setup process of OpenOffice.org (in progress)
 
−
|-
 
−
|Documentation/BASIC Guide
 
−
|Guide that provides an introduction to programming with OpenOffice.org BASIC
 
−
|-
 
−
|Documentation/Building Guide
 
−
|Guide that describes how to build the {{OOo}} software yourself, from source.
 
−
|-
 
−
|Documentation/DevGuide
 
−
|Guide that describes how to program with OpenOffice.org using the component technology UNO (Universal Network Objects) with OpenOffice.org.
 
−
|-
 
−
|Documentation/Reference
 
−
|Collection of reference material. References on this page should show up under '''Reference Lists''' at the Documentation main page.
 
−
|}
 
  
−
=Creating new Pages=
+
{{Note|Из-за проблемы "процентного кодирования" нелатинских символов в URL, механизм категорий в Энциклопедии не используется для пользовательской навигации и поиска информации.
  
−
{{Documentation/Caution | Before creating a page make sure that there is not already an existing page with a similar topic.}}
+
Категориям в Энциклопедии отводится вспомогательная техническая роль.}}
  
−
* If the new page can be a subpage of an existing page simply go to the existing page and create a link to the new page. After saving the page with the link you can click the link and start writing on your new page.
+
Категории, в которые включена страница, как правило, перечислены в нижнем колонтитуле страницы. Щелчок по категории ведёт к просмотру страницы заголовков страниц, которые отнесены к данной категории. Таким образом, категории являются тегом (меткой) для страниц, с помощью которого возможно просмотреть тематически связанные страницы.
  
−
* If you want to create a really new page for the Documentation project, you can use the wiki's URL for creating a new page. You should observe the wiki page tree when you create a new page in this way. The URL to a wiki page is then something like this: <br>  <tt><nowiki> http://wiki.services.openoffice.org/wiki/documentation/</nowiki>''Page Name''</tt>  
+
Для добавления страницы в категорию необходимо добавить ссылку <tt><nowiki>[[Category:''Имя_Категории'']]</nowiki></tt> в конце страницы.
−
* However, the recommended method is to search for the desired page name (in the Search field above left), and when the page does not exist, you will be offered to "create this page" by clicking on a link on the Search Results Page.  
 
  
−
{{Documentation/Note | The URL approach is only useful if you link the page later to other pages. Otherwise it will be hidden in the wiki.}}
+
{{Note|В Энциклопедии крайне не рекомендуется ручное категоризирование страниц. На каждой странице помещается шаблон подвала, в котором уже указана необходимая категория. Подробнее: {{SecTitleRulesRus|RU/rules/templates}}.}}
  
−
For more information about new pages see the [http://www.mediawiki.org/wiki/Help:Starting_a_new_page Mediawiki help about new pages]
+
Категория уже должна существовать. В противном случае будет создана новая категория, оторванная от общей структуры категорий wiki.
  
−
=Using Categories=
+
{{Caution|Не нужно создавать дубликаты категорий по одной теме. Имена категорий должны быть уникальными. В противном случае станет весьма затруднительно использовать систему категорий для поиска информации в wiki.}}
  
−
The Categories that are assigned to a page are usually listed at the bottom of the page. Click on a Category, and you will view a topic page with all the pages that have been classified in that Category. This way, a Category tag in a page gives you the opportunity to look up related contents. The bigger the page the more Category tags might be inserted
+
Возможно использовать шаблоны для добавления общих категорий для больших групп страниц, и это является предпочтительным. Более того, при изменении шаблона (добавлении/удалении категории в шаблоне) соответствующим образом изменится страница, на которой он задействован&nbsp;— категория будет добавлена/удалена.
  
−
To add a Category tag to a page
+
=Шаблоны=
−
# Click '''Special pages''' in the toolbox on the left side.
 
−
# Click '''Categories''' in the Special pages link list.
 
−
# Choose a Category name that makes sense, and apply it by adding <tt>[[Category:''Category Name'']]</tt> at the end of the page.
 
  
−
{{Documentation/Caution | Do not create duplicate Categories for the same topic. Each Category must be unique. Otherwise it will be difficult to use the Categories for searching the wiki.}}
+
Рекомендуется обратиться к [http://www.mediawiki.org/wiki/Help:Templates/ru документации на MediaWiki]
  
−
Look at [http://www.mediawiki.org/wiki/Help:Categories MediaWiki Help:Categories] if you want to know more about Wiki Categories.
+
==Добавление нового шаблона документов==
 +
Если в шаблоне предусмотрен вывод какого-либо текста (кроме названий продуктов и торговых марок), то в имени шаблона также должна присутствовать ''базовая страница языка'', как об этом говорилось выше.
  
−
A simple example of how to use Categories in Wiki books:
+
Если шаблон не выводит текст, и, без каких-либо изменений, может задействоваться на разных национальных страницах, то код языка в его имени опускается.
−
# Create a Category named after the current chapter.
 
−
# Add the new Category tag to all pages of that chapter
 
−
# Add the Category tag for the book to the newly created Category page.
 
  
−
The reader can then view the book Category.  The book Category shows all the chapters in the book.  If the reader clicks on a chapter Category, they can see all of the pages in that chapter (in alphabetical order).
 
  
−
Do not add a category and its subcategory to the same wiki page. For more information see the MediaWiki Help:Category section on [http://meta.wikimedia.org/wiki/Help:Category#Category_considerations Category considerations].
+
* Для того чтобы все шаблоны собрать в одну категорию, необходимо добавить к шаблону собственную категорию, которая, при этом, не будет влиять на категоризацию страницы, на которой будет применён шаблон. Данная категория помещается между тегами <code><nowiki><noinclude></nowiki></code>. Подробнее об этом изложено в документации: [http://meta.wikimedia.org/wiki/Help:Template#Noinclude.2C_includeonly.2C_and_onlyinclude MediaWiki help: Template (en)].
  
−
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].
+
* Созданный шаблон нужно добавить в одну из нижеприведённых инструкций, описывающих соответствующую серию шаблонов.  
  
−
=Templates=
+
В именах шаблонов (URL) не действует запрет на использование заглавных букв, как на прочих страницах Энциклопедии, поскольку эти URL используются только внутри кода статей.
−
 
 
−
Look at the [http://www.mediawiki.org/wiki/Help:Templates Templates help] if you are unfamiliar with mediawiki templates.
 
−
 
 
−
==Adding a new Documentation Template==
 
−
<section begin=addingtemplate />
 
−
* If you create a new template to be used in the wiki documentation, name it as a subpage of '''Documentation'''.
 
−
** wrong: <tt>mytemplate</tt>
 
−
** right: <tt>Documentation/mytemplate</tt>
 
−
 
 
−
* Add a description of the template purpose and usage to the template itself using the <code><noinclude></code> element as described in [http://meta.wikimedia.org/wiki/Help:Template#Noinclude.2C_includeonly.2C_and_onlyinclude MediaWiki help: Template].
 
−
 
 
−
* Add the template to the list of templates below.
 
−
<section end=addingtemplate />
 
 
{{Spacer|30}}
 
{{Spacer|30}}
  
−
== List of Existing Documentation Templates  ==
+
== Список существующих шаблонов документации ==
  
−
<section begin="doctemplates" /> This is a list of Documentation templates and their usage
+
<section begin="doctemplates" /> Это список шаблонов документации и примеров их использования
  
 
{| cellspacing="4" cellpadding="3" border="1" style="border-collapse: collapse;"
 
{| cellspacing="4" cellpadding="3" border="1" style="border-collapse: collapse;"
−
|- valign="top"
+
|-  
−
! Имя шаблона
+
!style="width:5%" | Имя шаблона
−
! Где использовать
+
!style="width:25%" | Где использовать
−
! Пример использования
+
!style="width:70%" | Пример использования
−
|- valign="top"
 
−
| [[Template:Documentation/Banner]]
 
−
| Puts the Documentation Project "Banner" at the top right of the page
 
−
{{RU/code|50|<nowiki>{{Documentation/Banner}}</nowiki>}}
 
−
| [[Image:Docbanner.png]]
 
−
|- valign="top"
 
−
| [[Template:Documentation/OOo]]
 
−
| Displays an OpenOffice.org logo
 
−
{{RU/code|50|<nowiki>{{Documentation/OOo}}</nowiki>}}
 
−
 
 
−
| {{Documentation/OOo}}
 
−
|- valign="top"
 
−
| [[Template:Documentation/PDF]]
 
−
|
 
−
{{RU/code|50|<nowiki>{{Documentation/PDF}}</nowiki>}}
 
−
| {{Documentation/PDF}}
 
−
|- valign="top"
 
−
| [[Template:Documentation/PRODUCTNAME]]
 
−
| Переменная для вывода названия продукта '''OpenOffice.org'''.
 
−
{{RU/code|50|<nowiki>{{Documentation/PRODUCTNAME}}</nowiki>}}
 
  
−
| {{Documentation/PRODUCTNAME}}
+
|-  
−
|- valign="top"
 
 
| [[Template:Documentation/hbar]]  
 
| [[Template:Documentation/hbar]]  
−
| Used to draw horizontal bars for simplistic bar charts
+
| Используется для рисования горизонтальных баров, для простых гистограмм
−
{{RU/code|50|<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}}  
  
−
|- valign="top"
+
|-  
−
| [[Template:RU/documentation/beingedited]]
 
−
| Устанавливайте данный знак на странице, которую в настоящее время редактируете, чтобы избежать конфликта изменений.
 
−
Используйте этот шаблон при выполнении больших изменений в статье, создание которых растягиваются более чем на один сеанс редактирования. Не забудьте добавить имя и дату "замок", добавив <tt><code><nowiki>~~~~</nowiki></code></tt> в качестве параметра шаблона:
 
−
{{RU/code|50|<nowiki>{{RU/documentation/beingedited|~~~~}}</nowiki>}}
 
−
 
 
−
| {{RU/documentation/beingedited|[[User:Fpe|Fpe]] 17:54, 7 February 2008 (CET)}}
 
−
|- valign="top"
 
−
| [[Template:RU/documentation/needsrework]]
 
−
|
 
−
{{RU/code|50|<nowiki>{{RU/documentation/needsrework}}</nowiki>}}
 
−
| {{RU/documentation/needsrework}}
 
−
|- valign="top"
 
−
| [[Template:RU/documentation/helpneeded]]
 
−
|
 
−
{{RU/code|50|<nowiki>{{RU/documentation/helpneeded|Проверка орфографии}}</nowiki>}}
 
−
| {{RU/documentation/helpneeded|Проверка орфографии}}
 
−
|- valign="top"
 
−
| [[Template:RU/documentation/checkedaccuracy]]
 
−
| Отметка для статей, которые были проверены на точность.
 
−
Не забудьте добавить своё имя и дату проведения проверки <tt><code><nowiki>~~~~</nowiki></code></tt> в качестве параметра:
 
−
{{RU/code|50|<nowiki>{{Documentation/CheckedAccuracy|~~~~}}</nowiki>}}
 
−
 
 
−
| {{RU/documentation/checkedaccuracy|Иванов 08:16, 22 января 2009}}
 
−
|- valign="top"
 
−
| [[Template:RU/documentation/outdated]]
 
−
| Указывает, что статья устарела.
 
−
{{RU/code|50|<nowiki>{{RU/documentation/outdated}}</nowiki>}}
 
−
 
 
−
| {{RU/documentation/outdated}}
 
−
|- valign="top"
 
−
| [[Template:RU/documentation/draftpage]]
 
−
| Метка для страниц, которые находятся в процессе создания (стадия Черновика).
 
−
{{RU/code|50|<nowiki>{{RU/documentation/draftpage}}</nowiki>}}
 
−
 
 
−
| {{RU/documentation/draftpage}}
 
−
 
 
−
|- valign="top"
 
−
| [[Template:RU/documentation/imported]]
 
−
|
 
−
{{RU/code|50|<nowiki>{{RU/documentation/imported|Имя автора|Имя переводчика}}</nowiki>}}
 
−
| {{RU/documentation/imported|Имя автора|Имя переводчика}}
 
−
|- valign="top"
 
−
| [[Template:Documentation/Windows]]
 
−
| Отображение логотипа Windows для ввода Windows-зависимого конкрета.
 
−
{{RU/code|50|<nowiki>{{Documentation/Windows|Windows-зависимый контент}}</nowiki>}}
 
−
 
 
−
| {{Documentation/Windows| Windows-зависимый контент}}
 
−
|- valign="top"
 
−
| [[Template:Documentation/Linux]]
 
−
| Отображение логотипа Linux для ввода Linux-зависимого конкрета.
 
−
{{RU/code|50|<nowiki>{{Documentation/Linux|Linux-зависимый контент}}</nowiki>}}
 
−
 
 
−
| {{Documentation/Linux| Linux-зависимый контент}}
 
−
|- valign="top"
 
−
| [[Template:Documentation/OSX]]
 
−
| Отображение логотипа Apple/OSX для ввода OSX-зависимого конкрета.
 
−
{{RU/code|50|<nowiki>{{Documentation/OSX | Mac related content}}</nowiki>}}
 
−
 
 
−
| {{Documentation/OSX | Mac-зависимый контент}}
 
−
|- valign="top"
 
 
| [[Template:Bug]]  
 
| [[Template:Bug]]  
 
| Ссылки на вопрос (баг) в Issuezilla.
 
| Ссылки на вопрос (баг) в Issuezilla.
−
{{RU/code|50|<nowiki>{{Bug|123456}}</nowiki>}}
+
{{Tlp|Bug|123456}}
−
 
 
 
| {{Bug|123456}}
 
| {{Bug|123456}}
−
|- valign="top"
 
−
| [[Template:Documentation/Note]]
 
−
| Применяется для примечаний, для концентрации внимания. Например, объяснений и комментариев.
 
−
{{RU/code|50|<nowiki>{{Documentation/Note|Это примечание}}</nowiki>}}
 
  
−
| {{Documentation/Note|Это примечание}}
+
|-  
−
|- valign="top"
+
| [[Template:HeaderBlock]]
−
| [[Template:Documentation/Tip]]  
+
| Оформительский шаблон.
−
| Применяется для выделения не критичной информации - например, для привлечения внимания к клавиатурным комбинациям.
+
Предназначен для оформления самых важных ссылок в виде подобия кнопки.
−
{{RU/code|50|<nowiki>{{Documentation/Tip|Правый щелчок мышью для вызова контекстного меню}}</nowiki>}}  
+
{{Tlp|HeaderBlock|<nowiki>[[RU]]</nowiki>}}
 +
| {{HeaderBlock|[[RU]]}}  
  
−
| {{Documentation/Tip|Правый щелчок мышью для вызова контекстного меню}}
+
|-
−
|- valign="top"
+
| Template:*TOC
−
| [[Template:Documentation/Caution]]  
+
| Несколько видов оглавлений, основанных на [[Template:MasterTOC]], используемых в руководствах.
−
| Примется для предупреждений, для потенциально опасной информации, например, влекущую потерю данных.
+
| См. например, [[Template:Documentation/BASICGuideTOC|Basic Guide TOC]]
−
{{RU/code|50|<nowiki>{{Documentation/Caution|Стирание файла может его уничтожить.}}</nowiki>}}
 
  
−
| {{Documentation/Caution|Стирание файла может его уничтожить.}}
+
|-  
−
|- valign="top"
+
| [[Template:MasterTOC]]  
−
| [[Template:RU/documentation/seealso]] and [[Template:RU/documentation/devguide/seealso]]  
+
| Это базовый шаблон для создания оглавлений. Для использования нужно кликнуть на имени шаблона.
 
|
 
|
−
{{RU/code|50|<nowiki>{{RU/documentation/seealso|
 
−
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 
−
}}</nowiki>}}
 
−
*'''DevGuide''' / '''Смотри также''' используются в Руководстве для разработчиков и должны быть исключены из создаваемых PDF и ODT книг.
 
  
−
| {{RU/documentation/seealso|
 
−
* [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with OpenOffice.org 3.x]]
 
−
}}
 
−
|- valign="top"
 
−
| [[Template:RU/fromforum]]
 
−
|
 
−
{{RU/code|50|<nowiki>{{RU/fromforum}}</nowiki>}}
 
−
| {{RU/fromforum}}
 
−
|- valign="top"
 
−
| [[Template:Documentation/Abstract]]
 
−
| Takes a short abstract of the chapter content of guides. Add to the top of guides.
 
−
{{RU/code|50|<nowiki>{{Documentation/Abstract|Abstract Text}}</nowiki>}}
 
−
 
−
| See, for example, [[Documentation/Administration Guide/Customizing|this Administration Guide Chapter]]
 
−
|- valign="top"
 
−
| Template:Documentation/*TOC
 
−
| Several tables of content based on [[Template:Documentation/MasterTOC]] used in guides.
 
−
| See, for example, the [[Template:Documentation/BASICGuideTOC/v2|Basic Guide TOC]]
 
−
|- valign="top"
 
−
| [[Template:Documentation/MasterTOC]]
 
−
| This is the master template that is used to create tables of content. For usage click the template name.
 
−
|- valign="top"
 
−
| [[Template:Documentation/OOoVersion]]
 
−
| Этот шаблон используется для вставки на странице окна с номером версии OpenOffice.org.
 
−
{{RU/code|50|<nowiki>{{RU/documentation/oooversion|3.3.x}}</nowiki>}}
 
−
| {{RU/documentation/oooversion|3.3.x}}
 
−
|- valign="top"
 
−
| [[Template:RU/documentation/sign]]
 
−
| Этот шаблон используется для вставки в статью подписи с именем автора.<br>Первый параметр - логин автора.<br>Второй параметр - имя, которое будет отображено в подписи.
 
−
{{RU/code|50|<nowiki>{{RU/documentation/sign|Sancho|А. Е. Харламенков}}</nowiki>}}
 
−
| {{RU/documentation/sign|Sancho|А. Е. Харламенков}}
 
−
|- valign="top"
 
−
| [[Template:RU/documentation/signyear]]
 
−
| Этот шаблон используется для вставки в статью подписи с именем автора и датой создания статьи.<br>Первый параметр - логин автора.<br>Второй параметр - имя, которое будет отображено в подписи.<br>Третий параметр - дата, выводимая в подписи.
 
−
{{RU/code|50|<nowiki>{{RU/documentation/signyear|Sancho|А. Е. Харламенков|2009}}</nowiki>}}
 
−
| {{RU/documentation/signyear|Sancho|А. Е. Харламенков|2009}}
 
 
|}
 
|}
  
 
<section end="doctemplates" />
 
<section end="doctemplates" />
  
−
=Graphical Content=
+
=Изображения и графика=
  
−
General guidelines for images are:
+
Вот основные правила для картинок.
−
* Use a descriptive and unique title. The filename should be constructed in a way so it shows the usage, e.g. Doc_mig_icon_data.png = '''Doc'''umentation image, used in the '''mig'''ration guide, depicting the '''data'''base '''icon'''.
 
−
* If possible, do not pre-scale the images you are uploading.  You can use the MediaWiki image thumbnail feature to scale the image.
 
−
* Edit the image if necessary to make sure that the important part is clear and visible.
 
−
* Keep in mind that people may be translating the page where you are placing an image.  Try not to include callouts or other extra text on the image.
 
−
* JPG is usually best for photos, SVG, for icons, logos etc, and PNG for screen captures.  Try not to use BMP.
 
  
 +
* Заголовок картинки должен быть уникальным и информативным. Имя файла так же должно иметь смысл, например '''scr_writer_conf_slovar.png''' отлично подойдёт для скриншота('''scr''') окна настройки('''conf''') словаря('''slovar''') в OOo Writer('''writer''').
 +
* Загружать картинки лучше в их оригинальном разрешении, если это возможно. Wiki автоматически создаёт уменьшенные картинки, которые в последствии можно вставлять в статьи.
 +
* Рекомендуется отредактировать картинку так, чтобы сделать основную её часть более заметной. Например: подчеркнуть красной линией нужную команду в меню.
 +
* Всегда необходимо помнить о том, что статью с этим изображением могут перевести на другой язык. Поэтому желательно избегать подписей и сносок на самой картинке, это упростит процедуру перевода.
 +
* Форматы: JPG для фотографий, SVG для значков, логотипов и т.&nbsp;п., PNG&nbsp;— для снимков экрана. Запрещается использовать BMP. (Paint давно поддерживает другие форматы)
  
−
Before you can insert your well prepared image in a wiki page you have to upload it.
 
−
# In the sidebar, under '''toolbox''', click '''Upload file'''. The image description page will appear.
 
−
# Use the image description page to describe an image and copyright status (if any).
 
  
 +
Перед вставкой в статью картинку необходимо загрузить на сервер. Для этого на боковой панели существует ссылка '''«Загрузить файл»''' в разделе '''инструменты'''. На странице описания картинки необходимо кратко сформулировать, что содержится на ней, а также акцентировать внимание на авторских правах на изображение, если это необходимо.
  
−
To place the image on a page you can use the MediaWiki Image thumbnail feature which "wraps" your illustrations in an image box.  This image box includes a spot for an image caption.  The syntax is <tt>[[Image:''image.png|thumb|position|size|Image caption'']]</tt>, where:
 
−
* thumb = thumbnail the image and wrap in an image box
 
−
* position = position on page. "none" places the image on the left of the frame with no text wrapping. "left" and "right" places the image on the left or right of the page with full text wrapping.
 
−
* size = max width in pixels for the image.  If the image is larger than this value it is scaled down.  If the image is smaller it is left as is.
 
−
If you do not declare a position and size, the image is scaled to a small thumbnail, and defaults to the right hand side of the page with full text wrapping.
 
  
−
Here is an example using <tt><nowiki>[[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]</nowiki></tt>
+
Загруженные картинки размещаются на странице с помощью следующего тега:
 +
<nowiki>[[Image:<имя>|<предпр.>|<положение>|<размер в px>|<надпись>]]</nowiki>
  
−
[[Image:LoadSaveOptions.png|thumb|none|500px|An example image caption]]
+
* Имя: имя файла загруженной картинки.
 +
* Предпр.: thumb&nbsp;— создать уменьшенную копию и поместить в обрамление; none&nbsp;— вставить как есть.
 +
* Положение: положение картинки на странице, left&nbsp;— слева с обтеканием; right&nbsp;— справа с обтеканием; none&nbsp;— картинка расположится слева, без обтекания.
 +
* Размер: максимальная ширина картинки в px. Если изображение больше этого значения, то оно будет смасштабировано, если меньше, то останется как есть.
  
−
* How to handle image and table numbering?
 
  
−
=Linking=
+
Если не указаны положение и размер, то изображение будет расположено справа в виде маленькой картинки.
  
−
Although the editing window offers assistence in writing internal and external links look at the [http://www.mediawiki.org/wiki/Help:Links MediaWiki help page about links] for a better understanding of how links are working in wikis.
+
<nowiki>Например:[[Image:'''LoadSaveOptions.png'''|thumb|left|250px|Окно настройки OOo]]</nowiki>
  
−
There is another MediaWiki help page if you need some [http://meta.wikimedia.org/wiki/Help:Wikitext_examples#Links  examples].
+
[[Image:LoadSaveOptions.png|thumb|left|250px|Окно настройки OOo]]
  
−
When creating link text consider the guidelines for [[Documentation/Dashboard/Help_Style_Guide#Using_Links | using links]] in our style guide.
 
  
−
=Основные работы по редактированию=
+
* Как управлять нумерацией изображений и таблиц?
−
 
−
Редактирование возможно только после входа под своим именем. Вы можете редактировать сразу всю страницу, нажав на вкладке '''править''' на самом верху. Но обычно удобнее редактировать отдельные разделы страницы, нажав на ссылку '''[править]''' справа от заголовка раздела. При редактировании, просьба соблюдать принятые [[Documentation/Dashboard/Help_Style_Guide|стили оформления [EN]]] в целях обеспечения единства стилей всех статей. Перед сохранением изменений, нажмите кнопку '''"Предварительный просмотр"'''.
 
  
 +
=Расстановка ссылок=
  
−
== Fixing inappropriate, inaccurate, or outdated content  ==
+
Хотя окно редактирования предлагает помощь в создании внутренних и внешних ссылок, рекомендуется просмотреть [http://www.mediawiki.org/wiki/Help:Links/ru MediaWiki страницу помощи по ссылкам] для лучшего понимания того, как ссылки работают в Wiki.
  
−
Contents that are not up to date are usually marked by one of the following labels:  
+
Возможно, также будет полезной страница помощи MediaWiki [http://meta.wikimedia.org/wiki/Help:Wikitext_examples#Links примеры ссылок (en)].
  
−
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
+
При создании текста ссылки необходимо следовать руководству по стилю [[Documentation/Dashboard/Help_Style_Guide#Using_Links | using links (en)]].
−
|- valign=top
 
−
| {{Documentation/Outdated}}
 
−
| This label means that an article is outdated as a whole and needs to be revised completely.
 
−
|- valign=top
 
−
| {{Documentation/HelpNeeded|works for OOo 2, needs to be confirmed for OOo 3}}
 
−
| If an article is partly outdated or inaccurate you may find this label asking for specific help.
 
−
|- valign=top
 
−
| {{Documentation/NeedsRework}}
 
−
| You can find a collection of pages with this label if you click on [[:Category:Documentation/NeedsRework|Pages that Need Help! ]] on the Wiki main page.
 
−
|}
 
  
−
When you have selected a page to work on
+
=Основные работы по редактированию=
 +
 +
Редактирование возможно только после входа под своим именем. Редактировать можно сразу всю страницу, щёлкнув по вкладке '''править''' на самом верху. Но обычно удобнее редактировать отдельные разделы страницы, щёлкнув по ссылке '''[править]''' справа от заголовка раздела. При редактировании, просьба соблюдать принятые [[Documentation/Dashboard/Help_Style_Guide|стили оформления (en)]] в целях обеспечения единства стилей всех статей. Перед сохранением изменений, рекомендуется использовать кнопку '''«Предварительный просмотр»'''.
  
−
#test whether the described procedures are still valid for the current version of OpenOffice.org.
 
−
#log in and make the necessary corrections.
 
  
−
This works best when you open two tabs in the browser, one for reading the procedures and another for editing.
+
==  Исправление несоответствующей действительности, неточной или устаревшей информации  ==
  
−
When you have finished, remove the above label(s), 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'''.
+
Информация, не являющаяся актуальной, обычно отмечается одним из следующих знаков:
  
−
==Fixing minor errors and typos==
+
{|border=1 style="border-collapse:collapse;" cellpadding=3 cellspacing=4
 +
|-
 +
| {{Tlp|OutDated|RU}}
 +
| Эта метка означает, что статья устарела и информация из неё актуальна только для предыдущих версий офиса.
 +
| {{HelpNeeded|RU|Проверка орфографии|1}}
 +
| Если статья частично устарела или содержит неточную информацию, эта метка будет знаком просьбы о помощи в редактировании.
 +
|-
 +
| {{NeedsRework|RU|1}}
 +
| Набор страниц, отмеченных таким знаком, может быть найден по ссылке [[:Category:Требуют доработки|Страницы, требующие доработки]] на главной странице [[RU|Wiki\RU]].
 +
|}
  
−
If you detect minor errors like typos, just log in and edit the article. Before clicking on the '''Save page''' button you might check the '''This is a minor edit''' box above.
+
Выбрав страницу для редактирования, необходимо:
  
−
==Fixing graphics and screenshots==
+
#проверить, что описанные инструкции всё ещё действуют для текущей версии {{OOo}};
 +
#войти в систему и сделать необходимые исправления.
  
−
To edit a graphic in the wiki, right-click the graphic and choose '''Save image as'''. When you have edited the graphic on your computer, go back to the wiki page, click the graphic, and in the image description page choose '''Upload a new version of this file'''.
+
Удобно работать в двух вкладках браузера: одна вкладка&nbsp;— для чтения описанных инструкций, вторая&nbsp;— для редактирования.
  
−
If you have created a new version of a screenshot, directly click the corresponding screenshot in the wiki and then '''Upload a new version of this file''' in the image description page.
+
Закончив редактирование, нужно удалить метку (или метки) о том, что статья требует редактирования, и поставить отметку «Проверена формальная точность» (как описано в [[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|Записать страницу}}.
  
−
==Fixing Style and Language==
+
==Исправление незначительных ошибок и опечаток==
  
−
Articles that need improvement in style and language might be recognized by the following labels:
+
При обнаружении незначительных ошибок типа опечаток, достаточно просто войти в систему и отредактировать статью. Перед тем как щёлкнуть кнопку {{Button|Записать страницу}}, желательно поставить галочку в пункте '''Малое изменение'''.
−
{{Documentation/HelpNeeded|Check the spelling}}
 
−
{{Documentation/NeedsRework}}
 
−
You can find a collection of articles with the latter label if you click on [[:Category:Documentation/NeedsRework | Pages that Need Help! ]] on the Wiki main page.
 
  
−
To improve such an article, just log in, click on the edit tab and make the necessary corrections. Then remove the label(s) and click on '''Save page'''.
+
==Исправление картинок и снимков экрана==
−
 
 
−
==Linking to localized pages==
 
−
 
 
−
* Link the various languages to each other using the Interwiki links syntax <tt><nowiki>[[ISO_Lang_code:Page_Title]]</nowiki></tt>. <br> For example, <tt><nowiki>[[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]]</nowiki></tt> adds a link to the Chinese translation of the first page of the Developer's Guide.  This link shows in the left column, under the heading "In other languages". This may be more practical to do with Wiki Templates as more languages are added.
 
−
* In the Developer's guide we use a template to link translated pages. <br> The Wiki Syntax is: <tt><nowiki>
 
−
{{Documentation/DevGuideLanguages|Page_Title}}</nowiki></tt> where Page_Title is the current Wiki page name. <br> For example, <tt><nowiki>{{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org
 
−
Developers Guide}}</nowiki></tt> will add the localized page links for the first page in the Developer's Guide. <br> If you want to see a link to your language at the Developer's Guide wiki pages simply add your language to the template [[Template:Documentation/DevGuideLanguages]]. For example, for Dutch you would have to add <tt><nowiki>[[nl:NL/{{{1}}}]]</nowiki></tt>. Make sure the template is referenced correctly in each of the translated pages.
 
−
 
 
−
==Validating Content==
 
−
 
 
−
==Fixing Spam / Deleting Pages==
 
−
 
 
−
If you detect spam you can send a mail to [mailto:dev@website.openoffice.org dev@website.openoffice.org].
 
−
 
 
−
There is also a [[Special:Listusers/sysop|list with Wiki Sysops]] (people who can delete pages). If you want to have pages deleted, you can either ask someone from that list, or better, add the Wiki Syntax <tt><nowiki>{{delete}}</nowiki></tt> anywhere on the page you want to be deleted. This will add the page to the "Candidates for speedy deletion" category, and the page will be deleted by someone with Sysop privileges, or by WikiBot maintenance.
 
−
 
 
−
=Working on FAQs=
 
−
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=
+
Для редактирования графики в Wiki необходимо щёлкнуть правой кнопкой мыши по картинке и выбрать пункт  '''Сохранить изображение как…'''. После редактирования картинки на своем компьютере нужно вернуться на страницу Wiki, щёлкнуть по картинке и на странице описания изображения выбрать пункт '''Загрузить новую версию этого файла'''.
−
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>. }}
+
Чтобы загрузить новую версию снимка экрана, нужно щёлкнуть на соответствующий снимок экрана Wiki и выбрать пункт '''Загрузить новую версию этого файла''' на странице описания изображения.
  
−
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>
 
  
 +
Статьи, требующие стилевых и языковых исправлений, можно узнать по следующим меткам:
 +
{{HelpNeeded|RU|Проверка орфографии|1}}
 +
{{NeedsRework|RU|1}}
 +
Набор статей, имеющих последнюю метку, можно получить, нажав на ссылку [[:Category:Требуют доработки| Страницы, требующие доработки]] на главной странице [[RU|Wiki/RU]].
  
−
If you want to revise existing How Tos, watch for the label "This article needs to be checked for accuracy and style."
+
Чтобы улучшить такую статью, необходимо войти в систему, щёлкнуть по ссылке редактирования и внести соответствующие изменения. Затем удалить метку (или метки) и щёлкнуть кнопку {{Button|Записать страницу}}.
−
* 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.
+
* Ссылки между страницами на разных языках можно делать, используя синтаксис ссылок Interwiki <tt><nowiki>[[ISO_Lang_code:Page_Title]]</nowiki></tt>. <br> Например,
 +
:<tt><nowiki>[[zh:Zh/Documentation/DevGuide/OpenOffice.org_Developers_Guide]]</nowiki></tt>
 +
:добавляет ссылку на китайский перевод первой страницы Руководства разработчика. Эта ссылка показывается в левом столбце под заголовком «на других языках». При добавлении новых локализаций более практичным будет воспользоваться шаблонами Wiki.
 +
* В Руководстве разработчика используется шаблон для создания ссылок на страницы переводов. <br> Синтаксис Wiki следующий:
 +
:<tt><nowiki>{{Documentation/DevGuideLanguages|Page_Title}}</nowiki></tt>
 +
:Page_Title&nbsp;— это имя текущей страницы Wiki. <br>
 +
:Например,
 +
:<tt><nowiki>{{Documentation/DevGuideLanguages|Documentation/DevGuide/OpenOffice.org/Developers Guide}}</nowiki></tt>
 +
:добавит ссылки на локализованные страницы для первой страницы Руководства разработчика.  <br>
 +
:Чтобы увидеть ссылку на локализацию на свой язык страниц Wiki Руководства разработчика, нужно просто добавить свой язык в шаблон
 +
:[[Template:Documentation/DevGuideLanguages]]
 +
:Например, для немецкого языка необходимо добавить
 +
:<tt><nowiki>[[nl:NL/{{{1}}}]]</nowiki></tt>
 +
:Необходимо убедиться, что шаблон корректно работает для каждой из переведённых страниц.
  
−
=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.
+
Для локализации материалов вики на с других языков, разработаны {{SecTitleRulesRus|RU/rules/translating}}.
  
−
=Localizing Content=
 
  
−
{{#lst:Help:Translating|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).







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

Retrieved from "https://wiki.harlamenkov.ru/index.php?title=RU/rules/wiki_editing_policy&oldid=18586"