Skład notatek odbywa się w systemie LaTeX. Aby dowiedzieć się więcej na ten temat można zajrzeć do książki "Nie za krótkie wprowadzenie do systemu LaTeX2e" lub innych, dostępnych na stronie GUST.

Do pracy nad notatkami będzie Ci potrzebny LaTeX np. TeX Live bądź MiKTeX(<-Użuwany do pierwszych wersji).

Potrzebny jest również edytor, oto jedne z najpopularniejszych:

Windows:

Texmaker
LEd - polski edytor, automatyczne uzupełnianie kodu, podgląd DVI, sprawdzanie pisowni. Więcej informacji na stronie pl.wikipedia.org/wiki/LaTeX_Editor
TeXnicCenter - zintegrowane środowisko programistyczna dla LaTeXa, więcej tutaj: pl.wikipedia.org/wiki/TeXnicCenter
LyX - edytor WYSIWYG więcej tutaj: pl.wikipedia.org/wiki/LyX
Bakoma - kolejny edytor typu WYSIWYG<-UŻYWANY DO TWORZENIA PIERWSZYCH WERSJI NOTATEK

Linux:

Texmaker
Kile
LyX - edytor WYSIWYG więcej tutaj: pl.wikipedia.org/wiki/LyX

Mac OS X:

Texmaker
LyX - edytor WYSIWYG więcej tutaj: pl.wikipedia.org/wiki/LyX
TeXShop

Do publikacji będzie również niezbędny klient Subversion za pomocą, którego łatwo opublikujesz swoją prace. Instalacja klienta różni się w zależności od systemu:

Linux:

W oknie terminala wystarczy pisać komendę: sudo apt-get install subversion
Jeżeli komuś wystarczy posługiwanie się konsolą, to powyższy skrypt wystarczy. Istnieje też możliwość zainstalowania nakładki graficznej RapidSVN. Robimy to komendą: sudo apt-get install rapidsvn
RapidSVN nie umieszcza aktywatora w menu dlatego należy zrobić to samemu. Uruchomić go możemy za pomocą polecenia: rapidsvn&

Windows:

Teraz kiedy masz zainstalowanego LaTeXa i Subversion oraz wybrany edytor, możesz przystąpić do pracy nad notatkami. W przypadku gdy masz zamiar pisać notatki w edytorze WYSIWYG wystarczą podstawowe znajomości LaTeXa. Zarówno przy nazewnictwie tak i przy tworzeniu obowiązuje pewien standard - TOS-N-2008-1 (The Open Source-Notes-2008-version 1).

Oczywiście, głównym powodem powstania tego standardu jest ujednolicenie stylów dokumentów tak aby nie różniły się od siebie znacząco.

Ułatwi to tworzenie i edycje notatek oraz zapobiegnie sytuacjom niespójności oraz wymieszaniu się stylów wewnątrz dokumentu. Poprawi również przenośność kodu na inne platformy.

Dodawanie nowych notatek

Należy kierować się zasadami opisanymi poniżej, podczas tworzenia notatek. Przede wszystkim należy pamiętać aby podczas tworzenia notatek zastosować taką oto preambułę:

%& --translate-file=il2-pl

\documentclass[a4paper,titlepage,titleauthor,withmarginpar,12pt]{mwart}

\usepackage{polski}

\usepackage[pdftex]{color, graphicx}

\renewcommand\familydefault{\sfdefault}

\sloppy

Powyższy zapis: %& --translate-file=il2-pl - ustawia stronę kodową Latin 2 (ISO8859-2) i tu ważne jest aby w swoim edytorze ustawić również taką samą stronę. Oprócz tego preambuła nakazuje stosować polską klasę dokumentu, z polskimi zasadami typografii oraz czcionkę bezszeryfową. Więcej na temat powyższych znaczników można przeczytać w dokumentacji LaTeXa oraz w książkach podawanych w linku na początku strony.

Po utworzeniu dokumentu należy go skompilować a następnie przystąpić do publikacji. Skompilować dokument można za pomocą dostępnych w programie przycisków w zależności od tego jaki format chcemy uzyskać. Według naszego standardu powinien to być plik ".pdf" ze względu na szerokie zastosowanie tego formatu. Oprócz niego, należy udostępnić kod źródłowy (plik z rozszerzeniem ".tex". Więcej zasad tworzenia notatek będzie dodawane a sam standard, rozwijany - wszelkie zmiany można śledzić na stronie za pomocą kanału RSS

Kiedy Twoje notatki są ukończone należy je zapisać, kierując się oczywiście zasadami nazewnictwa notatek. Dokumenty publikowane są za pomocą Subversion.

I tutaj również w zależności od systemu: Linux:

Zakładając, że nasz folder z notatkami i kodem źródłowym znajdują się w katalogu ~/projects/tex/open_notes - wystarczy wpisać komendę: svn import ~/projects/tex/open_notes http://svn2.assembla.com/svn/osn -m "Komentarz"
Za pomocą RapidSVN można to zrobić wchodząc w menu Repository -> Import lub za pomocą skrótu Ctrl+I.

Windows:

Edytowanie już opublikowanych notatek

System kontroli wersji Subversion pozwala na łatwe i efektowne edytowanie już opublikowanych notatek. Każda wersja dokumentu jest przechowywana na serwerze nawet po edycji można obejrzeć poprzednią wersję oraz w łatwy sposób śledzić zmiany jakie zaszły w dokumentach.