Materiały do zajęć - Jak pisać opis modułu?

Uniwersytet Gdański - Instytut Matematyki - Zakład Informatyki - Strona domowa

Jak pisać opis modułu?

Aby ułatwić proces dodawania nowych materiałów do strony zalecam zachować opisany poniżej format dokumentów. Sprawi to, że wasze opisy pojawią się szybciej, i będą zawierały mniej błędów. Oto, jak należy przygotować tekst:

Tylko część body w formacie HTML, kodowanie utf-8.
Encje HTML takie jak <, & muszą być zakodowane jako < &, itp.
Kod perla w tekście powinien być umieszczony w tagach <tt>...</tt>.
Kod perla umieszczony w osobnym bloku ma być umieszczony w tagach <code>...</code>
Nie umieszczaj tagów <tt> wewnątrz bloków <code>.
NIE wstawiaj do dokumentu nowych wierszy przez wpisywanie <br>! Jeżeli twoje bloki <code> nie są czytelne, bo składają się jak jedna linia, użyj arkusza styli z mojej strony, i nie renderuj kodu w IE. Wybierz Firefoxa! :P
Każdy akapit tekstu musi być umieszczony w tagach <p>...</p>.
Dodatkowe obrazki lub inne pliki dołączane do źródła powinny być przesłane jakby znajdowały się w podkatalogu img (obrazki) lub files (inne pliki).
Typowe tytuły mają poziom h2, jakieś rozdzialiki wewnątrz nich h3, itp.
Można wykorzystać malutki szablon do pisania swoich własnych plików, do pobrania stąd:

SZABLON!

O czym należy pamiętać

Za jeden opracowany moduł jest jeden punkt. Dotyczy to oczywiście tych, którzy studiują pod moim kierunkiem, i mają obowiązek rozliczyć się z zajęć :)
Opracowanie danego modułu może wykonać więcej osób pod warunkiem że ich opracowania nie bedą dotyczyły tego samego materiału. Innymi słowy - mogą się uzupełniać, nie mogą się zastępować. Proszę o skonsultowanie ze mną zamiaru rozwinięcia czyjegoś opisu.
Zamiar opracowania lub samo opracowanie modułu warto zgłosić do mnie wcześniej, aby mógł umieścić na stronie listę. Wtedy łatwiej uniknąć powtórzeń i wynikającej z tego straty czasu.
Każde opracowanie jest sprawdzane przeze mnie i trafi na stronę dopiero po wykonaniu wszystkich zalecanych przeze mnie poprawek i rozwinięć.

Co to za znaczek COOL ?

Jest to znaczek, który nadaję modułom, których opis bardzo mi się podoba, i który uznaję za szczególnie wartościowy. Można go traktować jak taką 'wirtualną' nagrodę. Liczba punktów za każdy moduł pozostaje stała.

Znaczek wygląda tak:

Jeżeli okaże się, że opisy modułów będą naprawdę dobrze zrobione i wartościowe, kto wie, może przyznam jakiś "bonus" za staranność i wysiłek :)

Lista opracowanych do tej pory modułów

Uniwersytet Gdański - Instytut Informatyki - Strona domowa - Perl

[c] Piotr Arłukowicz, materiały z tej strony udostępnione są na licencji GNU.