Formatowanie Tekstu

Dostępne również w językach Deutsch^[link1], English^[link2], Español^[link3], Français^[link4], Русский^[link5]

System obsługi dokumentów pracuje w oparciu o projekt WackoWiki, stąd jego formatowanie nieznacznie różni się od innych Wiki. Generalną zasadą jest, że wszystkie specjalne znaczniki formatujące tekst są zawsze podwójne i składają się z dwóch identycznych części otwierającej i zamykającej, co zostało wyjaśnione na przykładach poniżej.
W razie problemów polecamy zapoznać się z dodatkowymi dokumentami dotyczącymi formatowania tekstu

Te i inne metody formatowania tekstu najlepiej testować w specjalnie w tym celu przygotowanym brudnopisie^[link6] - zapraszamy :)

1. Podstawowe formatowanie

`pogrubienie`	pogrubienie
`//kursywa//`	kursywa
%%(wacko wrapper=text wrapper_align=center) wyśrodkowanie %% wrapper_align może mieć także inne parametry: center(środek), right(prawo) lub justify(wyjustowanie). ~~(także ''>>wyśrodkowanie<<'', ale lepiej go nie używać).~~	wyśrodkowanie
`__podkreślenie__`	podkreślenie
`--przekreślenie--`	~~przekreślenie~~
`##czcionka o stałej szerokości##`	`czcionka o stałej szerokości`
`++mała czcionka++`	mała czcionka
`!!uwaga!!`	uwaga
`!!(blue) kolor niebieski!!` Obsługiwane kolory to: (red) - czerwony , (green) - zielony i (blue) - niebieski	kolor niebieski
`??Wyróżnienie??`	Wyróżnienie
Index gorny `E=mc^^2^^`	E=mc²
Index dolny `Hvv2vvO`	H ₂ O

2. Odnośniki

Jako znacznik znaków do tworzenia linków można użyć okrągłego ((, )) lub kwadratu [[, ]]. używa się nawiasów. Oba znaki są jednakowe. Nawiasy kwadratowe mogą być użyteczne, jeśli tekst dokumentu zawiera już proste nawiasy okrągłe, które mogą być mylnie uznane za znaczniki.

2.1. Linki zewnętrzne

`[[https://wackowiki.org/ WackoWiki ]]` lub `((https://wackowiki.org/ WackoWiki))`	WackoWiki^[link7]
`https://wackowiki.org` automatycznie dodawany odnośnik	https://wackowiki.org
`PPR:OneMinuteWiki` InterWiki linking^[link8]	PPR:OneMinuteWiki^[link9]
`mailto:address@example.com` `((address@example.com))` wstawianie adresu poczty internetowej (zwanej: e-mail lub list-el)	mailto:address@example.com address@example.com^[link10]
`xmpp:adresse@example.com` Jabber.	xmpp:adresse@example.com

2.2. Linki wewnętrzne

`((KatalogiWiki))`	KatalogiWiki^[link11]
`((KatalogiWki Strona wyjaśniająca sposób tworzenia hierarchii i grupowania dokumentów Wiki))`	Strona wyjaśniająca sposób tworzenia hierarchii i grupowania dokumentów Wiki^[link11]
`https://wackowiki.org/wacko_logo.png` Dodawanie obrazka bez odnośnika.
`((http://wackowiki.org/ https://wackowiki.org/wacko_logo.png))` Dodawanie obrazka z odnośnikiem do innego dokumentu.	^[link12]
`((https://wackowiki.org/wacko_logo.png Wacko Wiki))` Obrazek z podpisem alternatywnym	Wacko Wiki^[link13]
`{{anchor href="test"}}` deklaracja kotwicy.
`((#test))` i `((/Witamy#TOC_1))` odwołanie do kotwicy.	test i /Witamy#TOC_1
`file:/mammut_mascot.jpg` lub `file:/Subpage/archive.zip` wstawianie odnośników do wgranych plików	file:/Subpage/archive.zip^[link14]

