Difference between revisions of "RU/rules/titles"

From Wiki
Jump to navigationJump to search
(Уточнение формулировок)
(Существенное дополнение раздела WIKI-кодирование — WIKI-coding)
Line 141: Line 141:
 
{{Doc/doc/code/tbl/strL10n
 
{{Doc/doc/code/tbl/strL10n
 
  |nom=3.1.
 
  |nom=3.1.
  |l1=Каждая статья в зоне RU, независимо от используемого принципа создания заголовка, должна начинаться со следующего кода:
+
  |l1=Каждая статья в зоне RU, за исключением служебных страниц (не предназначенных для самостоятельного просмотра), независимо от используемого принципа создания заголовка, должна начинаться со следующего кода:
<pre><section begin=title /><noinclude>
+
<span style="color:#8B4513"><nowiki><section begin=title /><noinclude></nowiki>
{{DISPLAYTITLE:Префикс заголовка</noinclude>Заголовок<noinclude>}}
+
<nowiki>{{DISPLAYTITLE:</nowiki><span style="color:green">'''ПРЕФИКС'''</span><nowiki></noinclude></nowiki><span style="color:green">'''НАИМЕНОВАНИЕ СТАТЬИ'''</span><nowiki><noinclude></nowiki><span style="color:green">'''СУФФИКС'''</span><nowiki>}}</nowiki>
</noinclude><section end=title />
+
<nowiki></noinclude><section end=title /></nowiki></span>
</pre>
 
 
Данный код обеспечивает создание локализованных заголовков статей и локализованных ссылок на статьи.
 
Данный код обеспечивает создание локализованных заголовков статей и локализованных ссылок на статьи.
* '''Префикс заголовка''' - необязательная часть заголовка, которая не извлекается при автоматическом создании локализованной ссылки на статью;
 
* '''Заголовок''' - обязательная часть заголовка, включаемая в автоматически создаваемую локализованную ссылку.
 
 
  |l2=  
 
  |l2=  
 
}}
 
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=
 +
|l1=Разберём этот код:
 +
* <span style="color:#8B4513"><nowiki>{{DISPLAYTITLE:...}}</nowiki></span> — системный шаблон для вставки локализованного заголовка страницы, который помещается в тэге заголовка страницы первого уровня H1. К сожалению, на данный момент содержимое  тэга {{Tag|DISPLAYTITLE}} можно только определить внутри статьи и невозможно считать из вне. Это заставило разработчиков Энциклопедии искать обходные пути, позволяющие использовать название страницы на других страницах и в элементах навигации.
 +
* <span style="color:green">'''ПРЕФИКС'''</span> и <span style="color:green">'''СУФФИКС'''</span> — необязательная часть заголовка, которая не извлекается при автоматическом создании локализованной ссылки на статью.
 +
* <span style="color:green">'''НАИМЕНОВАНИЕ СТАТЬИ'''</span> — обязательная часть заголовка, включаемая в автоматически создаваемую локализованную ссылку.
 +
* <span style="color:#8B4513"><nowiki><noinclude>...</noinclude></nowiki></span> — текст, помещённый внутрь секции {{Tag|noincude|1}} будет отображаться при непосредственном просмотре страницы, но будет скрываться при вставке страницы внутри другой страницы. Секция-антагонист называется {{Tag|includeonly|1}} — её содержимое будет отображаться только при внедрении содержимого страницы в другие документы. Текст на странице, который не попадает ни в одну из секций, будет отображаться всегда. Такая разметка широко используется при оформлении шаблонов: в секцию {{Tag|noincude|1}} помещается документация к шаблону, а в секцию {{Tag|includeonly|1}} — код шаблона.
 +
* <span style="color:#8B4513"><nowiki><section begin=title />...<section end=title /></nowiki></span> — начало и конец секции с именем '''title''', которая и импортируется в качестве значения шаблоном {{Tl|SecTitle}}.
 +
|l2=
 +
}}
 
{{Doc/doc/code/tbl/strL10n
 
{{Doc/doc/code/tbl/strL10n
 
  |nom=3.2.
 
  |nom=3.2.
  |l1=Данный код обеспечивает работу шаблона {{Tl|SecTitle}}
+
  |l1=Описанный в п. 3.1. код обеспечивает работу шаблона {{Tl|SecTitle}} — опорного шаблона Энциклопедии, на котором строится вся система внутренних ссылок на статьи Энциклопедии в пределах данной Wiki.
 
  |l2=
 
  |l2=
 
}}
 
}}
{{Doc/doc/code/tbl/strL10n
+
<!--{{Doc/doc/code/tbl/strL10n
 
  |nom=3.3.
 
  |nom=3.3.
 
  |l1=
 
  |l1=
 
  |l2=
 
  |l2=
}}
+
}}-->
 
