Zasady formatowania stron w systemie Wikka

Uwaga: Tekst zawarty między podwójnymi cudzysłowami nie jest formatowany.

Po przeczytaniu niniejszego poradnika, możesz poćwiczyć na stronie testowej.

1. Formatowanie tekstu

**pogrubienie**
pogrubienie

//pochylenie//
pochylenie

__podkreślenie__
podkreślenie

##tekst maszynowy##
tekst maszynowy

''tekst wyróżniony'' (używa się dwóch apostrofów)
tekst wyróżniony

++tekst przekreślony++
tekst przekreślony

££Text insertion££
Tekst dodany

¥¥Text deletion¥¥
~~Tekst usunięty~~

oznaczenie klawisza: #%Enter#%
oznaczenie klawisza: Enter

@@tekst wycentrowany@@

tekst wycentrowany

/* Treść pominięta */

Ukrywa treść objętą znacznikami. Dodatkowo nie wyświetla znaku końca linii. Przydatne przy wstawianiu komentarzy technicznych dotyczących składni artykułów.

`` Treść pominięta (z zachowaniem znaków końca linni``

Ukrywa treść objętą znacznikami, ale zachowuje znajdujące się na jej końcu znaki końca linii bądź spacje.

2. Nagłówki

Aby wstawiany tekst był nagłówkiem należy dodać odpowiednią ilość znaku = po obydwu jego stronach. Sześć znaków = wstawia największy nagłówek, dwa znaki = — najmniejszy.

====== Bardzo duży nagłówek ======

Bardzo duży nagłówek

===== Dość duży nagłówek =====

Dość duży nagłówek

==== Średni nagłówek ====

Średni nagłówek

=== Mniejszy nagłówek ===

5. Wypunktowania i wcięcia akapitów

Aby zastosować wcięcie akapitu należy rozpocząć linię od znaku tyldy (~), tabulatora lub czterech spacji (które zostaną automatycznie zamienione w znak tabulatora).

~Ten tekst posiada wcięcie ~~Ten posiada podwójne wcięcie Ten tekst także posiada wcięcie

Ten tekst posiada wcięcie

Ten posiada podwójne wcięcie

Ten tekst także posiada wcięcie

Aby utworzyć wypunktowanie lub listę numerowaną należy użyć nastepującej składni. Pamiętaj, że zamiast znaku tyldy (~) można użyć czterech spacji.

Lista wypunktowana
~- Pomarańcze
~- Jabłka
~- Cytryny

Pomarańcze
Jabłka
Cytryny

Lista numerowana

~1) Pomarańcze
~1) Jabłka
~1) Cytryny

Pomarańcze
Jabłka
Cytryny

Lista numerowana (z użyciem wielkich liter)

~A) Pomarańcze
~A) Gruszki

Pomarańcze
Gruszki

Lista numerowana (z użyciem małych liter)

~a) Pomarańcze
~a) Gruszki

Pomarańcze
Gruszki

Lista numerowana (z użyciem numeracji rzymskiej)

~I) Pomarańcze
~I) Gruszki

Pomarańcze
Gruszki

Lista numerowana (z użyciem numeracji rzymskiej małymi literami)

~i) Pomarańcze
~i) Gruszki

Pomarańcze
Gruszki

6. Komentarze

Aby sformatować tekst jako komentarz, najpierw wstaw wcięcie ( ~, tabulator lub cztery spacje), a następnie znak &.

~& Komentarz tłumacza
~~& Odpowiedź na komentarz
~~~& Dalsze uwagi

Komentarz tłumacza

Odpowiedź na komentarz

Dalsze uwagi

7. Wstawianie grafiki

Aby wstawić grafikę, należy użyć akcji o nazwie image.

{{image class="center" alt="logo DVD" title="Odnośnik z grafiką" url="images/dvdvideo.gif" link="RecentChanges"}}

