Project:Uputstva

Izvor: SI Wiki
Datum izmene: 28. avgust 2020. u 21:53; autor: KockaAdmiralac (razgovor | doprinosi) (Posebne stranice i podešavanja)
Pređi na navigaciju Pređi na pretragu

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 mejl sa domena etf.bg.ac.rs ili etf.rs. Kada administrator odobri aš 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:

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:
  • 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 SI 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 linkovi (ne obavezno eksterni), vezani za predmet
  • Predavanja — članci ili materijali sa ili vezani za predavanja na predmetu
  • Vežbe — članci ili materijali sa ili vezani za auditorne ili računske vežbe na predmetu
  • Korisne veze — eksterni linkovi koji mogu biti od pomoći u savlađivanju gradiva
  • Ispitni rokovi — članci ili eksterne stranice sa zadacima sa kolokvijuma ili ispita
  • Domaći zadaci — u zavisnosti od predmeta, ovde se nalaze informacije vezane za domaće zadatke kao predispitne obaveze
  • Lab vežbe — u zavisnosti od predmeta, ovde se nalaze informacije vezane za laboratorijske vežbe kao predispitne obaveze
  • Način ocenjivanja — Pravila formiranja ocene za predmet po školskim godinama

Predmeti mogu imati svoje kategorije, kojima će pripadati materijali vezani za predmet (fajlovi, slike i sl.) kao i članci koji pripadaju nekom predmetu (predavanja, vežbe, rokovi, domaći zadaci itd.)

Rokovi

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

Rokovi se imenuju u formatu <Naziv predmeta>/<Tip roka> <Datum>, gde je naziv predmeta isti kao naziv članka predmeta, tip roka u skraćenom obliku (kolokvijumi se obeležavaju K1, K2, K3 itd.) Ukoliko je izostavljen tip roka, podrazumeva se integralni ispit. Datum je u formatu <Pun naziva meseca> <Godina (bez tačke)>.

Primeri: Programiranje 2/K1P 2019, Matematika 2/Jun 2020, PORT/Lab Jul 2020 itd.

Na stranicama predmeta, u odeljku Ispitni rokovi, nalaze se linkovi do člankova. 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 vreme dok su u dobrom duhu. Sve nedoumice oko rešenja mogu se rešiti na stranici razgovora samog članka.

Članci rokova treba da imaju sadržaj postavljen na desnoj strani, elementom {{tocright}}, kao i link ka zvaničnoj verziji roka, ukoliko postoji.

Članci rokova su podeljeni po delu ispita (ukoliko postoji, npr. teorija i zadaci, pitalice i zadaci itd.) na nivou naslova, zatim zadaci na nivou prvog podnaslova, a svaki zadatak treba da ima dva podnaslova na nivou 2 koji se zovu Postavka i Rešenje (pored toga što zadatak možda trenutno nije rešen).

Preporuka je da se dugi postupci i detaljna rešenja obaviju elementom koji može da se rasklapa: 

<div class="mw-collapsible mw-collapsed" data-expandtext="Поступак">
...
</div>

Alternativno, za pitanja sa kratkim odgovorima mogu se koristiti spojleri. div sa klasom unhide-spoilers formira dugme za prikaz svih rešenja na stranici. 

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

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 fajl vezan za predmet, prva stvar u njegovom nazivu je skraćeno ime tog predmeta. Ukoliko niste sigurni koje je skraćeno ime, koristite ono isto kao i ostali fajlovi vezani za predmet, ako postoje.

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

Fajlovi vezani za rokove, odmah posle naziva predmeta treba da imaju i naziv roka, kao i broj zadatka, ako su vezani za zadatak.

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

Ukoliko imate nedoumice, pogledajte ostale fajlove vezane za predmet i primenite najsličniju šemu imenovanja.

Uređivanje

Vikitekst

Vizuelni editor

Matematičke formule

Za uredno i estetski pregledno ispisivanje matematičkih formula (kao i delova teksta koji zahtevaju posebno formatiranje) na Vikiju, koristi se . To je opisni jezik univerzalno prihvaćen u akademskom svetu za objavljivanje naučnih radova, kao i knjiga.

Za rad na Vikiju, srećom, nije neophodno poznavati jezik u širini, već samo delove vezane za ispisivanje matematičkih formula koristeći amsmath. Postoji bezbroj uputstva i tutorijala na internetu, kao npr. na WikiBooks-u, sa dosta korisnih primera.

Još lakši način pisanja formula je koristeći vizuelni editor - u meniju Umetanje postoji opcija Matematička formula, gde su dostupni (skoro) svi simboli koje možete ispisati.

Nemojte pisati formule običnim tekstom, već uvek koristite LaTeX, osim u člancima nevezanim za matematiku gde formule mogu biti identično ispisane običnim tipografskim znakovima.

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>

<math> \lim_{x \to a}{f(x)} = \infty </math>

<math>\int \frac{\sqrt[3]{x} + \sqrt{x}}{\sqrt[3]{x} + \sqrt[6]{x}}dx </math>

<math>\sum_{n = 1}^{+\infty} \frac{(2n+2)!}{\pi^n(n!)^2}</math>

Programski kod

Dijagrami

Preuzeto iz „https://siwiki.rs/w/index.php?title=Project:Упутства&oldid=897”