Прирачник за Wiki
Преглед
Овој wiki е составен од
страници, а секоја страница е составена од:
- Патека.
- Наслов.
- Содржина.
Патеката ја дефинира страницата на единствен начин и дефинира URL за достап до неа.
На пример, до страница со патека
/lang/open се достапува со URL
http://gambasdoc.org/help/lang/open.
Содржината на страницата мора да ја следи синтаксата опишана подолу во поглавјето „Wiki синтакса“.
Насловот се користи за покажување линк до страницата и не ја следи претходно наведената синтакса.
Тој се прикажува „каков што е“.
Кога постои линк до непостоечка страница, текстот на линкот е прикажан во курзив.
Конвенции за патеки
Теоретски, патеката на страницата е произволна, но мора да се придржува до следнава конвенција:
- Сите страници во врска со јазикот, се ставаат во /lang ако опишуваат клучни зборови и функции и во /cat, ако претставуваат приказипрегледи.
- Сите страници што се однесуваат на компонентите се ставаат во /comp. Патеката на страницата Компоненти е /comp/gb.xxx/class/symbol. Симболот почнува со точка ако е Класа Настан.
- Сите страници под патеката /def го сочинуваат речникот.
- Разновидните документи се ставаат под патеката /doc.
Како се уредува веќе постоечка страница
Кликнете на линкот „Edit“ на врвот на страницата.
Се појавува дијалог (
../comp/gb.form/dialog) во кој морате да го внесете вашето корисничко име и лозинка.
Овој дијалог се појавува само по еднаш во секоја сесија.
Потоа, можете да ја уредувате страницата и нејзиниот наслов според „Wiki синтаксата“.
Немојте да го менувате насловот на класите (
Класа), методите (
Метод) и настаните (
Настан) или на константите, бидејќи тие се генерираат автоматски.
Може да биде корисно ако се зачува оригиналната содржина на прозорецот за уредување во обичен уредувач, на пример, gedit (или Notepad) со исечи-и-вметни.
Кога ќе завршите со уредувањето, кликнете на копчето „Save“ за да ја ажурирате страницата.
Како да направите нова страница
Внесете нов URL за страница во вашиот интернет-прелистувач. Wiki ќе ви каже дека страницата не постои и ќе покаже линк „Create“ („направи“) на врвот на страницата.
Кликнете на линкот „Create“.
Како да избришете страница
Отворете ја страницата за уредување, избришете ги насловот и содржината.
Како да преведете страница на вашиот јазик
Едноставно, уредувајте ја страницата, но проверете дали ја гледате страницата во соодветниот јазик, што се познава по знаменцето во горниот лев агол на страницата.
Ако нема знаме што го претставува вашиот јазик, само кажете ми. Ќе го додадам.
 |
Преведувајте само наслови и содржини на страници. Немојте да преведувате линкови и имиња на страници!
|
Како се преведуваат предефинираните стрингови од wiki
Предефинираните стрингови од wiki, т.е. сѐ што не е наслов или содржина на страница, се наоѓа во транслацискиот
CGI скрипт-проект што управува со ова.
Изворниот код на овој проект се наоѓа во
Gambas архивата со изворен код, заедно со развојната околина и базата на податоци
Компоненти. Името му е „
doc.cgi“. Едноставно, преведете го како и секој друг проект.
Страници со слики
На wiki можете да поставувате и страници. Слика е страница чиј последен елемент од патеката, т.е. името на патеката, почнува со точка.
На пример,
/control/:combobox е слика што претставува контрола за уредување со паѓачка листа (combo-box).
За да вметнете слика во обична страница, едноставно направете линк:
[/control/:combobox].
Симболички линкови
Страниците чиј наслов почнува со карактерот „
@“, всушност се линкови до други страници.
Патеката на поврзаната страница е наведена веднаш по карактерот „
@“.
На пример, страницата
/cat/methoddecl, всушност е линк до страницата
/lang/methoddecl, а насловот на страницата
/cat/methoddecl е
@/lang/methoddecl.
Wiki синтакса
Ова е кус преглед на синтаксата што морате да ја користите за пишување статии на ова wiki.
Форматирање карактери
|
Синтакса
|
Опис
|
Резултат
|
|
*Задебелено*
|
Го прави текстот задебелен.
|
Задебелено
|
|
/Курзив/
|
Го става текстот во курзив.
|
/Курзив
|
|
=Фиксен=
|
Дава непропорционален фонт.
|
Фиксен
|
|
_Потцртан_
|
Го потцртува текстот.
|
Потцртан
|
 |
Ако карактерот претходи на празно место, тој не се смета како почетен форматирачки карактер, а ако следи по празно место, не се смета за завршен форматирачки карактер.
/ *Gambas* =Already= _Means_ BASIC! /
дава
/ Gambas Already Means BASIC! /
а не
Gambas Already Means BASIC!
|
 |
