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

From Apache OpenOffice Wiki
< RU‎ | rules
Jump to: navigation, search
(Перевод)
(Перевод)
Line 76: Line 76:
 
  |nom=1.
 
  |nom=1.
 
  |l1=Создание статей
 
  |l1=Создание статей
−
  |l2=
+
  |l2=Creating articles
 
  |level=2
 
  |level=2
 
}}
 
}}
Line 82: Line 82:
 
  |nom=1.1.
 
  |nom=1.1.
 
  |l1=Что представляют собой статьи
 
  |l1=Что представляют собой статьи
−
  |l2=
+
  |l2=What are articles
 
  |level=3
 
  |level=3
 
}}
 
}}
Line 88: Line 88:
 
  |nom=1.1.1.
 
  |nom=1.1.1.
 
  |l1=Каждая статья представляет собой законченное сообщение по отдельной теме. При необходимости статья может быть разбита не несколько частей.
 
  |l1=Каждая статья представляет собой законченное сообщение по отдельной теме. При необходимости статья может быть разбита не несколько частей.
−
  |l2=
+
  |l2=Each article is a complete message on a particular topic. If necessary, an article can be broken down into several parts.
 
}}
 
}}
 
{{Doc/doc/code/tbl/strL10n
 
{{Doc/doc/code/tbl/strL10n
 
  |nom=1.1.2.
 
  |nom=1.1.2.
 
  |l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ объединение нескольких тем в одну статью.}}
 
  |l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ объединение нескольких тем в одну статью.}}
−
  |l2=
+
  |l2={{Documentation/Caution|PROHIBITION combine several topics in one article.}}
 
}}
 
}}
 
{{Doc/doc/code/tbl/titleL1L2
 
{{Doc/doc/code/tbl/titleL1L2
 
  |nom=1.2.
 
  |nom=1.2.
 
  |l1=Заголовки статей и их URL
 
  |l1=Заголовки статей и их URL
−
  |l2=
+
  |l2=Titles article and their URL
 
  |level=3
 
  |level=3
 
}}
 
}}
Line 104: Line 104:
 
  |nom=1.2.1.
 
  |nom=1.2.1.
 
  |l1=При создании нового заголовка следует учитывать [[RU/instructions_for_writing_articles/technical_limitations|технические ограничения]].
 
  |l1=При создании нового заголовка следует учитывать [[RU/instructions_for_writing_articles/technical_limitations|технические ограничения]].
−
  |l2=
+
  |l2=When creating a new title should be considered [[RU/instructions_for_writing_articles/technical_limitations|technical restrictions]].
 
}}
 
}}
 
{{Doc/doc/code/tbl/titleL1L2
 
{{Doc/doc/code/tbl/titleL1L2
Line 115: Line 115:
 
  |nom=1.2.2.1.
 
  |nom=1.2.2.1.
 
  |l1=Каждая русскоязычная страница является дочерней по отношению к национальной языковой странице '''RU'''.
 
  |l1=Каждая русскоязычная страница является дочерней по отношению к национальной языковой странице '''RU'''.
−
  |l2=
+
  |l2=Each page of the Russian language is a subsidiary page of the national language page '''RU'''.
 
}}
 
}}
 
{{Doc/doc/code/tbl/strL10n
 
{{Doc/doc/code/tbl/strL10n
 
  |nom=1.2.2.2.
 
  |nom=1.2.2.2.
−
  |l1=Поэтому каждая страница должна начинаться с имени «'''RU'''» и следующего за ним символа «'''/'''».
+
  |l1=На основании п. 1.2.2.1., URL каждой страницы долежн начинаться с имени «'''RU'''» и следующего за ним символа «'''/'''».
−
  |l2=
+
  |l2=Based on paragraph 1.2.2.1., URL of each page should begin with the name «'''RU'''» and the following character «'''/'''».
 
}}
 
}}
 
