Difference between revisions of "RU/rules/writing articles"

From Wiki
Jump to navigationJump to search
(Код приведён в соответствие с правилами. Обновлено содержание.)
Line 1: Line 1:
−
<section begin=title /><noinclude>{{DISPLAYTITLE:</noinclude>Инструкция по написанию статей на национальной языковой странице&nbsp;RU<noinclude>}}</noinclude><section end=title />
+
<section begin=title /><noinclude>{{DISPLAYTITLE:</noinclude>Инструкция по написанию статей на национальной языковой странице&nbsp;RU{{Doc/doc/code/tbl/titleSeparator}}Instruction. Writing articles<noinclude>}}</noinclude><section end=title />
 
{{BreadCrumbL10n}}
 
{{BreadCrumbL10n}}
 
__NOTOC__
 
__NOTOC__
−
 
+
{{Rules}}
−
== 0. О статьях ==
+
<section begin=toc/>
−
 
+
{{Doc/doc/code/tbl/begin
−
:0.1 Настоящая Инструкция регулирует вопросы создания статей в пределах национальной языковой страницы RU и исполняет [[RU/rules_and_information_policy|Положение о национальной языковой странице RU и информационную политику]].
+
|l1=РУС
−
 
+
}}
−
:0.2. Для публикации отбираются статьи, удовлетворяющие следующим критериям:
+
{{Doc/doc/code/tbl/titleL1L2
−
::0.2.1 '''соответствие тематике ресурса''' - рассмотрение вопросов, связанных с {{OOo}}.
+
|nom=0.
−
::0.2.2 '''актуальность''' - изложенный материал должен иметь практическую ценность;
+
|l1=О статьях
−
::0.2.3 '''цельность''' - отдельный, самодостаточный информационный объект;
+
|l2=About Articles
−
::0.2.4 '''системность''' - интегрироваться в установленную информационную структуру;
+
|level=2
−
::0.2.5 '''завершённость''' - статья может находиться в состоянии "черновика" разумное время, далее - удаляется;
+
}}
−
::0.2.6 '''соответствие настоящему своду Правил'''.
+
{{Doc/doc/code/tbl/strL10n
−
 
+
|nom=0.1.
−
 
+
|l1=Настоящая Инструкция регулирует вопросы создания статей в пределах национальной языковой страницы RU и исполняет [[RU/rules_and_information_policy|Положение о национальной языковой странице RU и информационную политику]].
−
== 1. Создание статей ==
+
|l2=
−
=== 1.1. Что представляют собой статьи ===
+
}}
−
: 1.1.1. Каждая статья представляет собой законченное сообщение по отдельной теме. При необходимости статья может быть разбита не несколько частей.
+
{{Doc/doc/code/tbl/strL10n
−
 
+
|nom=0.2.
−
: 1.1.2. Объединение нескольких тем в одну статью не допускается.
+
|l1=Для публикации отбираются статьи, удовлетворяющие следующим критериям:
−
 
+
|l2=
−
=== 1.2. Заголовки статей и их URL ===
+
}}
−
: 1.2.1. При создании нового заголовка следует учитывать [[RU/instructions_for_writing_articles/technical_limitations|технические ограничения]].
+
{{Doc/doc/code/tbl/strL10n
−
====  1.2.2. URL ====
+
|nom=0.2.1.
−
: 1.2.2.1. Каждая русскоязычная страница является дочерней по отношению к национальной языковой странице '''RU'''.
+
|l1='''соответствие тематике ресурса''' - рассмотрение вопросов, связанных с {{OOo}}.
−
 
+
|l2=
−
: 1.2.2.2. Поэтому каждая страница должна начинаться с имени «'''RU'''» и следующего за ним символа «'''/'''».
+
}}
−
 
