Редактирование этой вики

Материал из Mandriva Russian Community Wiki

Создание учётной записи и личной страницы

Чтобы получить возможность вносить изменения в эту вики, необходимо создать учётную запись.

Примечание
Нужно ввести e-mail и пароль, указанные при регистрации учётной записи Mandriva на my.mandriva.com (для вики используется такое же имя пользователя, что для и форума и Bugzilla).

В верхнем правом углу этой страницы есть ссылка для доступа к вашей учётной записи. Перейдите по ссылке Представиться/Зарегистрироваться.

• Если у вас нет учётной записи Mandriva, перейдите по ссылке Создать учётную запись, вы будете перенаправлены на страницу создания учётной записи.
• Если у вас уже есть учётная запись Mandriva, достаточно ввести e-mail и пароль, указанные при её регистрации.

После того, как вы представитесь, в правом верхнем углу появятся другие ссылки:

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

Вначале эта страница пуста. Вы можете заполнить её. На своей личной странице каждый может писать что угодно: можно рассказать о себе, вставить ссылки на другие страницы и т. д. Можно использовать персональную страницу в качестве песочницы, проверяя корректность вики-форматирования перед внесением изменений в статьи.

Если вы ещё не создали личную страницу, то щёлкнув по своему имени в верхней части страницы, вы попадёте в режим редактирования. Напишите немного о себе. Затем, нажмите кнопку «Записать страницу», находящуюся в нижней части страницы. Поздравляем! Вы только что отредактировали свою первую вики-страницу!

Когда зайдете на свою персональную страницу, обратите внимание на адресную строку веб-браузера. Адрес будет похож на:

http://wiki.mandriva.com/ru/Участник:7aa119c317f462884f1876c03c836e59

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

Создание новой статьи

Внимание!
Перед созданием новой статьи мы настоятельно рекомендуем проверить, не создал ли её кто-нибудь до вас.

Для поиска по вики используется текстовое поле Перейти или Найти слева на странице.

1. Кнопка Перейти перенесёт вас на страницу названием, введённым в поле ввода.
2. Кнопка Найти осуществляет поиск по этой вики с помощью Google, это поможет отыскать существующие вики-страницы.

В первом случае, если страницы ещё не существует, вики предложит ссылку для её создания (красная ссылка).

Другой способ создать страницу - создать ссылку на страницу, которую вы хотите создать, например, на личной странице или в тексте уже существующей статьи. Будет показана КРАСНАЯ ссылка, это означает, что страницы еще не существует. Пример: СтраницаКоторойНет Щелкнув по этой ссылке, вы перейдете к странице редактирования новой статьи. Когда страница будет создана, ссылка станет голубого цвета.

Формат создания ссылок рассмотрен в следующем разделе.

В конце концов, можно создать свою статью через эту форму:

Как писать статью : основы wiki-разметки

Формат Mediawiki не требует особых знаний. Не нужно вставлять тэг <br>, чтобы вставить пустую строку. В большинстве случаев, вам достаточно вставить пустую строку, как в обычном текстовом редакторе.

• Руководство редактора Mediawiki.

Выбор названия и планирование статьи

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

Названия страниц, переименование и перенаправление: хорошие манеры!

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

Если вы ошиблись в заголовке

• переименуйте страницу или попросите об этом администратора the Wiki administrator list. Процедура переименования wiki-страницы заключается в переносе содержимого статьи со старой страницы на новую, с правильным названием и установки перенаправления между этими двумя страницами.
• Если ваша статья появилась в wiki недавно, перейдите на старую страницу (используйте список всех страниц) и присвойте странице категорию Category:Obsolete; администратор её удалит.
• Иначе, если статья находится в wiki уже очень давно, внешние ссылки (сайты в Интернет) могут на нее ссылаться. В этом случае, перенаправление нельзя удалять, чтобы не портить внешние сслыки и не создавать дурную славу Mandriva Wiki

Не создавайте перенаправления для всех возможных написаний одного и того же слова. Называйте свои статьи используя полное написание слова (здесь так принято), руководствуйтесь здравым смыслом. Не нужно называть статью "Репозиторий" и создавать множество перенаправлений, для каждого из возможных вариантов, которые могут встретиться в запросах "Репозитарий", "Репозитории", "Репы"... и т.д.

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

