Help:Editing:ru

From Valve Developer Community
Revision as of 18:37, 27 April 2010 by 00000 (talk | contribs) (Маркеры)

Jump to: navigation, search

Создание новой страницы

Чтобы создать ноую страницу, вам надо просто ввести её URL в строке адреса. Еслы вы хотите создать статью "Amazing New Tutorial"(Увлекательный Новый Урок), введите адрес http://developer.valvesoftware.com/wiki/Amazing_New_Tutorial. Затем отредактируйте страницу и сохраните её.

Альтернативным решением будет редактирование подходящей статьи по вашей теме. Добавьте ссылку на новую страницу (например, [[Amazing new Tutorial:ru]]) и щелкните по ней, чтобы перейти к странице редактирования.

Редактирование существующих страниц

Редактирование текущей страницы происходит в новой форме с текстовым полем. Вы можете делать любые изменения, добавить краткое описание ваших изменений (обычно используется, если вы нашли грамматическую ошибку), и затем сохранить изменения. Страница изменена! Также вы можете использовать различные кнопки редактирования для добавления вики-разметки в статью.

Примечание:Редактировать статью можно, если она не заблокирована от изменений.

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

Mediawiki editbuttons.png

Каждая кнопка отвечает за свой стиль форматирования. При нажатии она вставляет в текстовое поле разметку текста, который задаёт выделенному фрагменту специальное форматирование. Например, если вы хотите написать слово полужирным шрифтом, просто выделите это слово и нажмите на клавишу Ж (первая кнопка на панели редактирования).

Жирный текст button_bold.png

Синтаксис: '''Жирный текст'''

Просто напишите три апострофа до фрагмента текста, который будет написан жирным и три апострофа после.

Если вы хотите сделать текст жирным, вы должны ввести следующее:

    Если вы хотите '''сделать текст жирным'''

Курсивный текст button_italic.png

Синтаксис: ''Текст курсивом''

Задать курсивный текст так же просто, как и жирный, только поставить надо не три, а два апострофа до и после фрагмента текста.

Если вы хотите сделать текст курсивом, введите следующее:

    Если вы хотите ''сделать текст курсивом''

Подчёркнутый текст

Синтаксис: <u>Подчеркнутый текст</u>

Встроенной вики-разметки нет, но кто вам мешает использовать обычную HTML-разметку? Используйте тег <u>

Подчеркнутый текст делается так:

    <u>Подчеркнутый текст</u>
Примечание:Несмотря на то, что на панели инструментов есть кнопка с изображением подчёркнутого текста button_link.png, она задает не подчеркнутый текст, как можно подумать, а внутреннюю ссылку (См. далее)

Внутренняя ссылка button_link.png

Синтаксис: [[Текст ссылки]]

Если вы хотите сделать ссылку на другую страницу, вам нужен заголовок этой статьи. Чтобы сделать ссылку на главную страницу (англ. Main Page), просто напишите "Main_Page"!

Чтобы сделать ссылку на Главную Страницу(Main_Page), нужен следующий код:

    Чтобы сделать ссылку на Главную Страницу([[Main_Page]])

Также вы можете менять текст ссылки, который не будет влиять на адрес ссылки. Это нужно для соблюдения норм грамматики.

Итак, чтобы сделать ссылку на страницу, которая является Главной, вам нужен следующий код:

    Итак, чтобы сделать ссылку на [[Main_Page|страницу, которая является Главной]]

Внешние ссылки button_extlink.png

