Składnia

Teksty kursu powinny wyglądać spójnie, dlatego ten dokument opisuje podstawowe konwencje.

Strony mają mieć prawidłową, logiczną hierarchię nagłówków. Tytuł strony ma być nagłówkiem 1 rzędu:

 !Tytuł

Sekcje dokumentu mają rozpoczynać się nagłówkami niższego rzędu (!!, !!!).

Nagłówek opisujący element/właściwość:

 !!Polska nazwa: @@oryginalna-nazwa-elementu@@

Przykładowy kod należy otaczać

 @@w ten sposób@@

Przykłady mają być wyróżnione wcięciem. Mogą zawierać opis.

 (odstęp)
 (spacja)@@<html>@@
 (spacja)Tag HTML
 (odstęp)

Przykłady mogą pokazywać obok siebie właściwe i niewłaściwe techniki:

 + Tak należy robić
 - A tak jest źle

Notatki umieszczane przez

 -> Notatka dla czytelników (np. tips, objaśnienie nieco zbaczające z tematu)

 -< Uwaga dla czytelników (np. ostrzeżenie przed częstym błędem)

 -? Notatka dla piszących kurs — co zostało do zrobienia, co trzeba przerobić.

Cała składnia opisana została w TextFormattingRules.


Zmodyfikowano: 27.08.2005, 23:00