Wskazówka: Do wszystkich słów składających się z dwóch wyrazów pisanych dużą literą (na przykład FormatowanieTekstu), zostanie automatycznie dodany odnośnik do odpowiedniego dokumentu w obrębie tego systemu Wiki. W szczególności nie jest konieczne dodawanie http://wackowiki.org... w celu sformowania odnośnika.
Jeżeli konieczna jest zmiana odmiany NazwyWiki należy użyć podwójnych nawiasów i poprawnej formy NazwyWiki. Na przykład tekst: Wyświetl listę ((/RecentChanges ostatnich zmian)) zostanie zamieniony na: Wyświetl listę ostatnich zmian^[link15].

Wskazówka: Aby wyłączyć funkcję automatycznego tworzenia odnośnika z dwóch połączonych wyrazów (na przykład ~WackoWiki) należy taki wyraz umieścić w podwójnym cudzysłowie WackoWiki. Przed wyrazami można również umieszczać znak tyldy (~), na przykład WackoWiki.

Wskazówka: Aby utworzyć odnośnik do stron, które nie stanowią NazwyWiki^[link16] należy wykorzystać podwójne nawiasy. Na przykład odnośnik do głównej strony^[link17] można utworzyć w ten sposób: ((/HomePage głównej strony)).

3. Nagłówki i spisy treści

Informacje ogólne

Mechanizm Wiki ma możliwość automatycznego tworzenia spisu treści dowolnej strony. Spis treści jest dynamicznie generowany na podstawie nagłówków zawartych w dokumencie, przy czym nie są uwzględniane nagłówki pierwszego poziomu (taki nagłówek powinien występować na każdej stronie co najwyżej raz).

Nagłówki w dokumentach

Nagłówki w dokumentach Wiki tworzy się za pomocą znaków równości. W danym dokumencie powinien być co najwyżej jeden nagłówek najwyższego poziomu (odpowiednik <h1>) oraz dowolna ilość nagłówków niższych poziomów. Dla wygody poszczególne nagłówki zostały nazwane zgodnie z numerem, który generują przy tworzeniu Spisu Treści^[link18] dokumentów.

Przykłady nagłówków

`==Nagłówek najwyższego poziomu==`	Nagłówek najwyższego poziomu
`===Nagłówek pierwszego poziomu===`	Nagłówek pierwszego poziomu
`====Nagłówek drugiego poziomu====`	Nagłówek drugiego poziomu
`=====Nagłówek trzeciego poziomu=====`	Nagłówek trzeciego poziomu
`======Nagłówek czwartego poziomu======`	Nagłówek czwartego poziomu
`=======Nagłówek piątego poziomu=======`	Nagłówek piątego poziomu

Składnia polecenia

Podstawowy

Spis treści dokumentu tworzony jest za pomocą komendy {{toc}} (od angielskiego Table Of Contents).

Parametry

Komenda może przyjmować dodatkowe parametry {{toc page="nazwastrony" title="Nowy tytuł strony" numerate=1}}, gdzie:

page - jest nazwą strony, dla której wyświetlony zostanie spis treści. Jeżeli parametr nie zostanie podany, spis tworzony jest dla bieżącej strony,
title - dodaje tytuł tworzonego spisu treści,
numerate - włącza i wyłącza automatyczną numerację poszczególnych odnośników.

Przykłady

Spis treści bieżącego dokumentu: {{toc}}

Spis treści zewnętrznego dokumentu WIKI: {{toc page="FormatowanieTekstu"}}

Spis treści bieżącego dokumentu, ze zmienionym tytułem: {{toc title="Strony, której tytuł jest inny"}}

Spis treści zewnętrznego dokumentu WIKI, osnośniki numerowane:{{toc page="/Doc/Polski/FormatowanieTekstu" numerate=1}}

4. Listy numerowane i nienumerowane

Treść listy najlepiej wciąć za pomocą znaku tabulacji lub podwójnego odstępu, a następnie użyć jednego ze znaków *, 1., A., a., lub i. (uwaga na znak kropki), aby uzyskać pożądany typ listy.

