Delo z zbirko smernic

Ta stran opisuje postopke in način dela s sistemom BookStackApp, v okviru katerega gostimo polico s smernicami.

Pravila dostopa

Okolje

• opisBookStackApp ne omogoča dodeljevanja pravic specifično za objekt in posameznega uporabnika. Pravice se definira tako, da se uporabnika dodeli v skupino, pri čemer skupina definira pravila dostopa. Kljub temu pa tudi za skupino ni možno nastaviti specifičnih pravil dostopa
za

npr. stran.

Zaradi tega je postopek dela sledeč in se za pripravo smernic uporablja naslednje vloge: - Administrator ima dostop do vsega. - Urejevalec smernic - vloga, ki se ji določi možnost urejanja le strani, katerih lastnik je. Tako lahko administrator določi lastništvo neke strani uporabniku, kjer se nahajajo oz. nastajajo nove smernice. Ko uporabnik smernice uredi, se lastništvo dodeli administratorju, ki lahko edini ureja vsebine. Naenkrat je lahko lastnik objekta le eden uporabnik

Organizacija smernic

Vse smernice se nahajajo na polici Jezikovno označevanje korpusov. Vsak tip smernic predstavlja svojo knjigo, znotraj katere so lahko objavljene različne verzije tipa smernic.

Priprava novih in do sedaj neobstoječih smernic

Administrator uporabniku/-om dodeli pravice urejanja na novi strani, kjer se bodo nahajale nove smernice.

Priprava nove verzije obstoječih smernic

Administrator uporabniku/-om dodeli pravice urejanja na novi strani, kjer se bodo nahajale nove smernice. Ta stran je kopija obstoječih smernic, ki se bodo nadgrajevale.

Objava/zaključek smernic

Ko je pisanje smernic končano oz. je na podlagi njih pripravljen tudi korpus, se vsem (razen administratorju) odstrani dostop do urejanje strani s smernicami.

Priporoča se tudi izvoz smernic v formatu PDF.

Kako čimlažje uvoziti smernice iz obstoječih formatov

Obstaja kar nekaj orodij in storitev, ki vam ponujajo pretvorbo v format markdown. Ta orodja naj vam služijo v pomoč pri ročni izdelavi/popravkih končnih smernic v formatu markdown.

Za smernice, ki so zapisane v formatih MS Word, boste morda najboljši rezultat dosegli z naslednjimi koraki:

1. Pretvorba vsebine iz datoteke MS Word v markdown:

pandoc -s VHODNA_DATOTEKA.docx  --wrap=none --reference-links -t markdown -o IZHODNA_DATOTEKA.md

2. Kopiranje vsebine v novo stran v tem portalu, kjer bodo na voljo smernice.
3. Popravljanje vsebine, skladno s formatom markdown.
4. Dodajanje slik ali drugih vsebin v ta sistem in vključitev v markdown.

Pomembni vidiki (Slabosti)

1. Nikoli ne dodajajte povezav/slik/gradiv/... iz zunanjih virov. Želimo ohranjati dosegljivost smernic neodvisno od zunanjih vplivov.
2. Med pisanjem vsebine v tem portalu redno shranjujte vmesne rezultate. Izguba povezave z Internetom ali osvežitev strani bo pomenila izgubo vseh neshranjenih podatkov!!!
3. Končane smernice je potrebno nekako označiti - glede tega se treba še dogovoriti. Trenutno je uporabljena beseda DRAFT/FINAL v naslovu.
4. Na wiki-ju je več različnih projektov. Pravice in vloge pa so generalne za celotno spletišče. To pomeni, da je potrebno paziti, da ne prihaja do problemov, ko bi lahko nekdo iz drugega "projekta" spreminjal ali izbrisal smernice. Način dodeljevanja pravic v tem sistemu je precej rigiden.
5. TBA