upute_gitlab.txt

UPUTE ZA ARHIVIRANJE SEMINARA/PROJEKTA/DIPLOMSKOG/ZAVRSNOG RADA
===============================================
Prije obrane seminara/projekta/diplomskog/zavrsnog rada (najkasnije dan prije
obrane, tj. prilikom prezentacije), student(i) treba mentoru
predati arhivirane rezultate na GitLabu. Za Seminar je
dovoljno predati na obrani.

U repozitoriju treba bit struktura datoteka ovakva:

+---README.TXT <ascii file>
+---IZVJESCA <direktorij>
+---SEMINAR/PROJEKT/DIPLRAD/ZAVRRAD    <direktorij>
+---SOFTWARE   <direktorij>
+---OBRANA	<direktorij>
+---OSTALO     <direktorij>

Pojedini dijelovi trebaju biti uredjeni ovako:

1. README.TXT
<cisti text (ASCII) file>

----------------------------------------------------------------
Seminar/Projekt/Diplomski/Zavrsni rad br. [broj_rada], ak. god. 2009/10
Ime i prezime: [Ime Prezime]
Naslov rada:   [Naslov naslov naslov naslov...]
Datum obrane:  [datum]
Tekst zadatka: [Prepisati iz zadane teme/predaje koncepta seminara/projekta]


Sadrzaj:
- kratki opis sto je sve u arhivi i kako je organizirano, po potrebi
reference na README fileove u pojedinim direktorijima

----------------------------------------------------------------

2. IZVJESCA
<direktorij>

  - ovdje se trebaju nalaziti izvjesca koja smo imali na tjednim sastancima
  - naziv datoteka treba biti "izvjesce-[YYYYmmDD].ppt" ili .pptx

3. SEMINAR/PROJEKT/DIPLRAD/ZAVRRAD
<direktorij, s pod-direktorijima po potrebi>

 - README.TXT s opisom sto je sto

 - ako je rad (osim slika) u jednoj datoteci:

       a. konacna datoteka u formatu word processora koristenog
               za obradu teksta (npr. MS Word, LaTeX, ...)
       b. konacna datoteka u PDF formatu
       c. za slike ili grafove, koji su napravljeni pomocu nekog
               drugog alata (npr. snapshoti, crtezi u Visiu i sl.),
               pod-direktorij s datotekama u originalnom formatu

 - ako je rad (osim slika) organiziran u vise datoteka:

       a. sve tekstualne datoteke po gornjem postupku
               (original; PS ili PDF)
       b. sve slike i grafovi u originalnom formatu u posebni
               direktorij, vidi upute gore
       c. detaljne upute kako sastaviti rad u README.TXT


4. SOFTWARE - napravljeni izvorni programski kod (projekt iz IDE-a)
<direktorij, s pod-direktorijima po potrebi - npr. Android aplikacija, iOS aplikacija, waspmote, webapp, sql baze, ...>

- README.TXT   s opisom sto je sto

- INSTALL.TXT  upute za instalaciju i evt. postavljanje varijabli
               ako postoje upute u diplomskom radu  (a trebale bi!),
               dovoljna je referenca na brojeve stranica gdje se nalaze

- direktorij(i) s kodom
	a. ako se koristi C, C++, Java ili neki drugi programski jezik,
	   posebno staviti izvorne (source) datoteke, makefile/gradle/maven datoteke, 
	   eventualne upute za kompajliranje ako se ne koriste uobicajene naredbe
	b. U poseban direktorij staviti izvrsne verzije (ovo staviti na kraju kada je rad gotov)

FAQ: Sto sve staviti u repozitorij?

U repozitoriju treba biti sve sto bi vam trebalo da relativno brzo
(cca par sati) instalirate, konfigurirate i pokrenete svoj softver
kada bi se npr. nenadano pobrisao disk na racunalu na kojem
radite (ili dobijete drugo racunalo za rad).


5. OBRANA
<direktorij, s pod-direktorijima po potrebi>

- README.TXT   s opisom sto je sto

- datoteka s prezentacijom (originalni format)
- slike i grafovi ako su napravljeni u nekom drugom alatu (originali koji se mogu mijenjati)

6. OSTALO
<direktorij, s pod-direktorijima po potrebi>

- README.TXT s opisom sto je sto

- tu ide sve sto ne spada pod SEMINAR/PROJEKT/DIPLRAD/ZAVRRAD ili SOFTWARE, npr.:
       - Web stranice na koje se pozivate u poglavlju Literatura
       - Web siteovi, bookmark (HTML) file
       - literatura, clanci, specifikacije i sl. skinuto s mreze
         ili sto ste dobili u elektronickom obliku od nastavnika