Project:Uputstva

Svrha ove stranice jeste da korisnicima SI Wiki da uvid u procese na vikiju i pojednostavljena upustva za praćenje tih procesa. Opširniju pomoć u vezi sa MedijaVikijem možete naći na MediaWiki.org.

Registracija

Svako sa Elektrotehničkog fakulteta Univerziteta u Beogradu ima pravo da se registruje i da doprinosi SI Vikiju. Pre registracije, pročitajte članak o projektu, na kome se nalaze pravila i važne informacije.

Ukoliko se slažete sa pravilima, pošaljite zahtev za nalog. Kao dokaz da ste sa fakulteta, neophodno je da koristite adresu e-pošte sa domena etf.bg.ac.rs ili etf.rs. Kada administrator odobri vaš nov nalog, biće vam poslata poruka sa privremenom lozinkom, koju ćete morati da promenite pri prvom prijavljivanju. Nakon toga, uspešno ste otvorili nalog i možete početi sa uređivanjem.

Ukoliko ste naišli na neki problem ili nedoumicu oko procesa prijavljivanja, prijavite ga administratoru.

Hijerarhija vikija

Imenski prostori

Na SI Wiki, kao i na svim MedijaViki vikijima (poput Vikipedije), većina korisničkog sadržaja organizovana je u stranice. Svaka stranica ima svoj naziv preko kojeg joj se pristupa i sadržaj koji se na njoj prikazuje. Kao jedan vid organizacije stranica postoje imenski prostori, prefiksi naziva stranica koji označavaju osnovnu funkciju svih stranica sa tim prefiksom. Neki od osnovnih imenskih prostori u MedijaViki su:

Glavni imenski prostor — U ovom imenskom prostoru ne postoji prefiks ispred stranica i on se koristi za sadržaj direktno u vezi sa temom vikija, stranice za predmete, rokove i ostale materijale. Stranice u ovom imenskom prostoru se obično nazivaju člancima.
Корисник: — Stranice i podstranice za svakog korisnika vikija. Корисник:Корисничко име je obično glavna strana za korisnika sa datim korisničkim imenom gde se nalaze informacije o samom korisniku, a podstranice te stranice se obično koriste za testiranje i ostale projekte tog korisnika.
Project: — Stranice u vezi sa samim vikijem, procesima i uputstvima.
Датотека: — Stranice na kojima se nalaze opisi otpremljenih datoteka. Ovi opisi se generišu iz opisa zadatog na stranici za otpremanje datoteka i više informacija o njima se može naći na Šablon:File.
МедијаВики: — Stranice koje podešavaju kako viki izgleda. Dostupne za uređivanje samo administratorima vikija.
Шаблон: — Često korišćen vikitekst može se pretvoriti u šablon u ovom imenskom prostoru kako bi se olakšalo njegovo korišćenje na viki stranicama.
Категорија: — Kategorije su drugi osnovni oblik organizacije stranica na MedijaViki vikijima. Za razliku od imenskom prostora, jedna stranica može pripadati više kategorija, i funkcija stranica iz neke kategorije određena je nazivom i opisom te kategorije.
Модул: — Pošto vikitekst nije programski jezik a našim šablonima ponekad treba komplikovanija logika, ovde se čuva programski kod u Lua programskom jeziku koji rukovodi unosnim argumentima naših šablona.
Посебно: — Ovo nije pravi imenski prostor jer se u njemu ne čuva korisnički sadržaj, već se samo koriste za ostale funkcionalnosti vikija. Opisane su dalje u odeljku ispod.
Медија: — Ni ovo nije pravi imenski prostor, već imenski prostor koji se koristi za direktne veze do datoteka. Na primer, kada se poseti veza do Datoteka:M1 K3 - Rašajski (P2-3).pdf dođe se na stranicu sa opisom datoteke, dok kada se postavi veza do Medija:M1 K3 - Rašajski (P2-3).pdf dođe se do same datoteke.

Ovde su navedeni samo imenski prostori koji se trenutno koriste na SI Wiki. Шаблон:, Модул: i МедијаВики: imenski prostori vam najčešće neće trebati pri uređivanju na vikiju, a više o imenskim prostorima možete pročitati na MediaWiki.org.

Posebne stranice

Posebne stranice su stranice koje se ne mogu uređivati i koje se koriste za posebne radnje nad ostalim stranicama. Sve posebne stranice su izlistane ovde, a ispod su navedene neke od bitnijih posebnih stranica:

