Версия для печати темы
Нажмите сюда для просмотра этой темы в оригинальном формате
Форум программистов > VB .NET > Проект Винграда - справочник по программированию!


Автор: Exception 14.10.2006, 17:26
Здравствуйте.

Возможно, многие не знают о проекте http://wiki.vingrad.ru и его предназначении, а потому я создаю эту тему.

Итак, на сегодняшний день существует множество различных источников информации о языках программирования и других технологиях индустрии разработки программного обеспечения: официальная документация, форумы, онлайн-справочники, книги...

Что такое Viki?

http://wiki.vingrad.ru - это свободнопополняемый справочник по программированию. Это значит, что информацию (статью, например) в него может добавить каждый. http://wiki.vingrad.ru основана на движке MediaWiki, том же, что и http://ru.wikipedia.org. По сути, http://wiki.vingrad.ru - это и есть что-то вроде Википедии, но именно по программированию.

Подсветка синтаксиса

В настоящее время подсветка синтаксиса напрямую связана с http://wiki.vingrad.ru. Например, кликнув на любое ключевое слово в следующем куске кода, вы попадёте на страницу http://wiki.vingrad.ru с описанием этого ключевого слова.

Код
if (someCondition)
{
    int x;
    x = 0;
}


Как видите, статьи с описанием синтаксиса имеют вид Язык:Ключевое слово, например, http://wiki.vingrad.ru/Java:if или http://wiki.vingrad.ru/VB.Net:Select_Case.

Статьи

Основная единица http://wiki.vingrad.ru - это статья.

Примеры статей:
  •  http://wiki.vingrad.ru/ООП:Класс
  •  http://wiki.vingrad.ru/Vingrad:Правила_и_руководства
  •  http://wiki.vingrad.ru/VB.Net:Class
  •  http://wiki.vingrad.ru/Замыкание
По сути, фактический адрес статьи составляется из адреса нашего сервера и имени статьи:

http://wiki.vingrad.ru/Имя статьи

В случае, если в имени статьи есть пробелы, можно заменить их подчёркиваниями.

У статей, относящихся непосредственно к некоторому языку программирования или технологии, есть префиксы. Пример префикса: VB.Net, CSharp, ООП.

Бывает и так, что префиксов несколько, например: Vingrad:Правила и руководства:Как помочь.

По сути, сейчас наша задача заключается в том, чтобы полностью доделать http://wiki.vingrad.ru/VB.Net:Справочник_языка.

Примеры статей:

http://wiki.vingrad.ru/VB.Net:If...Then...Else
http://wiki.vingrad.ru/VB.Net:For_Each...Next


Wiki-разметка

Для статей используется Wiki-разметка. Вы можете посмотреть исходный код любой страницы, попросту нажав на ссылку "Править" сбоку.

Краткий справочник по Wiki-разметке:

''курсивный'' текст - курсивный текст
'''жирный''' текст - жирный текст
[[Имя статьи]] - ссылка на статью внутри Вики
[[Имя статьи|текст ссылки]] - "текст ссылки", ведущий на некоторую статью
<code>кусок текста</code> - делает часть текста написанной моноширинным шрифтом
<pre>код</pre> - в этот тег помещают примеры кода
[http://somewhere.com текст ссылки]] - внешняя ссылка

= Заголовок = - заголовок 1 уровня
== Заголовок == - заголовок 2 уровня
=== Заголовок === - заголовок 3 уровня
==== Заголовок ==== - заголовок 4 уровня

Списки:

* пункт 1
* пункт 2

Это маркированный список.

# пункт 1
# пункт 2

Это нумерованный список.

Остальное:

{{имя шаблона}} - используется для вставки в страницу шаблона. Объяснять, что это такое, долго, поэтому, думаю, если вас заинтересует эта тема, вы и сами разберётесь.


И что же делать?

http://wiki.vingrad.ru/index.php?title=VB.Net:Class&action=edit, как составляются статьи.
Потренируйтесь применять вики-разметку в специально отведённом месте - http://wiki.vingrad.ru/Sandbox.
Для создания новой статьи попросту введите её имя в текстбокс и нажмите "Перейти".

И наконец: не волнуйтесь, совсем не обязательно писать статью с начала до конца! Создайте хотя бы черновик, поместив в начало статьи шаблон {{draft}}.


Пример статьи:

Код

{{draft}}

<breadcrumbs></breadcrumbs>
<title-override>VB .NET: Справочник языка</title-override>

===Операторы объявления типов===
[[VB.Net:Namespace|Namespace]]

[[VB.Net:Class|Class]]

[[VB.Net:Interface|Interface]]

[[VB.Net:Structure|Structure]]

[[VB.Net:Enum|Enum]]

[[VB.Net:Delegate|Delegate]]

===Операторы объявления членов===
[[VB.Net:Dim|Dim]]

[[VB.Net:Property|Property]] ([[VB.Net:Get|Get]] / [[VB.Net:Set|Set]])

[[VB.Net:Sub|Sub]] / [[VB.Net:Function|Function]]

[[VB.Net:Event|Event]]

===Условные конструкции===
[[VB.Net:If...Then...Else|If...Then...Else]]

[[VB.Net:Select Case|Select Case]]


===Циклы===
[[VB.Net:For...Next|For...Next]]

[[VB.Net:For Each...Next|For Each...Next]]

[[VB.Net:While|While]]

[[VB.Net:Do...Loop|Do...Loop]]


===Операторы обработки ошибок===
[[VB.Net:On Error GoTo|On Error GoTo]]

[[VB.Net:Try...Catch...Finally|Try...Catch...Finally]]


===Одиночные операторы===
[[VB.Net:Imports|Imports]]

[[VB.Net:AddHandler|AddHandler]]

[[VB.Net:RemoveHandler|RemoveHandler]]

[[VB.Net:Return|Return]]

[[VB.Net:Continue|Continue]]

[[VB.Net:Exit|Exit]]

===Операторы в выражениях===
[[VB.Net:CType|CType]]

[[VB.Net:GetType|GetType]]

[[VB.Net:And|And]] / [[VB.Net:AndAlso|AndAlso]]

[[VB.Net:Or|Or]]/ [[VB.Net:OrElse|OrElse]]

[[VB.Net:Is|Is]] / [[VB.Net:IsNot|IsNot]]

===Опции компилятора===

[[VB.Net:Option Strict|Option Strict]]

[[VB.Net:Option Explicit|Option Explicit]]

[[VB.Net:Option Compare|Option Compare]]

===Модификаторы доступа===
[[VB.Net:Private|Private]]

[[VB.Net:Protected|Protected]]

[[VB.Net:Friend|Friend]]

[[VB.Net:Protected Friend|Protected Friend]]

[[VB.Net:Public|Public]]

===Типы данных===
[[VB.Net:Boolean|Boolean]]

[[VB.Net:Byte|Byte]]

[[VB.Net:Char|Char]]

[[VB.Net:Date|Date]]

[[VB.Net:Integer|Integer]]

[[VB.Net:Long|Long]]

[[VB.Net:Object|Object]]

[[VB.Net:Short|Short]]

[[VB.Net:String|String]]

[[Category:VB.Net:Справочник языка]]
[[Category:NeedsContent]]


Если есть какие-либо вопросы касательно вики - буду рад на них ответить в этой теме. Присоединяйтесь!

Powered by Invision Power Board (http://www.invisionboard.com)
© Invision Power Services (http://www.invisionpower.com)