Skip to main content

Urejanje police Jezikoslovno označevanje korpusov

Ta stran podaja tehnične postopke in način dela z odprtokodno platformo BookStack, ki gosti CJVT Wiki. Predstavljeni so tudi vsebinski in oblikovni vidiki, ki jih je pri dodajanju nove vsebine treba upoštevati, da se ohranja celovitost in enotnost informacij.
Za lažje urejanje vsebine na spletišču naj bo ta kratek vodnik.

Dostop za urejanje strani

Okolje BookStack ne omogoča dodeljevanja pravic samo za posamezen objekt (polico, knjigo) ali posameznega uporabnika. Pravice so določene za skupino uporabnikov, in vsak, ki želi urejati stran, mora v skupini pridobiti ustrezno vlogo. V skupini sta določeni dve vlogi, na kateri je vezan postopek urejanja strani:
some text- Administrator: ima dostop do vsega.
some text- Urejevalec smernic - vloga uporabnika z možnostjo urejanja strani, katerih lastnik je.
Vsak_a, ki želi urejati spletišče, si ustvari uporabniški račun na spletišču in enega od administratorjev prosi, da ga_jo doda v skupino in mu_ji dodeli vlogo urejevalca. Dodeljeno mu bo lastništvo objekta oz. nove police/knjige, ki ga želi urejati.
Pomni! Objekt ima lahko v lasti le en uporabnik naenkrat.
Ko uporabnik konča z urejanjem, se znova oglasi administratorju, da ta znova prevzame lastništvo objekta.

Organizacija police

Osnovna enota spletišča je polica "Shelf", ki jo poimenujemo. Ko je polica ustvarjena, lahko nanjo dodajamo knjige (Books). Knjiga ima lahko strani (Page) in/ali poglavja (Chapters), v katera lahko organiziramo vsebino, ki jo želimo predstaviti. V primeru police Jezikoslvno označevanje korpusov, ki predstavlja označevanje slovenskih korpusov, vsaka knjiga predstavlja en označevalni nivo (npr. Lematizacija, Oblikoskladnja ...). Vsaka knjiga se začne z uvodnim odstavkom, ki oriše označevalno raven. Knjiga ima 3 strani (Pages): Predstavitev oznak, Označevalne smernice in Reference in povezave. Vsaka stran ima uniformno uvodno poved, ki nakazuje na njeno vsebino, npr. V tem poglavju so navedene in strnjeno predstavljene oznake sistema JOS-SYN. Podrobnejšo predstavitev najdete v smernicah v poglavju Označevalne smernice.

Stran Predstavitev oznak vsebuje tabelo z oznakami. Upoštevamo potrebne prilagoditve, recimo če označevalni sistem nima oznak, ker gre za proces, te strani ni ali pa jo nadomesti stran Predstavitev [procesa] z natančenjšim opisom (npr. segmentacija, normalizacija).
Za oblikovanje besedila se uporablja jezik markdown. Uporabimo preproste znake, da dosežemo željeni učinek, recimo ** na obeh straneh besede/besedila za odebeljen tisk, * za poševen tisk. Besedilo lahko oblikujete tudi v običajnem urejevalniku besedil in ga s pomočjo spletne aplikacije pretvorite v markdown (besedilo iz urejevalnika preprosto kopirate v okno aplikacije in zgenerira se vaše besedilo v maptdownu, to kopirate in prilepite v urejevalnik na spletišču).

Stran Označevalne smernice našteva označevalne smernice sistema, zvrščene od najnovejše različice do najstarejše. Dokument citiramo in priložimo datoteke kot prilogo, na primer:

Različica 2.0 (02-2023)
projekt Razvoj slovenščine v digitalnem okolju
ARHAR HOLDT, Špela, TERČON, Luka, KREK, Simon, LEDINEK, Nina, MOŽE, Sara, SAKSIDA, Amanda, HOLZ, Nanika, 2023: Navodila za skladenjsko označevanje slovenščine po sistemu JOS-SYN. Različica 2.0. Rezultat projekta Razvoj slovenščine v digitalnem okolju. [DOCX] [PDF]

Nalaganje datotek: Datoteke najprej naložimo s svojega računalnika na strežnik. To storimo tako, da na navpičnem traku skrajno desno kliknemo na sponko (Attachments). Potem kliknemo na Upload file, izberemo datoteko s svojega računalnika in jo naložimo; ali pa primemo datoteko na svojem računalniku in jo odložimo kamorkoli v vzdolžnem delu menija. Naložena datoteka se pokaže na seznamu že naloženih datotek. Ko želimo pripeti povezavo do datoteke v besedilu, se s kurzorjem postavimo na mesto, kjer želimo povezavo. Izberemo pravo datoteko na seznamu in kliknemo na ikono verige desno ob njej. Ob ikoni verige sta še ikona svinčnika, ki odpre meni za urejanje (besedila) datoteke in ikona križca, ki omogoča brisanje datoteke.
Prikaz datoteke smernic, ki je trenutno v rabi, je tak: prilogo dodamo na željeno mesto v besedilu - pojavita se dva para oklepajev: v oglatih okepajih je najprej izvorno ime datoteke, ki bo prikazano in ki ga lahko poljubno spremenimo (kar v besedilu ali v desnem vzdolžnem meniju s klikom na ikono svinčnika ob datoteki na seznamu), v okroglih oklepajih pa je povezava do naložene datoteke - tega ne spreminjamo.
Po podobnem postopku lahko dodajamo tudi spletne strani. Polinkamo recimo projekte, v okviru katerih so smernice nastale.

Priporočače se,želimo dadodajati sonovo datotekerazličico smernicsmernic, na voljostrani lokalno,Označevalne naloženesmernice na strežnik,vrhu inseznama šecitiramo preknove spletnesmernice, povezave,na čestranskem sodesnem objavljenemeniju naložimo datoteko (gl. primerNalaganje datoteke zgoraj). in jih dodamo v besedilo.

Stran Reference in povezave vsebuje
Linkanje
spletnihPriporoča strani:

se,
Pripravada novihso datoteke referenc naložene na strežnik (in polinkane v besedilu) in do sedaj neobstoječih smernic

Administrator uporabniku/-om dodeli pravice urejanja na novi strani, kjerda se bodonavede nahajaletudi novespletno smernice.

povezavo
Pripravado novereference verzije obstoječih smernic

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

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
  1. Kopiranje vsebine v novo stran v tem portalu, kjer bodo na voljo smernice.
  2. Popravljanje vsebine, skladno s formatom markdown.
  3. 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
Back to top