pierwsza linia wcięta linia (za pomocą znaku TAB lub podwójnego odstępu)	pierwsza linia wcięta linia (za pomocą znaku TAB lub podwójnego odstępu)
* nienumerowana lista - pierwszy element * nienumerowana lista - kolejny element	nienumerowana lista - pierwszy element nienumerowana lista - kolejny element
1. numerowana lista - pierwszy element 1. numerowana lista - kolejny element	numerowana lista - pierwszy element numerowana lista - kolejny element
A. lista alfabetyczna (duże litery) - pierwszy element A. lista alfabetyczna (duże litery) - kolejny element	lista alfabetyczna (duże litery) - pierwszy element lista alfabetyczna (duże litery) - kolejny element
a. lista alfabetyczna (małe litery) - pierwszy element a. lista alfabetyczna (małe litery) - kolejny element	lista alfabetyczna (małe litery) - pierwszy element lista alfabetyczna (małe litery) - kolejny element
i. numerowana lista (format łaciński) - pierwszy element i. numerowana lista (format łaciński) - kolejny element	numerowana lista (format łaciński) - pierwszy element numerowana lista (format łaciński) - kolejny element

5. Cytowanie i definicje

`<[Cytowanie]>`	Cytowanie
`(?Wyrażenie oraz jego definicja jaka pojawi się po najechaniu myszką?)`	Wyrażenie
`(?Definicja paru wyrazów == Tu jest ona ukryta?)`	Definicja paru wyrazów

6. Przypisy dolne

Tekst, jeden przypis`[[]]` a potem następny`[[*]]`	Tekst, jeden przypis^a potem następny^*
Tekst, przypis ponumerowany`[[1]]` i następny`[[2]]`	Tekst, przypis ponumerowany¹ i następny²
`[[#]]` Tekst dla pierwszego przypisu `[[#*]]` Tekst dla drugiego przypisu `[[#1]]` Tekst dla pierwszego przypisu `[[#2]]` Tekst dla drugiego przypisu	^* Tekst dla pierwszego przypisu ^** Tekst dla drugiego przypisu ¹ Tekst dla pierwszego przypisu ² Tekst dla drugiego przypisu

auto-generated footnotes
[[^ text of footnote here]] generuje przypisy na końcu strony, zob. przykład

7. Cytowanie

Aby oznaczyć tekst jako odpowiedź lub komentarz, można użyć następującej składni:

Cześć!
> Tak, to jest to.
>> Czy jesteś pewien?
> Oczywiście, że tak!
>> Naprawdę?
>> Co teraz?

Cześć!

> Tak, to jest to.

>> Czy jesteś pewien?

> Oczywiście, że tak!

>> Naprawdę?

>> Co teraz?

8. Tabele

Tabele z obramowaniem

#|
*|header 1|header  2|header  3|*
||komórka 11|komórka 12|komórka 13||
||komórka 21|komórka 22||
|#

header 1	header 2	header 3
komórka 11	komórka 12	komórka 13
komórka 21	komórka 22

Tabele bez obramowania, szerokość 100%

#||
||komórka 11|komórka 12|komórka 13||
||komórka 21|komórka 22||
||#

komórka 11	komórka 12	komórka 13
komórka 21	komórka 22

Uwaga: Złożone tabele mogą być tworzone przy użyciu inline HTML, jeśli są dostępne.
Aby dołączyć rurkę | jako zawartość do Twojej komórki, zamknij rurkę parą podwójnych cytatów: ""|""

9. Inne przykłady

Linia pozioma <hr>:

----

Wymuszenie nowej linii:

tekst---teraz zacznij od nowej linii tekst
teraz zacznij od nowej linii

Tekst bez formatowania

Tekst, którego formatowanie nie powinno być z jakichś powodów zmieniane należy umieścić pomiędzy podwójnym cudzysłowem.

Ten tekst nie zostanie **pogrubiony**.

Czysty HTML
<# kod html #>
Można używać czystego kodu html na stronach Cyberpedii, należy go umieścić pomiędzy tymi znacznikami. Dla bezpieczeństwa zostanie on jednak przefiltrowany zgodnie z zasadami safeHTML^[link19], więc używanie go na stronach może trochę je spowolnić.

10. Rozszerzenia - dodatkowe znaki formatujące

Możliwości formatowania tekstu w WackoWiki mogą być w prosty sposób rozszerzone przy użyciu dodatkowych zewnętrznych formatów, które są wywoływane za pomocą składni %%(nazwa_formatowania) tekst%%.
Dostępne formatery aktualnie to :
wacko - czyli standartowy , uzywany na cyberpedii
code - bez podświetlania
comments - komentarze , widoczne tylko podczas edycji
Podświetlanie języków programistycznych:
css, hl, html, ini, java, pascal, sql, php

