Правила по оформлению текстов wiki

Правила и соглашения об оформлении текстов wiki.

  1. Личные и субъективные тексты должны подписываться.
  2. Писать следует грамотно, в соответствии с нормами русского языка. Увидевший опечатку, обязан ее исправить! 8-)
  3. Каждое предложение по возможности следует начинать с новой строки.
  4. Не следует использовать вложенные пространства имен.
  5. Каждая страница должна иметь ровно один заголовок первого уровня. При ссылках на страницу рекомендуется указывать именно его.
  6. Уровни заголовков следует располагать последовательно без пропусков1).
  7. Для выделения слов в тексте рекомендуется использовать подчеркнутый шрифт. Большие блоки текста лучше выделять курсивом.

Правила хорошего стиля

Несколько советов, как писать хорошие вики-страницы.

Структура страниц

  • Начинайте свою страницу с заголовка первого уровня с использованием значимого (осмысленного) названия.
  • Разбивайте текст на параграфы, оставляя одну пустую строку между ними. В среднем, параграф не должен превышать 10–20 строк.
  • Если ваш текст состоит из нескольких параграфов (от 3 до 5), подумайте о разбивке на разделы при помощи добавления заголовков 2–5 уровней.
  • Когда ваш текст начинает занимать больше 2–3-х экранных страниц, вставьте краткий обзор содержимого сразу после первого заголовка на странице.
  • Если у вас много ссылок на другие страницы вики или внешние ссылки, добавьте специальный раздел со ссылками. (Подробности ниже).
  • Если большинство страниц именного пространства имеют схожую структуру, добавьте шаблон, чтобы каждая новая страница могла создаваться с использованием этой структуры.

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

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

Язык

  • Соблюдайте правила грамматики языка, на котором вы пишете. Для английского языка не забывайте использовать артикли.
  • Соблюдайте правила пунктуации — предложения должны быть отделены друг от друга.
  • Пытайтесь писать коротко и ясно. Избегайте большого количества сложно-сочинённых предложений. Когда вы написали страницу, перечитайте её и попробуйте упростить слишком длинные предложения.
  • Решите, как вы будете обращаться к вашим читателям. Так как «ДокуВики» хорошо подходит для написания документации, вам часто придётся давать инструкции вашим читателям о том, как выполнить то или иное действие. При этом вы можете использовать несколько форм обращения к читателю: повелительное наклонение («Сделайте это!..», более мягкую форму мы/вы («После этого мы щёлкаем (вы щёлкаете) на кнопке…»), безличную форму («Необходимо сделать то-то и то-то») или форму с «я» («После этого я добавил кнопку на форму главного окна…»). Не смешивайте различные формы обращения.
  • Перед тем, как сохранить страницу, проверьте текст на отсутствие орфографических и грамматических ошибок. Если ваш текст будет содержать много ошибок, это уменьшит доверие к вашим высказываниям, несмотря на глубину и продуманность высказанного.
  • Придумайте свой стиль. Не пытайтель принудить себя писать в неудобной манере — написанное будет звучать ненатурально и скорее всего текст будет неприятно читать.

Ссылки

  • Если вы сталкиваетесь с термином, который требует подробного разъяснения, добавьте новую страницу для этого термина и сделайте на неё ссылку.
  • Перечитайте вашу страницу перед тем, как закончить над ней работу и добавьте ссылки на уже существующие страницы с описанием главных терминов.
  • Не добавляйте ссылки каждый раз, когда встречается определённый термин. Добавьте ссылку только на первом вхождении или в наиболее подходящем месте и, возможно, приведите дополнительную ссылку в разделе «Смотри также» в конце документа.
  • Предоставляйте ссылки на источники изображений, данных и цитат.
  • Старайтесь добавлять строку «Смотрите также:» в конец страницы. Дальше укажите вики-страницы, которые наиболее близко связаны с темой этой страницы.
  • Если вы решили предоставить читателям ссылки на внешние источники, расширяющие содержание вашей статьи, или те, что вы использовали при её написании, добавьте в конце раздел «Ссылки» или «Дополнительная информация», и поместите в него ссылки или другие указатели (например, номера ISBN) на источники информации. Если этого уже не сделано в основном тексте, то укажите назначение ссылки (например, «на [сайте] размещены дальнейшие советы по тому, как заняться „не-знаю-чем“»).

Картинки, видео и т. п.

  • «Картина красноречивей тысячи слов». Изображение может сказать даже больше, чем вы хотели. Humans tend to question the authenticity of images less than that of language. Короткое текстовое описание лучше, чем ничего или чем некорректное изображение.
  • Также как и с таблицами — всегда подписывайте изображения так, чтобы было ясно, что вы хотите показать. (Например, «Рис. 3.2: Любительское фото с калушатами, трямкающими бутявку на напушке.»)
  • Если вы не автор изображения, укажите источник (возможно со ссылкой) и указанием автора (copyright).
  • Не ссылайтесь на изображения с других сайтов, если не получили на это специального разрешения. Это приводит к расходам трафика сайта-обладателя изображения. Загружайте изображения в вики если есть такая возможность.
  • Если изображение занимает больше, чем треть страницы, используйте ссылку с инструкцией по изменению размера для вставки эскиза изображения.

Комментарии

Приветствуются! :)

1) для оглавления

Обсуждение

Ваш комментарий. вики-синтаксис разрешён:
  _      __   __ __   ____   ___    ____
 | | /| / /  / // /  / __/  / _ \  / __/
 | |/ |/ /  / _  /  / _/   / , _/ / _/  
 |__/|__/  /_//_/  /_/    /_/|_| /___/