Wymagany jest jedynie parametr url oraz alt, pozostałe są opcjonalne. Parametr link służy do wstawiania odnośnika (może być nim zarówno odnośnik wewnętrzny jak i zewnętrzny). Można także pominąć go w zupełności — w takim wypadku wstawiona zostanie jedynie grafika. Można użyć klas left, right oraz center, które spowodują umieszczenie grafiki odpowiednio po stronie lewej, prawej lub na środku.

8. Odnośniki

Istnieją trzy możliwości tworzenia odnośników do stron wewnątrz wiki:

wstaw nazwę strony (WikiName):

FormattingRules
FormattingRules
możesz dodać własny tekst dla odnośnika przez ujęcie go w nawiasy kwadratowe [[ i ]] (wewnątrz nawiasów wszystko po pierwszej spacji będzie traktowane jak tekst dla odnośnika):

[[FormattingRules Zasady formatowania artykułów w systemie Wikka]]
Zasady formatowania stron w systemie Wikka
wstaw grafikę z odnośnikiem (patrz instrukcje wyżej).

Aby wstawić odnośnik do innych stron (spoza wiki):

wpisz adres w treści strony:

http://www.example.com
http://www.example.com
możesz dodać własny tekst odnośnika przez ujęcie go w nawiasy kwadratowe [[ i ]] (wewnątrz nawiasów wszystko po pierwszej spacji będzie traktowane jak tekst dla odnośnika):

