Справка: Редактирование
![]() |
This page needs to be translated. Данная страница содержит информацию, которая частично либо некорректно переведена, или здесь вообще нет перевода. Если страница не может быть переведена по некоторым причинам, или она останется непереведенной длительный период после того, как это сообщение помещено, эта страница должна быть поставлена на удаление. Также, убедитесь в том что статья пытается соответствовать статье об альтернативных языках . Кроме того, не забудьте использовать русский словарь переводчика. |
![]() |
Эту статью необходимо переработать, чтобы она соответствовала стандартам качества.
|
Создание страниц
Панель редактирования
|
Форматирование страниц |
Шаблоны страниц | |
Руководство по специальному форматированию |
Создание страниц
Вы можете начать редактирование несуществующей страницы несколькими способами:
- Самый простой способ это ввести точное требующееся Вам название в "Строку поиска" затем нажать кнопку "Перейти". Если страница не существует, то Вы сможете её создать.

- Например, предположим, что Вы набрали "Foobar" в строку поиска, а затем нажали кнопку "Перейти". Так как страница не существует, Вы увидите следующее сообщение:
- Результаты по данному запросу отсутствуют.
- Создайте страницу "Foobar" в этой wiki!
- В этом случае, Вы можете нажать на ссылку Foobar и начать редактирование новой страницы.