Создание перенаправления

Если вы хотите, чтобы читатель со страницы Репозиторий автоматически попадал на страницу Источники программ, на странице Репозиторий нужно вставить следующий код:

#REDIRECT [[Источники программ]]

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

Форматирование страниц заголовками и подзаголовками

Чтобы отформатировать страницу, вы можете создавать разделы и подразделы, используя заголовки и подзаголовки. Для этого используется символ "=". Текст заголовка располагается между символами '=', количество символов должно быть одинаково слева и справа от заголовка (пример ниже). Число знаков '=' соответствует уровню заголовка.

Wiki-разметка позволяет использовать заголовки уровня H1, т.е. заголовок между одним "=" с каждой стороны. Но использование таких заголовков запрещено, чтобы сохранить различие между названием статьи и названиями разделов, а также во избежание ошибок Google при индексировании заголовков формата H1.

= Заголовки формата H1 запрещены =

Прочитайте Правила создания статьи

Ваш первый заголовок должен быть уровня H2  :

== Заголовок 1 (уровень H2) ==
=== Заголовок 2 (уровень H3) ===
==== Заголовок 3 (уровень H4) ====
===== Заголовок 4 (уровень H5) =====

Подробное описание можно найти в руководстве по MediaWiki.

Форматирование символов

Полужирный, курсив, подчеркнутый... Подробное руководство по форматированию символов можно найти в Справке Mediawiki (eng).

''Выделим слово'', '''еще немного''', '''''сильнее'''''.
'''F''' = ''m'' '''a'''.

<span style="color:#FF0000;">Подкрасим текст</span>

<small>маленькие буквы</small>

<big>большие буквы</big>

<strike>зачёркивать</strike>
<s>зачёркивать</s>
<u>и подчёркивать их...</u>

À Á Â Ã Ä Å Æ
Ç È É Ê Ë Ì Í
Î Ï Ñ Ò Ó Ô Õ Œ
Ö Ø Ù Ú Û Ü ß
à á â ã ä å æ
ç è é ê ë ì í
î ï ñ ò ó ô õ œ
ö ø ù ú û ü ÿ

¿ ¡ « » § ¶
† ‡ •

™ © ® ¢ € ¥ £ ¤

Нижний индекс: x<sub>2</sub> et
Верхний индекс: x<sup>2</sup>

Вставка кода

• С помощью тэгов <pre>ля ля ля... </pre> можно вставить отображение кода в статью, как показано ниже:

ля ля ля...

• То же самое можно сделать и для нескольких строк кода, без использования тэгов <pre> </pre>, достаточно добавить пробел в начале каждой строки.

ля ля ля...
это код
написанный простым добавлением пробела
в начало каждой строки.

Создание ссылок

Внутренние ссылки (на страницы этой Wiki)

Ссылки на статьи и подразделы

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

[[Установка Mandriva Linux]]

станет: Установка Mandriva Linux

[[Установка Mandriva Linux|Как установить Mandriva?]]

станет: Как установить Mandriva? (эта ссылка на ту же страницу, что и предыдущая).

Используя символ "#", можно ссылаться на раздел или подраздел другой страницы (в этом случае, рекомендуем добавлять уточняющий текст).