{{Doc/doc/code/tbl/strL10n
 
{{Doc/doc/code/tbl/strL10n
 
  |nom=1.2.2.3.
 
  |nom=1.2.2.3.
−
  |l1=Таким образом, в имени каждой статьи используется следующий префикс:<pre>RU/</pre>
+
  |l1=На основании пп. 1.2.2.1., 1.2.2.1., в имени каждой статьи используется следующий префикс:<pre>RU/</pre>
−
  |l2=
+
  |l2=Based on paragraphs. 1.2.2.1., 1.2.2.1., in the name of each article, use the following prefix:<pre>RU/</pre>
 
}}
 
}}
 
{{Doc/doc/code/tbl/strL10n
 
{{Doc/doc/code/tbl/strL10n
 
  |nom=1.2.2.4.
 
  |nom=1.2.2.4.
 
  |l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ создание статей без префикса «'''RU/'''» в имени (URL'е)}}  
 
  |l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ создание статей без префикса «'''RU/'''» в имени (URL'е)}}  
−
  |l2=
+
  |l2={{Documentation/Caution|PROHIBITION the creation of articles without the prefix «'''RU/'''» in the name (URL)}}
 
}}
 
}}
 
{{Doc/doc/code/tbl/strL10n
 
{{Doc/doc/code/tbl/strL10n
 
  |nom=1.2.2.5.
 
  |nom=1.2.2.5.
 
  |l1={{Documentation/Note|Регистр важен! URL wiki чувствителен к регистру.}}
 
  |l1={{Documentation/Note|Регистр важен! URL wiki чувствителен к регистру.}}
−
  |l2=
+
  |l2={{Documentation/Note|Important! Wiki URL is case sensitive.}}
 
}}
 
}}
 
{{Doc/doc/code/tbl/strL10n
 
{{Doc/doc/code/tbl/strL10n
 
  |nom=1.2.2.6.
 
  |nom=1.2.2.6.
−
  |l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ использование в URL заглавных букв (кроме префикса RU/). Исключением является пространство имён «'''Template:'''».}}  
+
  |l1={{Documentation/Caution|ЗАПРЕЩАЕТСЯ использование в URL заглавных букв (кроме префикса '''RU/'''). Исключением является пространство имён «'''Template:'''».}}
−
  |l2=
+
  |l2={{Documentation/Caution|PROHIBITION  use the URL capitalization (except for the prefix '''RU/'''). An exception is the namespace «'''Template :'''».}}
 
}}
 
}}
 
