Викиучебник:Как писать учебники и руководства: различия между версиями

Содержимое удалено Содержимое добавлено
Содержимое страницы заменено на «== Текст заголовка ==»
Строка 1:
== Текст заголовка ==
{{Эссе}}
 
<blockquote class="epigraph" style="max-width: 37%;" >Вам не нравится Викиучебник? Вы просто не умеете его готовить!</blockquote>
 
<blockquote class="epigraph" style="max-width: 37%;" >[[w:en:To Serve Man (The Twilight Zone)|Мистер Чемберс!]] Эта книга — «Готов ли человек?» — это… это кулинарная книга!</blockquote>
 
{{Вкратце
| Спешите поделиться собственной инструкцией по использованию новейшей JRH Foozilla 4.2 или решению линейных уравнений с одной неизвестной? [[#Создание нового учебника |Добро пожаловать!]]
| Заметили ошибку в оформлении (орфографии, терминологии, …)? [[w:Википедия:Правьте смело |Правьте смело!]]
| Очень нужная и полезная страница предложена к удалению? [[#Организационная деятельность |Примите участие в обсуждении!]]
}}
 
Принести пользу Викиучебнику по силам любому желающему. Здесь мы рассмотрим, <em >как именно</em> это можно сделать, — а заодно и как извлечь пользу <em >из</em> участия в проекте.
 
== Два направления работы ==
 
Как и в других проектах [[w:Фонд Викимедиа |Фонда Викимедиа]], участие в Викиучебнике представлено двумя основными направлениями:
* «тематическим» — [[#Создание нового учебника |созданием новых учебников]], дополнением существующих новым материалом (включая ссылки на ''авторитетные источники'' и иллюстрации), исправлением фактических ошибок;
* «организационным» — выявлением и устранением существующих проблем в оформлении (и, в меньшей степени, — содержании) учебных материалов, поддержкой «вспомогательных» страниц, участием в обсуждениях, выполнением [[Викиучебник:Администраторы |административных действий]], {{lang |en|etc.}}
 
Тем не менее, ''первичная цель'' в обоих случаях остается неизменной — сделать материалы проекта более ценными для читателей и создателей производных работ, а также сделать использование этих материалов и участие в работе над ними более удобным для тех, кому это может быть интересно.
 
Участники, разумеется, могут преследовать собственные цели. В случае «тематического» направления, такой целью может быть получение критики на собственную работу, или же просто обеспечение к ней доступа всех заинтересованных лиц. Материалы, важные для профессиональной деятельности, конечно, можно опубликовать на «сетевых ресурсах» предприятия, но сколь прост будет к ним доступ «извне»? Напротив, материалы Викиучебника доступны едва ли не из любой точки мира и едва ли не с любого «сетевого» устройства.
 
«Организационное» направление, по-видимому, будет наиболее интересным участникам-читателям, поскольку позволяет сделать поиск и чтение материалов более удобным, а также может привлечь к проекту новых авторов и, следовательно, — новый материал.
 
== Создание нового учебника ==
 
Для создания нового учебника по конкретной теме крайне желательно наличие некоторого опыта в объяснении этой самой темы, — не важно, в «формальной обстановке» или «неформальной». Полезным будет и наличие уже готового, представленного какой-либо аудитории материала (ориентировочно — 1000 слов и более.)
 
=== Новый учебник, или? ===
 
Перед внесением материала в проект следует проверить наличие близких по теме учебников или разделов — возможно, материал будет более уместен как новый раздел уже существующего учебника? Одновременно с этим можно будет выяснить названия подходящих для нового учебника [[Викиучебник:Категоризация |тематических категорий.]]
 
Удостоверьтесь также, что предлагаемый материал соответствует [[Викиучебник:Что такое Викиучебник |основным принципам]] именно <em >данного</em> проекта. Размещаемый здесь материал должен отвечать на вопрос «как?». В некоторых случаях, материал может подойти другим проектам [[w:Фонд Викимедиа |Фонда]]:
* [[w: |Википедии]] — если материал отвечает на вопрос «что такое?»;
* [[v: |Викиверситету]] — подойдут любого рода материалы, полезные в учебном процессе: учебные курсы и методические указания, работы учащихся и требования к их оформлению, списки экзаменационных вопросов и списки литературы для подготовки, {{lang |la|etc.}};
* [[s: |Викитеке]] — опубликованные («в печати») свободные работы — в том числе учебники и руководства, <em >а также их переводы</em> — не исключая и выполненные самими участниками Викитеки;
* [[q: |Викицитатнику]] — сборники цитат (по авторству, теме, произведению);
* [[voy: |Викигиду]] — путеводители по городам и странам;
* [[wikt: |Викисловарю]] — словарные статьи;
* [[n: |Викиновостям]] — новости.
 
<strong >Обратите внимание</strong>, что критерием освоения некоторых дисциплин (в частности, в сфере истории, филологии, философии) является знакомство ''с первоисточниками и критическими материалами'' по теме. ''Учебником'' по таким дисциплинам может оказаться, например, [[Викиучебник:Что такое Викиучебник#Что такое Викиучебник |собрание сочинений Шекспира]] (на правах ''первоисточника'') или сборник статей Википедии (как изложение идей, содержащихся ''в критике''.) Уместность материалов такого рода в Викиучебнике является предметом споров. По-видимому, первоисточники (в том числе аннотированные) следует в первую очередь предлагать Викитеке; обзор критики — Википедии; «практические задания» — Викиверситету. Викиучебник может служить разве что «инкубатором» для таких материалов.
 
=== Выбор названия ===
 
В названии учебника следует отразить конкретный ''предмет'' (умение, навык), которым (по мнению авторов) можно овладеть изучая его. Определенные усилия следует приложить к тому, чтобы название учебника не вводило в заблуждение — не использовало неоднозначных терминов и не было слишком уж общим. В частности, название учебника (или же, тем более, краткой справки) по использованию конкретной программы или языка программирования, не должно совпадать с названием ''самой'' этой программы (языка.)
 
Так, название ''Ядро Linux'' будет уместно лишь для учебника, в котором рассмотрена сборка данного ядра, в деталях разобрано его внутреннее устройство, приведены примеры написания новых компонент и публикации разного рода изменений в рассылках разработчиков, использования команднострочных средств — а равно и файловых систем <code >/proc</code> и </code >/sys</code> — для настройки и извлечения разнообразной информации, {{lang |la|etc.}}
 
<strong >Обратите внимание</strong>, что создание учебника автоматически резервирует [[Викиучебник:Категоризация#Категории страниц учебника |одноименную категорию]] для его страниц. Как следствие, создание учебника с названием, например, ''Бокрский язык'' сделает невозможным создание с таким названием <em >тематической</em> категории. Поэтому, для новых учебников следует, по-возможности, использовать более развернутые названия (например: ''Разговорник бокрского языка''.)
 
Если возникают сомнения относительно <em >названия</em> нового учебника или уместности нового материала в существующем учебнике, можно разместить материал [[Викиучебник:Личная страница участника |в «личном пространстве»]] и запросить мнение сообщества, — например, [[Викиучебник:Общий форум |на общем форуме.]]
 
=== Одностраничный учебник ===
 
Готовые материалы небольшого объема (в пределах порядка 2000‒5000 слов) допустимо размещать «одной страницей». Для этого (предполагая использование «типового» ''пользовательского агента Всемирной паутины'') можно воспользоваться следующим рецептом.
<ol>
<li ><p >Введите желаемое название учебника в поле ввода на странице [[Служебная:Поиск]]. Если учебника с таким названием не существует — будет предложено создать новую страницу. С той же целью можно просто перейти по ссылке вида https:{{SERVER}}/wiki/<var >Название нового учебника</var>.</p></li>
<li ><p id="{{anchorencode: оформление страницы}}" >Разместите материал на странице согласно следующему образцу.</p>
<span style="white-space: pre-wrap;" >В данном учебнике мы рассмотрим… <var >(краткое — в пределах 150 слов — описание предмета учебника, принятого автором подхода к изложению, {{lang |en|etc.}})</var></span>
== <var >Название раздела</var> ==
<var >Текст раздела.<var>
== См. также ==
* <var style="white-space: pre-wrap;" >Ссылки на другие учебники, страницы Википедии, прочие материалы по теме.</var>
== Примечания ==
{{tl |Примечания}}
{{tlp |Темы |<var >Одна тема</var> |<var >Другая тема</var>}}
{{tlp |Готовность |50%}}
</li>
<li ><p >Используйте функцию ''предварительного просмотра'' для проверки корректности оформления нового материала. После внесения материала его желательно повторно просмотреть и устранить обнаруженные дефекты.</p></li>
</ol>
 
=== Многостраничный учебник ===
 
Для материалов (предполагаемого) объема порядка 2000 слов и более следует создавать многостраничные учебники, для чего подойдет следующий рецепт.
<ol>
<li ><p >Введите желаемое название учебника в поле ввода на странице [[Служебная:Поиск]]. Если учебника с таким названием не существует — будет предложено создать новую страницу. С той же целью можно просто перейти по ссылке вида https:{{SERVER}}/wiki/<var >Название нового учебника</var>.</p></li>
<li ><p >Создайте «главную страницу» учебника согласно следующему образцу.</p>
<span style="white-space: pre-wrap;" >В данном учебнике мы рассмотрим… <var >(краткое — в пределах 150 слов — описание предмета учебника, принятого автором подхода к изложению, {{lang |en|etc.}})</var></span>
== Содержание ==
; <var >Название одной главы<var>
: [[<nowiki />/<var >Название раздела</var>/]]{{tlp |Стадия кор |25%|{{#time: Y-m-d}}}}
: [[<nowiki />/<var >Название раздела</var>/]]{{tlp |Стадия кор |75%|{{#time: Y-m-d}}}}
; <var >Название другой главы<var>
: [[<nowiki />/<var >Название раздела</var>/]]{{tlp |Стадия кор |50%|{{#time: Y-m-d}}}}
== См. также ==
* <var style="white-space: pre-wrap;" >Ссылки на другие учебники, страницы Википедии, прочие материалы по теме.</var>
{{tlp |Темы |<var >Одна тема</var> |<var >Другая тема</var>}}
{{tl |BookCat}}
{{tlp |Готовность |25%}}
 
Если количество разделов — невелико, на ''главы'' материал можно не делить. С другой стороны, если материал достаточно дифференцирован, можно использовать ''двухуровневую'' систему наименования страниц учебника — <code ><var >Название учебника</var>/<var >Главы́</var>/<var >Раздела</var></code>.
</li>
<li ><p >Используйте функцию ''предварительного просмотра'' для проверки корректности оформления страницы.</p></li>
<li ><p >Благодаря шаблону {{tl |BookCat}}, при просмотре страницы будет доступна ссылка на (пока несуществующую) [[Викиучебник:Категоризация#Категории страниц учебника |категорию страниц учебника.]] При ее создании, за основу можно взять следующий образец.</p>
{{tl |Заголовок категории учебника}}
[[<nowiki />Категория:<var >Одна тема</var>]]
[[<nowiki />Категория:<var >Другая тема</var>]]
</li>
<li ><p >Воспользуйтесь ссылкой на какой-либо из несуществующих разделов учебника для его создания. Оформить страницу раздела можно соответственно данному выше [[#оформление страницы |образцу оформления]] одностраничного учебника, <em >обязательно используя,</em> однако, шаблон {{tl |BookCat}} вместо {{tl |Темы}} и {{tl |Готовность}}. «Аннотация» в начале страницы, разумеется, также должна относится к материалу данной отдельной страницы, а не учебника в целом.</p></li>
<li ><p >После создания (дополнения) раздела — проверьте актуальность шаблона {{tl |Стадия кор}} в «Содержании» на «главной странице» учебника.</p></li>
</ol>
 
=== Перенос материала из других проектов ===
 
Содержание других проектов [[w:Фонд Викимедиа |Фонда]] также доступно (как правило) на условиях принятой в Викиучебнике лицензии CC BY-SA 3.0 (или же на условиях еще менее строгих CC BY или CC0), что позволяет сравнительно свободно ''заимствовать'' такой материал в данном проекте.
 
Следует помнить, однако, что лицензии [[w:Creative Commons |Creative Commons]] требуют сохранения информации об ''авторстве'' материала. Для чего, в свою очередь, следует «взять на вооружение» следующие простые правила:
# всегда указывать ''источник'' заимствования; ''желательно'' — в ''кратком описании'' соответствующего изменения (например: ''Перенесено из [[<nowiki />w:42 (число)]].''); если этого по какой-либо причине не было сделано, ''допустимо'' указать источник на «странице обсуждения»;
# если переносимый материал подлежит удалению <em >из истории</em> исходного проекта (как, например, при удалении из проекта исходной страницы в целом), для сохранения авторства необходимо перенести ''полную историю изменений'' исходной страницы; сделать это может любой администратор по запросу участника на странице [[Викиучебник:Запросы к администраторам]].
 
Эти же правила применимы и при переносе материала между страницами Викиучебника, а равно и при заимствовании доступных на условиях CC BY-SA 3.0 (или менее строгих CC BY, CC0, {{lang |la|etc.}}) материалов любых других ресурсов Всемирной паутины; в последнем случае — с той лишь оговоркой, что необходимая информация об источнике и авторстве может оказаться слишком подробной для ''краткого описания.'' При этом, такую информацию ''необходимо'' привести на «странице обсуждения».
 
Наконец, для заимствования материалов, условия распространения которых неизвестны или несовместимы с CC BY-SA 3.0, ''необходимо'' получить разрешение правообладателя [[w:Википедия:Получение разрешений |по форме OTRS.]]
 
=== Степень готовности ===
 
''Степень готовности'' учебников и составляющих их страниц указывается, с одной стороны, чтобы помочь читателю выбрать наиболее подходящий материал, с другой — как способ информирования участников о возможных направлениях улучшения материала.
 
Определять степень готовности можно по-разному. Следующие соображения, однако, представляются применимыми в наиболее общем случае:
# степень готовности должна прямо следовать из соответствия фактически представленного материала — заявленному в «аннотации»; предполагается, что <em >оценить</em> степень такого соответствия может любой знакомый с предметом участник проекта;
# по-видимому, степень готовности учебника в целом <em >не должна превышать</em> степени готовности любого из ''основных разделов'';
# решение о том, какие разделы считать «основными», принимается опять-таки на основании их соответствия «аннотации» к учебнику; в спорных случаях — решение остается за ''сообществом редакторов'' конкретного учебника.
 
== Организационная деятельность ==
 
Любая «организационная деятельность» начинается с обсуждений. Тем участникам, которым она интересна, следует обратить внимание на следующие страницы.
* [[Викиучебник:Общий форум]] — и его [[Special:PrefixIndex/Викиучебник:Общий форум/Архив/ |архив.]]
* [[Викиучебник:К удалению]] ([[:Категория:Викиучебник:Незакрытые обсуждения удаления страниц |текущие обсуждения]] '''·''' [[Special:PrefixIndex/Викиучебник:К удалению/ |полный список]].)
* [[Викиучебник:Запросы к администраторам]]
* [[Викиучебник:К переименованию]] ([[:Категория:Викиучебник:Незакрытые обсуждения переименования страниц |текущие обсуждения]] '''·''' [[Special:PrefixIndex/Викиучебник:К переименованию/ |полный список]].)
* [[Викиучебник:К восстановлению]]
 
Следующие страницы также существуют в проекте, однако по различным причинам фактически не используются.
* [[Викиучебник:Форум администраторов]] — коль скоро в проекте активны лишь два [[Викиучебник:Администраторы |администратора,]] для обсуждения возникающих между ними вопросов им вполне хватает личных «страниц обсуждения».
* [[Викиучебник:Планы и заявки]] — изначально предназначалась для информирования сообщества о (планируемом) размещении нового материала и поиска заинтересованных в работе над ним. В настоящее время для этой цели, как правило, используется [[Викиучебник:Общий форум |общий форум.]]
 
<strong >Обратите внимание</strong>, что ввиду сравнительно небольшой активности в проекте в целом, однотипные изменения количеством от пяти и более уже могут считаться ''массовыми'' и требовать предварительного согласования с сообществом Викиучебника (через [[Викиучебник:Общий форум |общий форум]]), — или ''сообществом редакторов учебника,'' если предполагаемые изменения затрагивают лишь один конкретный учебник.
 
Разумеется, чтобы успешно применять и улучшать правила и руководства проекта, следует для начала их изучить, для чего будет полезно обратиться к странице [[Викиучебник:Список правил и руководств]] и категории [[:Категория:Викиучебник:Правила и руководства]].
 
Отметим отдельно, что хотя опыт участия в других проектах [[w:Фонд Викимедиа |Фонда]] может оказаться полезным и в Викиучебнике, отдельные правила, а равно и практика их применения, могут существенно отличаться. Так, например, правило [[w:Википедия:Чем не является Википедия#Не инструкция |«не инструкция»]] Википедии к Викиучебнику применимо [[Викиучебник:Что такое Викиучебник#Викиучебник — не энциклопедия |лишь с обратным знаком.]]
 
=== Категоризация ===
 
: См. также: [[Викиучебник:Категоризация]], [[Викиучебник:Шаблоны]].
 
Для отнесения страниц основного пространства к тематическим и служебным категориям используется ряд шаблонов, включая [[#Многостраничный учебник |упомянутые выше]] {{tl |Темы}}, {{tl |Готовность}} и {{tl |BookCat}}.
 
Викиучебник постоянно развивается и накопленным материалам может стать «тесно» в рамках единой ''темы''. В таком случае, может быть полезно выделить часть из них в новую тему — для создания которой применим нижеследующий рецепт. Этот же рецепт будет полезен и в случае, когда для конкретной темы не создано ''категории всех учебников'' или страницы в пространстве [[Special:PrefixIndex/Полка: |Полка:]]. (Что, отметим, весьма вероятно — коль скоро используемые на таких страницах шаблоны существуют в проекте лишь с декабря 2014 г.)
 
<ol>
<li ><p >Воспользуйтесь [[Служебная:Поиск |поиском]], включив в него в том числе пространство имен [[Special:PrefixIndex/Категория: |Категория:]] — не исключено, что подходящая или достаточно близкая тема уже существует.</p></li>
<li ><p >Создайте новую страницу с именем вида <code >Категория:<var >Название темы</var></code> по следующему образцу.</p>
{{do wrap |Описание темы, со ссылкой на одноименную страницу в пространстве имен [[Special:PrefixIndex/Полка: |Полка:]] — <code ><nowiki >'''</nowiki>[[<nowiki />Полка:<var >Название темы</var> |<var >текст ссылки</var>]]<nowiki >'''</nowiki></code>.| elt = var}}
[[<nowiki />Категория:<var >Первая родительская тема</var>]]
[[<nowiki />Категория:<var >Вторая родительская тема</var>]]
{{do wrap |Ссылки на данную категорию в других языковых разделах — если существуют.| elt = var}}
<p >Здесь же можно применить и шаблон {{tl |Нав}} — в случае, если аналогичные категории существуют и в других проектах [[w:Фонд Викимедиа |Фонда Викимедиа.]]</p>
<p ><strong >Обратите внимание</strong>, что существующие в проекте шаблоны, поддерживающие пространство [[Special:PrefixIndex/Полка: |Полка:]], не позволяют отнести какую-либо тему более чем к двум родительским. (В случае необходимости, это ограничение можно обойти создав «дерево» или «цепь» тем.)</p></li>
<li ><p >Создайте также страницу ''категории всех учебников'' для данной темы — <code >Категория:<var >Название темы</var>/все учебники</code> — следующего содержания:</p>
{{tl |Категория всех}}&lt;noinclude&gt;
{{do wrap |&lt;!-- Пожалуйста добавляйте ссылки на другие языковые разделы ниже. Спасибо. --&gt;}}
&lt;/noinclude&gt;
</li>
<li ><p >Наконец, создайте для данной темы страницу в пространстве [[Special:PrefixIndex/Полка: |Полка:]] — <code >Полка:<var >Название темы</var></code>, взяв за основу следующий образец.</p>
{{<nowiki />[[Шаблон:Страница темы |Страница темы]]
| родитель = {{do wrap |Первая родительская тема| elt = var}}
| родитель2 = {{do wrap |Вторая родительская тема| elt = var}}
| описание = {{do wrap |Описание темы, со ссылкой на подходящую статью Википедии — <code ><nowiki >'''</nowiki>[[<nowiki />w:<var >Статья</var> |<var >текст ссылки</var>]]<nowiki >'''</nowiki></code>.| elt = var}}
}}&lt;noinclude&gt;
{{do wrap |&lt;!-- Пожалуйста добавляйте категории и ссылки на другие языковые разделы ниже. Спасибо. --&gt;}}
&lt;/noinclude&gt;
</li>
<li ><p >На всех этапах выше полезно использовать функцию ''предварительного просмотра'' для проверки корректности оформления создаваемых страниц.</p></li>
</ol>
 
=== Административные обсуждения ===
 
Помочь решению «административных» вопросов может любой опытный участник — потратив собственное время и силы на оформление так называемого «предварительного итога» по конкретному обсуждению, а также, возможно, — устранив проблему или проблемы, явившиеся основанием для исходного запроса. Никаких особых «технических привилегий» («флагов») для этого не требуется.
 
В некоторых случаях, [[Викиучебник:К удалению |запрос на удаление]] — или [[Викиучебник:Запросы к администраторам |запрос к администраторам]] в общем — может быть полностью исчерпан действиями непривилегированного участника. В таких случаях, администратору остается лишь формально «утвердить» итог и завершить обсуждение.
 
Чтобы возразить против принятых администратором <em >действий,</em> следует переименовать раздел ''Итог'' в ''Оспоренный итог'' и привести собственный вариант разрешения проблемы и доводы в его пользу — <strong >обязательно подкрепив их</strong> ссылками на правила, принципы, или ''административную практику'' Викиучебника, или же (в отсутствие таковых) — других проектов [[w:Фонд Викимедиа |Фонда Викимедиа.]]
 
С другой стороны, комментарии (пожелания, предложения) по использованной в «итоге» <em >формулировке</em> следует оставлять на «странице обсуждения» подводящего итог администратора.
 
<strong >Обратите внимание</strong>, что обсуждение формально считается закрытым с момента подведения итога участником с соответствующими привилегиями; продолжить такое обсуждение можно лишь ''оспорив'' итог как указано выше. В некоторых случаях, подводящий итог участник может установить шаблон {{tl |закрыто}} — как напоминание о завершении обсуждения (в частности — при подведении итога после оспаривания.) В общем случае, однако, подобные шаблоны последовательно используются лишь для закрытия страниц в целом, а не отдельных обсуждений.
 
Участникам, которым удается создавать новые запросы на выполнение административных действий чаще, чем администраторам удается подводить итоги по таким запросам, имеет смысл [[Викиучебник:Заявки на статус администратора |оформить заявку]] на получение привилегий администратора.
 
== См. также ==
 
<!-- Примерно в порядке уменьшения важности. -->
* [[Викиучебник:Что такое Викиучебник]]
* [[Викиучебник:Справка]]
* [[Викиучебник:Как использовать Викиучебник]]
* [[Вики]]
* [[Викиучебник:Администраторы]]
* [[Викиучебник:Категоризация]]
* [[w:Фонд Викимедиа|Фонд Викимедиа]]
* {{Meta-inline|Special:MyLanguage/Administrator|Администратор|кратко = 1}}
 
[[Категория:Викиучебник:Справка]]