Posebno:Otpremi — Otpremanje datoteka. Na stranici se takođe nalaze polja za ispunjavanje pri slanju datoteke koja će biti automatski dodata na stranicu opisa datoteke.
Posebno:Podešavanja — Razna podešavanja vašeg naloga. Više o dostupnim podešavanjima objašnjeno je u odeljku ispod.
Posebno:SkorašnjeIzmene i Posebno:Dnevnik — Svi skorašnji događaji na vikiju.
Posebno:StraniceSaPrefiksom — Izlistavanje svih stranica u nekom imenskom prostoru (Posebno:StraniceSaPrefiksom/Korisnik:, kao i svih stranica koje počinju nekim prefiksom (Posebno:StraniceSaPrefiksom/ASP1).
Izveštaji održavanja vikija mogu se videti na vrhu liste svih posebnih stranica. Ovi izveštaji ukazuju na moguće greške na vikiju, na primer, ukoliko se u Posebno:TraženeStranice pojavljuje stranica čiji je naziv očigledno pogrešno napisan time se mogu naći stranice na kojima je taj pogrešan naziv korišćen kako bi se ispravile.

Podešavanja

Podešavanja vašeg naloga se nalaze na Posebno:Podešavanja i podeljena su na sledeće odeljke:

Profil — Opšte informacije o vama, poput:
- Pravo ime — ukoliko ovo postavite, prikazivaće se u autorima stranica koje ste izmenjivali umesto "korisnik na projektu SI Wiki".
- Promena lozinke — Posebno:PromeniLozinku
- Jezik — u kojem će se prikazivati intefejs, između ostalog sadrži latinicu, ćirilicu (podrazumevano) i engleski.
- Rod — muški, ženski ili neutralni
Izgled — Podešavanja kako SI Wiki izgleda za vas, poput:
- Vektorska ili bezvremenska tema (ovu stranicu možete pogledati u bezvremenskoj temi ovde)
- Datum i vreme
- Da li se sadržaj stranice prikazuje ispod razlika u verzijama ili ne
- Da li se prikazuju sakrivene kategorije ili ne
Uređivanje — Podešavanja uređivanja.
- Ukoliko želite da podrazumevano koristite vikitekst režim pri uređivanju, štiklirajte "Koristi režim vikiteksta unutar vizuelnog uređivača."
- Ukoliko želite da koristite stabilni vikitekst uređivač iz 2010 umesto beta verzije vizuelnog uređivača, štiklirajte "Privremeno onemogući vizuelni uređivač dok je u beta fazi."
Spravice — Lokalni CSS i JavaScript koji vam može učiniti uređivanje lakšim
- Spravica Popravke tamne teme popravlja tamnu temu koja je postavljena pomoću Chrome zastavice chrome://flags/#enable-force-dark
- Spravica Isticanje sintakse dodaje isticanje sintakse vikiteksta u stari uređivač vikiteksta (vizuelni uređivač već ima isticanje sintakse). Ovo je podrazumevano uključeno ali ga možete isključiti ukoliko vam ne radi dobro.

Takođe je vredno napomenuti da ukoliko imate CSS ili JavaScript koji biste želeli da koristite na SI Wiki, to možete uraditi uređivanjem vaših common.js i common.css korisničkih podstranica.

Organizacija vikija

Semestri

Svaki od 8 semestra osnovnih akademskih studija Softverskog inženjerstva ima svoju kategoriju:

U tim kategorijama nalaze se isključivo stranice predmeta koji pripadaju tom semestru.

Predmeti

Stranice predmeta se najlakše prave šablonom na ovoj stranici. Stranice moraju pripadati kategoriji semestra u kom se nalaze, kao i kategoriji za obavezne odnosno izborne predmete.

Na svakoj stranici predmeta mogu postojati sledeći odeljci po sledećem redosledu:

Stranice — na kojima se nalaze veze (ne obavezno spoljašnje), u vezi sa za predmetom
Predavanja — članci ili materijali sa ili u vezi sa predavanjima na predmetu
Vežbe — članci ili materijali sa ili u vezi sa auditornim ili računskim vežbama na predmetu
Korisne veze — spoljašnje veze koje mogu biti od pomoći u savlađivanju gradiva
Ispitni rokovi — članci ili spoljašnje veze sa zadacima sa kolokvijuma ili ispita
Domaći zadaci — u zavisnosti od predmeta, ovde se nalaze informacije u vezi sa domaćim zadacima kao predispitnim obavezama
Lab vežbe — u zavisnosti od predmeta, ovde se nalaze informacije u vezi sa laboratorijskim vežbama kao predispitnim obavezama
Literatura — u zavisnosti od predmeta, ovde se nalaze bitne informacije i saveti vezani za objavljenu literaturu vezanu za predmet
Način ocenjivanja — Pravila formiranja ocene za predmet po školskim godinama

Predmeti mogu imati svoje kategorije kojima pripadaju materijali u vezi sa predmetom (dokumenti, slike, itd.) kao i članci koji pripadaju nekom predmetu (predavanja, vežbe, rokovi, domaći zadaci itd.)

Rokovi

Članci u vezi sa rokovima sadrže tekstove ispitnih rokova na nekom predmetu. Oni se obavezno nalaze u kategoriji za rokove, kao i kategoriji predmeta ukoliko postoji.

Oblik imenovanja rokova je <Naziv predmeta>/<Tip roka> <Datum>, gde je:

naziv predmeta isti kao naziv članka predmeta,
tip roka postavljen na K1, K2 ili K3 za kolokvijume, Lab za laboratorijske vežbe i prazan za integralne ispite, i
datum u obliku <Pun naziva meseca> <Godina (bez tačke)>.
Primeri:
- Programiranje 2/K1P 2019
- Matematika 2/Jun 2020
- PORT/Lab Jul 2020

Na stranicama predmeta, u odeljku Ispitni rokovi, nalaze se veze do članaka. Podeljeni su po vrsti roka (kolokvijum, integralni ispit, parcijalni ispit i sl.), pa onda po samom ispitnom roku, od najskorijih do najdavnijih.

Preporuka je da ukoliko postoji zvanično objavljen ispit da tekstovi budu što bliži originalu, ali su svaka dodatna pojašnjenja dobrodošla. Idealno je da kada doprinosite dodavanjem rešenja roka da vi budete autor tog rešenja. Prema pravilima projekta, korisnici ne odgovaraju za svoje doprinose ukoliko su pogrešni, sve dok su u dobrom duhu. Sve nedoumice oko rešenja mogu se rešiti na stranici razgovora samog članka.

Članci rokova, kao i generalno svi članci koji na vrhu nemaju sa desne strane drugih elemenata niti predugačak sadržaj, treba da imaju sadržaj postavljen na desnoj strani šablonom {{tocright}}, kao i vezu ka zvaničnoj verziji roka, ukoliko postoji.

Članci rokova su podeljeni po delu ispita (ukoliko postoji, npr. teorija i zadaci, pitalice i zadaci itd.), zatim zadacima, a svaki zadatak, ukoliko se očekuje da bude rešen, treba da bude podeljen na postavku i rešenje.

Preporuka je da se delovi dugih rešenja koji nisu ključni sakriju iza elementa za rasklapanje. Alternativno, za pitanja sa kratkim odgovorima mogu se koristiti spojleri. Tag sa klasom unhide-spoilers formira dugme za prikaz svih rešenja na stranici, a tag sa klasom spoiler označava neki deo teksta kao rešenje.

Primeri sakrivanja rešenja:

Kod

Izgled

<div class="mw-collapsible mw-collapsed" data-expandtext="Поступак">
Овде иде део поступка који не мора да буде видљив.
</div>

Ovde ide deo postupka koji ne mora da bude vidljiv.

<div class="unhide-spoilers"></div>
Задатак. <span class="spoiler">Решење.</span>

Zadatak. Rešenje.

Datoteke

Datoteke možete otpremiti pomoću ove posebne stranice. Ukoliko niste autor datoteke ili niste sigurni ko je, odaberite podrazumevanu licencu.

Materijali u obliku datoteka moraju da poštuju pravila imenovanja. Ako je datoteka u vezi sa predmetom, prva stvar u njenom nazivu je skraćeno ime tog predmeta. Skraćena imena predmeta mogu se naći ovde. Ukoliko ne postoji skraćeno ime predmeta, usvojite razumnu pretpostavku.

Primer: Datoteka:ORT1 Uputstvo za projektovanje MS flip-flopova.pdf

Datoteke u vezi sa rokovima, odmah posle naziva predmeta treba da imaju i naziv roka, kao i broj zadatka, ako su u vezi sa zadatkom.

Primer: Datoteka:ASP1 jul 2020 zadatak 3.2 rešenje.png

Ukoliko imate nedoumica, pogledajte ostale datoteke u vezi sa predmetom i primenite najsličniju šemu imenovanja.

Uređivanje

Istorijski, jedna od najvećih barijera uređivača na MedijaViki vikijima jeste nedostatak poznavanja cele procedure uređivanja. SI Wiki je projekat više fokusiran na sam sadržaj a manje na njegovu organizaciju, tako da je najlakše rešenje pri svakoj nedoumici sa uređivanjem ostaviti sadržaj koji planirate da doprinesete u što više ljudski-čitljivom obliku na stranici, jer iako formatiranje tog sadržaja ispadne ružno ili nečitljivo na samoj stranici, drugi uređivači vikija su tu da taj sadržaj dovedu u pristojan oblik. Obično mnogo više truda ode na pravljenje nekog sadržaja za viki nego na njegovo formatiranje, tako da nije u interesu vikija da zbog nedostatka formatiranja izgubi kvalitetan sadržaj.

Ipak, uređivanje je bitan deo učešća na vikiju i bilo bi vredno upoznati se sa njegovim osnovama. Ispod su većinom date veze do stranica na zvaničnom MedijaViki vikiju koje objašnjavaju osnove uređivanja, ali pored tih uputstava takođe je dobro:

pogledati koji vikitekst je korišćen na ostalim stranicama za potrebe koje vama trebaju pri dodavanju novog sadržaja, i
pitati ostale uređivače kroz koje god komunikacione kanale imate uspostavljene sa njima.

Vikitekst

Na MedijaViki vikijima, osnovni jezik formatiranja stranica jeste vikitekst. Vikitekst može sam po sebi biti značajno komplikovan, ali za potrebe SI Wiki biće vam potrebni samo neki njegovi osnovni delovi, navedeni na sledećim stranicama:

Formatiranje
Veze (dostupne međuviki veze na SI Wiki možete naći na Posebno:Međuviki)
Tabele
Slike

Vizuelni uređivač

Pored uređivanja vikiteksta, na SI Wiki je takođe instaliran vizuelni uređivač koji sa intefejsom sličnim današnjim WYSIWYG uređivačima dokumenata omogućava uređivanje vikiteksta. Detaljno upustvo korišćenja vizuelnog uređivača može se naći ovde. Svakako, za naprednije opcije vikiteksta kao i interaktivniji sadržaj na vikiju predlaže se korišćenje vikitekst uređivača, koji možete postaviti kao podrazumevani u svojim podešavanjima.

Matematičke formule

Za uredno i estetski pregledno ispisivanje matematičkih formula (kao i delova teksta koji zahtevaju posebno formatiranje) na vikiju, koristi se $\mathrm{L}\!\!^{{}_{\scriptstyle \mathrm{A}}} \!\!\!\!\!\;\;\mathrm{T}\!_{\displaystyle \mathrm{E}} \!\mathrm{X}$ . To je opisni jezik univerzalno prihvaćen u akademskom svetu za objavljivanje naučnih radova, kao i knjiga. Ukoliko pišete matematičke formule na vikiju, najbolje je da ih pišete koristeći LaTeX uokviren <math>…</math> tagovima umesto običnim tekstom.

Za rad na vikiju, srećom, nije neophodno poznavati jezik u širini, već samo delove u vezi sa ispisivanjem matematičkih formula koristeći amsmath paket. Postoji bezbroj uputstva i vodiča na internetu, kao na primer na WikiBooks-u, sa dosta korisnih primera. Još lakši način pisanja formula je koristeći vizuelni uređivač - u meniju Umetanje postoji opcija Matematička formula, gde su dostupni (skoro) svi simboli koje možete ispisati.

Neki primeri, zajedno sa kodom:
Kod	Izgled
<math>P = \left\{ \begin{array}{ll} 0.3 \cdot K1 + 0.35 \cdot K2 + 0.35 \cdot K3 \\ 0.3 \cdot K1 + I \end{array}\right. </math>	${\displaystyle P = \left\{ \begin{array}{ll} 0.3 \cdot K1 + 0.35 \cdot K2 + 0.35 \cdot K3 \\ 0.3 \cdot K1 + I \end{array}\right. }$
<math> \lim_{x \to a}{f(x)} = \infty </math>	$\lim_{x \to a}{f(x)} = \infty$
<math>\int \frac{\sqrt[3]{x} + \sqrt{x}}{\sqrt[3]{x} + \sqrt[6]{x}}dx </math>	$\int \frac{\sqrt[3]{x} + \sqrt{x}}{\sqrt[3]{x} + \sqrt[6]{x}}dx$
<math>\sum_{n = 1}^{+\infty} \frac{(2n+2)!}{\pi^n(n!)^2}</math>	$\sum_{n = 1}^{+\infty} \frac{(2n+2)!}{\pi^n(n!)^2}$

Programski kod

Programski kod na vikiju se piše uokviren u <syntaxhighlight lang="…">…</syntaxhighlight> tagove, gde se unutar tagova nalazi programski kod a u lang atributu oznaka jezika, kako bi se jasno istakla njegova sintaksa. Oznake jezika mogu biti bilo koje iz ove liste, poput c, cpp, html. Na SI Wiki takođe postoji dodatan jezik milo za isticanje sintakse pseudokoda korišćenom u knjizi Algoritmi i strukture podataka od Mila V. Tomaševića, za lakše isticanje sintakse na člancima u vezi sa algoritmima i strukturama podataka.

Primeri isticanja koda

Kod

Izgled

<syntaxhighlight lang="c">
#include <stdio.h>

// Исписује "Hello world!".
int main(void) {
    printf("Hello world!");
    return 0;
}
</syntaxhighlight>

#include <stdio.h>

// Исписује "Hello world!".
int main(void) {
    printf("Hello world!");
    return 0;
}

<syntaxhighlight lang="milo">
DECODE MORSE(msg)
i = 0
new_msg = ""
while msg[i] ≠ 0 do
    p = root
    while (msg[i] ≠ ' ') and (p ≠ nil) do
        if msg[i] = '.' then
            p = left(p)
        else if msg[i] = '-' then
            p = right(p)
        else
            ERROR(Invalid code)
        end_if
        i = i + 1
    end_while
    i = i + 1
    if (p = nil) or (sign(p) = 0) then
        ERROR(Invalid code)
    end_while
    new_msg = new_msg + sign(p)
end_while
return new_msg
</syntaxhighlight>

DECODE MORSE(msg)
i = 0
new_msg = ""
while msg[i] ≠ 0 do
    p = root
    while (msg[i] ≠ ' ') and (p ≠ nil) do
        if msg[i] = '.' then
            p = left(p)
        else if msg[i] = '-' then
            p = right(p)
        else
            ERROR(Invalid code)
        end_if
        i = i + 1
    end_while
    i = i + 1
    if (p = nil) or (sign(p) = 0) then
        ERROR(Invalid code)
    end_while
    new_msg = new_msg + sign(p)
end_while
return new_msg

Dijagrami

Dijagrame poput grafova ili hijerarhijskih prikaza je najbolje otpremati kao slike na viki. Preporučuje se korišćenje draw.io za crtanje dijagrama, ali bilo koji besplatan softver za to sa više formata izvoza bi trebalo da posluži. Ukoliko ne koristite nikakav tekst na dijagramu, pokušajte da dijagram otpremite kao SVG datoteku, radi boljeg kvaliteta. Takođe se preporučuje da veza do izvorne .drawio datoteke dodate kao vezu u napomenama datoteke kako bi budući uređivači mogli da se njome služe ukoliko budu menjali taj dijagram.

Dinamičke liste stranica

Dinamička izlistavanja stranica se koriste na vikiju kako stranice sa listama rokova, labova i ostalih stranica i podstranica ne bi morale da se ažuriraju svaki put kad se doda nova stranica. Obično se mogu prepoznati u vikitekstu kao {{#dpl:|…}} ili <dpl>…</dpl>. Uputstvo za njihovo korišćenje se nalazi ovde, ali se generalno smatraju naprednijim opcijama vikiteksta tako da ukoliko vam bude trebala izmena na nekoj dinamičkoj listi stranica ili nova dinamička lista stranica možete se obratiti nekom od iskusnijih uređivača vikija da ih sredi.

Ukoliko mislite da neka dinamička lista stranica treba da izlistava neku novonapravljenu stranicu a ona to ne radi, pokušajte da očistite keš te stranice korišćenjem "Očisti keš" dugmeta u padajućem meniju pored dugmeta za uređivanje (ili u desnoj traci, ukoliko postoji).

Project:Uputstva

Sadržaj

Registracija

Hijerarhija vikija

Imenski prostori

Posebne stranice

Podešavanja

Organizacija vikija

Semestri

Predmeti

Rokovi

Datoteke

Uređivanje

Vikitekst

Vizuelni uređivač

Matematičke formule

Programski kod

Dijagrami

Dinamičke liste stranica

Meni za navigaciju

Project:Uputstva

Registracija

Hijerarhija vikija

Imenski prostori

Posebne stranice

Podešavanja

Organizacija vikija

Semestri

Predmeti

Rokovi

Datoteke

Uređivanje

Vikitekst

Vizuelni uređivač

Matematičke formule

Programski kod

Dijagrami

Dinamičke liste stranica

Meni za navigaciju

Pretraga