[[Как пользоваться этой вики#Поиск в вики | Как пользоваться поиском ]]

станет: Как пользоваться поиском

Примечание
Когда вы ссылаетесь на статью wiki, пишите её название (название страницы) без подчеркиваний (не заменяйте пробелы символом "_"). Ваш веб-браузер сделает это автоматически в адресной строке. То же самое относится к ссылкам на подразделы после символа "#".

Ссылки на переводы

Когда вы переводите статью, можно указывать ссылки на её переводы на другие языки (например, исходный язык, с которого вы переводите документ). Пример оформления:

[[:fr:Accueil]]

станет: fr:Accueil

Это ссылка Mandriva wiki на страницу, написанную на другом языке (здесь, французском). Если убрать первый символ ":" [[fr:Accueil]], ссылка станет невидимой в тексте статьи и появится слева в блоке "на других языках". Мы настоятельно рекомендуем включать такие ссылки во все страницы, переведенные на другие языки.

Внешние ссылки

Простой адрес страницы в интернет автоматически преобразуется в ссылку

http://www.mandriva.com/

станет: http://www.mandriva.com/

Для описания ссылки, нужно использовать квадратные скобки. Напишите адрес страницы, вставьте пробел и наберите текст описания ссылки:

[http://www.mandriva.com/ Mandriva Website]

станет: Mandriva Website

Списки

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

* Списки это классно:
** Они позволяют упорядочить документацию
** Они делают чтение документов более комфортным

# Нумерованные списки также полезны
# Чёткая структура
## Комфортное чтение

# Создавая нумерацию
#* не вставляйте пустые строки 
#* между нумерованными строками
# Создавая нумерацию
#:- не вставляйте пустые строки 
#:- между нумерованными строками
# Всё очень просто, не так ли? :-)

Строки могут
:использовать
::многоуровневые
:::отступы

*Нумерованный список:
:#Первый элемент
:#Второй элемент
*Другие ветки списка

; Списки определений: список, содержащий определения
; Объяснение слова: объяснение значения слова

<ul>
  <li>Нумерованный список:
  <ol>
    <li>Первый элемент
    <li>Второй элемент
  </ol>
  <li>Другие ветки списка
</ul>

Использование шаблонов

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

Список шаблонов доступен на этой странице. Другой способ добраться до списка шаблонов - перейти по ссылке "Спецстраницы", потом перейти на "Все страницы", выбрать "Шаблон" из выпадающего списка 'Пространство имен' и щелкнуть по кнопке "'Выполнить'".

Способ использования шаблонов: (для Шаблон:Программа)

Форматирование:

Открывается с помощью {{Программа|Mozilla Firefox}}

покажет:

Открывается с помощью Mozilla Firefox

Совет!

Для подробного знакомства с шаблонами, особенно с их комплексным использованием, прочитайте статьи:

• Advanced wiki syntax (eng)
• Styles to be used in the Wiki (eng)

Редактирование существующей страницы

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

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

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

Можно воспользоваться двумя опциями:

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

И три кнопки:

• Записать страницу, чтобы сохранить свою работу (комбинация клавиш: Alt-Shift-S)
• Предварительный просмотр, чтобы увидеть как будет выглядеть страница, до того как ее увидят все остальные (Alt-Shift-P)
• Показать изменения, чтобы увидеть отличия между сохраненной страницей и вашими правками.

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

Пустой или не полный раздел

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

Этот раздел пуст или недостаточно полно раскрывает материал, вы можете улучшить его, отредактировав!

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

Если статья не завершена

Если вы понимаете, что статья не полная, не стесняйтесь вставлять вверху страницы шаблон: {{Черновик}}

Это сообщение показывает, что страница требует улучшений.

Если этот шаблон используется на странице, она автоматически заносится в категорию HouseKeeping.

Если вы перевели страницу

Если вы переводите статью, пожалуйста, сообщите о себе на странице Translation Tasks. Вставьте шаблон {{перевод|Переводчик|Оригинальная страница}}, который отобразит примерно следующее:

Этот шаблон автоматически добавит статью в категорию Неполный перевод.

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

Подкатегории

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

Например, предположим, что существуют категории 'Участники' и 'Участие в вики', а также, есть пользователь 'Vasili', который хочет, чтобы его страница выводилась в категории Участие в вики. В начало своей страницы (Vasili) он вставляет [[Категория:Участие в вики|Vasili]]. Приходится использовать "|Vasili" внутри ссылки на категорию, чтобы страница сортировалась корректно (первая буква была 'V'), иначе первая буква для сортировки будет 'У' по названию страницы [Участник:Vasili|Vasili].

В категории 'Участие в вики', нужно добавить [[Категория:Участники]], тогда она станет подкатегорией для 'Участники'.

Чтобы создать простую ссылку на категорию, но не включать в нее вашу страницу, нужно в ссылке поставить ":" перед словом "Категория". [[:Категория:Участие в вики]] -> Категория:Участие в вики (список страниц для участников вики).

Могу ли я вставлять изображения?

Чтобы использовать изображения, необходимо:

1. Загрузить изображение на сервер вики;
2. Использовать изображение в статье (одно изображение можно использовать много раз в разных статьях).

Внимание!
Прежде чем загружать изображение, познакомьтесь с правилами, принятыми в этой вики: Правила создания статьи

Загрузка изображения на сервер

1. Изображение должно находиться на вашем компьютере (на рабочем столе, в личной папке и т.д.).
2. Перейдите на страницу Загрузить файл (ссылка на страницу находится на панели инструментов слева).
3. Нажмите Обзор и выберите изображение для загрузки (к примеру, mandriva.png).
4. Иконки иструментов мандрива называются <инструмент>-icon.png, например, Drakrpm-icon.png.
5. Нажмите кнопку Загрузить файл, файл будет загружен на сервер и появится в вики; названием изображения будет Image:Mandriva.png (запомните его для последующего использования).

Использование изображения в вики

На странице список загруженных файлов можно проверить, что изображение корректно загрузилось на сервер (и вспомнить название файла :).

Чтобы показать изображение на странице, достаточно вставить ссылку, используя пару квадратных скобок: [[Image:Mandriva.png]].

Например, [[Image:Mandriva.png]] станет

Как расположить изображение в статье

Статью можно иллюстрировать набором изображений (например, скриншотами).

Простой способ вставки изображения:

[[Image:''Название файла с изображением, включая его расширение''|''параметр1''|''параметр2''|...|''Описание'']]

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

Описание изображения

Описание должно быть вставлено после последнего символа '|', оно может содержать элементы вики-разметки, ссылки и т.д. Если описание не нужно, можно оставить его пустым: [[Image:Name.png|option|]].

Есть несколько вариантов отображения описания:

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

В описании можно использовать внешние ссылки, но только без скобок (как обычный текст). Даже если ссылка неполная или плохо отображается, она все равно работает.

Управление размерами изображения

По умолчанию, выводится полноразмерное изображение. Вы можете изменить размер отображения картинки в статье двумя путями: прямо указав размер в точках или используя уменьшенную копию изображения - миниатюру.

Размер в точках

Размер задается явно в следующем формате:

• [[Image:Mandriva.png|10px|]] покажет:
  
• [[Image:Mandriva.png|50px|]] покажет:
  
• [[Image:Mandriva.png|100px|]] покажет:
  

Число перед px это ширина изображения. MediaWiki автоматически определит высоту, чтобы сохранить пропорции картинки.

Вставка миниатюры

Для создания миниатюры используется параметр thumb (или "thumbnail"). Если размер не указан, будет использован размер изображения, выбранный пользователем в своих настройках. Советуем не изменять размеры, а сохранять их первоначальные значения.

Пример:

[[Image:Mandriva.png|left|thumb|Выводится с размерами по умолчанию]]

Выводится с размерами по умолчанию

Миниатюра и ссылка на страницу с описанием изображения.

Расположение на странице

По умолчанию, изображение выводится в тексте, где было вставлено или справа, если содержит описание. Можно указать расположение с помощью параметра: left, right, center или none. Этот параметр управляет и выводом текста вокруг изображения.

Изображение слева

• Параметр left располагает изображение слева. Текст обтекает изображение справа. Если вставить еще одно изображение сразу же после этого, оно будет выведено справа. Если между двумя изображениями есть текст, то вторая картинка будет выведена правее и ниже первой, под текстом.

• Параметр none располагает изображение слева, но текст выводится под картинкой.

[[Image:Installation Mandriva One09.png|left|400px]] Текст следует за изображением

[[Image:Installation Mandriva One09.png|none|400px]] Текст следует за изображением 

Изображение справа

• Параметр right располагает изображение справа. Текст обтекает изображение слева. Если с другой стороны вставлено другое изображение, оно выводится справа под первым изображением.

[[Image:Installation Mandriva One09.png|right|400px]] Текст следует за изображением 

Изображение в центре

Параметр center, располагает изображение по центру страницы и начинает вывод текста под картинку:

[[Image:Installation Mandriva One09.png|center|400px]] Текст следует за изображением 

Рамка и описание

Параметр frame (или framed) добавляет рамку вокруг изображения. В этом случае, подпись всегда располагается под изображением. Для миниатюр (если использован параметр "thumb") рамка создается автоматически.

[[Image:Installation Mandriva One09.png|none|frame|текст описывающий изображение]]

Текст после изображений

Чтобы после вставленного изображения текст выводился нормально, заполняя все доступное место, нужно вставить код <br style="clear:both;" />. На текст перестанет действовать выравнивание заданное при выводе изображения.

Как вставить видео

Использование видеофайлов

Для видео используется дополнение MediaWiki EmbedVideo. Оно работает со следующими сайтами: Dailymotion, YouTube, Google Video, sevenload, Revver, FunnyOrDie.

В основном, эти сайты используют Flash или QuickTime для воспроизведения видео. Дополнение для поддержки свободных форматов Ogg и Theora находится в разработке.

Предупреждение
Не храните свои видеофайлы в самой вики! Дополнение EmbedVideo разработано специально, чтобы избежать хранения видео в вики. Видеофайлы должны располагаться на внешнем сервере.

Как вставить видео

Формат для вставки видео:

* {{#ev:service|id}} или
* {{#ev:service|id|ширина}}

Где:

• "Service" название сайта, на котором расположен видео-файл (Youtube, Dailymotion. ..)
• "Id" код видео-файла, он виден в адресной строке веб-браузера, когда вы смотрите это видео на сайте
• "ширина" (необязательный параметр) ширина видео-изображения в точках. Если параметр не указан, используется ширина по умолчанию.

Пример:

{{#ev:youtube|Mx5BUcTmoU8|300}}

Без параметра "ширина":

{{#ev:youtube|Mx5BUcTmoU8}}

Если вы включили видео в свою статью, подумайте в какую категорию Category: portal: video можно отнести эту видео-запись, чтобы включить ваш материал в тематический портал Видео. Это поможет упорядочить все статьи, содержащие видео-материалы.

Для сайте Dailymotion, есть небольшая сложность -- код видео-файла некорректно отображается в адресной строке. Код можно посмотреть на странице с нужным видео-материалом в поле "reader exportable".

Нужно найти строку: <param name="movie" value="http://www.dailymotion.com/swf/1lxfNaCwoZ11Oqhxp">

И скопировать код в формат:

{{#ev:dailymotion|1lxfNaCwoZ11Oqhxp}}

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

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

Быстрая подпись

Если вы вступаете в дискуссию на странице обсуждения или комментируете там статью, нужно подписывать свои комментарии, чтобы остальные участники знали, чьи это слова. Для подписи, достаточно вставить от 3 до 5 символов "~" подряд. Это аналогично созданию ссылки на свою личную страницу, 4 символа добавят к имени текущую дату и время, 5 символов вставят только дату и время.

~~~ выведет YuriMyasoedov

~~~~ выведет YuriMyasoedov 16:38, 16 июня 2009 (UTC)

~~~~~ выведет 16:38, 16 июня 2009 (UTC)

Используйте отступы (табуляцию)

Нужно вставить символ ':', для отступа на один интервал.

Я думаю что.... Вася
:Не согласен!  Петя
:: Ну не знаю... Саша

Я думаю что.... Вася

Не согласен! Петя

Ну не знаю... Саша

С панелью редактора можно работать быстрее и проще

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

Инструменты панели редактора слева направо:

• полужирный шрифт;
• курсив;
• внутренняя ссылка;
• внешняя ссылка;
• заголовок 2-го уровня (H2);
• встроенное изображение;
• ссылка на медиа-файл;
• математическая формула;
• игнорировать вики-формат;
• вставить подпись, дату и время;
• горизонтальная линия.

Подробности вики-разметки

Дополнительные подробности использования вики-разметки можно найти на странице: Advanced wiki syntax (eng).

Дополнительная помощь

За дополнительной помощью можно обратиться на официальный форум Mandriva.