Политика Wiki-редактирования
Содержание
- Политика и Условия использования веб-сайта wiki.harlamenkov.ru
- Миссия Энциклопедии
- Принципы дополнения Wiki
- [[RU/rules/wiki_editing_policy|]]
- Принципы именования страниц
- Стратегия
- Общие положения
- Инструкции
- Инструкция. Заголовки статей
- Инструкция. Создание новых рубрик
- Инструкция. Создание новых тем
- Инструкция. Создание новых тем в Базе Знаний
- Инструкция по написанию статей в Энциклопедии
- Правила стилевого оформления текстов
- Инструкция. Оформление таблиц
- (Разраб.) Инструкция. Шаблоны, общие для всех национальных языковых страниц
- Инструкция. О написании инструкций и документаций шаблонов
- Технические ограничения при создании заголовков (URL) статей
- Принципы перевода страниц
- Документация
- Обновление Правил
Перед началом редактирования страниц в зоне RU следует ознакомиться с Правилами ресурса:
Все действующие инструкции перечислены на странице Правила Энциклопедии. |
Этот документ поможет более эффективно работать над Wiki-документацией.
Contents
- 1 Об этих правилах
- 2 Получение аккаунта
- 3 Страницы обсуждений
- 4 Создание новых страниц
- 5 Шаблоны
- 6 Изображения и графика
- 7 Расстановка ссылок
- 8 Основные работы по редактированию
- 8.1 Исправление несоответствующей действительности, неточной или устаревшей информации
- 8.2 Исправление незначительных ошибок и опечаток
- 8.3 Исправление картинок и снимков экрана
- 8.4 Стилевые и языковые исправления
- 8.5 Ссылки на локализованные страницы
- 8.6 Проверка содержимого
- 8.7 Локализация контента
- 8.8 Изменение шаблонов
Об этих правилах
Данный документ описывает общие методы работы с системой MediaWiki, используемой в качестве технологической платформы Энциклопедии.
Данный документ отвечает на вопрос "как сделать".
Вопросы "почему" и "зачем" освещены в Полном своде правил Энциклопедии: Правила Энциклопедии.
Получение аккаунта
Чтобы получить возможность редактирования документов, необходимо зарегистрироваться. Регистрация новых участников выполняется по заявкам, направляемых на имя Администрации через форму обратной связи.
В заявке необходимо указать:
- фамилию, имя и отчество (полностью);
- место работы, должность, служебный телефон;
- информацию о специальности и образовании;
- адрес электропочты.
Атрибуты доступа высылаются Администрацией на указанный адрес электропочты.
После регистрации необходимо заполнить страницу своего профиля (имя пользователя отображается вверху страницы красным цветом, до тех пор, пока не будет создана пользовательская страница; для её создания необходимо щёлкнуть по ссылке с именем пользователя), используя в качестве шаблона страницы существующих участников.
При создании профиля допускается создание своих индивидуальных разделов, если необходимо. Этот образец предложен, чтобы профиль был единообразным у всех участников.
Для входа в систему используется точка входа в правом верхнем углу страницы. Необходимо пройти по ссылке Log in и ввести свои логин и пароль.
Страницы обсуждений
Страницы обсуждений предназначены для комментирования и обсуждения статей. Каждая статья имеет свою собственную страницу обсуждений.
Чтобы добавить комментарий к странице, необходимо:
- Щёлкнуть по вкладке Обсуждение вверху страницы.
- Чтобы начать новую тему в обсуждении, щёлкнуть по знаку [+] справа от вкладки Править вверху страницы, заполнить тему и записать свой комментарий в текстовом поле.
- Чтобы добавить комментарий к существующей дискуссии, нужно создать отступ перед своим ответом (он должен быть больше, чем отступ у абзаца перед комментарием). Для этого требуется вставить одно или несколько двоеточий (
:
) в начале каждого абзаца комментария. Одно двоеточие эквивалентно одному табулятору.
- Подписать сообщение. Для этого нужно вставить четыре тильды подряд (
~~~~
). Они преобразуются в подпись и текущую дату. Это можно сделать автоматически с помощью кнопки ( ) на панели инструментов. - По окончании, в поле «Описание изменений» ввести краткое описание сделанных изменений и щёлкнуть по кнопке Записать страницу.
Более подробная информация о создании обсуждений приведена в статье Help:Talk pages/ru.
Создание новых страниц
- Если новая страница является подстраницей у существующей страницы, достаточно перейти к этой существующей странице и создать в ней ссылку на новую страницу. После сохранения можно щёлкнуть по созданной ссылке и приступить к заполнению новой страницы.
- Для создания совершенно новой самостоятельной страницы можно использовать wiki-URL. Для этого в браузере в строке URL нужно ввести строку вида:
http://wiki.services.openoffice.org/wiki/национальная_языковая_страница/имя_новой_страницы
- При создании страницы таким образом, необходимо учитывать существующее дерево wiki-страниц. То есть если страница относится к какому-либо разделу, то в своём имени она должна содержать имя этого раздела. Например, если создаётся страница в проекте "qa" (контроль качества) в русскоязычной языковой зоне, в браузере в строке URL нужно ввести:
http://wiki.services.openoffice.org/wiki/RU/qa/имя_новой_страницы
- Рекомендуемый метод заключается в предварительном поиске нужной информации (поле Поиск на странице слева), и если требуемая страница не найдена (не существует), будет предложено создать данную страницу щелчком по ссылке «Создать страницу» на странице результатов поиска.
Создание страниц напрямую через URL допустимо только если затем будут добавлены ссылки на эту страницу с других страниц. В противном случае эта страница окажется «потерянной» в wiki. |
Подробные правила изложены в разделе Правила Энциклопедии и обязательны к исполнению. |
Дополнительная информация по созданию новых статей приведена в Документации Mediawiki по созданию новых статей.
Использование категорий
Категории, в которые включена страница, как правило, перечислены в нижнем колонтитуле страницы. Щелчок по категории ведёт к просмотру страницы заголовков страниц, которые отнесены к данной категории. Таким образом, категории являются тегом (меткой) для страниц, с помощью которого возможно просмотреть тематически связанные страницы.
Для добавления страницы в категорию необходимо добавить ссылку [[Category:''Имя_Категории'']] в конце страницы.
В Энциклопедии крайне не рекомендуется ручное категоризирование страниц. На каждой странице помещается шаблон подвала, в котором уже указана необходимая категория. Подробнее: (Разраб.) Инструкция. Шаблоны, общие для всех национальных языковых страниц. |
Категория уже должна существовать. В противном случае будет создана новая категория, оторванная от общей структуры категорий wiki.
Возможно использовать шаблоны для добавления общих категорий для больших групп страниц, и это является предпочтительным. Более того, при изменении шаблона (добавлении/удалении категории в шаблоне) соответствующим образом изменится страница, на которой он задействован — категория будет добавлена/удалена.
Шаблоны
Рекомендуется обратиться к документации на MediaWiki
Добавление нового шаблона документов
Если в шаблоне предусмотрен вывод какого-либо текста (кроме названий продуктов и торговых марок), то в имени шаблона также должна присутствовать базовая страница языка, как об этом говорилось выше.
Если шаблон не выводит текст, и, без каких-либо изменений, может задействоваться на разных национальных страницах, то код языка в его имени опускается.
- Для того чтобы все шаблоны собрать в одну категорию, необходимо добавить к шаблону собственную категорию, которая, при этом, не будет влиять на категоризацию страницы, на которой будет применён шаблон. Данная категория помещается между тегами
<noinclude>
. Подробнее об этом изложено в документации: MediaWiki help: Template (en).
- Созданный шаблон нужно добавить в одну из нижеприведённых инструкций, описывающих соответствующую серию шаблонов.
В именах шаблонов (URL) не действует запрет на использование заглавных букв, как на прочих страницах Энциклопедии, поскольку эти URL используются только внутри кода статей.
Список существующих шаблонов документации
Это список шаблонов документации и примеров их использования
Имя шаблона | Где использовать | Пример использования | ||
---|---|---|---|---|
Template:Documentation/hbar | Используется для рисования горизонтальных баров, для простых гистограмм
{{Documentation/hbar|width=100|bg=#3333FF}} |
| ||
Template:RUscientificStyle | Отметка для статей, стиль изложения которых не соответствует научному стилю подачи материала. | Template:RUscientificStyle | ||
Template:RUhelpneeded | Отметка для статей, нуждающихся в проверке орфографии.
{{RUhelpneeded|Проверка орфографии}} |
Template:RUhelpneeded | ||
Template:RUcheckedaccuracy | Отметка для статей, которые были проверены на точность.
Следует, в качестве параметров, указывать свой логин, имя и дату проверки: {{RUcheckedaccuracy|rail|Р. А. Алиев|17 мая 2010}} |
Template:RUcheckedaccuracy | ||
Template:RUoutdated | Указывает, что статья устарела.
{{RUoutdated}} |
Template:RUoutdated | ||
Template:RUdraftpage | Метка для страниц, которые находятся в процессе создания (стадия Черновика).
{{RUdraftpage}} |
Template:RUdraftpage | ||
Template:RUspecialPage | Метка для служебных страниц.
{{RUspecialPage}} |
Template:RUspecialPage | ||
Template:CoreCriticalTemplate | Данный шаблон предназначен для отметки критически важных базовых шаблонов, необдуманное вмешательство в которые может привести к разрушению всего проекта. |
Критически важный опорный шаблон — Core Critical Template.
| ||
Template:Documentation/Windows | Отображение логотипа Windows для ввода Windows-зависимого контента.
{{Documentation/Windows|Windows-зависимый контент}} |
| ||
Template:Documentation/Linux | Отображение логотипа Linux для ввода Linux-зависимого контента.
{{Documentation/Linux|Linux-зависимый контент}} |
| ||
Template:Documentation/OSX | Отображение логотипа Apple/OSX для ввода OSX-зависимого контента.
{{Documentation/OSX|Mac-зависимый контент}} |
| ||
Template:Bug | Ссылки на вопрос (баг) в Issuezilla.
{{Bug|123456}} |
Issue 123456 | ||
Template:Documentation/Tip | Применяется для выделения не критичной информации — например, для привлечения внимания к клавиатурным комбинациям.
{{Documentation/Tip|Правый щелчок мышью для вызова контекстного меню}} |
| ||
Template:Documentation/Caution | Применяется для предупреждений, для потенциально опасной информации, например, влекущую потерю данных.
{{Documentation/Caution|Стирание файла может его уничтожить.}} |
| ||
Template:RUseealso и Template:RUseealso | DevGuide / Смотри также используются в Руководстве для разработчиков и должны быть исключены из создаваемых PDF и ODT книг.
{{RUseealso| * [[Documentation/OOo3_User_Guides/Getting_Started|Getting Started with {{OOo3}} ]] }} |
Template:RUseealso | ||
Template:HeaderBlock | Оформительский шаблон.
Предназначен для оформления самых важных ссылок в виде подобия кнопки. {{HeaderBlock|[[RU]]}} |
|||
Template:RUfromforum | Отметка для статей, написанных по мотивам обсуждений на форуме community.i-rs.ru
{{RUfromforum}} |
Материал для этой статьи сформулирован на основе обсуждения | ||
Template:Documentation/Abstract | Для краткого обобщения содержания главы руководства. Добавляется в верхнюю часть руководств.
{{Documentation/Abstract|Abstract Text}} |
См., например, this Administration Guide Chapter | ||
Template:*TOC | Несколько видов оглавлений, основанных на Template:MasterTOC, используемых в руководствах. | См. например, Basic Guide TOC | ||
Template:MasterTOC | Это базовый шаблон для создания оглавлений. Для использования нужно кликнуть на имени шаблона. | |||
Template:Iop | Этот шаблон используется для вставки на странице названия InfraOffice.pro.
{{Iop}} |
InfraOffice.pro | ||
Template:IopVersion | Этот шаблон используется для вставки на странице окна с номером версии InfraOffice.pro.
{{IopVersion|3}} |
InfraOffice.pro 3
| ||
Template:OOoProVersion | Этот шаблон используется для вставки на странице окна с номером версии OpenOffice.org pro.
{{OOoProVersion|3.3.x}} |
OpenOffice.org pro 3.3.x
| ||
Template:Sign | Этот шаблон используется для вставки в статью подписи с именем автора. Первый параметр — логин автора. Второй параметр — имя, которое будет отображено в подписи. {{Sign|NGarbuz|Н. Е. Гарбуз}} |
| ||
Template:SignYear | Этот шаблон используется для вставки в статью подписи с именем автора и датой создания статьи. Первый параметр — логин автора. Второй параметр — имя, которое будет отображено в подписи. Третий параметр — дата, выводимая в подписи. {{SignYear}} |
| ||
Template:OOoPro | Этот шаблон используется для вставки в статью названия сборки 'OpenOffice.org pro' в любом месте текста. | OpenOffice.org pro OpenOffice.org pro | ||
Template:OOo | Этот шаблон используется для вставки в статью названия OpenOffice.org в любом месте текста.
{{OOo}} |
OpenOffice.org | ||
Template:OOo1 | Этот шаблон используется для вставки в статью названия OpenOffice.org 1.x в любом месте текста.
{{OOo1}} |
OpenOffice.org 1.x | ||
Template:OOo2 | Этот шаблон используется для вставки в статью названия OpenOffice.org 2.x в любом месте текста.
{{OOo2}} |
OpenOffice.org 2.x | ||
Template:OOo3 | Этот шаблон используется для вставки в статью названия OpenOffice.org 3.x в любом месте текста.
{{OOo3}} |
OpenOffice.org 3.x | ||
Template:OOoW | Этот шаблон используется для вставки в статью названия OpenOffice.org Writer в любом месте текста. | OpenOffice.org Writer Writer | ||
Template:OOoC | Этот шаблон используется для вставки в статью названия OpenOffice.org Calc в любом месте текста. | OpenOffice.org Calc Calc | ||
Template:OOoI | Этот шаблон используется для вставки в статью названия OpenOffice.org Impress в любом месте текста. | OpenOffice.org Impress Impress | ||
Template:OOoD | Этот шаблон используется для вставки в статью названия OpenOffice.org Draw в любом месте текста. | OpenOffice.org Draw Draw | ||
Template:OOoB | Этот шаблон используется для вставки в статью названия OpenOffice.org Base в любом месте текста. | OpenOffice.org Base Base | ||
Template:OOoM | Этот шаблон используется для вставки в статью названия OpenOffice.org Math в любом месте текста. | OpenOffice.org Math Math | ||
Template:OOoCh | Этот шаблон используется для вставки в статью названия OpenOffice.org Chart в любом месте текста. | OpenOffice.org Chart Chart | ||
Template:POOo | Этот шаблон используется для вставки в статью названия Portable OpenOffice.org в любом месте текста.
{{POOo}} |
Portable OpenOffice.org | ||
Template:SRB | Этот шаблон используется для вставки в статью названия 'Sun Report Builder' в любом месте текста. | Sun Report Builder Sun Report Builder | ||
Template:MSO | Этот шаблон используется для вставки в статью названия Microsoft Office в любом месте текста.
{{MSO}} |
Microsoft Office | ||
Template:MSO2003 | Этот шаблон используется для вставки в статью названия Microsoft Office 2003 в любом месте текста. | Microsoft Office 2003 MS Office 2003 | ||
Template:MSO2007 | Этот шаблон используется для вставки в статью названия Microsoft Office 2007 в любом месте текста. | Microsoft Office 2007 MS Office 2007 | ||
Template:MSO2010 | Этот шаблон используется для вставки в статью названия Microsoft Office 2010 в любом месте текста. | Microsoft Office 2010 MS Office 2010 | ||
Template:MSW | Этот шаблон используется для вставки в статью названия MS Word в любом месте текста. | MS Word Word | ||
Template:MSE | Этот шаблон используется для вставки в статью названия MS Excel в любом месте текста. | MS Excel Excel | ||
Template:MSA | Этот шаблон используется для вставки в статью названия MS Access в любом месте текста. | MS Access Access | ||
Template:MSPP | Этот шаблон используется для вставки в статью названия MS Power Point в любом месте текста. | MS Power Point Power Point | ||
Template:MSEq | Этот шаблон используется для вставки в статью названия MS Equation в любом месте текста. | MS Equation Equation | ||
Template:MSV | Этот шаблон используется для вставки в статью названия MS Visio в любом месте текста. | MS Visio Visio | ||
Template:Key | Этот шаблон используется для вставки в статью обозначений сочетаний клавиш.
{{Key|Ctrl|Shift|>}} |
Ctrl + ⇧ Shift + → | ||
Template:Button | Этот шаблон используется для вставки в статью обозначений кнопок экранных диалогов.
{{Button|Ok}} |
Ok | ||
Template:Menu | Данный шаблон предназначен для вставке в любом месте текста цепочки меню.
{{Menu|File|Open|Print|и т. д.}} |
File → Open → Print → 4 → 5 → 6 → 7 → 8 → 9 → 10 | ||
Template:Path | Шаблон предназначен для оформления пути файловой системы.
{{Path|C:\Program files\OpenOffice.org}} |
C:\Program files\OpenOffice.org |
Изображения и графика
Вот основные правила для картинок.
- Заголовок картинки должен быть уникальным и информативным. Имя файла так же должно иметь смысл, например 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]]
* Как управлять нумерацией изображений и таблиц?
Расстановка ссылок
Хотя окно редактирования предлагает помощь в создании внутренних и внешних ссылок, рекомендуется просмотреть MediaWiki страницу помощи по ссылкам для лучшего понимания того, как ссылки работают в Wiki.
Возможно, также будет полезной страница помощи MediaWiki примеры ссылок (en).
При создании текста ссылки необходимо следовать руководству по стилю using links (en).
Основные работы по редактированию
Редактирование возможно только после входа под своим именем. Редактировать можно сразу всю страницу, щёлкнув по вкладке править на самом верху. Но обычно удобнее редактировать отдельные разделы страницы, щёлкнув по ссылке [править] справа от заголовка раздела. При редактировании, просьба соблюдать принятые стили оформления (en) в целях обеспечения единства стилей всех статей. Перед сохранением изменений, рекомендуется использовать кнопку «Предварительный просмотр».
Исправление несоответствующей действительности, неточной или устаревшей информации
Информация, не являющаяся актуальной, обычно отмечается одним из следующих знаков:
Template:RUoutdated | Эта метка означает, что статья полностью устарела и требует переработки. |
Template:RUhelpneeded | Если статья частично устарела или содержит неточную информацию, эта метка будет знаком просьбы о помощи в редактировании. |
Набор страниц, отмеченных таким знаком, может быть найден по ссылке Страницы, требующие доработки на главной странице Wiki\RU. |
Выбрав страницу для редактирования, необходимо:
- проверить, что описанные инструкции всё ещё действуют для текущей версии OpenOffice.org;
- войти в систему и сделать необходимые исправления.
Удобно работать в двух вкладках браузера: одна вкладка — для чтения описанных инструкций, вторая — для редактирования.
Закончив редактирование, нужно удалить метку (или метки) о том, что статья требует редактирования, и поставить отметку «Проверена формальная точность» (как описано в Шаблонах предыдущего раздела). Затем щёлкнуть кнопку Записать страницу .
Исправление незначительных ошибок и опечаток
При обнаружении незначительных ошибок типа опечаток, достаточно просто войти в систему и отредактировать статью. Перед тем как щёлкнуть кнопку Записать страницу , желательно поставить галочку в пункте Малое изменение.
Исправление картинок и снимков экрана
Для редактирования графики в Wiki необходимо щёлкнуть правой кнопкой мыши по картинке и выбрать пункт Сохранить изображение как…. После редактирования картинки на своем компьютере нужно вернуться на страницу Wiki, щёлкнуть по картинке и на странице описания изображения выбрать пункт Загрузить новую версию этого файла.
Чтобы загрузить новую версию снимка экрана, нужно щёлкнуть на соответствующий снимок экрана Wiki и выбрать пункт Загрузить новую версию этого файла на странице описания изображения.
Стилевые и языковые исправления
Статьи, требующие стилевых и языковых исправлений, можно узнать по следующим меткам: Template:RUhelpneeded
Набор статей, имеющих последнюю метку, можно получить, нажав на ссылку Страницы, требующие доработки на главной странице 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). |