Kako radi ova prezentacija?

Prezentacija je sastavljena kombinovanjem nekoliko tehnologija:

• GNU/Emacs Org mode + Babel --- kako bi svi materijali za učenje bili u formi literate programming dokumenata, kako bi svako parče koda bilo izvršeno u kontekstu dokumenta pre eksportovanja u konačnu web stranicu.
• Hakyll + Stack --- kako bi se generisala statička web prezentacija samo iz onih delova koji treba da se nađu u prezentaciji.
• GitHub pages --- kako bi prezentacija bila javno dostupna.

Tok rada

1. Preći na develop granu, sav razvoj se odvija tamo.

2. Unutar direktorijuma org napisati org-mode dokument koji želite da objavite (npr. OCaml.org) i popunite ga materijalom (koristite Babel kada je to moguće).

3. Eksportujte svoj dokument u HTML. U Emacs-u koristite org-export-dispatch funkciju i tamo odaberite As HTML file opciju.

4. Uradite standardnu proceduru Hakyll-a za generisanje prezentacije

   $ stack build
   $ stack exec site build
   $ stack exec site watch

   I pogledajte svoju prezentaciju na localhost:8000.

   Sada Vam je ostalo samo da je objavite.

5. Objavljivanje prezentacije se radi tako što se skoro čitava master grana zameni sadržajem _site direktorijuma na develop grani:

   • dok ste još na develop grani kopirajte _site direktorijum u npr. ~/Desktop.
   • pređite na master granu.
   • sa master grane obrišite sve osim: CNAME, .git, .github, README.md, .gitignore.
   • sadržaj _site direktorijuma koji ste stavili u npr. ~/Desktop kopirajte na master granu.
   • push-ujte izmene na master granu na GitHub-u. Od ovog momenta Vaš materijaln je dostupan negde iza http://naprednetehnikeprogramiranja.tk/org/.
   • vratite se na develop granu.

   Skripta koja ovo automatizuje još ne postoji. Postojaće čim se za to nađe vremena.

   Komplikacija delimično potiče odavde.

Pisanje objava == obaveštenja == postova

Objave se pišu u standardnom markdown-u.

1. Napišite svoju objavu po ugledu na neku iz posts direktorijuma.
2. Uradite korak 4. pa 5. od gore.

Ostalo

• index stranica se piše direktno u index.html.
• about stranica se piše direktno u about.rst.
• contact stranica se piše direktno u contact.markdown.
• statički resursi dostupni svuda nalaze se u resources.
• slike dostupne materijalima napravljenim org-om nalaze se u org/images.

Pronašli ste grešku?

Ako pronađete bilo kakvu grešku ili nedoslednost u ovim materijalima (uključujući i sav povezan kod) molimo Vas da nam skrenete pažnju na to kako bismo zajedno učinili ovaj kurs boljim.

Budite slobodni da otvorite issue.