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

Материал из Викиучебника — открытых книг для открытого мира
Содержимое удалено Содержимое добавлено
Нет описания правки
м Правки 81.200.24.125 (обсуждение) откачены к версии Loyna
Строка 1: Строка 1:
{{Навигация}}1
{{Навигация}}


[[Викиучебник]], как&nbsp;и&nbsp;[[w:Википедия|Википедия]], работает по&nbsp;принципу [[w:Вики|«вики»]], и на&nbsp;том&nbsp;же движке&nbsp;— [[w:MediaWiki|«МедиаВики»]]. Поэтому научиться пользоваться Викиучебником можно из&nbsp;<big>[[w:Википедия:Справка|справочных страниц Википедии]]</big>, в&nbsp;особенности:
[[Викиучебник]], как&nbsp;и&nbsp;[[w:Википедия|Википедия]], работает по&nbsp;принципу [[w:Вики|«вики»]], и на&nbsp;том&nbsp;же движке&nbsp;— [[w:MediaWiki|«МедиаВики»]]. Поэтому научиться пользоваться Викиучебником можно из&nbsp;<big>[[w:Википедия:Справка|справочных страниц Википедии]]</big>, в&nbsp;особенности:
Строка 10: Строка 10:
Википедийские [[w:Википедия:Правила и указания|рекомендации по стилю]] применительны и к Викиучебнику, но по мере их осмысленности в отношении учебных текстов: всё же в учебниках часто востребованы повествовательные приёмы, выходящие за границы научного стиля речи.
Википедийские [[w:Википедия:Правила и указания|рекомендации по стилю]] применительны и к Викиучебнику, но по мере их осмысленности в отношении учебных текстов: всё же в учебниках часто востребованы повествовательные приёмы, выходящие за границы научного стиля речи.