Przykład podświetlania składni kodu:

Formatowanie języka PHP:
%%(php) <?php kod PHP ?>

%%(php)
<?php
phpinfo();
$s = "Hello, World!\n";
print $s;
%%

<?php
phpinfo();
$s = "Hello, World!\n";
print $s;

Uwaga: Kod PHP należy dodatkowo wprowadzić pomiędzy znakami <?php i ?>.

Komentarze

%%(comment) Komentarze. Tekst wprowadzony jako komentarz będzie widoczny wyłącznie podczas edycji dokumentu %% Wprowadzony komentarz będzie widoczny podczas edycji.

11. Wrappery dla formaterów

Wrappery pozwalają na wzbogacenie możliwości formaterów tekstu.
Dostępne typy wrapperów to: text, page, box, shade .

Przykłady użycia:

%%(css wrapper=box wrapper_align=left wrapper_width=270)
.d { font-size: 70% }
%%

`%%(css wrapper=shade) .d2 { font-size: 70% } %%`	.d2 { font-size: 70% }
	shade - czyli cień jest to po prostu box bez argumentów

`%%(wacko wrapper=text wrapper_align=center) tekst po środku , w ++dodatku++ //normalnie// formatowalny %%`	tekst po środku , w dodatku normalnie formatowalny
	text - pozwala wyznaczyć położenie bloku tekstu
`%%(wacko wrapper=page wrapper_width=200) tekst nie przekroczy 200 pixeli , aaaaaa aaaaaaa aaaaaa aaaaaa aaaaa aaa %%`	tekst nie przekroczy 200 pixeli , aaaaaa aaaaaaa aaaaaa aaaaaa aaaaa aaa
	page - pozwala regulować szerokość tekstu tak jak i jego położenie

%%(wacko wrapper=box wrapper_width=300 wrapper_align=left)
**Kto to zna?**---- 
>>Srebrny w głowie chip<<---
>>wolnym czyni mnie<<---
>>gdy zespolony z metalem<<---
>>dostrajam się<<---
//Cyberpunk 2020// %%

Links

[link1] https://wackowiki.org/doc/Doc/Deutsch/Formatierung
[link2] https://wackowiki.org/doc/Doc/English/Formatting
[link3] https://wackowiki.org/doc/Doc/Español/ReglasFormato
[link4] https://wackowiki.org/doc/Doc/Français/MiseEnForme
[link5] https://wackowiki.org/doc/Doc/Русский/WackoСинтаксис
[link6] https://wackowiki.org/doc/Sandbox
[link7] https://wackowiki.org/
[link8] https://wackowiki.org/doc/Doc/English/WikiConcept/InterWiki
[link9] http://wiki.c2.com/?OneMinuteWiki
[link10] mailto:address@example.com
[link11] https://wackowiki.org/doc/Doc/Polski/KatalogiWiki
[link12] http://wackowiki.org/
[link13] https://wackowiki.org/wacko_logo.png
[link14] https://wackowiki.org/doc/Subpage/file?get=archive.zip
[link15] https://wackowiki.org/doc/RecentChanges
[link16] https://wackowiki.org/doc/Doc/Polski/NazwaWiki
[link17] https://wackowiki.org/doc/HomePage
[link18] https://wackowiki.org/doc/Doc/Polski/SpisyTreści
[link19] https://wackowiki.org/doc/Dev/Projects/SafeHTML

Tekst, jeden przypis`[[]]` a potem następny`[[*]]`	Tekst, jeden przypis^a potem następny^*
Tekst, przypis ponumerowany`[[1]]` i następny`[[2]]`	Tekst, przypis ponumerowany¹ i następny²
`[[#]]` Tekst dla pierwszego przypisu `[[#*]]` Tekst dla drugiego przypisu `[[#1]]` Tekst dla pierwszego przypisu `[[#2]]` Tekst dla drugiego przypisu	^* Tekst dla pierwszego przypisu ^** Tekst dla drugiego przypisu ¹ Tekst dla pierwszego przypisu ² Tekst dla drugiego przypisu