Revision as of 07:32, 20 May 2010

Template:RU/documentation/beingedited Template:RU/documentation/helpneeded

fr:FR/Documentation/Dashboard/Wiki_Editing_Policy

Перед началом редактирования следует ознакомиться с Положением и информационной политикой ресурса.

Эта статья поможет вам эффективно создавать разделы wiki-документации.

Мы настоятельно рекомендуем Вам, объявлять о создании новых страниц или производстве значительных изменений в список рассылки dev@documentation.openoffice.org.

1 Набор правил. Независимый проект
2 Перед началом редактирования
3 Страницы обсуждений
4 Структура раздела Документация (en) в Wiki
5 Создание новых страниц
6 Использование категорий
7 Шаблоны
- 7.1 Adding a new Documentation Template
- 7.2 List of Existing Documentation Templates
8 Изображения и графика
9 Расстановка ссылок
10 Основные работы по редактированию
11 Working on FAQs
12 Working on How Tos
13 Working on Guides
14 Localizing Content

Набор правил. Независимый проект

В начале смотрите главный набор правил Wiki Contribution Guidelines (в процессе перевода).

Перед началом редактирования

Прежде чем вы сможете редактировать, вам нужно зарегистрироваться. Это не сложно.

Щёлкните по Log in / create account в правом верхнем углу экрана и введите необходимую информацию.
Мы рекомендуем использовать то же имя пользователя, что и на веб-сайте OpenOffice.org.
Затем вам надо будет подтвердить ваш адрес электропочты.

Для входа в систему используйте точку входа вверху страницы, введите ваш логин и пароль, щёлкнув по кнопке Log in.

На следующем шаге расскажите Сообществу о себе. Это безвредно и создаёт комфорт для работы в Wiki.

Когда вы вошли в систему, имя пользователя отображается вверху страницы красным цветом, до тех пор, пока вы не создадите свою страницу. Эта страница является вашим профилем. Щёлкните по своему имени, чтобы создать его.
На вашей странице, добавьте несколько разделов, как указано ниже, в ваш профиль OpenOffice Wiki;
- Несколько слов о себе;
- OpenOffice и вы;
- Ваш вклад;
- Направления развития;
- Какие планы на будущее?;
- Ссылки (по желанию);
- Контакты.

Это небольшой шаблон для создания профиля.

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

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

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

Все важные замечания должны быть объявлены в списке рассылки dev@documentation.openoffice.org, дабы гарантировать, что их заметят.

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

Щёлкните по вкладке Обсуждение вверху страницы.
- Если вы начинаете в обсуждении новую тему, щёлкните по знаку [+] справа от вкладки Править вверху страницы, заполните тему и запишите свой комментарий в текстовом поле.
- Если вы хотите добавить комментарий к существующей дискуссии, то создайте отступ перед своим ответом (он должен быть больше, чем отступ у абзаца перед комментарием), для чего вставьте одно или несколько двоеточий (:) в начале каждого абзаца вашего ответа. Одно двоеточие эквивалентно одному табулятору.
Подпишите ваше сообщение. Для этого вставьте четыре тильды подряд (~~~~). Они преобразуются в подпись и текущую дату. Это можно сделать автоматически с помощью кнопки ( ) на тулбаре.
По окончании в поле "Описание изменений" введите краткое описание сделанных вами изменений и щёлкните по кнопке Записать страницу.

Более подробная информация о создании обсуждений приведена в статье Mediawiki help about talk pages.

