Jak pisać strony w formacie Wiki
Strony w formacie Wiki są pisane w sposób przejrzysty, z intuicyjnym i czytelnym dla człowieka formatowaniem, które zostanie przekształcone na XHTML w momencie wyświetlania. Głównymi zaletami tego formatu jest to, iż nie musisz się uczyć języka HTML, aby otrzymać zaawansowane rezultaty, oraz to, że tekst napisany przez ciebie wygląda dobrze, nawet przed konwersją. Jest to też alternatywa dla zapisywania plików pisanych w Wordzie jako stron HTML. Dzięki temu pozostaje możliwość edytowania zasobów w środowisku on-line.
W zasadzie w formacie tym piszesz w zwyczajny sposób. Dostępny jest zestaw specjalnych znaków, które możesz dodać. Służą one do formatowania.
Formatowanie na poziomie bloków
Bloki paragrafów są od siebie oddzielone przynajmniej jedną pustą linią. Aby dodać specjalne formatowanie danego paragrafu, wstaw jeden z poniższych znaków jako pierwszy znak pierwszej linii danego bloku, a za nim umieść znak odstępu.
Znak | Styl bloku |
Brak znaku | Zwykły paragraf |
> | Cytat |
Odstęp (spacja) | Tekst z równymi odstępami między znakami |
% | Jw. oraz ignorowany jest format Wiki |
!# | Nagłówek - # oznacza poziom nagłówka (1 oznacza największy). |
Q. | Pytanie - wprowadzone po to, by w elegancki sposób prezentować pytania i odpowiedzi |
A. | OdpowiedĽ - jw. |
Formatowanie list
Proste listy mogą być tworzone w łatwy sposób, poprzez umieszczenie specjalnego znaku na początku każdej linii listy, a następnie znaku odstępu.
Lista kończy się na pustej linii. Listy mogą dowolnie się zagnieżdżać, a listy zagnieżdżone mogą być innego typu niż te zewnętrzne. Deklaracja listy i typy tekstu mogą być dowolnie mieszane i przeplatane w celu otrzymania zamierzonego efektu. Znaki specjalne są następujące :
Znak | Rodzaj elementu listy |
* | Lista nieuporzÄ…dkowana (kropki) |
# | Lista uporzÄ…dkowana (1,2,3 itd.) |
: | Lista definicji, definicja |
; | Lista definicji, tekst |
Przykład list zagnieżdżonych
* Pierwsza kropka
* Druga kropka
## Linia zagnieżdżona 1
## Linia zagnieżdżona 2
* Trzecia kropka
Daj efekt:
- Pierwsza kropka
- Druga kropka
- Linia zagnieżdżona 1
- Linia zagnieżdżona 2
- Trzecia kropka
Formatowanie wewnÄ…trz linii
Formatowanie wewnątrz linii pozwala nadać jednemu lub kilku wyrazom konkretny styl. Wykorzystane znaki specjalne mogą pojawić się gdziekolwiek wewnątrz linii, ale pamiętaj, że format nie przechodzi z linii na linie. Kody są następujące :
Przykład | Efekt | Formatowanie |
*hello world* | hello world | Pogrubienie |
/hello world/ | hello world | Kursywa |
+hello world+ | hello world | tekst 'wstawiony' |
-hello world- | hello world | tekst wykreślony |
hello ~world~ | hello world | Indeks dolny |
hello ^world^ | hello world | Indeks górny |
"hello world" | hello world | Cytat |
%hello world% | hello world | Równe odstępy między znakami |
@hello world@ | hello world | Cytat |
Akronimy (podpowiedzi)
Podpowiedzi są tworzone poprzez wpisanie akronimu dużymi literami, a następnie jego opisu umieszczonego w nawiasach. Pomiędzy akronimem, a nawiasem nie może być znaku odstępu. Przykład (najechanie kursorem na dolny napis HTML spowoduje wyświetlenie po chwili podpowiedzi) :
HTML(Hypertext Markup Language) HTML
Hiperłącza
Możesz wpisać odnośnik, a następnie (bez znaku odstępu) tekst, który ma być wyświetlany, umieszczony w nawiasach. Przykład : http://www.google.com/(Szukaj z Google) zostanie przetłumaczone na
Szukaj z Google.
Odnośniki do adresów e-mail mogą być realizowane w taki sam sposób, np.:
nikt@przyklad.com(Użytkownik testowy) zostanie przetłumaczone na
Użytkownik testowy
Odnośniki do modułów Moodle
Jeśli znasz numer id Moodle (szukaj ?id=nn na końcu adresu modułu), oraz nazwę modułu, możesz stworzyć odnośnik bezpośrednio do niego korzystając z następującej składni :
NazwaModułu:nn(Opis)
np. resource:36(Moja nowa strona) forum:10(PrzejdĽ do forum)
Odnośniki do grafiki w Moodle
Grafika może być mieszana z tekstem na stronach Wiki. Musisz najpierw przesłać grafikę i zapamiętać jego ścieżkę dostępu. Składnia jest następująca :
/..ścieżka do pliku..(tekst wskazówki)
przykładowo, /mypics/graphic.jpg(Obrazek z personelem)
Automatyczne formatowanie
Wiele powszechnie stosowanych funkcji jest tłumaczona na swoje odpowiedniki w XHTML automatycznie. Poniżej podano te najważniejsze :
- Linki HTTP są konwertowane na aktywne odnośniki
- ..., (R), (TM), (C), 1/4, 1/2, 3/4 sÄ… zmieniane na odpowiednie znaki
- liczba x liczba jest zmieniane na prawidłowy znak mnożenia.
- Linia rozpoczynająca się od przynajmniej czterech myślników jest zmieniana na poziomą linię.
Sprawdzanie pisowni (Doświadczalnie)
Narzędzie formatujące wiki może zostać przełączone w tryb sprawdzania pisowni. Umieść poniższą linię w dokumencie. Cały tekst znajdujący się poniżej tej linii zostanie sprawdzony...
!SPELL:kod_języka:wariant_języka
Przykłady:
!SPELL:en:british
!SPELL:pl
"kod_języka" powinien zostać zastąpiony odpowiednim kodem (np. EN, PL itp.),"wariant_języka" (wraz z przecinkiem) jest argumentem opcjonalnym. W przypadku języka angielskiego (kod EN) może przykładowo przyjmować wartości "american", "british", lub "canadian". Język polski dostępny jest jedynie w jednej wersji i drugi argument można spokojnie pominąć.
Po zakończeniu pracy narzędzia sprawdzającego pisownię wszystkie nieznane słowa zostaną zaznaczone. Sugerowane zmiany pojawiają się po najechaniu myszką na dane słowo.
UWAGA: Sprawdzanie pisowni korzysta z bibliotek pspell. Zarówno one jak i słowniki muszą być umieszczone na Twoim serwerze, aby narzędzie działało. Platforma Windows nie jest obsługiwana.
|