{{Doc/doc/code/tbl/strL10n
 
{{Doc/doc/code/tbl/strL10n

Revision as of 12:34, 5 November 2010

Rules.png



№ РУС ENG
0.

О статьях    —    About Articles

0.1. Настоящая Инструкция регулирует вопросы создания статей в пределах национальной языковой страницы RU и исполняет Положение о национальной языковой странице RU и информационную политику. This manual governs the creation of articles in the national language page RU and execute Rules and information policy of national language page RU.
0.2. Для публикации отбираются статьи, удовлетворяющие следующим критериям: For publish selected articles that meet the following criteria:
0.2.1. соответствие тематике ресурса — рассмотрение вопросов, связанных с Apache OpenOffice. are relevant to the resource — to address issues related to Apache OpenOffice.
0.2.2. актуальность — изложенный материал должен иметь практическую ценность; urgency — set out the material should be of practical value;
0.2.3. цельность — отдельный, самодостаточный информационный объект; wholeness — a separate, self-contained information object;
0.2.4. системность — интегрироваться в установленную информационную структуру; systemic — to integrate into the established information structure;
0.2.5. завершённость — статья может находиться в состоянии "черновика" разумное время, далее — удаляется; finality — an article may be able to "draft" a reasonable time after this - deleted;
0.2.6. достоверность — несомненная верность приводимых в статье сведений, проверка которых на опыте показала, что они соответствуют действительности, что даёт возможность использовать их без дополнительной проверки. credibility — no doubt the correctness of the information given in the paper, check that the experience showed that they correspond to reality, which makes it possible to use them without further verification.
0.2.7. непротиворечивость (последовательность) — отсутствие расхождений с другими статьями. consistency (sequence) — no disagreements with other articles.
0.2.8. неповторимость — на одну и ту же тему и по одному и тому же вопросу не может быть двух статей. originality — on the same subject and on the same issue can not be two articles.
0.2.9. соответствие настоящему своду Правил. conformity with this set of rules.
0.3. Статьи, опубликованные с нарушением п. 0.2. удаляются. Articles published in violation of Section 0.2. removed.


1.

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

1.1.

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

1.1.1. Каждая статья представляет собой законченное сообщение по отдельной теме. При необходимости статья может быть разбита не несколько частей. Each article is a complete message on a particular topic. If necessary, an article can be broken down into several parts.
1.1.2.
Documentation caution.png ЗАПРЕЩАЕТСЯ объединение нескольких тем в одну статью.
Documentation caution.png PROHIBITION combine several topics in one article.


1.2.

Заголовки статей и их URL    —    Titles article and their URL

1.2.1. При создании нового заголовка следует учитывать технические ограничения. When creating a new title should be considered technical restrictions.


1.2.2.

URL    —    URL

1.2.2.1. Каждая русскоязычная страница является дочерней по отношению к национальной языковой странице RU. Each page of the Russian language is a subsidiary page of the national language page RU.
1.2.2.2. На основании п. 1.2.2.1., URL каждой страницы долежн начинаться с имени «RU» и следующего за ним символа «/». Based on paragraph 1.2.2.1., URL of each page should begin with the name «RU» and the following character «/».
1.2.2.3. На основании пп. 1.2.2.1., 1.2.2.1., в имени каждой статьи используется следующий префикс:
RU/
 Based on paragraphs. 1.2.2.1., 1.2.2.1., in the name of each article, use the following prefix:
RU/
1.2.2.4.
Documentation caution.png ЗАПРЕЩАЕТСЯ создание статей без префикса «RU/» в имени (URL'е)
Documentation caution.png PROHIBITION the creation of articles without the prefix «RU/» in the name (URL)
1.2.2.5. Template:Documentation/Note Template:Documentation/Note
1.2.2.6.
Documentation caution.png ЗАПРЕЩАЕТСЯ использование в URL заглавных букв (кроме префикса RU/). Исключением является пространство имён «Template:».
Documentation caution.png PROHIBITION use the URL capitalization (except for the prefix RU/). An exception is the namespace «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|Н. Е. Гарбуз}}
1.4.2. Под шаблоном с подписью автора указывается номер версии Apache OpenOffice, текущей на момент написания статьи. Номер версии Apache OpenOffice проставляется с помощью шаблона {{RUoooversion}} с одним параметром, в котором указывается номер версии.
Например:
Шаблон    —    template Результат    —    result
{{RUoooversion|3.x}}

OpenOffice.org 3.x



1.4.3. Если статья не имеет прямого отношения к версии Apache OpenOffice, то указывается год написания статьи без указания версии Apache OpenOffice. В этом случае используется другой шаблон подписи.
Например:
Шаблон    —    template Результат    —    result
{{RUsignyear|AEroshin|А. В. Ерошин|2010}}


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 (Apache OpenOffice 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.

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

3.1. При написании статей и в заголовках статей при упоминании названий Apache OpenOffice, OpenOffice.org 1.x, OpenOffice.org 2.x, OpenOffice.org 3.x и OpenOffice.org pro следует использовать специальные шаблоны: {{OOo}}, {{OOo1}}, {{OOo2}}, {{OOo3}}, {{OOoPro}}.
3.2. Если в статье встречается прямое употребление названия Apache OpenOffice и/или 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. Если статья касается конкретной версии Apache OpenOffice, то вместо предыдущего шаблона, применяются два других:
{{RU/documentation/sign|Ivanov|И. И. Иванов}}
{{RU/documentation/oooversion|3.3.x}}
5.7. Последней строкой указывается шаблон подвала, описанный в п. 1.4.4.







Translator:
Denis V Chernosov






Правила зоны RU


Retrieved from "https://wiki.openoffice.org/w/index.php?title=RU/rules/writing_articles&oldid=187650"
Personal tools