+
{{Doc/doc/code/tbl/strL10n
−
: 1.2.2.3. Таким образом, в имени каждой статьи используется следующий префикс:
+
|nom=0.2.2.
−
  RU/
+
|l1='''актуальность''' - изложенный материал должен иметь практическую ценность;
−
{{Documentation/Caution| 1.2.2.4. Запрещается создание статей без префикса «'''RU/'''» в имени (URL'е)}}  
+
|l2=
−
{{Documentation/Note| 1.2.2.5. Регистр важен! URL wiki чувствителен к регистру.}}
+
}}
−
{{Documentation/Caution| 1.2.2.6. Запрещается использование в URL заглавных букв (кроме префикса RU/). Исключением является пространство имён «'''Template:'''».}}  
+
{{Doc/doc/code/tbl/strL10n
−
{{Documentation/Caution| 1.2.2.7. Запрещается создание статей с названиями транслитом (название статьи должно быть переведено на английский язык, а не транслитерировано). Для раздела [[RU/knowledge_base|"База Знаний"]] действуют [[RU/kb/knowledge base rules|особые условия]] наименования статей.}}  
+
|nom=0.2.3.
−
{{Documentation/Caution| 1.2.2.8. Запрещается использование кирилических символов в URL}}
+
|l1='''цельность''' - отдельный, самодостаточный информационный объект;
−
{{Documentation/Caution| 1.2.2.9. Запрещается использование в URL знаков препинания (кроме подчёркивания и дефиса) и пробелов}}  
+
|l2=
−
 
+
}}
−
: 1.2.2.10. Каждая статья создаётся со следующем именем:<br>
+
{{Doc/doc/code/tbl/strL10n
 +
|nom=0.2.4.
 +
|l1='''системность''' - интегрироваться в установленную информационную структуру;
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=0.2.5.
 +
|l1='''завершённость''' - статья может находиться в состоянии "черновика" разумное время, далее - удаляется;
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=0.2.6.
 +
|l1='''соответствие настоящему своду Правил'''.
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/titleL1L2
 +
|nom=1.
 +
|l1=Создание статей
 +
|l2=
 +
|level=2
 +
}}
 +
{{Doc/doc/code/tbl/titleL1L2
 +
|nom=1.1.
 +
|l1=Что представляют собой статьи
 +
|l2=
 +
|level=3
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.1.1.
 +
|l1=Каждая статья представляет собой законченное сообщение по отдельной теме. При необходимости статья может быть разбита не несколько частей.
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.1.2.
 +
|l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ объединение нескольких тем в одну статью.}}
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/titleL1L2
 +
|nom=1.2.
 +
|l1=Заголовки статей и их URL
 +
|l2=
 +
|level=3
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.2.1.
 +
|l1=При создании нового заголовка следует учитывать [[RU/instructions_for_writing_articles/technical_limitations|технические ограничения]].
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/titleL1L2
 +
|nom=1.2.2.
 +
|l1=URL
 +
|l2=URL
 +
|level=4
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
  |nom=1.2.2.1.
 +
|l1=Каждая русскоязычная страница является дочерней по отношению к национальной языковой странице '''RU'''.
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
  |nom=1.2.2.2.
 +
|l1=Поэтому каждая страница должна начинаться с имени «'''RU'''» и следующего за ним символа «'''/'''».
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
  |nom=1.2.2.3.
 +
|l1=Таким образом, в имени каждой статьи используется следующий префикс:<pre>RU/</pre>
 +
  |l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.2.2.4.
 +
|l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ создание статей без префикса «'''RU/'''» в имени (URL'е)}}
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.2.2.5.
 +
|l1={{Documentation/Note|Регистр важен! URL wiki чувствителен к регистру.}}
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.2.2.6.
 +
|l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ использование в URL заглавных букв (кроме префикса RU/). Исключением является пространство имён «'''Template:'''».}}
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.2.2.7.
 +
|l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ создание статей с названиями транслитом (название статьи должно быть переведено на английский язык, а не транслитерировано). Для раздела [[RU/knowledge_base|«База Знаний»]] действуют [[RU/kb/knowledge base rules|особые условия]] наименования статей.}}
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.2.2.8.
 +
|l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ использование кирилических символов в URL}}
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.2.2.9.
 +
|l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ использование в URL знаков препинания и пробелов (кроме подчёркивания и дефиса).}}
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
  |nom=1.2.2.10.
 +
|l1= Каждая статья создаётся со следующем именем:<br>
 
::'''RU/name_page''' где:<br>
 
::'''RU/name_page''' где:<br>
 
:::'''RU/''' - являются обязательным префиксом имени статьи.<br>
 
:::'''RU/''' - являются обязательным префиксом имени статьи.<br>
−
:::'''name_page''' - переведённое на английский язык название статьи.<br>
+
:::'''name_page''' - переведённое на английский язык название статьи.
−
 
+
|l2=
−
: 1.2.2.11. Если есть необходимость объединить несколько статей в группу, то применяется следующее правило:<br>
+
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
  |nom=1.2.2.11.
 +
|l1=Если есть необходимость объединить несколько статей в группу, то применяется следующее правило:<br>
 
::'''RU/group/name_page''' где:<br>
 
::'''RU/group/name_page''' где:<br>
−
:::'''group''' - общая для статей группа. Групп, следующих через слеш «/», может быть несколько.<br>
+
:::'''group''' - общая для статей группа. Групп, следующих через слеш «/», может быть несколько.
−
 
+
|l2=
−
==== 1.2.3. Заголовки статей====
+
}}
−
 
+
{{Doc/doc/code/tbl/titleL1L2
−
: 1.2.3.1. Первой строкой в статье должен быть указан отображаемый заголовок статьи.<br>
+
|nom=1.2.3.
−
::'''Например:'''<br>
+
|l1=Заголовки статей
−
  <nowiki>{{DISPLAYTITLE:База Знаний: Как сделать, чтобы графический объект при печати был не виден?}}</nowiki><br>
+
|l2=
−
  <nowiki>__NOTOC__</nowiki>
+
|level=3
−
 
+
}}
−
{{Documentation/Caution| 1.2.3.2. Запрещается создание статей без тега <nowiki>{{DISPLAYTITLE:}}</nowiki>}}
+
{{Doc/doc/code/tbl/strL10n
−
 
+
|nom=1.2.3.1.
−
=== 1.3. Категоризация статей===
+
|l1=Заголовки статей создаются в соответствии с инструкцией: {{SecTitle|RU/rules/titles}}
−
: 1.3.1. Каждая статья обязательно должна быть включена минимум в одну категорию. Обычно, тэг категории указывают в первых строках статьи, до начала текста.
+
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.2.3.2.
 +
|l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ создание статей, заголовок которых создан с нарушением {{SecTitle|RU/rules/titles}}.}}
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/titleL1L2
 +