Структура раздела Документация (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

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	Руководство по разработке пользовательских приложений OpenOffice.org из исходных текстов.
Documentation/DevGuide	Руководство по программированию OpenOffice.org, использоую технологию UNO (Universal Network Objects).
Documentation/Reference	Сборник справочных материалов. Ссылки на эту страницу (Reference Lists)отображаются на главной странице проекта документации.

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

Перед созданием страницы убедитесь, что по данной теме уже не создана страница.

Если новая страница является подстраницей у существующей страницы, просто перейдите к существующей странице и создайте ссылку на новую страницу. После сохранения страницы, щёлкните по созданной ссылке и начните писать вашу новую страницу.
Если вам необходимо создать совершенно новую самостоятельную страницу, вы можете использовать wiki-URL для создания новой страницы.Для этого в браузере в строке URL введите что-то вроде этого:

 http://wiki.services.openoffice.org/wiki/национальная_языковая_страница/имя_новой_страницы

Когда вы создаёте страницу таким образом, вы должны соблюдать существующее дерево wiki-страниц. То есть, если страница относится к какому-либо разделу, то в своём имени она должна содержать имя этого раздела. Например, если создаётся страница в проекте "qa" (контроль качества) в русской языковой зоне, в браузере в строке URL введите:

 http://wiki.services.openoffice.org/wiki/RU/qa/имя_новой_страницы

Рекомендуемый метод заключается в предварительном поиске нужной информации (поле Поиск на странице слева), и если требуемая страница не найдена (не существует), будет предложено создать данную страницу щелчком по ссылке "Создать страницу" на странице результатов поиска.

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

В русской языковой зоне существует дополнительное Положение о национальной языковой странице RU и информационная политика, обязательное к исполнению.

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

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

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

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

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

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

Дополнительная информация по категориям находится в документации MediaWiki.

Простой пример того, как использовать категории в книгах Wiki:

Создайте категорию с именем текущего раздела.
Добавьте новую метку категории для всех страниц этой главы.
Добавить теги категория для книги на вновь созданной странице категории.

Читатель может просматривать книгу категории. Книга категории включает все части книги. Если читатель щёлкнет по части категории, он увидит все страницы части в алфавитном порядке.

Не добавляйте категорию и её подкатегории на одну wiki-страницу. Дополнительная информация по категориям и подкатегориям в документации MediaWiki.

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

Шаблоны

Обратитесь к документации на mediawiki

Adding a new Documentation Template

Если вы создаёте новый шаблон для использовании, допустим, в разделе wiki Документация, назовите его как дочернюю страницу Документация.
- некорректно: новый_шаблон
- корректно: Документация/новый_шаблон

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

Полностью имя шаблона выглядит так:

Template:RU/Документация/новый_шаблон

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

Созданный шаблон добавьте в список шаблонов, приведённый ниже.

List of Existing Documentation Templates

This is a list of Documentation templates and their usage

Имя шаблона Где использовать Пример использования

Template:Documentation/Banner

Puts the Documentation Project "Banner" at the top right of the page

@@ Line 55: / Line 55: @@
 Более подробная информация о создании обсуждений приведена в статье [http://www.mediawiki.org/wiki/Help:Talk_pages Mediawiki help about talk pages].
-=Структура раздела [[Documentation|Документация [en]]] в Wiki=
+=Структура раздела [[Documentation|Документация (en)]] в Wiki=
 Раздел '''"Документация"''' это только часть большой Wiki OpenOffice.org. Проект '''doc.oo.o''' пытается представить информацию в этом разделе так, чтобы она была легко доступна и хорошо структурирована для упрощения навигации как пользователей, так и участников

Template:RU/documentation/outdated	Эта метка означает, что статья полностью устарела и требует переработки.
Template:RU/documentation/helpneeded	Если статья частично устарела или содержит неточную информацию, вы обнаружите эту метку как знак просьбы о помощи в редактировании.
Template:RU/documentation/needsrework	Вы можете найти набор страниц, отмеченных таким знаком, если нажмете на ссылку Pages that Need Help! на главной странице Wiki.

FAQ section	section name in category
General	General
Installation	Installation
Word Processing	Writer
Automatic Functions	Writer/AutomaticFunctions
Document Management	Writer/DocumentManagement
Formatting Pages and Docs	Writer/FormattingPagesAndDocuments
Formatting Text	Writer/FormattingText
Graphics, Frames & Objects	Writer/GraphicsFramesObjects
Indexes, Tables of Contents	Writer/IndexToc
Printing and Mail Merge	Writer/Printing
Spreadsheets	Calc
Drawings	Draw
Presentations	Impress
Formula Editor	Formula
Database	Databases
Macros	Macros

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

Revision as of 07:32, 20 May 2010

Contents

Набор правил. Независимый проект

Перед началом редактирования

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

Структура раздела Документация (en) в Wiki

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

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

Шаблоны

Adding a new Documentation Template

List of Existing Documentation Templates

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

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

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

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

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

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

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

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

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

Удаление спама / удаление страниц

Working on FAQs

Working on How Tos

Working on Guides

Localizing Content

Navigation menu

Search