Инструкция по написанию статей на национальной языковой странице RU — Instructions. Writing articles
From Wiki
Jump to navigationJump to search
№ | РУС | ENG | ||||
---|---|---|---|---|---|---|
0. |
О статьях — About Articles | |||||
0.1. | Настоящая Инструкция регулирует вопросы создания статей в пределах национальной языковой страницы RU и исполняет Положение о национальной языковой странице RU и информационную политику. | These Instructions govern the creation of articles on the national language page RU and satisfy the Rules and information policy of the national language page RU. | ||||
0.2. | Для публикации отбираются статьи, удовлетворяющие следующим критериям: | Encyclopedia articles are published if they meet the following content policies: | ||||
0.2.1. | соответствие тематике ресурса: рассмотрение вопросов, связанных с OpenOffice.org; | relevance to the topic: addressing issues relevant to the OpenOffice.org; | ||||
0.2.2. | актуальность: изложенный материал должен иметь практическую ценность; | applicability: the topic shall be applicable; | ||||
0.2.3. | цельность: отдельный, самодостаточный информационный объект; | wholeness: a separate, all-sufficient information object; | ||||
0.2.4. | системность: интегрируется в установленную информационную структуру; | systemic: can be integrated into the established information structure; | ||||
0.2.5. | завершённость: статья может находиться в состоянии «черновика» разумное время, далее — удаляется; | completeness: an article may be in a "draft" state during a reasonable time, after that it shall be deleted; | ||||
0.2.6. | достоверность: несомненная верность приводимых в статье сведений, проверка которых на опыте показала, что они соответствуют действительности, что даёт возможность использовать их без дополнительной проверки; | factual accuracy: unquestioned truth of the article contents. The trustworthiness of an article is verified by experience, what makes additional verifying unneeded; | ||||
0.2.7. | непротиворечивость (последовательность): отсутствие расхождений с другими статьями; | consistency: no discrepancy with other articles; | ||||
0.2.8. | неповторимость: на одну и ту же тему и по одному и тому же вопросу не может быть двух статей; | uniqueness: there may not be two articles on the same subject or on the same issue; | ||||
0.2.9. | соответствие настоящему своду Правил. | compliance with this set of Policies. | ||||
0.3. | Статьи, опубликованные с нарушением п. 0.2. удаляются. | Articles published in violation of Section 0.2. shall be deleted.
| ||||
1. |
Создание статей — Writing articles | |||||
1.1. |
Что представляют собой статьи — What is an article? | |||||
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. |
| |||||
1.2. |
Заголовки статей и их URL — Article titles and their URL | |||||
1.2.1. | При создании нового заголовка следует учитывать технические ограничения. | When creating a new title the technical limitations should be taken into account.
| ||||
1.2.2. |
URL — URL | |||||
1.2.2.1. | Каждая русскоязычная страница является дочерней по отношению к национальной языковой странице RU. | Each Russian-language page is subsidiary of the national language page RU. | ||||
1.2.2.2. | На основании п. 1.2.2.1., URL каждой страницы должен начинаться с имени «RU» и следующего за ним символа «/». | According to Section 1.2.2.1., URL of each page should begin with the name "RU" and a slash "/". | ||||
1.2.2.3. | На основании пп. 1.2.2.1., 1.2.2.2. в имени каждой статьи используется следующий префикс: RU/. |
According to Sections 1.2.2.1., 1.2.2.2. in the name of each article the prefix RU/is used. | ||||
1.2.2.4. | ||||||
1.2.2.5. | ||||||
1.2.2.6. | ||||||
1.2.2.7. |
|
| ||||
1.2.2.8. | ||||||
1.2.2.9. | ||||||
1.2.2.10. | Каждая статья создаётся со следующем именем:
|
Every article has the following name:
| ||||
1.2.2.11. | Если есть необходимость объединить несколько статей в группу, то применяется следующее правило:
|
If there is a need to join several articles in a group, then the following rule applies:
| ||||
1.2.3. |
Заголовки статей — Article Titles | |||||
1.2.3.1. | Заголовки статей создаются в соответствии с инструкцией: Инструкция. Заголовки статей — Guidelines. Article titles | Article titles shall be named according to the Instructions: Инструкция. Заголовки статей — Guidelines. Article titles | ||||
1.2.3.2. |
|
| ||||
1.2.3.3. |
|
| ||||
1.3. |
Категоризация статей — Article categorization | |||||
1.3.1. | Каждая статья обязательно должна быть включена минимум в одну категорию. Поскольку для каждого раздела, рубрики и темы в зоне RU разработаны обязательные к применению соответствующие шаблоны подвалов, то тег категории уже в них включён. Если же подходящего для статьи шаблона подвала не найдено, то тег категории следует указать в последней строке статьи, после текста.
|
Every article is supposed to belong to at least one category. Since there are templates for bottom parts of every section, heading and topic in the national page RU, so the category tag is already included there. If there is no appropriate template for the bottom part of an article, then its category tag should be placed at the end of the wikitext.
| ||||
1.4. |
Подписи статей — Article signatures | |||||
1.4.1. | Каждая статья подписывается пользователем, её создавшим (создателем). При внесении корректировок изменение имени создателя не допускается.
|
A user that created an article should sign it. It is prohibited to change a user signature when editing the article.
| ||||
| ||||||
1.4.2. | Под шаблоном с подписью автора указывается номер версии OpenOffice.org, текущей на момент написания статьи. Номер версии OpenOffice.org проставляется с помощью шаблона {{RUoooversion}} с одним параметром, в котором указывается номер версии.
|
Under the template with the author`s signature there should be a version number of the OpenOffice.org, which was current to the moment of writing the article. The version number of the OpenOffice.org is stamped by the template {{RUoooversion}} which has one parameter—the version number.
| ||||
| ||||||
1.4.3. | Если статья не имеет прямого отношения к версии OpenOffice.org, то указывается год написания статьи без указания версии OpenOffice.org. В этом случае используется другой шаблон подписи.
|
If an article has no direct relationship to the OpenOffice.org version, then a year of writing that article is stamped without specifying the OpenOffice.org version number. In this case another signature template is used.
| ||||
| ||||||
1.4.4. | Последним в статье, после шаблона подписи, вставляется шаблон подвала статьи {{xxxxxВottom}}, где ххххх — имя соответствующего раздела. Подробно все шаблоны подвалов описаны в (Разраб.) Инструкция. Шаблоны, общие для всех национальных языковых страниц — Guidelines. Templates that are common to all national language pages. | The last in an article, next to the signature template, there is the template for an article bottom {{xxxxxВottom}}, where ххххх is the name of the relevant section. All the templates for a section bottom are described in detail in (Разраб.) Инструкция. Шаблоны, общие для всех национальных языковых страниц — Guidelines. Templates that are common to all national language pages.
| ||||
2. |
Вставка специальных элементов — Inserting special elements | |||||
2.1. |
Ссылки на внутренние статьи — Internal links | |||||
2.1.1. | Ссылки на внутренние статьи в зоне RU данной wiki оформляются с помощью специального шаблона {{SecTitle}} с одним обязательным параметром — wiki-URL. Например | Internal links in the national page RU of this wiki are formed by the special template {{SecTitle}} with one required parameter—wiki-URL. For example | ||||
| ||||||
2.1.2. | Ссылки на статьи из прочих языковых зон данной wiki оформляются следующим образом: | Links to pages from other national pages of this wiki should look as follows: | ||||
| ||||||
2.2. |
Вставка кода Star Basic и других языков программирования — Inserting listings of Star Basic and other programming languages | |||||
2.2.1. | Для вставки в статьи кода Star Basic (OpenOffice.org Basic) следует использовать следующую конструкцию: <source lang="oobas"> ... </source> |
The following marking is used for inserting listings of the Star Basic (OpenOffice.org Basic) code: <source lang="oobas"> ... </source> | ||||
| ||||||
2.2.2. | source lang поддерживет синтаксис следующих языков: | source lang supports the syntax of the following programming languages: | ||||
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 — Using the names "OpenOffice.org" and "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}}. | In order to write the following names: OpenOffice.org, OpenOffice.org 1.x, OpenOffice.org 2.x, OpenOffice.org 3.x and OpenOffice.org pro in the text and in the title of an article, the special templates are used: {{OOo}}, {{OOo1}}, {{OOo2}}, {{OOo3}}, {{OOoPro}}. | ||||
3.2. | Если в статье встречается прямое употребление названия OpenOffice.org и/или OpenOffice.org pro, их следует заменить на соответствующий шаблон. | If there is the direct using of the name OpenOffice.org and/or OpenOffice.org pro in an article, it should be changed to the appropriate template. | ||||
3.2.1. | Исключением из п. 3.2. является упоминание конкретных версий программы (например текст "OpenOffice.org 1.2.3" не нужно заменять на "{{OOo}} 1.2.3"). | The exception to par. 3.2. is the mention of specific versions (eg text "OpenOffice.org 1.2.3" do not need to be replaced by a "{{OOo}} 1.2.3"). | ||||
3.2.2. | Для вставки на странице статичного текста из шаблона рекомендуется использовать конструкцию вида: {{subst:OOo}} 1.2.3. | To insert a static text on the page from a template is recommended to use the design of the form: {{subst:OOo}} 1.2.3.
| ||||
4. |
Употребление наименований Microsoft Office и отдельных его приложений — Using the names of the Microsoft Office and its applications | |||||
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}}. | In order to write the following names: Microsoft Office, Microsoft Office 2003, Microsoft Office 2010, MS Word, MS Excel, MS Access, MS Power Point and MS Equation in the text and in the title of an article, the special templates are used: {{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, их следует заменить на соответствующий шаблон. | If there is the direct using of the names Microsoft Office, Microsoft Office 2003, Microsoft Office 2010, MS Word, MS Excel, MS Access, MS Power Point or MS Equation in an article, they should be changed to the appropriate template. | ||||
4.2.1. | Исключением из п. 4.2. является упоминание конкретных версий программы (например текст "MS Word 5.0" не нужно заменять на "{{MSW}} 5.0"). | The exception to par. 4.2. is the mention of specific versions (eg text "MS Word 5.0" do not need to be replaced by a "{{MSW}} 5.0"). | ||||
4.2.2. | Для вставки на странице статичного текста из шаблона рекомендуется использовать конструкцию вида: {{subst:MSW}} 5.0. | To insert a static text on the page from a template is recommended to use the design of the form: {{subst:MSW}} 5.0.
| ||||
5. |
Обязательные элементы построения статей — The required elements for writing articles | |||||
5.1. | Создание русскоязычного заголовка описано в п. 1.2.3.1. | The policies of creating a Russian-language title are described in Section 1.2.3.1. | ||||
5.2. | Сразу за заголовком следует шаблон «хлебных крошек» {{BreadCrumbL10n}} без параметра. Для статей из «Базы Знаний» в шаблоне {{BreadCrumbL10n}} следует указать в качестве параметра wiki-URL темы, к которой относится статья. | Right next to the title there is the "bread crumbs" {{BreadCrumbL10n}} template with no parameters. For articles in the "Knowledge Base" the wiki-URL of the applying article topic should be specified as a parameter in the {{BreadCrumbL10n}} template. | ||||
5.3. | Следом за «хлебными крошками» указывается магическое слово __NOTOC__ для отключения локального оглавления статьи. Включать локальное оглавление в статье следует только в виде исключения при наличии серьёзной необходимости. Для этого указывается магическое слово __TOC__ | Right next to the "bread crumbs" there goes the magical word __NOTOC__ for disabling the local article table of contents. Enabling the local table of contents in an article should be made only as an exception in serious need. For that the magic word __TOC__ is specified. | ||||
5.4. | Далее следует основной текст статьи, который помещается внутрь секции toc: | Next goes the general text of an article inside the section toc: | ||||
<section begin=toc/> ...Основной текст статьи... <section end=toc/> | ||||||
5.5. | В конце ставится подпись{{RUsignyear|Ivanov|И. И. Иванов|2010}} |
In the end of an article the signature {{RUsignyear|Ivanov|И. И. Иванов|2010}}is stamped | ||||
5.6. | Если статья касается конкретной версии OpenOffice.org, то вместо предыдущего шаблона, применяются два других: {{RU/documentation/sign|Ivanov|И. И. Иванов}} {{RU/documentation/oooversion|3.3.x}} |
If an article applies to the specific version of the OpenOffice.org, then instead of the previous template the two other templates are used: {{RU/documentation/sign|Ivanov|И. И. Иванов}} {{RU/documentation/oooversion|3.3.x}} | ||||
5.7. | Последней строкой указывается шаблон подвала, описанный в п. 1.4.4. | In the last line of a page there is the template of the bottom part, described in Section 1.4.4. |
Template:RUsignyear
Template:RUsigntransEng