Синтаксис: [http://www.example.com текст ссылки]

Внешние ссылки используются для WEB-страниц, которые не находятся в этой вики.

Чтобы сделать ссылку на сайт Steampowered.com, используйте следующий код:

    Чтобы сделать ссылку на сайт [http://www.steampowered.com Steampowered.com]

Заголовок button_headline.png

Синтаксис: ==Текст заголовка==

Заголовки нужны для того, чтобы разделять страницу на разные логические части. Заголовок первого уровня используется в названии страницы, он очень большой. Если использовать его во второй раз, то он будет немного меньше. Все добавленные вами заголовки будут одинакового размера, который зависит от количества знаков равенства.

Заголовки - идеальное средство для упорядочивания материала на странице. К тому же, вики-движок автоматически создает содержание страницы в начале, позволяя просмотреть нужную информацию по одному щелчку мышки.

Так можно получить такой прекрасный большой текст как этот

Используйте следующий код:

    === Так можно получить такой прекрасный большой текст как этот ===

Вставка изображений button_image.png

Синтаксис: [[Image:Example.jpg]]

Изображения можно загружать на этот сайт и напрямую ссылаться на них.

Совет:
Чтобы загрузить изображение, перейдите на эту страницу: Special:Upload


Чтобы добавить эту картинку с улыбающимся лицом Test.gif, используйте следующее:

    Чтобы добавить эту картинку с улыбающимся лицом [[Image:Test.gif]]


Предупреждение:УБЕДИТЕСЬ В ТОМ, ЧТО ЗАГРУЖЕННЫЕ ИЗОБРАЖЕНИЯ НЕ ЗАЩИЩЕНЫ АВТОРСКИМ ПРАВОМ.

Без вики-разметки button_nowiki.png

Syntax: <nowiki>Вставьте неформатированный текст сюда</nowiki>

Этот тег нечасто используется, исключая создание этой страницы, где нужно просмотреть нужные теги, которые нельзя отобразить обычным способом, т.к. вики-движок воспринимает это как форматированный текст. Чтобы избежать этого, используйте тег <nowiki></nowiki> вокруг нужного (того, который надо отобразить).


<code>Вставьте сюда текст</code>

<nowiki><code>Вставьте сюда текст</code></nowiki>

Подпись button_sig.png

Синтаксис: --~~~~

Вставляет ваше имя (имя пользователя) и время/дату создания. Это обычно используется для подписи своих сообщений на страницах обсуждения.

Предупреждение:Т.к. создавать и редактировать статьи на Valve Developer Community может каждый, в статьях подписи использовать нельзя

Горизонтальная линия button_hr.png

Синтаксис: ----

Горизонтальные линии используются для отделения больших блоков текста друг от друга, и ими лучше не злоупотреблять, т.к. выглядит это некрасиво. Чтобы отделить


этот текст, используйте следующий код:

    Чтобы отделить 
    ----
    этот текст

Other, unlisted formatting tools

Categorizing your pages

Syntax: [[Category:Category Name]]

If you want your page to show up in the automatically generated category tables like on the Special:Categories page, you will need to add a tag (or two, or three, or however many apply) to the end of your page. Code examples:

[[Category:Level Design]]
[[Category:Tutorials]]

Cite code

Syntax: <code>inline code text</code>

Open a <code> tag before your text and close it after your text with </code>.

If you want to cite a piece of code, then the code would run as so:

    If you want to cite a <code>piece on code</code>

If you want to cite an entire block of code, do not use <code> tags, instead add an extra space character to the beginning of each line of code. Empty lines where there should be breaks in the code must also begin with a space character.

For example:

int a;

// comment

a = 10;
Note:HTML <pre> tags can also be used, but should be avoided unless absolutely necessary.

"Code" boxes

To make those pretty little code boxes used throughout this guide, just make a new paragraph with a space character before the first character and a line break above and below. Be careful though, text that is inside a code box will not wrap. So if you happen to copy in Shakespeare's entire works, the formatted page is going to be about 600 pixels tall and about 60 billion wide.

So if you want a pretty code box kinda like this...

Insert a space at the beginning of the paragraph.

Маркеры

Маркеры используются для разных элементов, которые относятся к одной категории.

  • Thing 1
  • Thing 2
  • Thing 3

Маркированный список как этот, можно сделать так:

* Thing 1
* Thing 2
* Thing 3

Отступы

Без отступа

Один отступ
Два отступа
и т.д.

Вы можете делать отступы с помощью добавления двоеточия (:) в начало строки Пример:

:Один отступ
::Два отступа.

Который отобразится так:

Один отступ
Два отступа.

Перенаправления

Чтобы перенаправить пользователя на другую страницу, используйте следующий код:

#REDIRECT [[новая_страница]]

Все, кто зайдут на эту страницу, перейдут на новую_страницу. Пример: Game Cache File

Примечание:Вы можете перейти назад на страницу и отредактировать её.

Tables

Tables are exceedingly complex, and cannot be described here in sufficient detail. Please use the Wikimedia Help:Table page to assist you in creating them. They are just as versatile as their HTML counterparts.

Templates

Templates are an easy and fast way to apply a uniform structure to pages and frequently quoted pieces of information.

Several of the common templates available for use:

  • {{Cleanup}} — used to mark articles in need of cleanup to conform to a sufficient level of quality.
  • {{Pov}} — used to mark articles which do not follow the point of view guideline.
  • {{Spoiler}} — used to mark spoilers in conjuction with {{Endspoiler}}
Example: {{Spoiler}}The secret revealed!{{Endspoiler}} Produces:

The secret revealed!Template:Endspoiler

  • {{wip}} — use this to tell other editors you are currently editing the article.
  • {{Wrongtitle}} — used to display the correct title for articles misnamed by MediaWiki.
Example: {{wrongtitle|title=func_detail}} Produces:

Template:Wrongtitle

  • {{Note}} — This is used for adding a note message
Example: {{Note|This is a note}} Produces:
Note:This is a note
  • {{tip}} — This is used for adding a helpful tip
Example: {{tip|This is a helpful tip}} Produces:
Tip:This is a helpful tip
  • {{warning}} — Add a warning message
Example: {{warning|This is a bad idea}} Produces:
Warning: This is a bad idea
  • {{bug}} — Used for describing a known bug
Example: {{bug|This is a bug}} Produces:
Bug: This is a bug
  • {{clr}} — This is used for clearing vertical space after an image
  • {{Wiki}} — used to link to a wikipedia article.
Example: {{Wiki|Valve Corporation}} Produces:
Valve Corporation
  • {{todo}} — Used for listing unfinished work on an article
Example: {{todo|add some stuff}} Produces:
To do: add some stuff
  • {{PD}} — Used for marking an image as being in the Public Domain
  • {{HL1}} — Goldsource Icon
  • {{HL2}} — Source Icon
  • {{EP1 add}} — For listing a feature added with Episode 1 Source Engine update
Example: {{EP1 add|crates}} Produces:
crates (New with Half-Life 2: Episode One / Source 2006)
  • {{EP2 add}} — For listing a feature added with the Orange Box Source Engine update
Example: {{EP2 add|barrels}} Produces:
barrels (New with Half-Life 2: Episode Two / Source 2007)
  • {{L4D add}} — For listing a feature added with the Left 4 Dead Source Engine update
Example: {{L4D add|crates and barrels}} Produces:
crates and barrels (New with Left 4 Dead)
  • {{OutputsTable}} — For creating an entity outputs table
  • {{Split-apart}} — For suggesting an article has become too long or is covering too broad a subject
  • {{Shortcut}} — used to put a little box to the right, displaying a shortcut title to a redirect page to that article.
  • {{Stub}} — used to mark and categorize a stub article.
  • {{Delete}} — For suggesting a candidate for speedy deletion, no reason given.
  • {{Deletebecause}} — For suggesting a candidate for speedy deletion, reason given.
  • {{Deleteagain}} — For suggesting reposted content that has been removed before but brought back.
  • {{Nonsense}} — For suggesting a candidate for speedy deletion because article is patent nonsense.

 
All templates (Contains two pages at the time of writing, so click on Next page to see the rest.)

Formatting guidelines

There are no hard rules for specific formatting, other than keeping HTML at a bare minimum. There are some generally accepted styles you can use, though:

Italics

  • Should in general follow standard English usage -- italics are meant for slight emphasis. Italics should not be used for full sentences, as that is not minor emphasis and actually makes the emphasis unintelligible.
  • Newly defined words in a sentence. For example: "Levels are created with a series of blocks, called brushes, which can be created in all manner of sizes. Brushes are the basic components of levels". After the first italicized instance, the word is no longer italicized.
  • Parameters in a command-line that are to be replaced by the user: hl2.exe +map mapname -dev
  • Can be combined with "<" and ">" for parameters with longer names: hl2.exe -game <game directory>
  • Other standard uses in English can be found at Wikipedia:Italic_type.

Использование тега<code>

  • Если нету другого эквивалента викиразметки.
  • Выражения коммандной строки:c:\program files\valve\steam\
  • Переменные в коде или в текстовых файлах:$staticprop или m_nCounter
  • Параметры консоли разработчика: mat_wireframe 1
  • Имена файлов: bspzip.exe
  • Названия энтитей: info_player_start
  • Другие игровые или данные редактора Hammer, такие как названия текстур, Input'ов/Output'ов, и.т.п.

Выделение жирным

  • Очень важные моменты: "Примечание: Использование этой команды может привести к поломке жесткого диска." Так же, как и курсивом, жирным шрифтом не стоит злоупотреблять.
  • Команды меню или другого пользовательского интерфейса:"Сначала, выберите пункт меню File, затем - Map Properties. Вы увидите окно Object Properties. Выберите поле Skybox Texture Name."
  • Если слово является ссылкой на википедию, не обязательно его выделять жирным.

Шаблоны для описания энтитей

Статьи, описывающие энтити, должны иметь четкую структуру (см. статью Entity_Article_Template). Чтобы упростить создание этих статей, были созданы специальные шаблоны для параметров энтитей, Input'ов, Output'ов

Примечание:Здесь написаны только самые распространённые шаблоны. Для особых игровых шаблонов см. последние части статьи.

Параметры энтитей

Input'ы

Output'ы

Шаблоны Counter-Strike Source

Шаблоны Team Fortress 2

See also

Wikipedia has excellent resources on text formatting available here. The information is referential of the Wikipedia site, but is applicable to all MediaWiki powered sites, including the Valve Developer Community.
Retrieved from "https://developer.valvesoftware.com/w/index.php?title=Help:Editing:ru&oldid=132936"