|nom=1.3.
 +
|l1=Категоризация статей
 +
|l2=
 +
|level=3
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.3.1.
 +
|l1= Каждая статья обязательно должна быть включена минимум в одну категорию. Поскольку, для каждого раздела, рубрики и темы в зоне RU разработаны обязательные к применению соответствующие шаблоны подвалов, то тэг категории уже в них включён. Если же подходящего для статьи шаблона подвала не найдено, то тег категории следует указать в последней строке статьи, после текста.
 +
::'''Например:'''<pre>[[Category:RU/kb]]</pre>
 +
  |l2=
 +
}}
 +
{{Doc/doc/code/tbl/titleL1L2
 +
|nom=1.4.
 +
|l1=Подписи статей
 +
|l2=
 +
|level=3
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.4.1.
 +
|l1=Каждая статья подписывается пользователем, её создавшим (создателя). При внесении корректировок изменение имени создателя не допускается.
 +
::Имя создателя проставляется с помощью шаблона {{Tl|RUsign}} с двумя параметрами, где: '''1-й параметр'''  - регистрационное имя автора в системе; '''2-й параметр''' - Имя, которое будет отображено в подписи.
 +
::'''Например:'''
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/exampleBegin}}
 +
{{Doc/doc/code/tbl/exampleStrL10n
 +
  |examp1=<nowiki>{{RUsign|NGarbuz|Н. Е. Гарбуз}}</nowiki>
 +
|examp2={{RUsign|NGarbuz|Н. Е. Гарбуз}}
 +
}}
 +
{{Doc/doc/code/tbl/exampleEnd}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.4.2.
 +
|l1=Под шаблоном с подписью автора указывается номер версии {{OOo}}, текущей на момент написания статьи. Номер версии {{OOo}} проставляется с помощью шаблона {{Tl|RUoooversion}} с одним параметром, в котором указывается № версии.
 +
::'''Например:'''
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/exampleBegin}}
 +
{{Doc/doc/code/tbl/exampleStrL10n
 +
|examp1=<nowiki>{{RUoooversion|3.x}}</nowiki>
 +
|examp2={{RUoooversion|3.x}}
 +
}}
 +
{{Doc/doc/code/tbl/exampleEnd}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=1.4.3.
 +
|l1= Если статья не имеет прямого отношения к версии {{OOo}}, то указывается год написания статьи без указания версии {{OOo}}. В этом случае используется другой шаблон подписи.
 
::'''Например:'''
 
::'''Например:'''
−
  <nowiki>[[Category:RU/kb]]</nowiki>
+
  |l2=
−
 
+
}}
−
: 1.3.2. Для большинства разделов страницы RU и Базы Знаний разработаны шаблоны подвалов (обязательные к применению в соответствующих рубриках), в которых уже указана соответствующая категория. В этом случае использовать тэг <nowiki>[[Category:ххх]]</nowiki> не нужно.
+
{{Doc/doc/code/tbl/exampleBegin}}
−
 
+
{{Doc/doc/code/tbl/exampleStrL10n
−
=== 1.4. Подписи статей===
+
|examp1=<nowiki>{{RUsignyear|AEroshin|А. В. Ерошин|2010}}</nowiki>
−
: 1.4.1. Каждая статья подписывается пользователем, её создавшим (создателя). При внесении корректировок изменение имени создателя не допускается.
+
|examp2={{RUsignyear|Aeroshin|А. В. Ерошин|2010}}
−
::Имя создателя проставляется с помощью шаблона
+
}}
−
<nowiki>{{RU/documentation/sign|login|Фамилия_И_О}}</nowiki>
+
{{Doc/doc/code/tbl/exampleEnd}}
−
:::где:
+
{{Doc/doc/code/tbl/strL10n
−
{|
+
|nom=1.4.4.
−
|&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'''login'''
+
|l1=Последним в статье, после шаблона подписи, вставляется шаблон подвала статьи {{Tag|xxxxxВottom}}, где '''ххххх''' - имя соответствующего раздела. Подробно все шаблоны подвалов описаны в {{SecTitle|RU/templates}}.
−
| - регистрационное имя автора в системе.
+
  |l2=
−
  |-
+
}}
−
  |&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'''Фамилия_И_О'''
+
{{Doc/doc/code/tbl/titleL1L2
−
  | - Имя, которое будет отображено в подписи.
+
  |nom=2.
−
  |}
+
  |l1=Вставка специальных элементов
−
 
+
  |l2=
−
: 1.4.2. Под именем автора проставляется номер версии {{OOo}}, текущей на момент написания статьи.
+
|level=2
−
::Номер версии {{OOo}} проставляется с помощью шаблона
+
}}
−
<nowiki>{{RU/documentation/oooversion|3.x}}</nowiki>
+
{{Doc/doc/code/tbl/titleL1L2
−
:::где '''3.x''' - № версии.
+
|nom=2.1.
−
 
+
|l1=Ссылки на внутренние статьи
−
::'''Например:'''<br>
+
|l2=
−
  <nowiki>{{RU/documentation/sign|NGarbuz|Н. Е. Гарбуз}}</nowiki>
+
  |level=3
−
<nowiki>{{RU/documentation/oooversion|3.x}}</nowiki>
+
}}
−
 
