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