To repozytorium zawiera kod strony wakacjezmd.github.io, na której znajdują się rozwiązania kolokwiów oraz egzaminów z Matematyki Dyskretnej prowadzonej na wydziale Matematyki, Informatyki i Mechaniki UW.
Do generowania zawartości strony potrzebny jest jekyll. Żeby je zainstalować trzeba ściągnąć Ruby i wpisać:
(sudo) gem install jekyll
(sudo) gem install webrickPo wprowadzeniu zmian w repozytorium dobrze jest włączyć jekyll serve
z katalogu głównego i przed pushem sprawdzić lokalnie czy wszystko działa.
Wszystkie błędy można zgłaszać na stronie issues.
W katalogu _solutions znajdują się rozwiązania wszystkich egzaminów
i kolokwiów podzielone podkatalogami na odpowiednie lata.
Format nazw plików egzaminów powinien spełniać poniższe reguły:
<rok>-egzamin-<nr>.md.
We wszystkich plikach można używać LaTeXa. Wzory inline należy umieszczać
w nawiasach \(<wzór>\), a wzory mające być wyświetlane w oddzielnych liniach
w znacznikach $$<wzór>$$.
- liczby Stirlinga I rodzaju
{ n\brack m } - liczby Stirlinga II rodzaju
{ n\brace m } - używamy
bmod nalbo\pmod{n}, nie\mod nalbomod n - używamy
\dotszamiast... - używamy
\midzamiast| - używamy
\timeszamiastx - każda liczba i zmienna powinna być zapisana w LaTeXu.
Zamiast
n musi być większe od 3, powinno być\(n\) musi być większe od \(3\)
Niestety parser Markdown inaczej interpretuje tekst umieszczony w tagach HTML (np. rozwiązania), a inaczej ten umieszczony normalnie w pliku.
- W treści zadania
_jest interpretowany jako kursywa, więc we wszystkich wzorach trzeba wpisywać\_. - W treści zadania
\jest interpretowany jako escapowanie kolejnego znaku, więc jeżeli chcemy dodać blok LaTeXa inline to należy napisać\\(<wzór>\\).
Plik egzaminu bądź kolokwium powinien posiadać odpowiedni nagłówek:
---
layout: page
permalink: <link do strony>
---Link do egzaminów powinien mieć format /<rok>/egzamin/<nr>/.
Markdown każdego zadania powinien mieć następującą strukturę:
### Zadanie <NR>
<TREŚĆ>
<div data-collapse>
<h4 class="collapsible">Rozwiązanie</h4>
<div class="solution">
<p>
<CZĘŚĆ ROZWIĄZANIA>
</p>
<p>
<CZĘŚĆ ROZWIĄZANIA>
</p>
<p>
<CZĘŚĆ ROZWIĄZANIA>
</p>
</div>
</div>
---Można dodawać rozwiązania do zadań, które mają już rozwiązanie - nawet do tego zachęcamy. Oczywiście rozwiązania muszą być wzajemnie różne. W przypadku zadań z więcej niż jednym rozwiązaniem warto je ponumerować i/lub dodać krótki opis, na przykład: Rozwiązanie I (algebraiczne), Rozwiązanie II (interpretacja).
Można dodawać rozwiązania w postaci linku do stacka - w takiej sytuacji pole ma wyglądać tak:
<div>
<h4 class="collapsible"><a href="link">Rozwiązanie (link)</a></h4>
</div>Po dodaniu nowego pliku egzaminu należy dodać odpowiednie linki w index.html.