+
{{Doc/doc/code/tbl/strL10n
−
: 1.4.3. Если статья не имеет прямого отношения к версии {{OOo}}, указывается год написания статьи без указания версии {{OOo}}. В этом случае используется другой шаблон.
+
|nom=2.1.1.
−
::'''Например:'''<br>
+
|l1=Ссылки на внутренние статьи в зоне RU данной wiki оформляются с помощью специального шаблона {{Tl|SecTitle}} с одним обязательным параметром - wiki-URL. Например
−
  <nowiki>{{RUsignyear|AEroshin|А. В. Ерошин|2010}}</nowiki>
+
  |l2=
−
 
+
}}
−
: 1.4.4. Статьи оканчиваются обязательной вставкой шаблона после подписи:
+
{{Doc/doc/code/tbl/exampleBegin}}
−
<nowiki>{{xxxxxВottom}}</nowiki>
+
{{Doc/doc/code/tbl/exampleStrL10n
−
::где '''ххххх''' - имя соответствующего раздела.
+
|examp1=<nowiki>{{SecTitle|RU/kb/00000000}}</nowiki>
−
 
+
  |examp2={{SecTitle|RU/kb/00000000}}
−
=== 1.5. Создание перенаправления===
+
}}
−
: 1.5.1 При необходимости для некоторых статей создаются страницы перенаправления с русским названием.
+
{{Doc/doc/code/tbl/exampleEnd}}
−
: 1.5.2. Статьи-перенаправления содержат команду редиректа и шаблон категории.<br>
+
{{Doc/doc/code/tbl/strL10n
−
::'''Например:'''<br>
+
|nom=2.1.2.
−
<nowiki>#Redirect [[RU/kb/00000000]]</nowiki>
+
  |l1=Ссылки на статьи из прочих языковых зон данной wiki оформляются следующим образом:
−
  <nowiki>{{xxxxxВottom}}</nowiki>
+
  |l2=
−
 
+
}}
−
 
+
{{Doc/doc/code/tbl/exampleBegin}}
−
== 2. Вставка специальных элементов ==
+
{{Doc/doc/code/tbl/exampleStrL10n
−
=== 2.1. Ссылки на внутренние статьи===
+
|examp1=<nowiki>[[Main_Page|Главная страница wiki]]</nowiki>
−
: 2.1.1. Ссылки на внутренние статьи данной wiki оформляются следующим образом:<br>
+
|examp2=[[Main_Page|Главная страница wiki]]
−
  <nowiki>[[RU/kb/00000000|00000000 Положение о Базе Знаний]]</nowiki>
+
}}
−
 
+
{{Doc/doc/code/tbl/exampleEnd}}
−
=== 2.2. Вставка кода Star Basic и других языков программирования===
+
{{Doc/doc/code/tbl/titleL1L2
−
: 2.2.1. Для вставки в статьи кода Star Basic ({{OOo}} Basic) следует использовать следующую конструкцию:
+
|nom=2.2.
−
<nowiki><source lang="oobas"></nowiki>
+
|l1=Вставка кода Star Basic и других языков программирования
 +
|l2=
 +
|level=3
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=2.2.1.
 +
|l1=Для вставки в статьи кода Star Basic ({{OOo}} Basic) следует использовать следующую конструкцию: <pre><source lang="oobas">
 
  ...
 
  ...
−
  <nowiki></source></nowiki>
+
  </source></pre>
−
 
+
|l2=
−
{| class="prettytable" style="width:100%"
+
}}
−
!style="width:50%"|Код
+
{{Doc/doc/code/tbl/exampleBegin}}
−
!style="width:50%"|Результат
+
{{Doc/doc/code/tbl/exampleStrL10n
−
|-
+
  |examp1=<pre><source lang="oobas">
−
  |
+
  function MyFunc()
−
<nowiki><source lang="oobas"></nowiki>
+
    MyFunc = 1
−
  <nowiki>function MyFunc()</nowiki>
+
  end function
−
<nowiki>  MyFunc = 1</nowiki>
+
  </source></pre>
−
  <nowiki>end function</nowiki>
+
  |examp2=<source lang="oobas">
−
  <nowiki></source></nowiki>
 
−
 
 
−
  |<source lang="oobas">
 
 
function MyFunc()
 
function MyFunc()
 
   MyFunc = 1
 
   MyFunc = 1
 
end function
 
end function
 
</source>
 
</source>
−
 
+
}}
−
|}
+
{{Doc/doc/code/tbl/exampleEnd}}
−
 