- Вы можете изменить URL в адресной строке для перехода туда, куда Вы хотели (в этом случае используя адрес https://developer.valvesoftware.com/wiki/Foobar).
- Некоторые страницы в Wiki содержат много красных ссылок. Если Вы знакомы с темой несуществующей страницы, не стесняйтесь создавать новую страницу, перейдя по красной ссылке. Ваши вклады высоко ценятся, и чем более синих ссылок, тем лучше.
В ходе редактирования, нажатие кнопки Предварительный просмотр (справа от кнопки Записать страницу ) поможет определить, выглядит ли Ваше редактирование хорошо. Это показывает окончательный результат отредактированной страницы, не сохраняя его. Это позволит избежать спама Последние изменения с сохраненными изменения, к разочарованию других редакторов.
Когда вы закончите редактирование, корректируйте его, чтобы удостовериться, что редактирование окончательное, и затем щелкните Записать страницу, чтобы, наконец, создать новую страницу.
Тестовые страницы (Sandbox)
Чтобы проверить свои навыки редактирования, вы можете использовать публичную тестовую страницу, или создать свою. Тестовую страницу можно создать с помощью пользовательской страницы, где в адресной строке в конце URL-строки просто добавьте "/Sandbox". Перед созданием убедитесь, что вы находитесь на своей собственной странице.
Опытные редакторы страниц, которые желают дальше продвигать свои навыки редактирования в шаблонах, могут использовать Template: TestTemplate страницу, чтобы проверить их шаблон кода.
Создание страниц "Как сделать..."
Основные рекомендации по написанию обучающих страниц.
- Перед тем как начинать, убедитесь, что вы полностью понимаете тему о которой хотите написать. Очень трудно написать что-то информативное, если вы не знаете подробности этой темы.
- Решите, какую обучающую страницу вы делаете. Это базовое руководство для людей, которые не часто пользуются Hammer? Или эта страница больше подходит для продвинутых пользователей?
- Хороший туториал представляет собой информацию которую интересно читать:
- Перед тем как начать, добавьте краткое описание о чем ваша страница.
- Разбейте его на этапы. Если эта страница для начинающих, не бойтесь описывать каждый шаг.
- Разбейте всё на группы шагов, которые все вместе достигают одной цели.
- Добавляйте картинки. Изображение может описать то, что не нуждается в пояснениях. Тем не менее, не переполняйте страницу. Используйте изображения тогда, когда это улучшает текст.
- Добавляйте таблицы при объяснении ввода и вывода поведения энтити. Это становится проще, если таблица совпадает с флагами вывода в Хаммере уже наполненного информацией. Читатель может просто скопировать его или перепроектировать, понять почему это должно быть сделано так, а не иначе.
- При написании обучающей страницы, имейте в виду, что есть люди которые не знакомы с большинством энтити и различных инструментов Хаммера. Не пытайтесь объяснять что-то, что уже есть в Wiki, используйте перенаправляющиеся ссылки, для ознакомления читателя с этим материалом.
- Пытайтесь описывать шаги в логической последовательности. После прочтения вашего туториала люди будут делать так, как делали вы.
- Сделайте хорошее резюме в конце страницы.
Теперь создайте sandbox страницу и начните писать!
Создание страниц о моде
Пожалуйста ознакомьтесь с рекомендациями перед созданием страницы о Source/GoldSrc моде.
Создание страниц об энтити
Смотрите шаблон для создания страниц о энтити.
Создание Категорий
Категории позволяют страницам добавлять автоматически списки. Эти структуры помогают группировать страницы аналогичной тематики. Там также может быть раздел со списком подкатегорий этой категории.
Страницы категорий обычно создаются для описания. Например, Категория:Blender является категорией для всех страниц, связанных с пакетом 3D моделирования и с открытым исходным кодом, Blender.
Чтобы добавить страницу в категорию, просто разместите [[Category:'''ИМЯ КАТЕГОРИИ''']]
в нижней части страницы. Все страницы, которые имеют одинаковое название категории будут отображаться автоматически.
Для получения списка всех текущих категорий, посетите Категории.
Создание страницы пользователя
Вы можете редактировать свою личную страницу. Запрещается редактировать страницы других пользователей, оставлять ссылки на сайты с порнографией, торрент ссылки и т.д. Если вы это нарушите,то получите бан по IP навсегда.
Чтобы создать страницу пользователя вы должны сначала зарегистрироваться на VDC.Зарегистрироваться. После того как вы зарегистрировались и вошли в аккаунт, нажмите на имя пользователя в самом верхнем правом углу.
Создание страниц-обсуждений
Вы можете создать страницы для обсуждения вопросов, содержание которых должно соответствовать названию страницы. Он также может быть использован для запроса помощи.
Чтобы создать или отредактировать страницу для обсуждения, просто нажмите на вкладку "Обсуждение" выше, рядом с вкладкой "Статья".

Страницы обсуждения имеют специальный поток. Когда вы комментируете посты на странице обсуждения, используются отступы, чтобы ответить на комментарии.Смотрите ниже для получения дополнительной информации.
Чтобы подписать ваши комментарии с вашим именем и дате/времени поста нужно использовать четыре символа. Четыре тильды (~~~~) будут автоматически заменяться общедоступной информацией пользователя вместе с датой и временем поста. Подписи объясняются далее.
Указания по редактированию
Although these aren't rules, they are necessary guidelines that each user should acquire and respect.
- A user page is a user's own personal space. Try not to make edits to a user page without consent of the page's owner.
- Make use of the Show preview button when editing a page. This will show you exactly how the page will look after saving your changes. It will help keep the Recent changes page clean and easier to navigate.
Editing Toolbar
Each button, when pressed, will paste a small example of the usage of a pace of special formatting. If you have text selected, pressing a button will format the text instead of pasting in sample code. For example, to make some text bold, simply select some text in the edit window and press the bold button (the first button on the editing bar).
Bold text 
Bold text is very simple. Put in three (3) single apostrophes before the section of text you wish to bold, and three (3) after.
Syntax
'''Bold text'''
Example
Remember to '''always''' brush your teeth.
Results
Remember to always brush your teeth.
Italicized text 
Italics are just as easy as bold text. Put in two (2) single apostrophes before the section of text you wish to italicize, and two (2) after.
Syntax
''Italic text''
Example
The ''Queen Mary'' sailed last night.
Results
The Queen Mary sailed last night.
Internal links 
If you want to link to another page that is in this particular wiki, you simply need the title of the page. To link to the Main Page, you simply use "Main Page". Easy!
Syntax
[[Link title]]
Example
Click here to go to the main page: [[Main Page]]
Results
Click here to go to the main page: Main Page

You can also change the text of the link, without affecting what it links to. This is useful if you have to adjust for grammar.
Syntax
[[Link title|Text for link]]
Example
[[Main Page|Click here]] to go to the main page.
Results
Click here to go to the main page.

[[Help:Editing#Internal_links|Jump to "Internal links"]]
.External links 
External links are used to link to web pages that are not in this wiki. Any link with the icon means it's external, and any link with the
icon means it's a secure link.
Syntax
[http://www.example.com link title]
Example
[http://www.valvesoftware.com/jobs/ Click here] to learn more about applying to Valve.
Results
Click here to learn more about applying to Valve.
Example
[https://plus.google.com Google+ (secure link)]
Results
Google+ (secure link)
Adding a headline 
Headlines are used to subdivide an article into meaningful sections. You can change headline sizes by varying the number of equals signs (=) to change the size of the headline. This makes it very easy to categorize a page, creating a clean, efficient way to find information. Additionally, with multiple headlines, the wiki engine will eventually add a Table of Contents box to the beginning of the page, allowing a viewer to instantly hop to the subject they want on the page. On standard pages, second level (Large) headlines should be used. Extra-Large headlines are reserved for the page title.
Syntax
= Extra-Large Headline =
== Large Headline ==
=== Medium Headline ===
==== Small Headline ====
Extra-large
- Example of an XL headline (should not be commonly used)
Large
- Example of a L headline (use this as the first headline on a page)
Medium
- Example of a M headline
Small
- Example of a S headline
Embedded pictures 
Embedded pictures are pictures that have been uploaded to the wiki and are now directly hosted by it. To upload a picture, visit Special:Upload.

The [[Image:Filename.png]]
syntax has a few options that you can use. These can be placed as an option anywhere in the line:
Option Example Description thumb [[Image:Filename.png|thumb]]
Produces a framed thumbnail version of the image. ###px (size) [[Image:Filename.png|300px|thumb|This is an example image]]
Changes the pixel size of the images. left (right, center) [[Image:Filename.png|thumb|150px|right]]
Controls the alignment of the image on the page
Ignore Wiki formatting 
This button may rarely be pressed, as the only time this may be used are for making descriptions for maintenance edits or writing pages like this one here. It will ignore all wiki formatting between the nests and only returns plain and simple text.
Syntax
<nowiki>Insert non-formatted text here</nowiki>
Example
<nowiki>This is '''bold''' text.</nowiki>
Results
This is '''bold''' text.
Signature 
Inserts your user name, which links back to your user page, and a time stamp, which marks the exact time you submitted your edit. This is mainly used to "sign" your posts when inserting comments on Talk (discussion) pages. It is common courtesy to sign your comments on Talk pages. You can change what appears in your signature by going to Special:Preferences.

Syntax
--~~~~
Example
This discussion page may need archived soon. --~~~~
Results
This discussion page may need archived soon. --FakeUser23 21:38, 17 October 2011 (PDT)
Horizontal lines 
Syntax
----
Horizontal lines are usually only used at the end of a large section of a single page. Use them sparingly, as too many make a page look ugly. Proper use of headlines can render these unnecessary.
Formatting Pages
Bullet points
This function can create unordered lists. Bullet points are useful for listing multiple items that fall into a similar category.
Syntax
* Item 1
* Item 2
* etc...Example
* Red
* Blue
* GreenResults
- Red
- Blue
- Green

Numbered lists
You can create ordered lists using this syntax. Numbered lists automatically number items according to their placement in the page.
Syntax
# Item 1
# Item 2
# etc...Example
# This is the first step.
# This is the second step.
Results
- This is the first step.
- This is the second step.
Definition lists
You can also create definition lists equivalent to the <dl>, <dt>, and <dd> HTML tags.
Syntax
;Item 1
:About Item 1
;Item 2
:About Item 2Example
;Center
:A point equidistant from all points on the surface of a sphere.
Results
- Center
- A point equidistant from all points on the surface of a sphere.
Indenting
Indenting is more commonly used when responding to discussion posts. A colon character (:) is placed at the beginning of the line. The more placed, the further the indent. This indents a line of text about the same length as if you pressed the Tab ⇆ key.
Example
:This line will be indented once.
::This line will be indented twice.
:::This line will be indented thrice.Results
- This line will be indented once.
- This line will be indented twice.
- This line will be indented thrice.
- This line will be indented twice.
- This line will be indented once.
This format is commonly used in discussion pages. When a user makes a post, it is common to indent your response. See the fake discussion below for an example of how to properly flow talk pages with indents. The colons only appear as an example.
Anybody else believe unicorns exist? --jd650
- :Yes. Actually, I've bred a couple of them. --MarcusTwain
- ::Really? Do you have photos? --jd650
- ::I, too, am interested in these photos. --Halifax
- :::I, err.. don't have a camera.. --MarcusTwain
- :No, I don't believe in unicorns. --ChOcObO_23
- ::Why not? --jd650
Adding tables
Tables are a diverse way to lay out information on a page. Because they can be very specific, the table below shows a quick how-to when creating Wiki tables as opposed to standard XHTML tables.
XHTML | Wiki | |
---|---|---|
Table | <table></table> | {| |} |
Styles | <table class="standard-table"></table> | {| class=standard-table {| class=wikitable |
Header cell | <th>heading</th> | ! heading |
Row | <tr></tr> | |- |
Data cell |
<td>cell1</td> |
| cell1 | cell2 |
Data cell | <td>cell1</td> <td>cell2</td> <td>cell3</td> | | cell1 || cell2 || cell3 |
Sample table | <table> <tr> <td>1</td> <td>2</td> </tr> <tr> <td>3</td> <td>4</td> </tr> <tr> <td>5</td> <td>6</td> </tr> </table> |
{| | 1 || 2 |- | 3 || 4 |- | 5 || 6 |} |
Sample table | <table> <tr> <th>Quantity</th> <th>Grocery Item</th> </tr> <tr> <td>4</td> <td>Apples</td> </tr> <tr> <td>3</td> <td>Oranges</td> </tr> <tr> <td>12</td> <td>Eggs</td> </tr> <tr> <td>9</td> <td>Bananas</td> </tr> </table> |
{| ! Quantity || Grocery Item |- | 4 || Apples |- | 3 || Oranges |- | 12 || Eggs |- | 9 || Bananas |} |
Syntax highlighting
To enable syntax highlighting for blocks of code, the syntax is pretty simple.

<source>
tag, because XML uses that tag in some scripts.Syntax
<syntaxhighlight lang="cpp">C++ source code</syntaxhighlight>
Example
<syntaxhighlight lang="cpp">(Insert FireBullets() method here)</syntaxhighlight>
Results
void CBaseEntity::FireBullets( const FireBulletsInfo_t &info ) { static int tracerCount; trace_t tr; CAmmoDef* pAmmoDef = GetAmmoDef(); int nDamageType = pAmmoDef->DamageType(info.m_iAmmoType); int nAmmoFlags = pAmmoDef->Flags(info.m_iAmmoType); //... //remainder omitted //... }
For a list of supported languages, see Help:Syntax Highlighting for more information.
Redirecting pages
Sometimes you'll come across pages that are named incorrectly, or improperly named. You can redirect pages to their intended destination by a couple different methods.
The easiest way to redirect a page that already contains data is to click the icon next to the search box above the page, then selecting Move Page. Follow instructions carefully before you decide to move a page.
The manual way to redirect a page is to use the following syntax:
Syntax
#REDIRECT [[new_page]]

#REDIRECT
tag.You can go back to a Redirect and edit it by clicking the link underneath the new page's title.
Message boxes
To make a portion of text standout from the rest, you can place them in preformatted boxes by simply placing a single space at the beginning of a line.
Syntax
Insert text after the space.
Example
There is a space at the beginning of this line.
Results
There is a space at the beginning of this line.
You can also use the <pre>
tag for a message box. Just use <pre>Message box.</pre>
.
Categorizing pages
If you'd like a page to show up in the automatically generated category tables (full category list found here) like on the category page Category:Level_Design, you will need to append the [[Category:name]]
at the bottom of the page.
For an example of how pages can be categorized, the bottom of this page have the following [[Category]]
tags:
[[Category:Tutorials]] [[Cateogry:Wiki]] [[Category:Help]]
Go ahead and scroll down to the bottom of the page. You'll notice the three categories that were just listed are available at the bottom.
Page Templates
Click here to view the extensive list of templates available for use.
Specific 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.
Mod Page Guidelines
To do: Condense Help:Mod_Profiles for quick list of tips.
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. If the newly defined word has an article, make it a link as well.
- 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.
Bolding
- Strong emphasis: "Using this command may cause hard drives to explode." Like italics, over-use of bolding renders the emphasis unintelligible.
- Menu commands and other program UI: "First, go to the File menu and choose Map Properties to bring up the Object Properties dialog box. Click the Skybox Texture Name field."
- If the word is a wiki link, it does not require to be bold.
<code> тег
- Предпочтительно к использованию, т.к. нет другой вики разметки с такими же функциями.
- Параметры командной строки:
c:\program files\valve\steam\
- Переменные в коде или текстовых файлах:
$staticprop
илиm_nCounter
- Консольные команды:
mat_wireframe 1
- Имена файлов:
bspzip.exe
- Имена энтитей:
info_player_start
- Другие игровые или Hammer данные, такие как имена текстур, имена input и output и т.д.
See also
- Help:Contents
- Help:Cleanup
- Category:Cleanup
- Valve Developer Community:About
- Valve Developer Community:Terms of use
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.