Различия
Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия | ||
wiki:новые_правила [2012/05/16 14:09] [Шаблон статьи про программу] |
wiki:новые_правила [2014/07/13 04:59] (текущий) удалил подпись |
||
---|---|---|---|
Строка 2: | Строка 2: | ||
<note important>Это черновик! Если есть идеи - смело правьте эту страницу, но добавляйте информацию только с подписью (есть в инструментах)</note> | <note important>Это черновик! Если есть идеи - смело правьте эту страницу, но добавляйте информацию только с подписью (есть в инструментах)</note> | ||
- | **Документация Ubuntu.ru** снискивает всё большую популярность как внутри круга почитателей Ubuntu, так и далеко за его пределами. В связи с этим, способствуя дальнейшему перспективному развитию ресурса, члены Сообщества принимают и обязуются соблюдать нижеследующие **Правила и рекомендации**: | + | **Документация Ubuntu.ru** становится всё более популярной как внутри круга почитателей Ubuntu, так и далеко за его пределами. В связи с этим, способствуя дальнейшему перспективному развитию ресурса, члены Сообщества принимают и обязуются соблюдать нижеследующие **Правила и рекомендации**: |
===== Создание статьи ===== | ===== Создание статьи ===== | ||
Строка 17: | Строка 17: | ||
>> --- [[user>Пупизоид]] //2012/05/15 13:18// | >> --- [[user>Пупизоид]] //2012/05/15 13:18// | ||
Публиковать рекомендуется только статьи, представляющие интерес широкого круга членов Сообщества. Не стоит писать и опубликовывать материал, интересный лишь его автору; степень значимости статьи можно примерно определить количеством ссылок на неё с других статей. Чем больше таких ссылок - тем важнее статья, тем большую она несёт в себе информационную ценность.\\ | Публиковать рекомендуется только статьи, представляющие интерес широкого круга членов Сообщества. Не стоит писать и опубликовывать материал, интересный лишь его автору; степень значимости статьи можно примерно определить количеством ссылок на неё с других статей. Чем больше таких ссылок - тем важнее статья, тем большую она несёт в себе информационную ценность.\\ | ||
- | Объём статей должен превышать 10-15 строк полезного текста. Статьи, не преодолевшие порог, будут поставлены в [[http://help.ubuntu.ru/?do=showtag&tag=deleteme|очередь на удаление]]. | + | Объём статей должен превышать <del>10-15</del> примерно 20 строк полезного текста. Статьи, не преодолевшие порог, будут поставлены в [[http://help.ubuntu.ru/?do=showtag&tag=deleteme|очередь на удаление]] или перенесены в содержание другой статьи. |
> 10-15 строк- мало, мне кажется | > 10-15 строк- мало, мне кажется | ||
> --- [[user>Пупизоид]] //2012/05/16 13:43// | > --- [[user>Пупизоид]] //2012/05/16 13:43// | ||
Строка 29: | Строка 29: | ||
>> Ну в картинках то ковардак будет, их там нужно систематизировать, потому что структура папок то видна. | >> Ну в картинках то ковардак будет, их там нужно систематизировать, потому что структура папок то видна. | ||
>> --- [[user>Пупизоид]] //2012/05/15 13:04// | >> --- [[user>Пупизоид]] //2012/05/15 13:04// | ||
+ | |||
+ | > В названии статей не должно быть никаких слов, обозначающих действие. Как-то: установка, настройка и т.д. В качестве общего исключения могут выступать статьи, образованные в результате разделения одной очень большой статьи на части путём выделения самых больших разделов. | ||
+ | > --- [[user>Malamut]] //2012/05/22 14:10// | ||
Создавая новую страницу, внимательно отнеситесь не только к её наполнению, но и наименованию с заголовком - визитной карточке страницы Документации. Имя статьи - слово или словосочетание, отображаемое после имени раздела 'wiki/', например, 'wiki/**правила**', где **правила** - имя статьи в системе Документации. [[#Создание статьи|Имя статьи задаётся её автором]]. Заголовком статьи считается первый [[syntax#Разбивка на разделы|заголовок 1-го уровня]], отображающийся в шапке материала и, кроме того, на других индексных страницах. \\ | Создавая новую страницу, внимательно отнеситесь не только к её наполнению, но и наименованию с заголовком - визитной карточке страницы Документации. Имя статьи - слово или словосочетание, отображаемое после имени раздела 'wiki/', например, 'wiki/**правила**', где **правила** - имя статьи в системе Документации. [[#Создание статьи|Имя статьи задаётся её автором]]. Заголовком статьи считается первый [[syntax#Разбивка на разделы|заголовок 1-го уровня]], отображающийся в шапке материала и, кроме того, на других индексных страницах. \\ | ||
Строка 36: | Строка 39: | ||
===== Структура статьи ===== | ===== Структура статьи ===== | ||
- | Для поддержания целостности и единообразия статей в разделе Документации в создаваемой странице следует использовать такие заголовки, как:<note tip>Это лишь рекомендуемая структура, в точности её можно не соблюдать.</note> | + | Для поддержания целостности и единообразия статей в разделе Документации в создаваемой странице необходимо использовать следующий шаблон: |
- | * **[[#Наименование статей|Первичный заголовок 1-го уровня]]** | + | <file> |
+ | ======Имя статьи====== | ||
+ | Тут необходимо изложить основную информацию о рассматриваемом ниже предмете и (или) вопросе. Первые абзацы статьи играют роль вступительной части, приводятся ссылки в вики на используемые термины. | ||
+ | =====//Произвольно//===== | ||
+ | В силу неординарности построения статей, решения о создании определённых подзаголовков ложатся на плечи автора или редактора, если автором эта важная составляющая была упущена. | ||
+ | ======Ссылки====== | ||
+ | здесь можно указать сторонние источники, дополнительные материалы по теме, и, например, ссылку на тему обсуждения страницы на форуме. | ||
+ | </file> | ||
+ | Система Документации под управлением DokuWiki поддерживает автоматическое создание оглавления статьи при наличии трёх и более заголовков. Помните, что именно заголовки определяют структуру и оглавление статьи, не пренебрегайте их использованием. \\ | ||
+ | |||
+ | <del> * **[[#Наименование статей|Первичный заголовок 1-го уровня]]** | ||
* **Общая информация** - краткое изложение сведений и положений о предмете статьи. Здесь может быть использована информация с официальных сайтов, файлов помощи программ, иных вики-ресурсов и т.п. | * **Общая информация** - краткое изложение сведений и положений о предмете статьи. Здесь может быть использована информация с официальных сайтов, файлов помощи программ, иных вики-ресурсов и т.п. | ||
* //Произвольно// - в силу неординарности построения статей, решения о создании определённых подзаголовков ложатся на плечи автора или редактора, если автором эта важная составляющая была упущена. | * //Произвольно// - в силу неординарности построения статей, решения о создании определённых подзаголовков ложатся на плечи автора или редактора, если автором эта важная составляющая была упущена. | ||
- | * **См.также** - здесь можно указать сторонние источники, дополнительные материалы по теме, и, например, ссылку на тему обсуждения страницы на форуме. | + | * **См.также** - здесь можно указать сторонние источники, дополнительные материалы по теме, и, например, ссылку на тему обсуждения страницы на форуме.</del> |
- | Система Документации под управлением DokuWiki поддерживает автоматическое создание оглавления статьи при наличии трёх и более заголовков. Помните, что именно заголовки определяют структуру и оглавление статьи, не пренебрегайте их использованием. | + | |
Строка 49: | Строка 61: | ||
Любой другой материал, уже изложенный в другой статье, заново пересказывать не стоит - лучше просто дать ссылку.\\ | Любой другой материал, уже изложенный в другой статье, заново пересказывать не стоит - лучше просто дать ссылку.\\ | ||
Если вы обнаружили в себе рвение и возможность описать что-то не совсем подходящее к редактируемой статье - подумайте, [[#Минимальный объём и значимость|нужно ли это остальным]]? - и, если нужно - напишите отдельную, с подробным раскрытием вопроса. | Если вы обнаружили в себе рвение и возможность описать что-то не совсем подходящее к редактируемой статье - подумайте, [[#Минимальный объём и значимость|нужно ли это остальным]]? - и, если нужно - напишите отдельную, с подробным раскрытием вопроса. | ||
+ | <note important>Ни в коем случае не забывайте про [[wiki:syntax#ссылки]]! Чем больше в статье [[wiki:syntax#ссылки|ссылок]], приоритетно - на [[wiki:syntax#внутренние|внутренние ресурсы]], тем прочнее она входит в систему Документации, тем крепче и стабильнее наблюдается взаимосвязь между разнообразными материалами.</note> | ||
Все статьи следует, по возможности, **[[#Иллюстрации и снимки экрана|сопровождать наглядными иллюстрациями]]**. | Все статьи следует, по возможности, **[[#Иллюстрации и снимки экрана|сопровождать наглядными иллюстрациями]]**. | ||
<note important>Формирование [[#Структура статьи|верной структуры]], [[#Оформление|оформления]], использование возможностей [[wiki:syntax|синтаксиса]] и, конечно же, достойное [[#Наполнение и содержание|содержание]] и соблюдение общепринятой [[terms/стилистика_статей|стилистики статей]] определяют успех статьи.</note> | <note important>Формирование [[#Структура статьи|верной структуры]], [[#Оформление|оформления]], использование возможностей [[wiki:syntax|синтаксиса]] и, конечно же, достойное [[#Наполнение и содержание|содержание]] и соблюдение общепринятой [[terms/стилистика_статей|стилистики статей]] определяют успех статьи.</note> | ||
+ | > Всегда стоит помнить, что многие пользователи используют не самую последнюю версию Ubuntu. Особенно это замечание актуально для серверных версий. Поэтому если вы хотите обновить статью, заменив какие-то устаревшие части на актуальные для текущего релиза Ubuntu, то **всегда** оставляйте комментарии с информацией о том, как нужно поступать при использовании старых версий. Проще говоря: **никогда** не удаляйте полезную информацию из статьи, если она актуальна хоть для какой-нибудь версии Ubuntu. Вместо этого переносите её в отдельные разделы или заметки, с пометкой об области применимости. | ||
+ | > --- [[user>Malamut]] //2012/05/24 10:43// | ||
===== Иллюстрации и снимки экрана ===== | ===== Иллюстрации и снимки экрана ===== | ||
Все статьи следует сопровождать пояснительными снимками экрана либо иллюстрирующими изображениями((к иллюстрирующим изображениям можно отнести, к примеру, логотип программы с официального сайта)). \\ | Все статьи следует сопровождать пояснительными снимками экрана либо иллюстрирующими изображениями((к иллюстрирующим изображениям можно отнести, к примеру, логотип программы с официального сайта)). \\ | ||
+ | Элементы оформления статей (галочки, крестики, логотипы Ubuntu и т.д.) необходимо брать (и добавлять свои) в пространстве **wiki:оформление:**. | ||
>Основные требования: все скриншоты должны быть сделаны при использовании стандартной темы рабочего стола Unity со стандартным набором иконок с одним из стандартных фонов, дабы не отвлекать читателя на изучение особенностей оформления. Он должен видеть то, что будет видеть на экране своего монитора. | >Основные требования: все скриншоты должны быть сделаны при использовании стандартной темы рабочего стола Unity со стандартным набором иконок с одним из стандартных фонов, дабы не отвлекать читателя на изучение особенностей оформления. Он должен видеть то, что будет видеть на экране своего монитора. | ||
> | > | ||
Строка 73: | Строка 89: | ||
> | > | ||
> --- [[user>Пупизоид]] //2012/05/16 13:52// | > --- [[user>Пупизоид]] //2012/05/16 13:52// | ||
+ | >> [[http://lurkmore.to/Tl;dr|тлдр]], нет правда. Подсократить бы, раза в три. Притом, плагин же менять будут?:-? Я надеюсь. --- [[user>forekko]] | ||
Необходимо напомнить, что изображения, найденные в сети Интернет, сохранять на сервере ресурса Документации не обязательно, их можно поместить и отображать в статье напрямую с другого сайта. При таком использовании подразумевается указание ссылки на сайт. | Необходимо напомнить, что изображения, найденные в сети Интернет, сохранять на сервере ресурса Документации не обязательно, их можно поместить и отображать в статье напрямую с другого сайта. При таком использовании подразумевается указание ссылки на сайт. | ||
+ | DELETEME --- [[user>forekko]] | ||
+ | |||
+ | > Логотипы программ - в /wiki, скриншоты и все остальные иллюстрации - в wiki/program_name. | ||
+ | > --- [[user>Malamut]] //2012/05/18 01:33// | ||
=====Статьи про программы===== | =====Статьи про программы===== | ||
Имя страницы статьи про программу, сервис и т.д. должна соответствовать шаблону: | Имя страницы статьи про программу, сервис и т.д. должна соответствовать шаблону: | ||
<file>help.ubuntu.ru/wiki/имя_программы</file> | <file>help.ubuntu.ru/wiki/имя_программы</file> | ||
+ | При переполнении статьи большим объемом информации необходимо добавлять тэг ''объемная'', что бы редактор отделил раздувшийся раздел в отдельную статью. | ||
+ | |||
====Шаблон статьи про программу==== | ====Шаблон статьи про программу==== | ||
<file> | <file> | ||
Строка 90: | Строка 113: | ||
======Использование====== | ======Использование====== | ||
- | Описание нестандартного применения программы, внутри какого то комплексного решения. | + | Описание нестандартного применения программы, внутри какого то комплексного решения, для каждого применения создается свой подраздел. |
+ | =====Вариант №1===== | ||
+ | =====Вариант №2===== | ||
+ | =====Вариант №n===== | ||
======Особенности версии====== | ======Особенности версии====== | ||
- | В этом разделе указываются особенности настройки и использования программ различных версий | + | В этом разделе указываются особенности настройки и использования программ различных версий, для каждой версии создается свой подраздел. |
=====Версия Х===== | =====Версия Х===== | ||
=====Версия Х+1===== | =====Версия Х+1===== | ||
Строка 104: | Строка 130: | ||
{{tag>программы}} | {{tag>программы}} | ||
</file> | </file> | ||
+ | При возникновении своего видения настройки программы необходимо создать дополнительный раздел "Настройка(альтернативная)".\\ | ||
+ | Тэг ''программы''-- обязателен! | ||
==== Статьи про конкретные программы (сервисы и т.д.) ==== | ==== Статьи про конкретные программы (сервисы и т.д.) ==== | ||
Строка 117: | Строка 145: | ||
> Если же нужна инструкция по специфичной настройке для какого-то случая - то в отдельную статью. Например: интеграция_ejabberd_с_active_directory | > Если же нужна инструкция по специфичной настройке для какого-то случая - то в отдельную статью. Например: интеграция_ejabberd_с_active_directory | ||
> --- [[user>Malamut]] //2012/05/12 13:49// | > --- [[user>Malamut]] //2012/05/12 13:49// | ||
+ | =====Статьи в разделе "Совместимость"===== | ||
+ | > Этот раздел вообще не трогаю; мне кажется, его стоит вынести в отдельные рекомендации конкретно раздела. --- [[user>forekko]] | ||
+ | В данном разделе создаются статьи для каждого устройства, в которых описываются особенности (или отсутствие) их использования вместе с Ubuntu. При написании статьи, воздержитесь, пожалуйста, от эмоциональной окраски текста, используйте технический язык.\\ Имя адреса страницы должно содержать производителя и модель описываемого устройства: | ||
+ | <file>help.ubuntu.ru/совместимость/hp_pavilion_dv6_2055er</file> | ||
+ | Ссылка на статью должна быть __обязательно__ добавлена в статью | ||
+ | <file>help.ubuntu.ru/совместимость/производитель_устройства</file> | ||
+ | |||
+ | > Так тэги же нужно использовать, а страницы производителей устройств сделать индексными просто, страницы без тэгов- удалять. | ||
+ | > --- [[user>Пупизоид]] //2012/05/16 14:15// | ||
+ | ====Шаблон статьи==== | ||
+ | <file> | ||
+ | ======Название устройства====== | ||
+ | В имени статьи указывается только модель устройства (Без производителя) | ||
+ | Далее указывается: | ||
+ | Совместимость с Ubuntu: нет проблем\решаемые проблемы\нерешаемые проблемы | ||
+ | ======Графика====== | ||
+ | Описываются проблемы (и их решения) с графикой | ||
+ | ======Звук====== | ||
+ | Описываются проблемы (и их решения) со звуком | ||
+ | ======Сеть====== | ||
+ | Описываются проблемы (и их решения) с сетевыми устройствами | ||
+ | ======Bluetooth====== | ||
+ | Описываются проблемы (и их решения) с функцией передачи файлов | ||
+ | ======Прочее оборудование===== | ||
+ | Описываются проблемы (и их решения) с прочим оборудованием (кардридеры, клавиатуры и т.д.) | ||
+ | ======Ссылки====== | ||
+ | Ссылки на сторонние материалы по решению проблем. | ||
+ | {{tag>имя_производителя}} | ||
+ | </file> | ||
+ | Примечания: | ||
+ | 1) для "нет проблем\решаемые проблемы\нерешаемые проблемы" можно придумать картинки веселые, и в шаблоне привести все три, нужно будет удалить лишнее только. | ||
+ | |||
+ | |||
+ | ====== Неструктурированные наброски идей по мотивам правил википедии ====== | ||
+ | |||
+ | Статьи следует писать на литературном русском языке в [[wpru>Научный_стиль|научном стиле]] от третьего лица. | ||
+ | |||
+ | Если на предмет статьи существует несколько различных взглядов, то в идеале их все необходимо изложить, или хотя бы добавить пометки про другие варианты. | ||
+ | |||
+ | Соблюдайте удобную для читателя последовательность повествования и размещения служебных пометок в исходном тексте статьи. | ||
+ | |||
+ | Последовательность изложения: | ||
+ | |||
+ | В статьях следует повествовать: | ||
+ | от общего к частному | ||
+ | от простого к сложному | ||
+ | в порядке важности, известности, достоверности | ||
+ | |||
+ |