+
{{Doc/doc/code/tbl/strL10n
−
: 2.2.2. '''source lang''' поддерживет синтаксис следующих языков:
+
|nom=2.2.2.
−
::abap, actionscript, actionscript3, ada, apache, applescript, apt_sources, asm, asp, autoit, avisynth, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, cil, cmake, cobol, cpp, cpp-qt, csharp, css, d, dcs, delphi, diff, div, dos, dot, eiffel, email, erlang, fo, fortran, freebasic, genero, gettext, glsl, gml, gnuplot, groovy, haskell, hq9plus, html4strict, idl, ini, inno, intercal, io, java, java5, javascript, kixtart, klonec, klonecpp, latex, lisp, locobasic, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, matlab, mirc, modula3, mpasm, mxml, mysql, nsis, oberon2, objc, ocaml, ocaml-brief, oobas, oracle11, oracle8, pascal, per, perl, php, php-brief, pic16, pixelbender, plsql, povray, powershell, progress, prolog, properties, providex, python, qbasic, rails, rebol, reg, robots, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, tcl, teraterm, text, thinbasic, tsql, typoscript, vb, vbnet, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xml, xorg_conf, xpp, z80
+
|l1='''source lang''' поддерживет синтаксис следующих языков:
−
 
+
|l2=
−
== 3. Употребление наименований {{OOo}} и OpenOffice.org pro ==
+
}}
−
: 3.1. При написании статей и в заголовках статей при упоминании названий {{OOo}}, {{OOo1}}, {{OOo2}}, {{OOo3}} и {{OOoPro}} следует использовать специальные шаблоны:
+
|-
−
{{RUcode|50|<nowiki>{{OOo}}</nowiki>}}
+
|
−
{{RUcode|50|<nowiki>{{OOo1}}</nowiki>}}
+
| colspan="2" |abap, actionscript, actionscript3, ada, apache, applescript, apt_sources, asm, asp, autoit, avisynth, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, cil, cmake, cobol, cpp, cpp-qt, csharp, css, d, dcs, delphi, diff, div, dos, dot, eiffel, email, erlang, fo, fortran, freebasic, genero, gettext, glsl, gml, gnuplot, groovy, haskell, hq9plus, html4strict, idl, ini, inno, intercal, io, java, java5, javascript, kixtart, klonec, klonecpp, latex, lisp, locobasic, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, matlab, mirc, modula3, mpasm, mxml, mysql, nsis, oberon2, objc, ocaml, ocaml-brief, oobas, oracle11, oracle8, pascal, per, perl, php, php-brief, pic16, pixelbender, plsql, povray, powershell, progress, prolog, properties, providex, python, qbasic, rails, rebol, reg, robots, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, tcl, teraterm, text, thinbasic, tsql, typoscript, vb, vbnet, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xml, xorg_conf, xpp, z80
−
{{RUcode|50|<nowiki>{{OOo2}}</nowiki>}}
+
{{Doc/doc/code/tbl/titleL1L2
−
{{RUcode|50|<nowiki>{{OOo3}}</nowiki>}}
+
|nom=3.
−
{{RUcode|50|<nowiki>{{OOoPro}}</nowiki>}}
+
|l1=Употребление наименований {{OOo}} и {{OOoPro}}
−
 
+
|l2=
−
: 3.2. Если в статье встречается прямое употребление названия {{OOo}} и/или {{OOoPro}}, их следует заменить на соответствующий шаблон.
+
|level=2
−
 
+
}}
−
 
+
{{Doc/doc/code/tbl/strL10n
−
== 4. Употребление наименований {{MSO}} и отдельных его приложений ==
+
|nom=3.1.
−
: 4.1. При написании статей и в заголовках статей при упоминании названий {{MSO}}, {{MSO2003}}, {{MSO2010}}, {{MSW}}, {{MSE}}, {{MSA}}, {{MSPP}} и {{MSEq}} следует использовать специальные шаблоны:
+
|l1=При написании статей и в заголовках статей при упоминании названий {{OOo}}, {{OOo1}}, {{OOo2}}, {{OOo3}} и {{OOoPro}} следует использовать специальные шаблоны: {{Tl|OOo}}, {{Tl|OOo1}}, {{Tl|OOo2}}, {{Tl|OOo3}}, {{Tl|OOoPro}}.
−
{{RUcode|50|<nowiki>{{MSO}}</nowiki>}}
+
|l2=
−
{{RUcode|50|<nowiki>{{MSO2003}}</nowiki>}}
+
}}
−
{{RUcode|50|<nowiki>{{MSO2010}}</nowiki>}}
+
{{Doc/doc/code/tbl/strL10n
−
{{RUcode|50|<nowiki>{{MSW}}</nowiki>}}
+
|nom=3.2.
−
{{RUcode|50|<nowiki>{{MSE}}</nowiki>}}
+
|l1=Если в статье встречается прямое употребление названия {{OOo}} и/или {{OOoPro}}, их следует заменить на соответствующий шаблон.
−
{{RUcode|50|<nowiki>{{MSA}}</nowiki>}}
+
|l2=
−
{{RUcode|50|<nowiki>{{MSPP}}</nowiki>}}
+
}}
−
{{RUcode|50|<nowiki>{{MSEq}}</nowiki>}}
+
{{Doc/doc/code/tbl/titleL1L2
−
 
+
|nom=4.
−
: 4.2. Если в статье встречается прямое употребление названий  {{MSO}}, {{MSO2003}}, {{MSO2010}}, {{MSW}}, {{MSE}}, {{MSA}}, {{MSPP}} и/или {{MSEq}}, их следует заменить на соответствующий шаблон.
+
|l1=Употребление наименований {{MSO}} и отдельных его приложений
−
 
+
|l2=
−
== 5. Обязательные элементы построения статей ==
+
|level=2
−
: 5.1. Для создания русскоязычного заголовка следует использовать тег:
+
}}
−
  <nowiki>{{DISPLAYTITLE:Русское наименование статьи}}</nowiki>
