Difference between revisions of "Help:Editing:ru"

From Valve Developer Community
Jump to: navigation, search
m
(Настраиваю таблицу | Перевожу)
Line 2: Line 2:
 
|en=Help:Editing
 
|en=Help:Editing
 
}}
 
}}
 +
{{wip | [[User:Sodiet|Sodiet]] 08:29, 13 August 2012 (PDT)}}
 
{{totranslate:ru}}
 
{{totranslate:ru}}
 
{{cleanup:ru}}
 
{{cleanup:ru}}
== Создание новой страницы ==
 
Чтобы создать ноую страницу, вам надо просто ввести её '''URL''' в строке адреса.
 
Еслы вы хотите создать статью "Amazing New Tutorial"(''Увлекательный Новый Урок''), введите адрес http://developer.valvesoftware.com/wiki/Amazing_New_Tutorial. Затем отредактируйте страницу и сохраните её.
 
  
Альтернативным решением будет редактирование подходящей статьи по вашей теме. Добавьте ссылку на новую страницу (например, <code><nowiki>[[Amazing new Tutorial:ru]]</nowiki></code>) и щелкните по ней, чтобы перейти к странице редактирования.
+
__NOTOC__
 +
{{category header|background-color=#E0E0E0|border-color=lightgray}}
 +
{{category newcolumn|rowspan=5|width=50%|background-color=#F7F7F7|border-color=lightgray}}
  
== Редактирование существующих страниц ==
+
== Создание страниц ==
Редактирование текущей страницы происходит в новой форме с текстовым полем. Вы можете делать любые изменения, добавить краткое описание ваших изменений (обычно используется, если вы нашли грамматическую ошибку), и затем сохранить изменения. Страница изменена! Также вы можете использовать различные кнопки редактирования для добавления вики-разметки в статью.
+
* [[Help:Editing:ru#Creating_a_How-to_Page|How-to pages]]
{{note:ru|Редактировать статью можно, если она не заблокирована от изменений.}}
+
* [[Help:Editing:ru#Creating_a_Mod_Page|Mod pages]]
 +
* [[Help:Editing:ru#Creating_an_Entity_Page|Entity pages]]
 +
* [[Help:Editing:ru#Creating_Categories|Categories]]
 +
* [[Help:Editing:ru#Creating_User_Pages|User pages]]
 +
* [[Help:Editing:ru#Creating_Discussion_Pages|Discussion pages]]
 +
* [[Help:Editing:ru#Editing_Guidelines|'''Editing Guidelines''']]
  
== Кнопки редактирования ==
+
== Панель редактированиея ==
[[Image:mediawiki_editbuttons.png]]
 
  
Каждая кнопка отвечает за свой стиль форматирования. При нажатии она вставляет в текстовое поле разметку текста, который задаёт выделенному фрагменту специальное форматирование. Например, если вы хотите написать слово '''полужирным''' шрифтом, просто выделите это слово и нажмите на клавишу '''Ж''' (первая кнопка на панели редактирования).
+
https://developer.valvesoftware.com/w/skins/common/images/button_bold.png [[Help:Editing:ru#Bold_text|Bold text]]<br />
 +
https://developer.valvesoftware.com/w/skins/common/images/button_italic.png [[Help:Editing:ru#Italicized_text|Italic text]]<br />
 +
https://developer.valvesoftware.com/w/skins/common/images/button_link.png [[Help:Editing:ru#Internal_links|Adding internal links]]<br />
 +
https://developer.valvesoftware.com/w/skins/common/images/button_extlink.png [[Help:Editing:ru#External_links|Adding external links]]<br />
 +
https://developer.valvesoftware.com/w/skins/common/images/button_headline.png [[Help:Editing:ru#Adding_a_headline|Adding a headline]]<br />
 +
https://developer.valvesoftware.com/w/skins/common/images/button_image.png [[Help:Editing:ru#Embedded_pictures|Inserting a picture]]<br />
 +
https://developer.valvesoftware.com/w/skins/common/images/button_nowiki.png [[Help:Editing:ru#Ignore_Wiki_formatting|Ignore Wiki formatting]]<br />
 +
https://developer.valvesoftware.com/w/skins/common/images/button_sig.png [[Help:Editing:ru#Signature|Inserting your signature]]<br />
 +
https://developer.valvesoftware.com/w/skins/common/images/button_hr.png [[Help:Editing:ru#Horizontal_lines|Horizontal lines]]<br />
  
=== Жирный текст http://developer.valvesoftware.com/w/skins/common/images/button_bold.png ===
+
{{category newcolumn|rowspan=1|width=50%|background-color=#FBF7EA|border-color=#E4DCCD}}
'''Синтаксис:''' <code><nowiki>'''Жирный текст'''</nowiki></code>
 
  
Просто напишите три апострофа до фрагмента текста, который будет написан жирным и три апострофа после.
+
== Форматирование страниц ==
 +
* [[Help:Editing:ru#Bullet_points|Bullet points]]
 +
* [[Help:Editing:ru#Numbered_lists|Numbered lists]]
 +
* [[Help:Editing:ru#Definition_lists|Definition lists]]
 +
* [[Help:Editing:ru#Indenting|Indenting]]
 +
* [[Help:Editing:ru#Redirecting_pages|Redirecting pages]]
 +
* [[Help:Editing:ru#Adding_tables|Adding tables]]
 +
* [[Help:Editing:ru#Categorizing_pages|Categorizing pages]]
 +
* [[Help:Editing:ru#Syntax_highlighting|Syntax highlighting for script/code]]
 +
* [[Help:Editing:ru#Message_boxes|Message boxes]]
  
Если вы хотите '''сделать текст жирным''', вы должны ввести следующее:
+
{{category cell|width=50%|background-color=white|border-color=lightgray}}
    Если вы хотите <nowiki>'''сделать текст жирным'''</nowiki>
 
  
=== Курсивный текст http://developer.valvesoftware.com/w/skins/common/images/button_italic.png ===
+
== Page Templates ==
'''Синтаксис:''' <code><nowiki>''Текст курсивом''</nowiki></code>
+
* [[Help:Editing:ru/Page_Templates:ru#Markup_Templates|Markup templates]]
 +
* [[Help:Editing:ru/Page_Templates:ru#Maintenance_Templates|Maintenance templates]]
 +
* [[Help:Editing:ru/Page_Templates:ru#Formatting_Templates|Formatting templates]]
 +
* [[Help:Editing:ru/Page_Templates:ru#Entity-specific_Templates|Entity-specific templates]]
 +
** [[Help:Editing:ru/Page_Templates:ru#Valve_Game_Icons|Valve Game Icons]]
 +
{{category cell|width=50%|background-color=white|border-color=lightgray}}
  
Задать курсивный текст так же просто, как и жирный, только поставить надо не три, а два апострофа до и после фрагмента текста.
+
== Руководство по специальному форматированию ==
 +
* [[Help:Editing:ru#Mod_Page_Guidelines|Mod Page Guidelines]]
 +
* [[Help:Editing:ru#Italics|Italics]]
 +
* [[Help:Editing:ru#Bolding|Bolding]]
 +
* [[Help:Editing:ru#Code_tag|<nowiki><code></nowiki> tag]]<br />
  
Если вы хотите ''сделать текст курсивом'', введите следующее:
+
* [[Help:Editing:ru#See_also|See also]]
    Если вы хотите <nowiki>''сделать текст курсивом''</nowiki>
 
  
=== Подчёркнутый текст ===
+
{{category end}}
'''Синтаксис:''' <code><nowiki><u>Подчеркнутый текст</u></nowiki></code>
 
  
Встроенной вики-разметки нет, но кто вам мешает использовать обычную HTML-разметку?
+
= Page Creation =
Используйте тег <code><nowiki><u></nowiki></code>
+
You can start editing a non-existent page in several ways:
  
<u>Подчеркнутый текст</u> делается так:
+
* The easiest way is to type the exact name you want into the "Search" bar then hit "Go". If the page doesn't exist, you will be able to create it.
    <nowiki><u>Подчеркнутый текст</u></nowiki>
+
{{warning|Make sure the subject of the page you have in mind isn't already on the wiki. For example, you want to create the page "Portal 2 Particles", but you didn't notice the [[List of Portal 2 Particles]] page.}}
 +
:For example, let's say you've typed "Foobar" in the search bar, then hit the "Go" button. Since the page doesn't exist, you are given this message:
 +
::There were no results matching the query.
 +
::'''Create the page "<span style="color:#C20;">Foobar</span>" on this wiki!'''
 +
:In this scenario, you are able to click the <span style="color:#C20;">Foobar</span> link and begin editing your new page.
 +
{{tip|Red links are pages that have not been created yet, and blue links are pages that already exist.}}
 +
* You can can modify the URL in your address bar to go where you'd like (in this case using the address ''<nowiki>https://developer.valvesoftware.com/wiki/Foobar</nowiki>'').
 +
* Some pages in the wiki contain many red links. If you are familiar with the subject matter of the non-existent page, feel free to create the new page by following the red link. Your contributions are greatly appreciated, and the more blue links, the better.
  
{{note:ru|Несмотря на то, что на панели инструментов есть кнопка с изображением подчёркнутого текста http://developer.valvesoftware.com/w/skins/common/images/button_link.png, она задает не подчеркнутый текст, как можно подумать, а внутреннюю ссылку (См. далее)}}
+
During the course of an edit, clicking ''Show preview'' (to the right of the ''Save page'' button) will help you determine if your edit looks good. This displays the final result of the edited page, but does not save it. This will avoid spamming the ''Recent changes'' page with saved edits, to the frustration of other editors.
  
=== Внутренняя ссылка http://developer.valvesoftware.com/w/skins/common/images/button_link.png ===
+
When you are done editing, proofread it to make sure that the edit is final, and then click ''Save page'' to finally create the new page.
  
'''Синтаксис:''' <code><nowiki>[[Текст ссылки]]</nowiki></code>
+
=== Sandboxes ===
 +
To test your editing skills, you can either use the public [[Valve Developer Community:Sandbox|Sandbox]] page, or create your own sandbox page. You can create your own sandbox by navigating to your user page, then adding "/Sandbox" in your address bar at the end of the URL. Be sure you're on your user page before creating it.
  
Если вы хотите сделать ссылку на другую страницу, вам нужен заголовок этой статьи. Чтобы сделать ссылку на главную страницу (''англ.'' Main Page), просто напишите "Main_Page"!
+
Seasoned editors who wish to further advance their editing skills in Templates can use the [[Template:TestTemplate]] page to test their template code.
 +
{{backtotop|align=right}}
  
Чтобы сделать ссылку на Главную Страницу([[Main_Page]]), нужен следующий код:
+
== Creating a How-to Page ==
    Чтобы сделать ссылку на Главную Страницу(<nowiki>[[Main_Page]]</nowiki>)
 
  
Также вы можете менять текст ссылки, который не будет влиять на адрес ссылки. Это нужно для соблюдения норм грамматики.
+
There are some basic guidelines on writing your own tutorial and how-to pages.  
  
Итак, чтобы сделать ссылку на [[Main_Page|страницу, которая является Главной]], вам нужен следующий код:
+
* Most importantly, before you start, make sure you fully understand the subject you want to write a tutorial about. It can be very hard to write something informative if you're not sure how to do it yourself.
    Итак, чтобы сделать ссылку на <nowiki>[[Main_Page|страницу, которая является Главной]]</nowiki>
+
* Decide what kind of tutorial you are making. Is it a basic tutorial for people who haven't used [[Valve Hammer Editor|Hammer]] much, like how to use the texture browser? Or is it a tutorial explaining how to create complex scenarios with-in a game, more suited for advanced users?
 +
* A good tutorial is a tutorial that is fun to read:
 +
** Before you start, add a brief description of what the tutorial will be about.
 +
** Split it into steps, each with one very specific key feature. If it is a beginner tutorial, do not be afraid to include every step.
 +
** Group sets of steps which all together achieve one through the other a goal. For example, if you are writing a tutorial about a collapsing elevator, group the steps explaining how to create an elevator frame, animated door model, and invisible entities into one group. The next group of steps in the tutorial can explain how to make the elevator collapse using entity inputs and outputs. Finally, describe how to connect everything together.
 +
** Add pictures. An image can describe something that is not self-explanatory. However, don't overflow the tutorial with them: use images when it will improve the text.
 +
** Add charts, when explaining entity input and output behaviors. It's easier to follow if there's a chart identical to the Output flag in Hammer already filled with the information. The reader can just copy it or reverse engineer it to see why it should be done like this and not differently.
 +
* When writing a tutorial, keep in mind people who may not be familiar with most of the uncommon entities in Hammer. When listing one, [[Help:Editing#Internal_links|link]] it to the page describing it. Don't try to explain what it is, or how generally it should be used if it's already explained on the entity page.
 +
* Try to connect steps with a logical order that other people will understand. After reading your tutorial they will do that action as you did it. If they can't understand what they did they can't improve upon it.
 +
* Make a good summary at the end of the tutorial to make it obvious to the reader had done all the steps necessary in order to achieve the goal.
  
=== Внешние ссылки http://developer.valvesoftware.com/w/skins/common/images/button_extlink.png ===
+
Now create a [[Help:Editing#Sandboxes|sandbox page]] and start writing!
'''Синтаксис:''' <code><nowiki>[http://www.example.com текст ссылки]</nowiki></code>
 
  
Внешние ссылки используются для WEB-страниц, которые не находятся в этой вики.
+
== Creating a Mod Page ==
 +
Please review the [[Help:Mod_Profiles|Mod page guidelines]] before creating a page for a Source/GoldSrc mod.
  
Чтобы сделать ссылку на сайт [http://www.steampowered.com Steampowered.com], используйте следующий код:
+
== Creating an Entity Page ==
    Чтобы сделать ссылку на сайт <nowiki>[http://www.steampowered.com Steampowered.com]</nowiki>
+
See [[Entity Article Template]] for help creating entity pages.
  
=== Заголовок http://developer.valvesoftware.com/w/skins/common/images/button_headline.png ===
+
== Creating Categories ==
'''Синтаксис:''' <code><nowiki>==Текст заголовка==</nowiki></code>
+
[[Special:Categories|Categories]] enable pages to be added to automatic listings. These help structure many pages by grouping them together around similar subjects. There may also be a section listing the subcategories of that category.
  
Заголовки нужны для того, чтобы разделять страницу на разные логические части. Заголовок первого уровня используется в названии страницы, он очень большой. Если использовать его во второй раз, то он будет немного меньше. Все добавленные вами заголовки будут одинакового размера, который зависит от количества знаков равенства.  
+
Category pages are usually created for the description of their existence. For example, [[:Category:Blender]] is a category for all pages related to the free and open source 3D modeling package, [[Blender]].
  
Заголовки - идеальное средство для упорядочивания материала на странице. К тому же, вики-движок автоматически создает содержание страницы в начале, позволяя просмотреть нужную информацию по одному щелчку мышки.
+
To add a page to a category, simply place <code>[[Category:'''CATEGORY NAME''']]</code> at the bottom of the page. All pages that have the same category name will be listed automatically in the category.
  
=== Так можно получить такой прекрасный большой текст как этот ===
+
For a list of all current categories, visit [[Special:Categories]].
'''Используйте следующий код:'''
+
{{backtotop|align=right}}
    <nowiki>=== Так можно получить такой прекрасный большой текст как этот ===</nowiki>
 
  
=== Вставка изображений http://developer.valvesoftware.com/w/skins/common/images/button_image.png ===
+
== Creating User Pages ==
'''Синтаксис:''' <code><nowiki>[[Image:Example.jpg]]</nowiki></code>
+
Your user page is your own personal editing venture. You are free to edit it with anything you desire. It is frowned upon by the Valve Developer Community to make direct edits to user pages that do not belong to you, unless the page contains media or external links relating to pornographic material, illegal warez/torrent sites, etc. If that is the case, you will risk your IP for permanent ban from the VDC.
  
Изображения можно загружать на этот сайт и напрямую ссылаться на них.  
+
To edit your user space, you must first have an account on the VDC. Registering is [https://developer.valvesoftware.com/w/index.php?title=Special:UserLogin&type=signup free and easy to do.]
{{Tip:ru|Чтобы загрузить изображение, перейдите на эту страницу: [[Special:Upload]]}}
+
Once you're logged in, click on your username at the very top-right of this page.
 +
{{backtotop|align=right}}
  
Чтобы добавить эту картинку с улыбающимся лицом [[Image:Test.gif]], используйте следующее:
+
== Creating Discussion Pages ==
    Чтобы добавить эту картинку с улыбающимся лицом <nowiki>[[Image:Test.gif]]</nowiki>
+
Discussion (or talk) pages are for user discussions concerning the information contained in its respective main page. It can also be used for requesting help. Talk pages (even your own) should not be used for sandboxes. Doing so does not leave a proper place for discussion.
  
{{Warning:ru|УБЕДИТЕСЬ В ТОМ, ЧТО ЗАГРУЖЕННЫЕ ИЗОБРАЖЕНИЯ НЕ ЗАЩИЩЕНЫ АВТОРСКИМ ПРАВОМ.}}
+
To create or edit a discussion page, just click the "Discussion" tab above, next to the "Page" tab.
 +
{{tip|You can also use the keystroke {{key|Alt}}+{{key|T}} to quickly switch to the discussion page, that is if your web browser/operating system allows it.}}
  
=== Без вики-разметки http://developer.valvesoftware.com/w/skins/common/images/button_nowiki.png ===
+
Discussion pages have a special flow. When you are commenting on posts in a discussion page, indents are used to reply to comments. [[Help:Editing#Indenting|See below]] for more information on this technique.
'''Syntax:''' <code><nowiki><nowiki>Вставьте неформатированный текст сюда</nowiki></nowiki></code>
 
  
Этот тег нечасто используется, исключая создание [[Help with Editing:ru|этой страницы]], где нужно просмотреть нужные теги, которые нельзя отобразить обычным способом, т.к. вики-движок воспринимает это как форматированный текст. Чтобы избежать этого, используйте тег <nowiki><nowiki></nowiki></nowiki> вокруг нужного (того, который надо отобразить).
+
It is important to sign your comments with your username and the time/date of the post. This is a simple process that only requires four characters. Four tildes (<nowiki>~~~~</nowiki>) will automatically be replaced with your public user information along with the time and date of the post. Signatures are explained further [[Help:Editing#Signature|here]].
 +
{{backtotop|align=right}}
  
 +
== Editing Guidelines ==
 +
<!-- More guidelines would be helpful -->
 +
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 {{key|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 [[Special:RecentChanges|Recent changes]] page clean and easier to navigate.
  
<nowiki><code>Вставьте сюда текст</code></nowiki>
+
= Editing Toolbar =
<nowiki><nowiki><code>Вставьте сюда текст</code></nowiki></nowiki>
+
https://developer.valvesoftware.com/w/images/1/1e/Mediawiki_editbuttons.png{{clr}}
 +
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 https://developer.valvesoftware.com/w/skins/common/images/button_bold.png ==
 +
Bold text is very simple. Put in three (3) single apostrophes before the section of text you wish to bold, and three (3) after.
 +
{{syntax2
 +
|syn=<nowiki>'''Bold text'''</nowiki>
 +
|in=<nowiki>Remember to '''always''' brush your teeth.</nowiki>
 +
|out=Remember to '''always''' brush your teeth.
 +
}}
  
=== Подпись http://developer.valvesoftware.com/w/skins/common/images/button_sig.png ===
+
== Italicized text https://developer.valvesoftware.com/w/skins/common/images/button_italic.png ==
'''Синтаксис:''' <code><nowiki>--~~~~</nowiki></code>
+
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.
 +
{{syntax2
 +
|syn=<nowiki>''Italic text''</nowiki>
 +
|in=<nowiki>The ''Queen Mary'' sailed last night.</nowiki>
 +
|out=The ''Queen Mary'' sailed last night.
 +
}}
  
Вставляет ваше имя (имя пользователя) и время/дату создания. Это обычно используется для подписи своих сообщений на страницах обсуждения.
+
== Internal links https://developer.valvesoftware.com/w/skins/common/images/button_link.png ==
{{warning:ru|Т.к. создавать и редактировать статьи на Valve Developer Community может каждый, в статьях подписи использовать  '''нельзя'''}}
+
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!
 +
{{syntax2
 +
|syn=<nowiki>[[Link title]]</nowiki>
 +
|in=<nowiki>Click here to go to the main page: [[Main Page]]</nowiki>
 +
|out=Click here to go to the main page: [[Main Page]]
 +
}}
 +
{{note|Spaces are automatically converted to underlines for internal links. <nowiki>[[Main_Page]]</nowiki> is equivalent to <nowiki>[[Main Page]]</nowiki>, but you should use the latter.}}
 +
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.
 +
{{syntax2
 +
|syn=<nowiki>[[Link title|Text for link]]</nowiki>
 +
|in=<nowiki>[[Main Page|Click here]] to go to the main page.</nowiki>
 +
|out=[[Main Page|Click here]] to go to the main page.
 +
}}
 +
{{tip|Any header on a page can be "jumped to" by including a hash tag and header name at the end of the link title. For example: <code><nowiki>[[Help:Editing#Internal_links|Jump to "Internal links"]]</nowiki></code>.}}
  
=== Горизонтальная линия http://developer.valvesoftware.com/w/skins/common/images/button_hr.png ===
+
== External links https://developer.valvesoftware.com/w/skins/common/images/button_extlink.png ==
'''Синтаксис:''' <code><nowiki>----</nowiki></code>
+
External links are used to link to web pages that are not in this wiki. Any link with the https://developer.valvesoftware.com/w/skins/vector/images/external-link-ltr-icon.png icon means it's external, and any link with the https://developer.valvesoftware.com/w/skins/vector/images/lock-icon.png icon means it's a secure link.
 +
{{syntax2
 +
|syn=<nowiki>[http://www.example.com link title]</nowiki>
 +
|in=<nowiki>[http://www.valvesoftware.com/jobs/ Click here]</nowiki> to learn more about applying to Valve.
 +
|out=[http://www.valvesoftware.com/jobs/ Click here] to learn more about applying to Valve.
 +
}}
 +
{{syntax2
 +
|in=<nowiki>[https://plus.google.com Google+ (secure link)]</nowiki>
 +
|out=[https://plus.google.com Google+ (secure link)]
 +
}}
  
Горизонтальные линии используются для отделения больших блоков текста друг от друга, и ими лучше не злоупотреблять, т.к. выглядит это некрасиво. Чтобы отделить
+
== Adding a headline https://developer.valvesoftware.com/w/skins/common/images/button_headline.png ==
----
+
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.
этот текст, используйте следующий код:
 
    <nowiki>Чтобы отделить
 
    ----
 
    этот текст</nowiki>
 
  
== Other, unlisted formatting tools ==
+
{{syntax2
 +
|syn=<nowiki>= Extra-Large Headline =</nowiki><br />
 +
<nowiki>== Large Headline ==</nowiki><br />
 +
<nowiki>=== Medium Headline ===</nowiki><br />
 +
<nowiki>==== Small Headline ====</nowiki>
 +
}}
  
=== Categorizing your pages ===
+
= Extra-large =
'''Syntax:''' <code><nowiki>[[Category:Category Name]]</nowiki></code>
+
* 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
  
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:
+
== Embedded pictures https://developer.valvesoftware.com/w/skins/common/images/button_image.png ==
 +
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]].
 +
{{warning|Please read the [[Valve_Developer_Community:Image_use_policy|image use policy]] before uploading images.}}
 +
{{syntax2
 +
|syn=<nowiki>[[Image:Filename.png]]</nowiki>
 +
|in=<nowiki>[[Image:Steam_available.png]]</nowiki>
 +
|out=[[Image:Steam_available.png]]
 +
}}
 +
The <code><nowiki>[[Image:Filename.png]]</nowiki></code> syntax has a few options that you can use. These can be placed as an option anywhere in the line:
 +
:{| class=standard-table
 +
! Option || Example || Description
 +
|-
 +
| ''thumb'' || <code><nowiki>[[Image:Filename.png|thumb]]</nowiki></code> || Produces a framed thumbnail version of the image.
 +
|-
 +
| ''###px'' (size) || <code><nowiki>[[Image:Filename.png|300px|thumb|This is an example image]]</nowiki></code> || Changes the pixel size of the images.
 +
|-
 +
| ''left (right, center)'' || <code><nowiki>[[Image:Filename.png|thumb|150px|right]]</nowiki></code> || Controls the alignment of the image on the page
 +
|}
  
<nowiki>[[Category:Level Design]]</nowiki><br>
+
== Ignore Wiki formatting https://developer.valvesoftware.com/w/skins/common/images/button_nowiki.png ==
<nowiki>[[Category:Tutorials]]</nowiki>
+
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.
 +
{{syntax2
 +
|syn=<nowiki><nowiki>Insert non-formatted text here</nowiki></nowiki>
 +
|in=<nowiki><nowiki>This is '''bold''' text.</nowiki></nowiki>
 +
|out=<nowiki>This is '''bold''' text.</nowiki>
 +
}}
  
=== Cite code  ===
+
== Signature https://developer.valvesoftware.com/w/skins/common/images/button_sig.png ==
'''Syntax:''' <code><nowiki><code>inline code text</code></nowiki></code>
+
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#mw-htmlform-signature|Special:Preferences]].
 +
{{tip|The syntax includes two hyphens (--), but you really only need four tildes (<nowiki>~~~~</nowiki>) to insert a signature.}}
 +
:{{syntax2
 +
|syn=<nowiki>--~~~~</nowiki>
 +
|in=<nowiki>This discussion page may need archived soon. --~~~~</nowiki>
 +
|out=This discussion page may need archived soon. --[[User:FakeUser23|FakeUser23]] 21:38, 17 October 2011 (PDT)
 +
}}
  
Open a <nowiki><code></nowiki> tag before your text and close it after your text with <nowiki></code></nowiki>.
+
== Horizontal lines https://developer.valvesoftware.com/w/skins/common/images/button_hr.png ==
 +
{{syntax2
 +
|syn=<nowiki>----</nowiki>
 +
}}
 +
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 [[#Adding_a_headline|headlines]] can render these unnecessary.
  
If you want to cite a <code>piece of code</code>, then the code would run as so:
+
{{backtotop|align=right}}
    If you want to cite a <nowiki><code>piece on code</code></nowiki>
+
= Formatting Pages =
  
If you want to cite an entire block of code, do not use <code><nowiki><code></nowiki></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.
+
== Bullet points ==
 +
This function can create unordered lists. Bullet points are useful for listing multiple items that fall into a similar category.
 +
{{syntax2
 +
|syn=
 +
<nowiki>* Item 1</nowiki><br />
 +
<nowiki>* Item 2</nowiki><br />
 +
<i>* etc...</i>
 +
|in=
 +
<nowiki>* Red</nowiki><br />
 +
<nowiki>* Blue</nowiki><br />
 +
<nowiki>* Green</nowiki>
 +
|out=<br />
 +
* Red
 +
* Blue
 +
* Green
 +
}}
 +
{{tip|Increasing the number of asterisks (<nowiki>*</nowiki>) increases the indent of the item.}}
  
For example:
+
== Numbered lists ==
 +
You can create ordered lists using this syntax. Numbered lists automatically number items according to their placement in the page.
 +
{{syntax2
 +
|syn=
 +
<nowiki># Item 1</nowiki><br />
 +
<nowiki># Item 2</nowiki><br />
 +
<i># etc...</i>
 +
|in=
 +
<nowiki># This is the first step.</nowiki><br />
 +
<nowiki># This is the second step.</nowiki><br />
 +
|out=<br />
 +
# This is the first step.
 +
# This is the second step.
 +
}}
  
int a;
+
== Definition lists ==
+
You can also create definition lists equivalent to the <nowiki><dl>, <dt>, and <dd></nowiki> HTML tags.
// comment
+
{{syntax2
+
|syn=<nowiki>;Item 1</nowiki><br />
a = 10;
+
<nowiki>:About Item 1</nowiki><br />
 +
<nowiki>;Item 2</nowiki><br />
 +
<nowiki>:About Item 2</nowiki>
 +
|in=<nowiki>;Center</nowiki>
 +
<nowiki>:A point equidistant from all points on the surface of a sphere.</nowiki>
 +
|out=<br />
 +
;Center
 +
:A point equidistant from all points on the surface of a sphere.
 +
}}
  
{{note|HTML <code><nowiki><pre></nowiki></code> tags can also be used, but should be avoided unless absolutely necessary.}}
+
== 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 {{key|Tab}} key.
 +
{{syntax2
 +
|in=<nowiki>:This line will be indented once.</nowiki><br />
 +
<nowiki>::This line will be indented twice.</nowiki><br />
 +
<nowiki>:::This line will be indented thrice.</nowiki>
 +
|out=&nbsp;
 +
:This line will be indented once.
 +
::This line will be indented twice.
 +
:::This line will be indented thrice.
 +
}}
  
=== "Code" boxes ===
+
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.
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...
+
Anybody else believe unicorns exist? --<span style="color:#8BB9E0;">jd650</span>
 +
:<b><nowiki>:</nowiki></b>Yes. Actually, I've bred a couple of them. --<span style="color:#8BB9E0;">MarcusTwain</span>
 +
::<b><nowiki>::</nowiki></b>Really? Do you have photos? --<span style="color:#8BB9E0;">jd650</span>
 +
::<b><nowiki>::</nowiki></b>I, too, am interested in these photos. --<span style="color:#8BB9E0;">Halifax</span>
 +
:::<b><nowiki>:::</nowiki></b>I, err.. don't have a camera.. --<span style="color:#8BB9E0;">MarcusTwain</span>
 +
:<b><nowiki>:</nowiki></b>No, I don't believe in unicorns. --<span style="color:#8BB9E0;">ChOcObO_23</span>
 +
::<b><nowiki>::</nowiki></b>Why not? --<span style="color:#8BB9E0;">jd650</span>
  
Insert a space at the beginning of the paragraph.
+
== 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.
  
=== Маркеры ===
+
<table class="wikitable">
Маркеры используются для разных элементов, которые относятся к одной категории.
+
<tr><th>&nbsp;</th><th>XHTML</th><th>Wiki</th>
  
* Thing 1
+
<tr>
* Thing 2
+
<th>Table</th>
* Thing 3
+
<td><nowiki><table></table></nowiki>
 +
<td><pre><nowiki>{|
 +
|}</nowiki></pre>
 +
<tr>
 +
<th>Styles</th>
 +
<td><nowiki><table class="standard-table"></table></nowiki></td>
 +
<td><pre><nowiki>{| class=standard-table</nowiki>
 +
<nowiki>{| class=wikitable</nowiki></pre></td>
 +
<tr>
 +
<th>Header cell</th>
 +
<td><nowiki><th>heading</th></nowiki></td>
 +
<td><pre><nowiki>! heading</nowiki></pre></td>
 +
<tr>
 +
<th>Row</th>
 +
<td><nowiki><tr></tr></nowiki></td>
 +
<td><pre><nowiki>|-</nowiki></pre></td>
 +
<tr>
 +
<th>Data cell</th>
 +
<td>
 +
<nowiki><td>cell1</td></nowiki><br>
 +
<nowiki><td>cell2</td></nowiki>
 +
</td>
 +
<td>
 +
<pre><nowiki>| cell1
 +
| cell2</nowiki></pre>
 +
</td>
 +
</tr>
 +
<tr>
 +
<th>Data cell</th>
 +
<td><nowiki><td>cell1</td> <td>cell2</td> <td>cell3</td></nowiki></td>
 +
<td><pre><nowiki>| cell1 || cell2 || cell3</nowiki></pre></td>
 +
</tr>
 +
<tr>
 +
<th>Sample table</th>
 +
<td><pre><nowiki>
 +
<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>
 +
</nowiki></pre></td>
 +
<td><pre><nowiki>
 +
{|
 +
| 1 || 2
 +
|-
 +
| 3 || 4
 +
|-
 +
| 5 || 6
 +
|}</nowiki></pre></td>
 +
</tr>
 +
<tr>
 +
<th>Sample table</th>
 +
<td><pre><nowiki>
 +
<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>
 +
</nowiki></pre></td>
 +
<td><pre><nowiki>
 +
{|
 +
! Quantity || Grocery Item
 +
|-
 +
| 4 || Apples
 +
|-
 +
| 3 || Oranges
 +
|-
 +
| 12 || Eggs
 +
|-
 +
| 9 || Bananas
 +
|}</nowiki></pre></td>
 +
</tr>
 +
</table>
  
Маркированный список как этот, можно сделать так:
+
== Syntax highlighting ==
<nowiki>* Thing 1
+
To enable syntax highlighting for blocks of code, the syntax is pretty simple.
* Thing 2
+
{{note|This new syntax replaces the <code><nowiki><source></nowiki></code> tag, because XML uses that tag in some scripts.}}
* Thing 3</nowiki>
+
{{syntax2
 +
|syn=<nowiki><syntaxhighlight lang="cpp">C++ source code</syntaxhighlight></nowiki>
 +
|in=<nowiki><syntaxhighlight lang="cpp"></nowiki><i>(Insert [[FireBullets()]] method here)</i><nowiki></syntaxhighlight></nowiki>
 +
|out=<syntaxhighlight lang="cpp">
 +
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
 +
        //...
 +
}
 +
</syntaxhighlight>
 +
}}
  
=== Отступы ===
+
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.
<nowiki>:Один отступ
 
::Два отступа.</nowiki>
 
  
Который отобразится так:
+
The easiest way to redirect a page that already contains data is to click the https://developer.valvesoftware.com/w/skins/vector/images/arrow-down-icon.png 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:
Чтобы перенаправить пользователя на другую страницу, используйте следующий код:
+
{{syntax2
 +
|syn=<nowiki>#REDIRECT [[new_page]]</nowiki>
 +
}}
 +
{{warning|This method can only be used if the page is empty. If you are manually moving a page, copy the edit source of the page and paste it into the new page. Then the original page can be replaced with the <code><nowiki>#REDIRECT</nowiki></code> tag.}}
  
<nowiki>#REDIRECT [[новая_страница]]</nowiki>
+
You can go back to a Redirect and edit it by clicking the link underneath the new page's title.
  
Все, кто зайдут на эту страницу, перейдут на новую_страницу. Пример: [[Game Cache File]]
+
== 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.
 +
{{syntax2
 +
|syn=<nowiki>&nbsp;Insert text after the space.</nowiki>
 +
|in=<nowiki>&nbsp;There is a space at the beginning of this line.</nowiki>
 +
|out=<pre>There is a space at the beginning of this line.</pre>
 +
}}
 +
You can also use the <code><nowiki><pre></nowiki></code> tag for a message box. Just use <code><nowiki><pre>Message box.</pre></nowiki></code>.
  
{{note:ru|Вы можете перейти назад на страницу и отредактировать её.}}
+
== Categorizing pages ==
 +
If you'd like a page to show up in the automatically generated category tables (<i>full category list [[Special:Categories|found here]]</i>) like on the category page [[:Category:Level_Design]], you will need to append the <code><nowiki>[[Category:name]]</nowiki></code> at the bottom of the page.
  
=== Tables ===
+
For an example of how pages can be categorized, the bottom of this page have the following <code><nowiki>[[Category]]</nowiki></code> tags:
Tables are exceedingly complex, and cannot be described here in sufficient detail. Please use the [[Metawikipedia:Help:Table|Wikimedia Help:Table]] page to assist you in creating them. They are just as versatile as their HTML counterparts.
+
<nowiki>[[Category:Tutorials]]</nowiki>
 +
<nowiki>[[Cateogry:Wiki]]</nowiki>
 +
<nowiki>[[Category:Help]]</nowiki>
  
=== Templates ===
+
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.
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:
+
{{backtotop|align=right}}
 +
= Page Templates =
 +
[[Help:Editing/Page_Templates|Click here]] to view the extensive list of templates available for use.{{backtotop|align=right}}
  
* <nowiki>{{</nowiki>[[Template:Cleanup|Cleanup]]<nowiki>}}</nowiki> &mdash; used to mark articles in need of cleanup to conform to a sufficient level of quality.
+
= Specific Formatting Guidelines =
* <nowiki>{{</nowiki>[[Template:Pov|Pov]]<nowiki>}}</nowiki> &mdash; used to mark articles which do not follow the point of view guideline.
+
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.
* <nowiki>{{</nowiki>[[Template:wip|wip]]<nowiki>}}</nowiki> &mdash; use this to tell other editors you are currently editing the article.
+
== Mod Page Guidelines ==
*<nowiki>{{</nowiki>[[template:Note|Note]]<nowiki>}}</nowiki> &mdash; This is used for adding a note message
+
{{todo|Condense [[Help:Mod_Profiles]] for quick list of tips.}}
::'''Example:''' <nowiki>{{Note|This is a note}}</nowiki> '''Produces:'''
+
== Italics ==
:::{{Note|This is a note}}
 
* <nowiki>{{</nowiki>[[template:tip|tip]]<nowiki>}}</nowiki> &mdash; This is used for adding a helpful tip
 
::'''Example:''' <nowiki>{{tip|This is a helpful tip}}</nowiki> '''Produces:'''
 
::: {{tip|This is a helpful tip}}
 
*<nowiki>{{</nowiki>[[template:warning|warning]]<nowiki>}}</nowiki> &mdash; Add a warning message
 
::'''Example:''' <nowiki>{{warning|This is a bad idea}}</nowiki> '''Produces:'''
 
:::{{warning|This is a bad idea}}
 
* <nowiki>{{</nowiki>[[template:bug|bug]]<nowiki>}}</nowiki> &mdash; Used for describing a known bug
 
::'''Example:''' <nowiki>{{bug|This is a bug}}</nowiki> '''Produces:'''
 
:::{{bug|This is a bug}}
 
* <nowiki>{{</nowiki>[[template:clr|clr]]<nowiki>}}</nowiki> &mdash; This is used for clearing vertical space after an image
 
*<nowiki>{{</nowiki>[[template:Wiki|Wiki]]<nowiki>}}</nowiki> &mdash; used to link to a wikipedia article.
 
::'''Example:''' <nowiki>{{Wiki|Valve Corporation}}</nowiki> '''Produces:'''
 
::: {{Wiki|Valve Corporation}}
 
* <nowiki>{{</nowiki>[[template:todo|todo]]<nowiki>}}</nowiki> &mdash; Used for listing unfinished work on an article
 
::'''Example:''' <nowiki>{{todo|add some stuff}}</nowiki> '''Produces:'''
 
:::{{todo|add some stuff}}
 
*<nowiki>{{</nowiki>[[template:PD|PD]]<nowiki>}}</nowiki> &mdash; Used for marking an image as being in the Public Domain
 
*<nowiki>{{</nowiki>[[template:HL1|HL1]]<nowiki>}}</nowiki> &mdash; Goldsource Icon
 
*<nowiki>{{</nowiki>[[template:HL2|HL2]]<nowiki>}}</nowiki> &mdash; Source Icon
 
*<nowiki>{{</nowiki>[[template:EP1 add|EP1 add]]<nowiki>}}</nowiki> &mdash; For listing a feature added with Episode 1 Source Engine update
 
::'''Example:''' <nowiki>{{EP1 add|crates}}</nowiki> '''Produces:'''
 
:::{{EP1 add|crates}}
 
*<nowiki>{{</nowiki>[[template:EP2 add|EP2 add]]<nowiki>}}</nowiki> &mdash; For listing a feature added with the Orange Box Source Engine update
 
::'''Example:''' <nowiki>{{EP2 add|barrels}}</nowiki> '''Produces:'''
 
:::{{EP2 add|barrels}}
 
*<nowiki>{{</nowiki>[[template:L4D add|L4D add]]<nowiki>}}</nowiki> &mdash; For listing a feature added with the Left 4 Dead Source Engine update
 
::'''Example:''' <nowiki>{{L4D add|crates and barrels}}</nowiki> '''Produces:'''
 
:::{{L4D add|crates and barrels}}
 
*<nowiki>{{</nowiki>[[template:OutputsTable|OutputsTable]]<nowiki>}}</nowiki> &mdash; For creating an entity outputs table
 
* <nowiki>{{</nowiki>[[Template:Split-apart|Split-apart]]<nowiki>}}</nowiki> &mdash; For suggesting an article has become too long or is covering too broad a subject
 
* <nowiki>{{</nowiki>[[Template:Shortcut|Shortcut]]<nowiki>}}</nowiki> &mdash; used to put a little box to the right, displaying a shortcut title to a redirect page to that article.
 
* <nowiki>{{</nowiki>[[Template:Stub|Stub]]<nowiki>}}</nowiki> &mdash; used to mark and categorize a [[Wikipedia:Wikipedia:Stub|stub]] article.
 
* <nowiki>{{</nowiki>[[Template:Delete|Delete]]<nowiki>}}</nowiki> &mdash; For suggesting a candidate for speedy deletion, no reason given.
 
* <nowiki>{{</nowiki>[[Template:Deletebecause|Deletebecause]]<nowiki>}}</nowiki> &mdash; For suggesting a candidate for speedy deletion, reason given.
 
* <nowiki>{{</nowiki>[[Template:Deleteagain|Deleteagain]]<nowiki>}}</nowiki> &mdash; For suggesting reposted content that has been removed before but brought back.
 
* <nowiki>{{</nowiki>[[Template:Nonsense|Nonsense]]<nowiki>}}</nowiki> &mdash; For suggesting a candidate for speedy deletion because article is [[Wikipedia:Wikipedia:Patent nonsense|patent nonsense]].
 
&nbsp;<br>
 
[http://developer.valvesoftware.com/w/index.php?title=Special%3AAllpages&from=&namespace=10 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.
 
* 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.
+
* Newly defined words in a sentence. For example: "Levels are created with a series of blocks, called ''[[brush]]es'', 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: <code>hl2.exe +map ''mapname'' -dev</code>
 
* Parameters in a command-line that are to be replaced by the user: <code>hl2.exe +map ''mapname'' -dev</code>
 
* Can be combined with "<" and ">" for parameters with longer names: <code>hl2.exe -game ''<game directory>''</code>
 
* Can be combined with "<" and ">" for parameters with longer names: <code>hl2.exe -game ''<game directory>''</code>
 
* Other standard uses in English can be found at [[Wikipedia:Italic_type]].
 
* Other standard uses in English can be found at [[Wikipedia:Italic_type]].
  
=== Использование тега<nowiki><code></nowiki> ===
+
== Bolding ==
* Если нету другого эквивалента викиразметки.
+
* Strong emphasis: "Using this command may cause hard drives to '''explode'''." Like italics, over-use of bolding renders the emphasis unintelligible.
* Выражения коммандной строки:<code>c:\program files\valve\steam\</code>
+
* 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."
* Переменные в коде или в текстовых файлах:<code>$staticprop</code> или <code>m_nCounter</code>
+
* If the word is a wiki link, it does not require to be bold.
* Параметры консоли разработчика: <code>mat_wireframe 1</code>
 
* Имена файлов: <code>bspzip.exe</code>
 
* Названия энтитей: <code>info_player_start</code>
 
* Другие игровые или данные редактора Hammer, такие как названия текстур, Input'ов/Output'ов, и.т.п.
 
  
=== Выделение жирным ===
+
== <nowiki><code> tags</nowiki> ==
* Очень важные моменты: "'''Примечание:''' Использование этой команды может привести к '''поломке жесткого диска'''." Так же, как и курсивом, жирным шрифтом не стоит злоупотреблять.
+
* Are fine to use, as there is no other wiki markup equivalent.
* Команды меню или другого пользовательского интерфейса:"Сначала, выберите пункт меню '''File''', затем - '''Map Properties'''. Вы увидите окно '''Object Properties'''. Выберите поле '''Skybox Texture Name'''."
+
* Command-line statements: <code>c:\program files\valve\steam\</code>
* Если слово является ссылкой на википедию, не обязательно его выделять жирным.
+
* Variables in code or text files: <code>$staticprop</code> or <code>m_nCounter</code>
 
+
* In-game console commands: <code>mat_wireframe 1</code>
== Шаблоны для описания энтитей ==
+
* Filenames: <code>bspzip.exe</code>
Статьи, описывающие энтити, должны иметь четкую структуру (см. статью [[Entity_Article_Template]]). Чтобы упростить создание этих статей, были созданы специальные шаблоны для параметров энтитей, Input'ов, Output'ов
+
* Entity names: <code>info_player_start</code>
{{note:ru|Здесь написаны только самые распространённые шаблоны. Для особых игровых шаблонов см. последние части статьи.}}
+
* Other in-game or Hammer data, such as texture names, input and output names, etc.
 
 
=== Параметры энтитей ===
 
* [[Template:KV_Angles]]
 
* [[Template:KV_EnableDisable]]
 
* [[Template:Kv_global]]
 
* [[Template:KV_Origin]]
 
* [[Template:KV_Parentname]]
 
* [[Template:KV_Shadow]]
 
* [[Template:KV_Targetname]]
 
 
 
=== Input'ы ===
 
* [[Template:I_EnableDisable]]
 
* [[Template:I_Parentname]]
 
* [[Template:I_Shadow]]
 
* [[Template:I_Targetname]]
 
 
 
=== Output'ы ===
 
* [[Template:O_Targetname]]
 
 
 
=== Шаблоны Counter-Strike Source ===
 
* [[Template:BasicCSSweapon]]
 
 
 
=== Шаблоны Team Fortress 2 ===
 
* [[Template:KV_TFTeam]]
 
* [[Template:tfitem]]
 
  
 
== See also ==
 
== 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 [[Wikipedia:Wikipedia:How to edit a page|here]]. The information is referential of the Wikipedia site, but is applicable to all MediaWiki powered sites, including the Valve Developer Community.
 
Wikipedia has excellent resources on text formatting available [[Wikipedia:Wikipedia:How to edit a page|here]]. The information is referential of the Wikipedia site, but is applicable to all MediaWiki powered sites, including the Valve Developer Community.
 
+
{{backtotop|align=right}}
[[Category:Tutorials:ru]]
+
[[Category:Tutorials]]
[[Category:Wiki:ru]]
+
[[Category:Wiki]]
 +
[[Category:Help]]

Revision as of 08:29, 13 August 2012

English




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

Панель редактированиея

button_bold.png Bold text
button_italic.png Italic text
button_link.png Adding internal links
button_extlink.png Adding external links
button_headline.png Adding a headline
button_image.png Inserting a picture
button_nowiki.png Ignore Wiki formatting
button_sig.png Inserting your signature
button_hr.png Horizontal lines

Форматирование страниц

Page Templates

Руководство по специальному форматированию

Page Creation

You can start editing a non-existent page in several ways:

  • The easiest way is to type the exact name you want into the "Search" bar then hit "Go". If the page doesn't exist, you will be able to create it.
Warning.png Warning: Make sure the subject of the page you have in mind isn't already on the wiki. For example, you want to create the page "Portal 2 Particles", but you didn't notice the List of Portal 2 Particles page.
For example, let's say you've typed "Foobar" in the search bar, then hit the "Go" button. Since the page doesn't exist, you are given this message:
There were no results matching the query.
Create the page "Foobar" on this wiki!
In this scenario, you are able to click the Foobar link and begin editing your new page.
Tip.png Tip: Red links are pages that have not been created yet, and blue links are pages that already exist.
  • You can can modify the URL in your address bar to go where you'd like (in this case using the address https://developer.valvesoftware.com/wiki/Foobar).
  • Some pages in the wiki contain many red links. If you are familiar with the subject matter of the non-existent page, feel free to create the new page by following the red link. Your contributions are greatly appreciated, and the more blue links, the better.

During the course of an edit, clicking Show preview (to the right of the Save page button) will help you determine if your edit looks good. This displays the final result of the edited page, but does not save it. This will avoid spamming the Recent changes page with saved edits, to the frustration of other editors.

When you are done editing, proofread it to make sure that the edit is final, and then click Save page to finally create the new page.

Sandboxes

To test your editing skills, you can either use the public Sandbox page, or create your own sandbox page. You can create your own sandbox by navigating to your user page, then adding "/Sandbox" in your address bar at the end of the URL. Be sure you're on your user page before creating it.

Seasoned editors who wish to further advance their editing skills in Templates can use the Template:TestTemplate page to test their template code.

[Back to top]

Creating a How-to Page

There are some basic guidelines on writing your own tutorial and how-to pages.

  • Most importantly, before you start, make sure you fully understand the subject you want to write a tutorial about. It can be very hard to write something informative if you're not sure how to do it yourself.
  • Decide what kind of tutorial you are making. Is it a basic tutorial for people who haven't used Hammer much, like how to use the texture browser? Or is it a tutorial explaining how to create complex scenarios with-in a game, more suited for advanced users?
  • A good tutorial is a tutorial that is fun to read:
    • Before you start, add a brief description of what the tutorial will be about.
    • Split it into steps, each with one very specific key feature. If it is a beginner tutorial, do not be afraid to include every step.
    • Group sets of steps which all together achieve one through the other a goal. For example, if you are writing a tutorial about a collapsing elevator, group the steps explaining how to create an elevator frame, animated door model, and invisible entities into one group. The next group of steps in the tutorial can explain how to make the elevator collapse using entity inputs and outputs. Finally, describe how to connect everything together.
    • Add pictures. An image can describe something that is not self-explanatory. However, don't overflow the tutorial with them: use images when it will improve the text.
    • Add charts, when explaining entity input and output behaviors. It's easier to follow if there's a chart identical to the Output flag in Hammer already filled with the information. The reader can just copy it or reverse engineer it to see why it should be done like this and not differently.
  • When writing a tutorial, keep in mind people who may not be familiar with most of the uncommon entities in Hammer. When listing one, link it to the page describing it. Don't try to explain what it is, or how generally it should be used if it's already explained on the entity page.
  • Try to connect steps with a logical order that other people will understand. After reading your tutorial they will do that action as you did it. If they can't understand what they did they can't improve upon it.
  • Make a good summary at the end of the tutorial to make it obvious to the reader had done all the steps necessary in order to achieve the goal.

Now create a sandbox page and start writing!

Creating a Mod Page

Please review the Mod page guidelines before creating a page for a Source/GoldSrc mod.

Creating an Entity Page

See Entity Article Template for help creating entity pages.

Creating Categories

Categories enable pages to be added to automatic listings. These help structure many pages by grouping them together around similar subjects. There may also be a section listing the subcategories of that category.

Category pages are usually created for the description of their existence. For example, Category:Blender is a category for all pages related to the free and open source 3D modeling package, Blender.

To add a page to a category, simply place at the bottom of the page. All pages that have the same category name will be listed automatically in the category.

For a list of all current categories, visit Special:Categories.

[Back to top]

Creating User Pages

Your user page is your own personal editing venture. You are free to edit it with anything you desire. It is frowned upon by the Valve Developer Community to make direct edits to user pages that do not belong to you, unless the page contains media or external links relating to pornographic material, illegal warez/torrent sites, etc. If that is the case, you will risk your IP for permanent ban from the VDC.

To edit your user space, you must first have an account on the VDC. Registering is free and easy to do. Once you're logged in, click on your username at the very top-right of this page.

[Back to top]

Creating Discussion Pages

Discussion (or talk) pages are for user discussions concerning the information contained in its respective main page. It can also be used for requesting help. Talk pages (even your own) should not be used for sandboxes. Doing so does not leave a proper place for discussion.

To create or edit a discussion page, just click the "Discussion" tab above, next to the "Page" tab.

Tip.png Tip: You can also use the keystroke Alt+T to quickly switch to the discussion page, that is if your web browser/operating system allows it.

Discussion pages have a special flow. When you are commenting on posts in a discussion page, indents are used to reply to comments. See below for more information on this technique.

It is important to sign your comments with your username and the time/date of the post. This is a simple process that only requires four characters. Four tildes (~~~~) will automatically be replaced with your public user information along with the time and date of the post. Signatures are explained further here.

[Back to top]

Editing Guidelines

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

Mediawiki_editbuttons.png

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 button_bold.png

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 button_italic.png

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 button_link.png

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
Note.png Note: Spaces are automatically converted to underlines for internal links. [[Main_Page]] is equivalent to [[Main Page]], but you should use the latter.

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.
Tip.png Tip: Any header on a page can be "jumped to" by including a hash tag and header name at the end of the link title. For example: [[Help:Editing#Internal_links|Jump to "Internal links"]].

External links button_extlink.png

External links are used to link to web pages that are not in this wiki. Any link with the external-link-ltr-icon.png icon means it's external, and any link with the lock-icon.png 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 button_headline.png

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 button_image.png

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.

Warning.png Warning: Please read the image use policy before uploading images.
 
   Syntax [[Image:Filename.png]] 
 Example [[Image:Steam_available.png]] 
   Results Steam available.png

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 button_nowiki.png

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 button_sig.png

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.

Tip.png Tip: The syntax includes two hyphens (--), but you really only need four tildes (~~~~) to insert a signature.
 
   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 button_hr.png

 
   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.


[Back to top]

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
* Green
 

   Results
  • Red
  • Blue
  • Green
Tip.png Tip: Increasing the number of asterisks (*) increases the indent of the item.

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
  1. This is the first step.
  2. 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 2
 

 Example ;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 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.

 XHTMLWiki
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>
<td>cell2</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.

Note.png Note: This new syntax replaces the <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 arrow-down-icon.png 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]]
Warning.png Warning: This method can only be used if the page is empty. If you are manually moving a page, copy the edit source of the page and paste it into the new page. Then the original page can be replaced with the #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.


[Back to top]

Page Templates

Click here to view the extensive list of templates available for use.

[Back to top]

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> tags

  • Are fine to use, as there is no other wiki markup equivalent.
  • Command-line statements: c:\program files\valve\steam\
  • Variables in code or text files: $staticprop or m_nCounter
  • In-game console commands: mat_wireframe 1
  • Filenames: bspzip.exe
  • Entity names: info_player_start
  • Other in-game or Hammer data, such as texture names, input and output names, etc.

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.

[Back to top]