[[http://example.com/mandarynki/ Strona o mandarynkach]]
Strona o mandarynkach

[[mail@example.com Napisz do mnie!]]
mail@example.com Napisz do mnie!
wstaw link typu interwiki (zobacz listę stron dostępnych przez interwiki):

Wikipedia:WikkaWiki
Wikipedia:WikkaWiki

Google:CSS
Google:CSS

Thesaurus:Happy
Thesaurus:Happy
możesz dodać własny tekst dla odnośnika analogicznie jak powyżej:

[[Wikipedia:WikkaWiki Co mówi Wikipedia na temat WikkaWiki?]]
Wikipedia:WikkaWiki Co mówi Wikipedia na temat WikkaWiki?
wstaw grafikę z odnośnikiem (patrz niżej).

9. Tabele

Aby wstawić tabelę, należy użyć akcji o nazwie table.

{{table columns="5" cellpadding="1" cells="###;ROZMIAR;KOLOR;URODA;INTELIGENCJA;SŁOŃ;duży;szary;znaczna;wysoka;ŻABA;nieduży;zielony;###;bardzo wysoka"}}

	ROZMIAR	KOLOR	URODA	INTELIGENCJA
SŁOŃ	duży	szary	znaczna	wysoka
ŻABA	nieduży	zielona		bardzo wysoka

W miejscu pustych komórek tabeli należy wstawić ###.
Bardziej skomplikowane tabele można wstawiać używając języka HTML (patrz niżej).

10. Tekst kolorowy

Aby wstawić tekst w danym kolorze, należy użyć akcji o nazwie color.

{{color c="blue" text="Cały jestem niebieski!"}}
Cały jestem niebieski!

Można także użyć wartości szesnastkowych (zgodnie ze składnią HTML). Użyj parametru hex.

{{color hex="#E60000" text="Czerwony."}}
Czerwony.

Można także oprócz koloru znaków zmieniać kolor tła. W tym celu użyj parametrów fg i bg.

{{color fg="#A60000" bg="#f9f2d3" text="Mam żółtawe tło i czerwone znaki."}}
Mam żółtawe tło i czerwone znaki.

{{color fg="yellow" bg="black" text="Mam czarne tło i zółte znaki."}}
Mam czarne tło i zółte znaki.

11. Tekst w ramce

Można wstawić tekst w ramce wyrównanej do lewej lub prawej strony. W przypadku wyrównania do lewej należy objąć tekst znakami <<.

<<Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Duis volutpat nulla. Suspendisse convallis aliquam augue. Mauris nisi magna, commodo non, lobortis tempus, eleifend a, ante.<< Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed bibendum. Sed luctus. Nullam tempor iaculis velit. Praesent nunc justo, lacinia vel, malesuada quis, convallis gravida, felis. Nunc tincidunt imperdiet felis. Nullam lectus. Morbi at ligula. Aenean at risus. Nunc eros quam, pellentesque vitae, posuere a, ultricies a, orci. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Integer pretium est dictum purus. Integer eget nulla at enim laoreet rutrum. Sed aliquet bibendum justo. Nulla semper tellus sed quam. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Sed nec risus. Fusce est augue, laoreet in, blandit a, vehicula et, justo. Ut turpis. Mauris non eros.

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Duis volutpat nulla. Suspendisse convallis aliquam augue. Mauris nisi magna, commodo non, lobortis tempus, eleifend a, ante.

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed bibendum. Sed luctus. Nullam tempor iaculis velit. Praesent nunc justo, lacinia vel, malesuada quis, convallis gravida, felis. Nunc tincidunt imperdiet felis. Nullam lectus. Morbi at ligula. Aenean at risus. Nunc eros quam, pellentesque vitae, posuere a, ultricies a, orci. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Integer pretium est dictum purus. Integer eget nulla at enim laoreet rutrum. Sed aliquet bibendum justo. Nulla semper tellus sed quam. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Sed nec risus. Fusce est augue, laoreet in, blandit a, vehicula et, justo. Ut turpis. Mauris non eros.

Aby wstawić tekst w obramowaniu wyrównanym do prawej należy użyć znaków >>.

>>Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Duis volutpat nulla. Suspendisse convallis aliquam augue. Mauris nisi magna, commodo non, lobortis tempus, eleifend a, ante.>> Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed bibendum. Sed luctus. Nullam tempor iaculis velit. Praesent nunc justo, lacinia vel, malesuada quis, convallis gravida, felis. Nunc tincidunt imperdiet felis. Nullam lectus. Morbi at ligula. Aenean at risus. Nunc eros quam, pellentesque vitae, posuere a, ultricies a, orci. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Integer pretium est dictum purus. Integer eget nulla at enim laoreet rutrum. Sed aliquet bibendum justo. Nulla semper tellus sed quam. Vestibulum ante ipsum primis in faucibus orci luctus et ultrices posuere cubilia Curae; Cum sociis natoque penatibus et magnis dis parturient montes, nascetur ridiculus mus. Sed nec risus. Fusce est augue, laoreet in, blandit a, vehicula et, justo. Ut turpis. Mauris non eros.

Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Duis volutpat nulla. Suspendisse convallis aliquam augue. Mauris nisi magna, commodo non, lobortis tempus, eleifend a, ante.

Wstaw ::c:: aby dalszy tekst umieścić pod tekstem w obramowaniu (działanie identyczne jak w języku HTML polecenie clear="both").

12. Formatowaniu kodu

Przy użyciu relatywnie prostej składni, można do treści strony wstawić kod źródłowy w dowolnym języku programowania. Cały tekst wewnątrz tak zdefiniowanego bloku nie będzie w żaden sposób interpretowany.
Aby wstawić blok z kodem źródłowym bez wyszczególniania języka należy użyć składni:

%% To jest blok tekstu będący kodem. %%.

 To jest blok tekstu będący kodem.

Aby wstawić blok z kodem źródłowym z kolorowaniem składni, należy dodatkowo okreslić język kodu. Lista obsługiwanych języków znajduje się poniżej.

%%(php) <?php echo "Hello, World!"; ?> %%

<?php

echo "Hello, World!";

?>

Można także włączyć numerowanie linii i określić początkowy numer linii:

%%(php;15) <?php echo "Hello, World!"; ?> %%

<?php
echo "Hello, World!";
?>

Jeśli dodatkowo podasz nazwę pliku, będzie ona użyta przy pobieraniu pliku z kodem.

%%(php;15;test.php) <?php echo "Hello, World!"; ?> %%

test.php (line 15)

<?php
echo "Hello, World!";
?>

Obsługiwane języki
Język	Formatter	Język	Formatter	Język	Formatter
Actionscript	`actionscript`	ABAP	`abap`	ADA	`ada`
Apache Log	`apache`	AppleScript	`applescript`	ASM	`asm`
ASP	`asp`	AutoIT	`autoit`	Bash	`bash`
BlitzBasic	`blitzbasic`	Basic4GL	`basic4gl`	bnf	`bnf`
C	`c`	C for Macs	`c_mac`	C#	`csharp`
C++	`cpp`	C++ (+QT)	`cpp-qt`	CAD DCL	`caddcl`
CadLisp	`cadlisp`	CFDG	`cfdg`	ColdFusion	`cfm`
CSS	`css`	D	`d`	Delphi	`delphi`
Diff-Output	`diff`	DIV	`div`	DOS	`dos`
Dot	`dot`	Eiffel	`eiffel`	Fortran	`fortran`
FreeBasic	`freebasic`	FOURJ's Genero 4GL	`genero`	GML	`gml`
Groovy	`groovy`	Haskell	`haskell`	HTML	`html4strict`
INI	`ini`	Inno Script	`inno`	Io	`io`
Java 5	`java5`	Java	`java`	Javascript	`javascript`
LaTeX	`latex`	Lisp	`lisp`	Lua	`lua`
Matlab	`matlab`	mIRC Scripting	`mirc`	Microchip Assembler	`mpasm`
Microsoft Registry	`reg`	Motorola 68k Assembler	`m68k`	MySQL	`mysql`
NSIS	`nsis`	Objective C	`objc`	OpenOffice BASIC	`oobas`
Objective Caml	`ocaml`	Objective Caml (brief)	`ocaml-brief`	Oracle 8	`oracle8`
Pascal	`pascal`	Per (FOURJ's Genero 4GL)	`per`	Perl	`perl`
PHP	`php`	PHP (brief)	`php-brief`	PL/SQL	`plsql`
Python	`phyton`	Q(uick)BASIC	`qbasic`	robots.txt	`robots`
Ruby on Rails	`rails`	Ruby	`ruby`	SAS	`sas`
Scheme	`scheme`	sdlBasic	`sdlbasic`	Smarty	`smarty`
SQL	`sql`	TCL/iTCL	`tcl`	T-SQL	`tsql`
Text	`text`	thinBasic	`thinbasic`	Unoidl	`idl`
VB.NET	`vbnet`	VHDL	`vhdl`	Visual BASIC	`vb`
Visual Fox Pro	`visualfoxpro`	WinBatch	`winbatch`	XML	`xml`
X++	`xpp`	ZiLOG Z80 Assembler	`z80`

13. Mindmapy

Wikka obsługuje mindmapy w formacie Wikka:FreeMind mindmapy w formacie FreeMind. Umieścić mindmapę w artykule można na dwa sposoby.

Sposób 1: Umieścić plik z mindmapą na serwerze oraz wstawić odnośnik do strony, np:
http://yourdomain.com/freemind/freemind.mm
Nie ma potrzeby stosowania dodatkowego formatowania.

Sposób 2: Wkleić zawartość pliku z mindmapą bezpośrednio do treści strony:

Otworzyć plik w formacie FreeMind w edytorze tekstowym.
Zaznaczyć całość tekstu i skopiować do schowka.
Wkleić do treści strony w Wikka.

14. Wstawianie kodu HTML

Można z łatwością umieścić kod HTML na stronie wiki przez objęcie go podwójnym cudzysłowem:

""[html code]""

""y = x<sup>n+1</sup>""
y = xⁿ⁺¹

""<acronym title="Cascade Style Sheets">CSS</acronym>""
CSS

Domyślnie niektóre polecenia HTML są usuwane, celem zabezpieczenia przed potencjalnie niebezpiecznym kodem. Więcej informacji na ten temat: Wikka:SafeHTML.
Jeśli chcesz wyłączyć to zabezpieczenie, przeczytaj instrukcje na stronie Wikka:UsingHTML.

CategoryWiki

Wiki Spis : FormattingRules