+
{{Doc/doc/code/tbl/strL10n
−
 
+
|nom=4.1.
−
: 5.2. Если статья Базы Знаний, то указывается ссылка на рубрику
+
|l1=При написании статей и в заголовках статей при упоминании названий {{MSO}}, {{MSO2003}}, {{MSO2010}}, {{MSW}}, {{MSE}}, {{MSA}}, {{MSPP}} и {{MSEq}} следует использовать специальные шаблоны: {{Tl|MSO}}, {{Tl|MSO2003}}, {{Tl|MSO2010}}, {{Tl|MSW}}, {{Tl|MSE}}, {{Tl|MSA}}, {{Tl|MSPP}}, {{Tl|MSEq}}.
−
  <nowiki>[[RU/kb/xxx|База Знаний: Рубрика]]</nowiki>
+
|l2=
−
 
+
}}
−
: 5.3. Затем отключаем оглавление (необязательно, но желательно)
+
{{Doc/doc/code/tbl/strL10n
−
  <nowiki>__NOTOC__</nowiki>
+
|nom=4.2.
−
 
+
|l1=Если в статье встречается прямое употребление названий  {{MSO}}, {{MSO2003}}, {{MSO2010}}, {{MSW}}, {{MSE}}, {{MSA}}, {{MSPP}} и/или {{MSEq}}, их следует заменить на соответствующий шаблон.
−
: 5.4. Далее следует основной текст статьи.
+
|l2=
−
: 5.4.1. Если статья Базы Знаний, то указывается ссылка на индекс (соответствующий)
+
}}
−
<nowiki>[[RU/kb/index/20|Индекс: Calc]]</nowiki>
+
{{Doc/doc/code/tbl/titleL1L2
−
: 5.4.2. В конце ставится подпись
+
|nom=5.
−
<nowiki>{{RUsignyear|Ivanov|И. И. Иванов|2010}}</nowiki>
+
|l1=Обязательные элементы построения статей
−
: 5.4.3. Если статья касается конкретной версии {{OOo}}, то вместо предыдущего шаблона, применяются два других:
+
|l2=
−
<nowiki>{{RU/documentation/sign|Ivanov|И. И. Иванов}}</nowiki>
+
|level=2
−
<nowiki>{{RU/documentation/oooversion|3.3.x}}</nowiki>
+
}}
−
: 5.4.4. Последней строкой указывается шаблон подвала
+
{{Doc/doc/code/tbl/strL10n
−
  <nowiki>{{Kb____рубрика______Вottom}}</nowiki>
+
|nom=5.1.
 +
|l1=Создания русскоязычного заголовка описано в п. 1.2.3.1.
 +
  |l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=5.2.
 +
|l1=Сразу за заголовком следует шаблон «хлебных крошек» {{Tl|BreadCrumbL10n}} без параметра. Для статей из «Базы Знаний» в шаблоне {{Tl|BreadCrumbL10n}} следует указать в качестве параметра wiki-URL темы, к которой относиться статья.
 +
  |l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=5.3.
 +
  |l1=Следом за «хлебными крошками» указывается магическое слово '''<nowiki>__NOTOC__</nowiki>''' для отключения локального оглавления статьи. Включать локальное оглавление в статье следует только в виде исключения при наличии серьёзной необходимости. Для этого указывается магическое слово '''<nowiki>__TOC__</nowiki>'''
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=5.4.
 +
|l1=Далее следует основной текст статьи, который помещается внутрь секции '''toc''':
 +
|l2=
 +
}}
 +
|-
 +
|
 +
| colspan="2" |<pre><section begin=toc/>
 +
...Основной текст статьи...
 +
<section end=toc/></pre>
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=5.5.
 +
|l1=В конце ставится подпись<pre><nowiki>{{RUsignyear|Ivanov|И. И. Иванов|2010}}</nowiki></pre>
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=5.6.
 +
|l1=Если статья касается конкретной версии {{OOo}}, то вместо предыдущего шаблона, применяются два других:<pre>{{RU/documentation/sign|Ivanov|И. И. Иванов}}
 +
{{RU/documentation/oooversion|3.3.x}}</pre>
 +
|l2=
 +
}}
 +
{{Doc/doc/code/tbl/strL10n
 +
|nom=5.7.
 +
|l1=Последней строкой указывается шаблон подвала, описанный в п. 1.4.4.
 +
  |l2=
 +
}}
 +
{{Doc/doc/code/tbl/end}}
 +
<section end=toc/>
  
  
 +
<section begin=signature/>
 
{{RUsignyear|Sancho|А. Е. Харламенков|2010}}
 
{{RUsignyear|Sancho|А. Е. Харламенков|2010}}
−
{{RUBottom}}
+
{{RUsigntransEng|Denis0.ru|Denis V Chernosov }}
 +
{{RUrulesBottom}}
 +
