Wakacje z MD

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.

Generowanie strony

Do generowania zawartości strony potrzebny jest jekyll. Żeby je zainstalować trzeba ściągnąć Ruby i wpisać:

(sudo) gem install jekyll
(sudo) gem install webrick

Po wprowadzeniu zmian w repozytorium dobrze jest włączyć jekyll serve z katalogu głównego i przed pushem sprawdzić lokalnie czy wszystko działa.

Błędy

Wszystkie błędy można zgłaszać na stronie issues.

Pliki z rozwiązaniami

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.

Dodawanie rozwiązań

LaTeX

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>$$.

Przydatne wzory i częste błędy

• liczby Stirlinga I rodzaju { n\brack m }
• liczby Stirlinga II rodzaju { n\brace m }
• używamy bmod n albo \pmod{n}, nie \mod n albo mod n
• używamy \dots zamiast ...
• używamy \mid zamiast |
• używamy \times zamiast x
• 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\)

UWAGA

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>\\).

Nagłówek

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>/.

Zadania

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>

Nowy egzamin

Po dodaniu nowego pliku egzaminu należy dodać odpowiednie linki w index.html.