== Как читать ==
==Как читать==
Мы надеемся, что Вы без подсказок поймёте, как работать с Викиучебником, — по крайней мере, как продвигаться по его страницам и читать их. Если что-то непонятно, просим о том [http://ru.wikibooks.org/w/index.php?title=Форум&action=edit&section=new оповестить]: мы, завсегдатаи Викиучебника, постараемся помочь Вам и предупредить непонятки у других пользователей.
Мы надеемся, что Вы без подсказок поймёте, как работать с Викиучебником, — по крайней мере, как продвигаться по его страницам и читать их. Если что-то непонятно, просим о том [http://ru.wikibooks.org/w/index.php?title=Форум&action=edit&section=new оповестить]: мы, завсегдатаи Викиучебника, постараемся помочь Вам и предупредить непонятки у других пользователей.


=== Гипертекст ===
===Гипертекст===
Викиучебники составляются как [[w:гипертекст|гипертексты]], а не простые (последовательные, «книжные») тексты. Поэтому, в частности, мы не поясняем прямо тут, что такое «гипертекст», а просто ставим в предыдущем предложении гиперссылку на статью [[w:Википедия|Википедии]].
Викиучебники составляются как [[w:гипертекст|гипертекст]]ы, а не простые (последовательные, «книжные») тексты. Поэтому, в частности, мы не поясняем прямо тут, что такое «гипертекст», а просто ставим в предыдущем предложении гиперссылку на статью [[w:Википедия|Википедии]].


=== Ссылки ===
===Ссылки===
Но ссылки порой ведут не на статьи Википедии, а на другие страницы Викиучебника, или на иные сайты Всемирной сети. Разница указывается оформлением ссылок:
Но ссылки порой ведут не на статьи Википедии, а на другие страницы Викиучебника, или на иные сайты Всемирной сети. Разница указывается оформлением ссылок:
* [[w:Ботва|Ссылка на статью «Ботва» в Википедии]]
* [[w:Ботва|Ссылка на статью «Ботва» в Википедии]]
Строка 23: Строка 23:
* [[Несуществующая страница|Ссылка на несуществующую страницу]]
* [[Несуществующая страница|Ссылка на несуществующую страницу]]


== Что помещать ==
==Что помещать==
Если неочевидна пригодность вносимого текста для Викиучебника, автору следует озадачиться вопросами:
Если неочевидна пригодность вносимого текста для Викиучебника, автору следует озадачиться вопросами:
* Полезно ли знание, предлагаемое текстом, в действительной жизни?
* Полезно ли знание, предлагаемое текстом, в действительной жизни?
* Что мешает назвать это учебником?
* Что мешает назвать это учебником?
** Можно ли от этого избавиться без переработки текста, а лишь добавив нечто?
**Можно ли от этого избавиться без переработки текста, а лишь добавив нечто?
** Можно ли убрать «мешающие» части?
**Можно ли убрать «мешающие» части?
* Вообразимо ли, что этот текст был бы выпущен печатным тиражом и распродан в книжных магазинах?
* Вообразимо ли, что этот текст был бы выпущен печатным тиражом и распродан в книжных магазинах?
Если нет, то текст не подходит Викиучебнику. Однако, наверное, можно оставить его, если он пригодится в качестве подраздела или приложения к одному из существующих полноценных учебников.
Если нет, то текст не подходит Викиучебнику. Однако, наверное, можно оставить его, если он пригодится в качестве подраздела или приложения к одному из существующих полноценных учебников.


== Как начать ==
==Как начать==
Творить учебник трудно. Даже если Вы уверены в достатке знаний, способностей и энтузиазма для написания учебника и [[#Что помещать|его пригодности]] для сайта Викиучебник, сперва:
Творить учебник трудно. Даже если Вы уверены в достатке знаний, способностей и энтузиазма для написания учебника и [[#Что помещать|его пригодности]] для сайта Викиучебник, сперва:
* Решите [[#Именование|о заглавии]].
*Решите [[#Именование|о заглавии]].
* Задумайте подходяющую структуру учебного текста и продумайте, [[#Структурирование|как она будет представлена на сайте]].
*Задумайте подходяющую структуру учебного текста и продумайте, [[#Структурирование|как она будет представлена на сайте]].
* Если требуются, поищите соавторов и ценителей [[Планы и заявки|среди других посетителей сайта]] или инде.
*Если требуются, поищите соавторов и ценителей [[Планы и заявки|среди других посетителей сайта]] или инде.
* Научитесь работать в вики-среде (из [[w:Википедия:Справка|Справки в Википедии]] или из Викиучебника «[[Вики]]») поработайте сперва над существующими текстами (по ходу получая из них знания), поучитесь правильным и изящным [[#Вёрстка|способам оформления]], наладьте себе эффективный набор инструментов для удобства редактирования.
*Научитесь работать в вики-среде (из [[w:Википедия:Справка|Справки в Википедии]] или из Викиучебника «[[Вики]]») поработайте сперва над существующими текстами (по ходу получая из них знания), поучитесь правильным и изящным [[#Вёрстка|способам оформления]], наладьте себе эффективный набор инструментов для удобства редактирования.
* Подумайте, как украсить Ваш текст.
*Подумайте, как украсить Ваш текст.


После этого советуем сопоставить свои замыслы с существующими образцами готовых викиучебников: не повторяйте их ошибок и повторяйте их успехи. Если есть вопросы, задайте их в нашем [[форум]]е. Зарегистрируйтесь: это даст Вам обустроить внешний вид Викиучебника для удобной работы, присвоит Вашему имени все сделанные Вами правки и создаст личную страницу (где можно рассказать о себе) и страницу для личного обращения к Вам от других участников.
После этого советуем сопоставить свои замыслы с существующими образцами готовых викиучебников: не повторяйте их ошибок и повторяйте их успехи. Если есть вопросы, задайте их в нашем [[форум]]е. Зарегистрируйтесь: это даст Вам обустроить внешний вид Викиучебника для удобной работы, присвоит Вашему имени все сделанные Вами правки и создаст личную страницу (где можно рассказать о себе) и страницу для личного обращения к Вам от других участников.
Строка 44: Строка 44:
<big>Как начнёте новый учебник, запишите его на страницу [[Учебники]]</big> и укажите ступень его развития (как у других, пиктограммой). Можете найти соответствующую статью в [[w:Википедия|Википедии]] и поставить на свой учебник ссылку с помощью шаблона <code>[[w:Шаблон:Викиучебник|<nowiki>{{</nowiki>Викиучебник<nowiki>}}</nowiki>]]</code>.
<big>Как начнёте новый учебник, запишите его на страницу [[Учебники]]</big> и укажите ступень его развития (как у других, пиктограммой). Можете найти соответствующую статью в [[w:Википедия|Википедии]] и поставить на свой учебник ссылку с помощью шаблона <code>[[w:Шаблон:Викиучебник|<nowiki>{{</nowiki>Викиучебник<nowiki>}}</nowiki>]]</code>.


=== Не уповайте ===
===Не уповайте===
Гадаете, почему у нас [[Учебники|так много покинутых недописок]]? Многие начинают их с расчётом, что по появлении одной-двух еле законченных глав со всех концов Рунета тотчас прибегут трудолюбивые соавторы и сделают всю работу по замыслу начинателя.
Гадаете, почему у нас [[Учебники|так много покинутых недописок]]? Многие начинают их с расчётом, что по появлении одной-двух еле законченных глав со всех концов Рунета тотчас прибегут трудолюбивые соавторы и сделают всю работу по замыслу начинателя.


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


== Структурирование ==
==Структурирование==
Упорядочивать сведения учебника и подразделять их надо разумно, радея об удобстве чтения и скорости создания [[w:вики|вики]]-текста.
Упорядочивать сведения учебника и подразделять их надо разумно, радея об удобстве чтения и скорости создания [[w:вики|вики]]-текста.


=== Помещение одной страницей ===
===Помещение одной страницей===
Обычно — лучший способ с бесспорными достоинствами. Первое — удобство сохранения страницы на локальном компьютере и вывода на печать. Второе — автоматически создающийся, структурированный список всех подзаголовков, дающий удобные гипертекстовые ссылки на любой озаглавленный подраздел страницы.
Обычно — лучший способ с бесспорными достоинствами. Первое — удобство сохранения страницы на локальном компьютере и вывода на печать. Второе — автоматически создающийся, структурированный список всех подзаголовков, дающий удобные гипертекстовые ссылки на любой озаглавленный подраздел страницы.
При этом способе не теряется возможность ссылания на отдельные подразделы: нужно всего лишь после адреса ссылки поставить:
При этом способе не теряется возможность ссылания на отдельные подразделы: нужно всего лишь после адреса ссылки поставить:
Строка 58: Строка 58:
Это будет работать со внутренними <nowiki>[[вики-ссылками]]</nowiki>. А для внешней ссылки адрес можно получить из вышеупомянутого списка содержания (иначе не сработает, ибо в URL-строке русские буквы должны кодироваться <code>%D0%92%D0%BE%D1%82</code> так).
Это будет работать со внутренними <nowiki>[[вики-ссылками]]</nowiki>. А для внешней ссылки адрес можно получить из вышеупомянутого списка содержания (иначе не сработает, ибо в URL-строке русские буквы должны кодироваться <code>%D0%92%D0%BE%D1%82</code> так).


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


Если же автор хочет увести внимание читателя на другую страницу, он может просто поставить гиперссылку на неё<ref>Если же нужно вместе со ссылкой дать пояснение, используйте [[w:Википедия:Сноски|сноски]] вместо внутритекстовых гиперссылок.</ref>. Например, если Вы ещё не знаете, как делать гиперссылки, можете перейти к странице [[w:Википедия:Как править статьи|Википедия:Как править статьи]] в Википедии. А ещё можете прочесть самоописание [[Викиучебник]]а.
Если же автор хочет увести внимание читателя на другую страницу, он может просто поставить гиперссылку на неё<ref>Если же нужно вместе со ссылкой дать пояснение, используйте [[w:Википедия:Сноски|сноски]] вместо внутритекстовых гиперссылок.</ref>. Например, если Вы ещё не знаете, как делать гиперссылки, можете перейти к странице [[w:Википедия:Как править статьи|Википедия:Как править статьи]] в Википедии. А ещё можете прочесть самоописание [[Викиучебник]]а.


==== Сноски ====
====Сноски====
<references />
<references />


=== Объединяющее именование ===
===Объединяющее именование===
Можно именовать главы так, что читателю легко угадать название всего учебника, например:
Можно именовать главы так, что читателю легко угадать название всего учебника, например:
* Уход за питомцами: Кормление
* Уход за питомцами: Кормление
* Уход за питомцами Купание
* Уход за питомцами - Купание
''Такие способы применять '''не стоит''''', ибо есть другой, при котором автоматически создаётся гиперссылка на раздел «уровнем выше»:
''Такие способы применять '''не стоит''''', ибо есть другой, при котором автоматически создаётся гиперссылка на раздел «уровнем выше»:
* Уход за питомцами/Прогулка
* Уход за питомцами/Прогулка
Строка 75: Строка 75:
; <code><nowiki>[[/Прогулка]]</nowiki></code>:приведёт читателя на страницу [[Уход за питомцами/Прогулка]].
; <code><nowiki>[[/Прогулка]]</nowiki></code>:приведёт читателя на страницу [[Уход за питомцами/Прогулка]].


=== Вспомогательные ссылки ===
===Вспомогательные ссылки===
Бывает полезно поместить заметную и наглядную ссылку на связанную страницу обособленно от текста, например: «К оглавлению», «Следующая глава: ''(Заголовок)''», «Углублённые темы:» и тому подобные. Можно применять стрелочки ←→↑↓ и другие [[w:Википедия:Специальные символы|спецсимволы]]. Можно оформлять [[w:HTML|HTML]]’ом и [[w:CSS|CSS]]’ом, при умении.
Бывает полезно поместить заметную и наглядную ссылку на связанную страницу обособленно от текста, например: «К оглавлению», «Следующая глава: ''(Заголовок)''», «Углублённые темы:» и тому подобные. Можно применять стрелочки ←→↑↓ и другие [[w:Википедия:Специальные символы|спецсимволы]]. Можно оформлять [[w:HTML|HTML]]’ом и [[w:CSS|CSS]]’ом, при умении.


==== Меню ====
====Меню====
Легко создать меню для викиучебника, то есть меню в интернетном смысле: список гиперссылок на подразделы сайта, а в нашем случае — на страницы данного викиучебника.
Легко создать меню для викиучебника, то есть меню в интернетном смысле: список гиперссылок на подразделы сайта, а в нашем случае — на страницы данного викиучебника.
# Создаёте особую страницу с приставкой '''«Шаблон:»'''. (Пример: [[Шаблон:ОФП Содержание]].)
# Создаёте особую страницу с приставкой '''«Шаблон:»'''. (Пример: [[Шаблон:ОФП Содержание]].)
Строка 85: Строка 85:
Не беспокойтесь о ссылках на текущую страницу: таковые всегда будут '''выделены''' и «отключены» в качестве гиперссылок. Пример: [[Викиучебник:Справка]].
Не беспокойтесь о ссылках на текущую страницу: таковые всегда будут '''выделены''' и «отключены» в качестве гиперссылок. Пример: [[Викиучебник:Справка]].


=== Категории ===
===Категории===
Любая страница может быть помещена в [[w:Википедия:Категории|категории]], которые также могут быть вложены.
Любая страница может быть помещена в [[w:Википедия:Категории|категории]], которые также могут быть вложены.


Строка 94: Строка 94:
Так составлена [[Кулинарная книга]].
Так составлена [[Кулинарная книга]].


=== Включение страниц ===
===Включение страниц===
Всё содержимое страницы можно включить в другую, вот так:
Всё содержимое страницы можно включить в другую, вот так:
<code><nowiki>{{:Название включаемой страницы}}</nowiki></code>
<code><nowiki>{{:Название включаемой страницы}}</nowiki></code>
(Увы, древеса категорий так не включаются.) Так можно, например, делать одностраничные версии подразделённых учебников или отдельных глав, — пригодится для создания печатных версий учебников.
(Увы, древеса категорий так не включаются.) Так можно, например, делать одностраничные версии подразделённых учебников или отдельных глав, — пригодится для создания печатных версий учебников.


== Именование ==
==Именование==
Именовать страницы и подразделы страниц следует по разумным правилам, указанным далее в порядке предпочтения.
Именовать страницы и подразделы страниц следует по разумным правилам, указанным далее в порядке предпочтения.


=== Правила русского языка и типографики ===
===Правила русского языка и типографики===
Викиучебник стремится стать серьёзным образовательным изданием. Обязательно соблюдать правила русского языка и русской [[w:Типографика|типографики]]. В частности, не заменяйте в названиях букву [[w:Ё|ё]] иными.
Викиучебник стремится стать серьёзным образовательным изданием. Обязательно соблюдать правила русского языка и русской [[w:Типографика|типографики]]. В частности, не заменяйте в названиях букву [[w:Ё|ё]] иными.


Строка 111: Строка 111:
! style="width:50%;text-align:left;color:#060;"|Правильное
! style="width:50%;text-align:left;color:#060;"|Правильное
|-
|-
| style="text-align:left"| Слово «алгоритм» Происхождение и развитие
| style="text-align:left"| Слово "алгоритм" - Происхождение и развитие
| style="text-align:left"| [[Слово «алгоритм»: происхождение и развитие]]
| style="text-align:left"| [[Слово «алгоритм»: происхождение и развитие]]
|}
|}


=== Соображения удобства и красоты ===
===Соображения удобства и красоты===
В [[w:Вики|вики]]-среде удобство заглавия страницы определяется, в первую очередь, его краткостью: чем короче оно, тем легче поставить на данный документ как вики-ссылку с другой страницы, так и общесетевую [[w:URL|URL]]-ссылку. Ещё один аспект удобства — удобочитаемость; краткость названия при этом — также положительный фактор, но есть и другие: следует избегать неакронимных сокращений («И. П. Сидоров и др.» и т. п.), чередования языков и алфавитов, неоднозначных и малоизвестных слов.
В [[w:Вики|вики]]-среде удобство заглавия страницы определяется, в первую очередь, его краткостью: чем короче оно, тем легче поставить на данный документ как вики-ссылку с другой страницы, так и общесетевую [[w:URL|URL]]-ссылку. Ещё один аспект удобства — удобочитаемость; краткость названия при этом — также положительный фактор, но есть и другие: следует избегать неакронимных сокращений («И. П. Сидоров и др.» и т. п.), чередования языков и алфавитов, неоднозначных и малоизвестных слов.


Строка 128: Строка 128:
|}
|}


=== Соответствие сути ===
===Соответствие сути===


Название учебника должно определять его содержание; не быть частным, если повествует об общей теме, и наоборот; совсем уж нельзя ложно представлять суть учебного текста. Но, следуя этим соображениям, нельзя жертвовать краткостью и удобством заглавия страницы. Оно может быть верным, но не совершенно точным, и такое вполне допустимо.
Название учебника должно определять его содержание; не быть частным, если повествует об общей теме, и наоборот; совсем уж нельзя ложно представлять суть учебного текста. Но, следуя этим соображениям, нельзя жертвовать краткостью и удобством заглавия страницы. Оно может быть верным, но не совершенно точным, и такое вполне допустимо.
Строка 140: Строка 140:
|}
|}


=== Понятность ===
===Понятность===


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


* Загадочно-масонское: [[LOR-FAQ]]
*Загадочно-масонское: [[LOR-FAQ]]
* Не понимаете? И не надо : [[Suomen kieli käyttöön]]
*Не понимаете? И не надо : [[Suomen kieli käyttöön]]
* Жаргон : [[Свойства оператора свёртки]]
*Жаргон : [[Свойства оператора свёртки]]
* «Названия не переводятся» : [[Ruby]], [[Microsoft Excel]]
*«Названия не переводятся» : [[Ruby]], [[Microsoft Excel]]
* …но иногда всё же поясняются: [[Язык программирования D]]
*…но иногда всё же поясняются: [[Язык программирования D]]
* Заголовки журнальных статей : [[Знакомство с методом математической индукции]]
*Заголовки журнальных статей : [[Знакомство с методом математической индукции]]
* Понятное, хоть и неформальное, название: [[Математика случая]]
*Понятное, хоть и неформальное, название: [[Математика случая]]
* Заглавие, хотевшее стать оглавлением: [[Защита конфиденциальных данных и анонимность в интернете]]
*Заглавие, хотевшее стать оглавлением: [[Защита конфиденциальных данных и анонимность в интернете]]


=== Перенаправления ===
===Перенаправления===
Обязательно ставьте [[w:Википедия:Перенаправления|перенаправления]] со всех распространённых альтернативных или ошибочных вариантов названия на правильный.
Обязательно ставьте [[w:Википедия:Перенаправления|перенаправления]] со всех распространённых альтернативных или ошибочных вариантов названия на правильный.


== Вёрстка ==
==Вёрстка==
{{рамка}}Можно и нужно использовать возможности украшения текста. Это когда наглядно различается обычный повествовательный текст, <code>строки кода</code>, математические переменные (например <math>x</math> или <math>\Omega</math>),
{{рамка}}Можно и нужно использовать возможности украшения текста. Это когда наглядно различается обычный повествовательный текст, <code>строки кода</code>, математические переменные (например <math>x</math> или <math>\Omega</math>),
* обычные списки и
*обычные списки и
;списки : определений,
;списки : определений,
{{Эпиграф|эпиграфы оформляются как эпиграфы,|иногда с указанием автора, места и времени;}}
{{Эпиграф|эпиграфы оформляются как эпиграфы,|иногда с указанием автора, места и времени;}}
Строка 164: Строка 164:
или <span style="color:brown;background:#f8fafc;border:thin dotted red;padding:0.3em;">посредством [[w:CSS|CSS]]</span>.
или <span style="color:brown;background:#f8fafc;border:thin dotted red;padding:0.3em;">посредством [[w:CSS|CSS]]</span>.
{{info|1=Набор вспомогательных ''шаблонов''{{Ref|shablony}} сбережёт время на создании часто применяемых элементов оформления.}}
{{info|1=Набор вспомогательных ''шаблонов''{{Ref|shablony}} сбережёт время на создании часто применяемых элементов оформления.}}
* {{Note|shablony}} — Список всех шаблонов можно найти [http://ru.wikibooks.org/w/index.php?title=%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F%3AAllpages&from=&namespace=10 на служебной странице «Allpages»]
*{{Note|shablony}} — Список всех шаблонов можно найти [http://ru.wikibooks.org/w/index.php?title=%D0%A1%D0%BB%D1%83%D0%B6%D0%B5%D0%B1%D0%BD%D0%B0%D1%8F%3AAllpages&from=&namespace=10 на служебной странице «Allpages»]
{{Внимание|'''Чрезмерная избыточность не нужна'''<br />
{{Внимание|'''Чрезмерная избыточность не нужна'''<br />
Не увлекайтесь шибко красочными значками и разноцветными рамками.}}
Не увлекайтесь шибко красочными значками и разноцветными рамками.}}
Строка 173: Строка 173:
Если надо вывести что-то без обработки вики-разметки, используйте метку <code><nowiki><nowiki></nowiki></nowiki></code>, например <code><nowiki><nowiki>{{Внимание|[[w:Еда|]]}}</nowiki></nowiki></code> выдаст <nowiki>{{Внимание|[[w:Еда|]]}}</nowiki>, а не как обычно.
Если надо вывести что-то без обработки вики-разметки, используйте метку <code><nowiki><nowiki></nowiki></nowiki></code>, например <code><nowiki><nowiki>{{Внимание|[[w:Еда|]]}}</nowiki></nowiki></code> выдаст <nowiki>{{Внимание|[[w:Еда|]]}}</nowiki>, а не как обычно.


=== Раскраска программного кода ===
===Раскраска программного кода===
Работает так: <code><nowiki><source lang="ruby">3.times{print "Мур!"}</source></nowiki></code> превращается в:<source lang="ruby">3.times{print "Мур!"}</source>
Работает так: <code><nowiki><source lang="ruby">3.times{print "Мур!"}</source></nowiki></code> превращается в:<source lang="ruby">3.times{print "Мур!"}</source>
{{акмар}}
{{акмар}}


== Настройка вывода, копирование и печать ==
==Настройка вывода, копирование и печать==
[[w:Википедия:Регистрация|Зарегистрировавшись]], Вы можете [[w:Википедия:Настройки|настроить интерфейс Викиучебника]]. Сохранять локальную копию страницы покамест не получается без досадных изменений в её облике; мы работаем над этим.
[[w:Википедия:Регистрация|Зарегистрировавшись]], Вы можете [[w:Википедия:Настройки|настроить интерфейс Викиучебника]]. Сохранять локальную копию страницы покамест не получается без досадных изменений в её облике; мы работаем над этим.


Строка 184: Строка 184:
# В настройках печати уберите весь дополнительный служебный текст (разве только номер страницы можно оставить) и излишне широкие поля.
# В настройках печати уберите весь дополнительный служебный текст (разве только номер страницы можно оставить) и излишне широкие поля.
# Там же настройте масштаб страницы. Если на странице есть изображения (некоторые формулы также выводятся картинками), то масштабировать следует с оглядкой на искажения картинок.
# Там же настройте масштаб страницы. Если на странице есть изображения (некоторые формулы также выводятся картинками), то масштабировать следует с оглядкой на искажения картинок.
#* Желательно масштабировать с таким шагом: 25 %, 50 %, 100 %, 200 %
#* Желательно масштабировать с таким шагом: 25%, 50%, 100%, 200%
# Желательно сохранить все элементы оформления страницы (цвета/фон/изображения/стиль) неизменными.
# Желательно сохранить все элементы оформления страницы (цвета/фон/изображения/стиль) неизменными.
# Проверьте, показан/спрятан ли как надо блок «содержание» в начале книги
# Проверьте, показан/спрятан ли как надо блок «содержание» в начале книги
Строка 191: Строка 191:


== meta wants your opinion ==
== meta wants your opinion ==
:: ''Начата дискуссия по выбору логотипа для [[meta:Wikibooks/Logo|Wikibooks]] и [[meta:Wikijunior/Logo|Wikijunior]]. Все викиавторы приглашаются к участию в ней.''
::''Начата дискуссия по выбору логотипа для [[meta:Wikibooks/Logo|Wikibooks]] и [[meta:Wikijunior/Logo|Wikijunior]]. Все викиавторы приглашаются к участию в ней.''


[[da:Wikibooks:Hjælp]]
[[da:Wikibooks:Hjælp]]

Версия от 15:55, 18 мая 2009

ПесочницаКак писать учебники и руководстваСписок правил и руководствОбщий форум — Планы и заявки — Голосования 
Удаление страниц — Восстановление страниц — Переименование страниц — Разделение страницОбъединение страниц
Запросы к администраторам — Форум администраторов — Выборы администраторов 

Викиучебник, как и Википедия, работает по принципу «вики», и на том же движке — «МедиаВики». Поэтому научиться пользоваться Викиучебником можно из справочных страниц Википедии, в особенности:

Есть ещё пошаговый викиучебник, пригодный в качестве методического пособия: «Вики».

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

Как читать

Мы надеемся, что Вы без подсказок поймёте, как работать с Викиучебником, — по крайней мере, как продвигаться по его страницам и читать их. Если что-то непонятно, просим о том оповестить: мы, завсегдатаи Викиучебника, постараемся помочь Вам и предупредить непонятки у других пользователей.

Гипертекст

Викиучебники составляются как гипертексты, а не простые (последовательные, «книжные») тексты. Поэтому, в частности, мы не поясняем прямо тут, что такое «гипертекст», а просто ставим в предыдущем предложении гиперссылку на статью Википедии.

Ссылки

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

Что помещать

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

  • Полезно ли знание, предлагаемое текстом, в действительной жизни?
  • Что мешает назвать это учебником?
    • Можно ли от этого избавиться без переработки текста, а лишь добавив нечто?
    • Можно ли убрать «мешающие» части?
  • Вообразимо ли, что этот текст был бы выпущен печатным тиражом и распродан в книжных магазинах?

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

Как начать

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

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

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

Не уповайте

Гадаете, почему у нас так много покинутых недописок? Многие начинают их с расчётом, что по появлении одной-двух еле законченных глав со всех концов Рунета тотчас прибегут трудолюбивые соавторы и сделают всю работу по замыслу начинателя.

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

Структурирование

Упорядочивать сведения учебника и подразделять их надо разумно, радея об удобстве чтения и скорости создания вики-текста.

Помещение одной страницей

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

#Заголовок подраздела

Это будет работать со внутренними [[вики-ссылками]]. А для внешней ссылки адрес можно получить из вышеупомянутого списка содержания (иначе не сработает, ибо в URL-строке русские буквы должны кодироваться %D0%92%D0%BE%D1%82 так).

Контекстные гиперссылки

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

Если же автор хочет увести внимание читателя на другую страницу, он может просто поставить гиперссылку на неё[1]. Например, если Вы ещё не знаете, как делать гиперссылки, можете перейти к странице Википедия:Как править статьи в Википедии. А ещё можете прочесть самоописание Викиучебника.

Сноски

  1. Если же нужно вместе со ссылкой дать пояснение, используйте сноски вместо внутритекстовых гиперссылок.

Объединяющее именование

Можно именовать главы так, что читателю легко угадать название всего учебника, например:

  • Уход за питомцами: Кормление
  • Уход за питомцами - Купание

Такие способы применять не стоит, ибо есть другой, при котором автоматически создаётся гиперссылка на раздел «уровнем выше»:

  • Уход за питомцами/Прогулка

На странице с таким названием будет автоматически стоять гиперссылка на страницу «Уход за питомцами», с которой, в свою очередь, можно ссылаться на подразделы сокращённым способом:

[[/Прогулка]]
приведёт читателя на страницу Уход за питомцами/Прогулка.

Вспомогательные ссылки

Бывает полезно поместить заметную и наглядную ссылку на связанную страницу обособленно от текста, например: «К оглавлению», «Следующая глава: (Заголовок)», «Углублённые темы:» и тому подобные. Можно применять стрелочки ←→↑↓ и другие спецсимволы. Можно оформлять HTML’ом и CSS’ом, при умении.

Меню

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

  1. Создаёте особую страницу с приставкой «Шаблон:». (Пример: Шаблон:ОФП Содержание.)
  2. Сделайте на ней меню. Оформьте его красиво и удобно.
  3. В любом месте, где надо поместить это меню, сделайте вызов шаблона, вот так: {{ОФП Содержание}}. Приставка «Шаблон:» опускается.

Не беспокойтесь о ссылках на текущую страницу: таковые всегда будут выделены и «отключены» в качестве гиперссылок. Пример: Викиучебник:Справка.

Категории

Любая страница может быть помещена в категории, которые также могут быть вложены.

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

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

Так составлена Кулинарная книга.

Включение страниц

Всё содержимое страницы можно включить в другую, вот так:

{{:Название включаемой страницы}}

(Увы, древеса категорий так не включаются.) Так можно, например, делать одностраничные версии подразделённых учебников или отдельных глав, — пригодится для создания печатных версий учебников.

Именование

Именовать страницы и подразделы страниц следует по разумным правилам, указанным далее в порядке предпочтения.

Правила русского языка и типографики

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

Заглавие:
Неправильное Правильное
Слово "алгоритм" - Происхождение и развитие Слово «алгоритм»: происхождение и развитие

Соображения удобства и красоты

В вики-среде удобство заглавия страницы определяется, в первую очередь, его краткостью: чем короче оно, тем легче поставить на данный документ как вики-ссылку с другой страницы, так и общесетевую URL-ссылку. Ещё один аспект удобства — удобочитаемость; краткость названия при этом — также положительный фактор, но есть и другие: следует избегать неакронимных сокращений («И. П. Сидоров и др.» и т. п.), чередования языков и алфавитов, неоднозначных и малоизвестных слов.

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

Нелепое Человечное
Руководство по работе со звуком в GNU/Linux Звук в Линуксе

Соответствие сути

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

Лукавое Верное
Курс информатики для школьников 8—9 классов Информационные технологии

Понятность

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

Перенаправления

Обязательно ставьте перенаправления со всех распространённых альтернативных или ошибочных вариантов названия на правильный.

Вёрстка

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

  • обычные списки и
списки
определений,

эпиграфы оформляются как эпиграфы,

иногда с указанием автора, места и времени;

важное выделяется жирностью, кеглем и стилем шрифта или посредством CSS.

Информация

Набор вспомогательных шаблонов[1] сбережёт время на создании часто применяемых элементов оформления.

Вот пример:


Значок пользователя ЖЖ LJ-авторfhtagn или сообщества ru_obrazovanie

Если надо вывести что-то без обработки вики-разметки, используйте метку <nowiki></nowiki>, например <nowiki>{{Внимание|[[w:Еда|]]}}</nowiki> выдаст {{Внимание|[[w:Еда|]]}}, а не как обычно.

Раскраска программного кода

Работает так: <source lang="ruby">3.times{print "Мур!"}</source> превращается в:
3.times{print "Мур!"}

Настройка вывода, копирование и печать

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

Печатать же страницу на принтере советуем так:

  1. Настройте в своём браузере шрифт с засечками и такого кегля, чтобы обычный текст сравнялся по величине с формулами.
  2. В настройках печати уберите весь дополнительный служебный текст (разве только номер страницы можно оставить) и излишне широкие поля.
  3. Там же настройте масштаб страницы. Если на странице есть изображения (некоторые формулы также выводятся картинками), то масштабировать следует с оглядкой на искажения картинок.
    • Желательно масштабировать с таким шагом: 25%, 50%, 100%, 200%
  4. Желательно сохранить все элементы оформления страницы (цвета/фон/изображения/стиль) неизменными.
  5. Проверьте, показан/спрятан ли как надо блок «содержание» в начале книги
  6. Перейдите к версии страницы для печати и проверьте (в браузере), как он будет смотреться на бумаге.
  7. Проверьте, достаточно ли бумаги в принтере и по желанию настройте двустороннюю печать (как в книге).

meta wants your opinion

Начата дискуссия по выбору логотипа для Wikibooks и Wikijunior. Все викиавторы приглашаются к участию в ней.