<section end=signature/>

Revision as of 21:04, 1 November 2010

Rules.png




№ РУС ENG
0.

О статьях    —    About Articles

0.1. Настоящая Инструкция регулирует вопросы создания статей в пределах национальной языковой страницы RU и исполняет Положение о национальной языковой странице RU и информационную политику.
0.2. Для публикации отбираются статьи, удовлетворяющие следующим критериям:
0.2.1. соответствие тематике ресурса - рассмотрение вопросов, связанных с OpenOffice.org.
0.2.2. актуальность - изложенный материал должен иметь практическую ценность;
0.2.3. цельность - отдельный, самодостаточный информационный объект;
0.2.4. системность - интегрироваться в установленную информационную структуру;
0.2.5. завершённость - статья может находиться в состоянии "черновика" разумное время, далее - удаляется;
0.2.6. соответствие настоящему своду Правил.


1.

Создание статей    —    

1.1.

Что представляют собой статьи    —    

1.1.1. Каждая статья представляет собой законченное сообщение по отдельной теме. При необходимости статья может быть разбита не несколько частей.
1.1.2.
Documentation caution.png ЗАПРЕЩАЕТСЯ объединение нескольких тем в одну статью.


1.2.

Заголовки статей и их URL    —    

1.2.1. При создании нового заголовка следует учитывать технические ограничения.


1.2.2.

URL    —    URL