HTML ознаките се зачувуваат, wiki нив не ги интерпретира.
|
Ако внесете...
|
Добивате...
|
|
M<sup>rs</sup> <font color="red">Pierce</font>
|
Mrs Pierce
|
|
 |
Ако сакате нормално да употребите специјален карактер или ако не сакате да вметнете HTML ознаки, пред нив ставете обратна коса црта „\“.
|
Ако внесете...
|
Добивате...
|
|
\*Bold\*
|
*Bold*
|
|
Don't do \<\<that>>!
|
Don't do <<that>>!
|
|
Наслови, пасуси и редови
За да скокнете ред на крајниот резултат, т.е. за да почнете нов пасус, треба да вметнете празен ред.
Пример
|
Ако внесете...
|
Добивате...
|
Gambas Веќе
Means BASIC!
|
Gambas Already Means BASIC!
|
Gambas Already
Means BASIC!
|
Gambas Already
Means BASIC!
|
Ако завршите ред со потцртичка, се вметнува преод во наредниот ред.
Пример
|
Ако внесете...
|
Добивате...
|
Gambas Already_
Means BASIC!
|
Gambas Already
Means BASIC!
|
 |
Следниве специјални карактери се користат само на почетокот на редот.
|
|
Синтакса
|
Опис
|
Резултат
|
+Title
|
Покажува голем наслов.
|
Наслов
|
++Title
|
Покажува помал наслов.
|
Наслов
|
+++Title
|
И така натаму...
|
Наслов
|
++++Title
|
|
Наслов
|
|
--
|
Horizontal line
|
|
==
<u>Ова е *цитатен* текст</u>
==
|
Текст за цитати. Забележете дека HTML ознаките се интерпретираат.
|
|
Табели
Следниве специјални карактери се користат само на почетокот на редот.
|
Синтакса
|
Опис
|
|
[[
|
Почнува табела.
|
|
]]
|
Завршува табела.
|
|
][
|
Одвојува два реда.
|
|
-
|
Одвојува две колони.
|
Првиот ред секогаш ги содржи заглавијата. Ако првиот ред е празен, не се печатат заглавија.
Пример
|
Ако внесете...
|
Добивате...
|
Ако внесете...
|
Добивате...
|
[[
Прво заглавие
-
Второ заглавие
-
Трето заглавие
][
1
-
2
-
3
][
4
-
5
-
6
]]
|
|
Прво заглавие
|
Второ заглавие
|
Трето заглавие
|
|
1
|
2
|
3
|
|
4
|
5
|
6
|
|
[[
][
1
-
2
-
3
][
4
-
5
-
6
]]
|
|
Линкови
Ова wiki автоматски создава линкови. Ова може да се оневозможи само со обратна коса црта!
|
Синтакса
|
Опис
|
Резултат
|
|
[/lang/arithop]
|
Линк до тема
|
Аритметички оператори
|
|
[http://gambas.sourceforge.net|Gambas web site]
|
Линк до секој URL
|
Gambas web site
|
|
Што е ASCII?
|
Автоматски линк
|
Што е ASCII?
|
|
Што е \ASCII?
|
Како да се исклучи автоматски линк
|
Што е ASCII?
|
 |
Страница што почнува со карактер „@“ се смета за симболички линк до вистинска страница чија патека е дадена со остатокот од насловот.
Уредете ја оваа страница: page за да разберете.
|
Специјални секции
Секцијата почнува со ред со почетен карактер
„{“ и завршува со ред што почнува со карактер
„}“.
Секциите можат да се вгнездуваат една во друга.
|
Ако внесете...
|
Добивате...
|
{syntax
Ова е синтакса на функција
}
|
Ова е синтакса на функција
|
{example
Пример
}
|
Example
|
{seealso
Погледнете ги и овие функции...
}
|
See also
Погледнете ги и овие функции...
|
{box
Обична рамка
}
|
Обична рамка
|
{warning
Предупредување!
}
|
 |
Предупредување!
|
|
{info
Обрнете внимание.
}
|
 |
Обрнете внимание.
|
|
{vb
Visual Basic не работи како Gambas.
}
|
 |
Visual Basic не работи како Gambas.
|
|
{tip
Корисен совет.
}
|
 |
Корисен совет.
|
|
- Ставете прекршување на ред (празен ред) пред и по ваквите рамки.
- Не користете прекршување на ред во seealso рамка.
Специјални команди
Специјална команда е ред што почнува со карактер
„@“.
|
Специјална команда
|
Опис
|
|
@components
|
Вметнува листа на сите компоненти.
|
|
@classes
|
Вметнува листа на сите класи на моменталната (Компоненти).
|
|
@symbols
|
Ги вметнува сите симболи на моменталната Класа.
|
|
@index /root/index/path
|
Создава индекс на сите страници со наведената коренска патека. Се индексираат само страниците од првото ниво.
|