{{Doc/doc/code/tbl/titleL1L2
 
{{Doc/doc/code/tbl/titleL1L2
 
  |nom=4.
 
  |nom=4.

Revision as of 20:26, 23 October 2010

Правила Энциклопедии    —    Rules Encyclopedia Template:RUdraftpage Template:RUbeingedited


РУС ENG
1.

Общие положения    —    Terms

1.1. Настоящая инструкция регулирует исключительно создание заголовков, помещаемых в специальный тег {{DISPLAYTITLE}}.
1.2. Для разделов зоны RU используется научный принцип создания заголовка, если не указано иное. Отдельные разделы зоны RU требуют иных принципов построения заголовков.
1.3. Каждый раздел, в котором действуют отличный от научного принцип создания заголовка перечисляется в настоящем документе и для него излагается соответствующий ему принцип, технология и описание использования.


2.

Принципы именования    —    Principles of naming

2.1.

Научный принцип    —    Natural (literary) principle

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


2.1.2.

Технология    —    Technology

2.1.2.1. Главный принцип — как именно предмет статьи называется в научной литературе — таким должно быть и её название в Энциклопедии.


2.1.3.

Использование    —    Use

2.1.3.1. Для статей используется научный принцип создания заголовков.


2.2.

Картотечный (библиотечный, словарный, формальный) принцип    —    Filing (library, vocabulary, formal) principle

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


2.2.2.

Технология    —    Technology

2.2.2.1. Главный принцип — кодификация заголовка. При этом эстетичность уходит на второй план, уступая место технологичности. Основной упор делается на точность и однозначность, а также на особенности восприятия информации пользователями — наиболее значимое слово ставится в начале заголовка, остальные пишутся после него через запятую или выносятся в круглые скобки, не учитывая или учитывая лишь отчасти частотность использования словосочетания в языке. Выделяют до трёх уровней значимости.
2.2.2.2. Так, в статье "Особенности форматирования ячеек таблицы" явно присутствуют два уровня значимости:
  • таблица (первый / высший уровень) - наиболее точный и краткий идентификатор объекта статьи;
  • ячейка (второй уровень) - вспомогательный, уточняющий идентификатор объекта статьи.

И только затем, после точки, пишется остальной текст заголовка.

2.2.2.3. Следовательно, кодифицированный заголовок будет выглядеть следующим образом:

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

2.2.2.4. Иногда картотечный заголовок совпадает с научным.


2.2.3.

Использование    —    Use

2.2.3.1. Картотечные заголовки обладают следующими свойствами:
  • Простота категоризации:

При включении статей в категории и поиске их по индексу.

  • Удобство работы читателя

При сортировке по алфавиту позволяет сгруппировать статьи об однородных объектах.

  1. Стандарт в печатных изданиях и библиотечных каталогах.
  2. Быстрота восприятия: наиболее значимый идентификатор помещается в начале заголовка, поэтому, читателю нужно меньше времени на его анализ.
  3. Простота и удобство: при включении статей в категории и поиске их по индексу.
2.2.3.2. Единственным значимым недостатком картотечных заголовков является их искусственность.


3.

WIKI-кодирование    —    WIKI-coding

3.1. Каждая статья в зоне RU, за исключением служебных страниц (не предназначенных для самостоятельного просмотра), независимо от используемого принципа создания заголовка, должна начинаться со следующего кода:
<section begin=title /><noinclude>
{{DISPLAYTITLE:ПРЕФИКС</noinclude>НАИМЕНОВАНИЕ СТАТЬИ<noinclude>СУФФИКС}}
</noinclude><section end=title />

Данный код обеспечивает создание локализованных заголовков статей и локализованных ссылок на статьи.

Разберём этот код:
  • {{DISPLAYTITLE:...}} — системный шаблон для вставки локализованного заголовка страницы, который помещается в тэге заголовка страницы первого уровня H1. К сожалению, на данный момент содержимое тэга {{DISPLAYTITLE}} можно только определить внутри статьи и невозможно считать из вне. Это заставило разработчиков Энциклопедии искать обходные пути, позволяющие использовать название страницы на других страницах и в элементах навигации.
  • ПРЕФИКС и СУФФИКС — необязательная часть заголовка, которая не извлекается при автоматическом создании локализованной ссылки на статью.
  • НАИМЕНОВАНИЕ СТАТЬИ — обязательная часть заголовка, включаемая в автоматически создаваемую локализованную ссылку.
  • <noinclude>...</noinclude> — текст, помещённый внутрь секции <noincude> будет отображаться при непосредственном просмотре страницы, но будет скрываться при вставке страницы внутри другой страницы. Секция-антагонист называется <includeonly> — её содержимое будет отображаться только при внедрении содержимого страницы в другие документы. Текст на странице, который не попадает ни в одну из секций, будет отображаться всегда. Такая разметка широко используется при оформлении шаблонов: в секцию <noincude> помещается документация к шаблону, а в секцию <includeonly> — код шаблона.
  • <section begin=title />...<section end=title /> — начало и конец секции с именем title, которая и импортируется в качестве значения шаблоном {{SecTitle}}.
3.2. Описанный в п. 3.1. код обеспечивает работу шаблона {{SecTitle}} — опорного шаблона Энциклопедии, на котором строится вся система внутренних ссылок на статьи Энциклопедии в пределах данной Wiki.


4.

Разделы, использующие картотечные заголовки    —    Sections using filing headlines

4.1. Картотечный принцип построения заголовков используется в следующих разделах Энциклопедии:


Template:RUsignyear Template:RUsigntransEng






К началу страницы