1.2.2.1. Каждая русскоязычная страница является дочерней по отношению к национальной языковой странице RU.
1.2.2.2. Поэтому каждая страница должна начинаться с имени «RU» и следующего за ним символа «/».
1.2.2.3. Таким образом, в имени каждой статьи используется следующий префикс:
RU/
1.2.2.4.
Documentation caution.png ЗАПРЕЩАЕТСЯ создание статей без префикса «RU/» в имени (URL'е)
1.2.2.5.
Documentation note.png Регистр важен! URL wiki чувствителен к регистру.
1.2.2.6.
Documentation caution.png ЗАПРЕЩАЕТСЯ использование в URL заглавных букв (кроме префикса RU/). Исключением является пространство имён «Template:».
1.2.2.7.
Documentation caution.png ЗАПРЕЩАЕТСЯ создание статей с названиями транслитом (название статьи должно быть переведено на английский язык, а не транслитерировано). Для раздела «База Знаний» действуют особые условия наименования статей.
1.2.2.8.
Documentation caution.png ЗАПРЕЩАЕТСЯ использование кирилических символов в URL
1.2.2.9.
Documentation caution.png ЗАПРЕЩАЕТСЯ использование в URL знаков препинания и пробелов (кроме подчёркивания и дефиса).
1.2.2.10. Каждая статья создаётся со следующем именем:
RU/name_page где:
RU/ - являются обязательным префиксом имени статьи.
name_page - переведённое на английский язык название статьи.
1.2.2.11. Если есть необходимость объединить несколько статей в группу, то применяется следующее правило:
RU/group/name_page где:
group - общая для статей группа. Групп, следующих через слеш «/», может быть несколько.


1.2.3.

Заголовки статей    —    

1.2.3.1. Заголовки статей создаются в соответствии с инструкцией: Инструкция. Заголовки статей    —    Guidelines. Article titles
1.2.3.2.
Documentation caution.png ЗАПРЕЩАЕТСЯ создание статей, заголовок которых создан с нарушением Инструкция. Заголовки статей    —    Guidelines. Article titles.


1.3.

Категоризация статей    —    

1.3.1. Каждая статья обязательно должна быть включена минимум в одну категорию. Поскольку, для каждого раздела, рубрики и темы в зоне RU разработаны обязательные к применению соответствующие шаблоны подвалов, то тэг категории уже в них включён. Если же подходящего для статьи шаблона подвала не найдено, то тег категории следует указать в последней строке статьи, после текста.
Например:
[[Category:RU/kb]]


1.4.

Подписи статей    —    

1.4.1. Каждая статья подписывается пользователем, её создавшим (создателя). При внесении корректировок изменение имени создателя не допускается.
Имя создателя проставляется с помощью шаблона {{RUsign}} с двумя параметрами, где: 1-й параметр - регистрационное имя автора в системе; 2-й параметр - Имя, которое будет отображено в подписи.
Например:
Шаблон    —    template Результат    —    result
{{RUsign|NGarbuz|Н. Е. Гарбуз}} Template:RUsign
1.4.2. Под шаблоном с подписью автора указывается номер версии OpenOffice.org, текущей на момент написания статьи. Номер версии OpenOffice.org проставляется с помощью шаблона {{RUoooversion}} с одним параметром, в котором указывается № версии.
Например:
Шаблон    —    template Результат    —    result
{{RUoooversion|3.x}} Template:RUoooversion
1.4.3. Если статья не имеет прямого отношения к версии OpenOffice.org, то указывается год написания статьи без указания версии OpenOffice.org. В этом случае используется другой шаблон подписи.
Например:
Шаблон    —    template Результат    —    result
{{RUsignyear|AEroshin|А. В. Ерошин|2010}} Template:RUsignyear
1.4.4. Последним в статье, после шаблона подписи, вставляется шаблон подвала статьи {{xxxxxВottom}}, где ххххх - имя соответствующего раздела. Подробно все шаблоны подвалов описаны в [[RU/templates|RU/templates]].


2.

Вставка специальных элементов    —    

2.1.

Ссылки на внутренние статьи    —    

2.1.1. Ссылки на внутренние статьи в зоне RU данной wiki оформляются с помощью специального шаблона {{SecTitle}} с одним обязательным параметром - wiki-URL. Например
Шаблон    —    template Результат    —    result
{{SecTitle|RU/kb/00000000}} Шаблоны. Шаблон по умолчанию
2.1.2. Ссылки на статьи из прочих языковых зон данной wiki оформляются следующим образом:
Шаблон    —    template Результат    —    result
[[Main_Page|Главная страница wiki]] Главная страница wiki
2.2.

Вставка кода Star Basic и других языков программирования    —    

2.2.1. Для вставки в статьи кода Star Basic (OpenOffice.org Basic) следует использовать следующую конструкцию: 
<source lang="oobas">
 ...
 </source>
Шаблон    —    template Результат    —    result 
<source lang="oobas">
 function MyFunc()
    MyFunc = 1
 end function
 </source>
 
function MyFunc()
   MyFunc = 1
end function
2.2.2. source lang поддерживет синтаксис следующих языков:
abap, actionscript, actionscript3, ada, apache, applescript, apt_sources, asm, asp, autoit, avisynth, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_mac, caddcl, cadlisp, cfdg, cfm, cil, cmake, cobol, cpp, cpp-qt, csharp, css, d, dcs, delphi, diff, div, dos, dot, eiffel, email, erlang, fo, fortran, freebasic, genero, gettext, glsl, gml, gnuplot, groovy, haskell, hq9plus, html4strict, idl, ini, inno, intercal, io, java, java5, javascript, kixtart, klonec, klonecpp, latex, lisp, locobasic, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, make, matlab, mirc, modula3, mpasm, mxml, mysql, nsis, oberon2, objc, ocaml, ocaml-brief, oobas, oracle11, oracle8, pascal, per, perl, php, php-brief, pic16, pixelbender, plsql, povray, powershell, progress, prolog, properties, providex, python, qbasic, rails, rebol, reg, robots, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, tcl, teraterm, text, thinbasic, tsql, typoscript, vb, vbnet, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xml, xorg_conf, xpp, z80
3.

Употребление наименований OpenOffice.org и OpenOffice.org pro    —    

3.1. При написании статей и в заголовках статей при упоминании названий OpenOffice.org, OpenOffice.org 1.x, OpenOffice.org 2.x, OpenOffice.org 3.x и OpenOffice.org pro следует использовать специальные шаблоны: {{OOo}}, {{OOo1}}, {{OOo2}}, {{OOo3}}, {{OOoPro}}.
3.2. Если в статье встречается прямое употребление названия OpenOffice.org и/или OpenOffice.org pro, их следует заменить на соответствующий шаблон.


4.

Употребление наименований Microsoft Office и отдельных его приложений    —    

4.1. При написании статей и в заголовках статей при упоминании названий Microsoft Office, Microsoft Office 2003, Microsoft Office 2010, MS Word, MS Excel, MS Access, MS Power Point и MS Equation следует использовать специальные шаблоны: {{MSO}}, {{MSO2003}}, {{MSO2010}}, {{MSW}}, {{MSE}}, {{MSA}}, {{MSPP}}, {{MSEq}}.
4.2. Если в статье встречается прямое употребление названий Microsoft Office, Microsoft Office 2003, Microsoft Office 2010, MS Word, MS Excel, MS Access, MS Power Point и/или MS Equation, их следует заменить на соответствующий шаблон.


5.

Обязательные элементы построения статей    —    

5.1. Создания русскоязычного заголовка описано в п. 1.2.3.1.
5.2. Сразу за заголовком следует шаблон «хлебных крошек» {{BreadCrumbL10n}} без параметра. Для статей из «Базы Знаний» в шаблоне {{BreadCrumbL10n}} следует указать в качестве параметра wiki-URL темы, к которой относиться статья.
5.3. Следом за «хлебными крошками» указывается магическое слово __NOTOC__ для отключения локального оглавления статьи. Включать локальное оглавление в статье следует только в виде исключения при наличии серьёзной необходимости. Для этого указывается магическое слово __TOC__
5.4. Далее следует основной текст статьи, который помещается внутрь секции toc: 
<section begin=toc/>
...Основной текст статьи...
<section end=toc/>
5.5. В конце ставится подпись
{{RUsignyear|Ivanov|И. И. Иванов|2010}}
5.6. Если статья касается конкретной версии OpenOffice.org, то вместо предыдущего шаблона, применяются два других:
{{RU/documentation/sign|Ivanov|И. И. Иванов}}
{{RU/documentation/oooversion|3.3.x}}
5.7. Последней строкой указывается шаблон подвала, описанный в п. 1.4.4.



Template:RUsignyear Template:RUsigntransEng




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


Retrieved from "http://wiki.harlamenkov.ru/index.php?title=RU/rules/writing_articles&oldid=5371"