Predloge za zaključna dela na oddelku za matematiko FMF UL

Za uporabo najprej preberite navodila na vaši spletni učilnici, nato pa prenesite ustrezen arhiv s predlogo:

in sledite spodnjim navodilom za uporabo. Dokument bi se moral prevesti brez posebnosti in dodatnih nastavitev. Nekaj pogostih težav in rešitev je opisanih spodaj.

Za pomoč pri razvoju se zahvaljujemo Aniti Buckley (za pomoč pri poenotenju in uvedbi PDF/A formata), Maji Klavžar (za natančna navodila glede navajanja literature), Matjažu Konvalinki (kot skrbniku za vse potrebne informacije), Anji Petković (za angleški primer magistrskega dela) in Sašu Strletu (za prvo različico predloge za diplomsko delo).

Razvijalci: Luna Strah, Jure Slak, Matija Pretnar, Gašper Golob in Katja Berčič.

Predloge za zaključna dela v sodelovanju z drugimi univerzami

Če zaključno delo opravljate v sodelovanju z drugo univerzo (npr. program dvojne diplome v Trstu), potrebujete posebno predlogo. Če na spodnjem seznamu ni ustreznega arhiva, nas prosimo kontaktirajte.

Za urejanje dokumentov močno priporočamo Visual Studio Code s podaljškom LaTeX Workshop in podaljškom za črkovanje LTeX. Za preverjanje črkovanja neodvisno od urejevalnika lahko uporabite aspell.

V LaTeX dokumentu pod komentarjem % naslednje ukaze ustrezno dopolnite izpolnite ime avtorja, mentorja, morebitnega somentorja, naslov dela in ostalo. Ti ukazi se uporabijo v generiranju naslovnice, izjave, povzetka in PDF metapodatkov.

Predloga podpira arhivski standard PDF/A-2b, ki mu mora zadoščati vaše zaključno delo, ko ga boste oddali preko VIS-a. Med prevajanjem se samodejno pripravijo ustrezni metapodatki in zaznamki za poglavja, ki jih lahko vidite v drevesni strukturi v pregledovalniku PDF dokumentov.

Vaš PDF pred oddajo (ali pa že kdaj prej) preverite z uporabo spletnega validatorja PDFForge ali pa z validatorjem veraPDF, ki ga lahko namestite na svoj računalnik.

Odpravljanje napak

Če imate težavo s predlogo:

  1. Najprej počistite dodatne datoteke (.log, .aux ipd.), v katerih se lahko stare napake zadržujejo dlje, kot je treba. V urejevalniku Visual Studio Code to naredite tako, da v paleti ukazov (Command Palette, Ctrl+Shift+P oz. Cmd+Shift+P na macOS) natipkate Clean Auxiliary Files. Tam bo pisalo tudi, s katero bližnjico pridete do te funkcije na vašem računalniku. Alternativno lahko v ukazni vrstici poženete ukaz latexmk -c.
  2. V spodnjem seznamu poiščite napako, ki jo imate, sledite navodilom ter ponovite 1. korak.
  3. Če napake na seznamu ne najdete, stopite v stik z razvijalci ali odprite issue na GitHubu. V nobenem primeru ne spreminjajte datoteke fmfdelo.cls ali strukture predloge, saj je šlo zaradi formata PDF/A v predlogo veliko truda in bo spreminjanje bolj kot ne še kaj dodatno pokvarilo.

Seznam najpogostejših napak

Matematični simboli v naslovih in ključnih besedah

Če v naslovih ali ključnih besedah uporabite matematične znake, jih pregledovalnik mogoče ne bo prikazal, ali pa bo celo prišlo do težav pri prevajanju. V tem primeru lahko z ukazom \texorpdfstring{$formula$}{golo besedilo} (kot je prikazano na primeru v predlogi), dodate še se golo besedilo (ki lahko vsebuje UTF-8 znake), ki se bo uporabilo v PDF kazalu ali meta-podatkih PDF dokumenta.

pdfapart undefined

Če dobite pri prevajanju napako podobno ! Package keyval Error: pdfapart undefined., priporočamo, da posodobite svojo distribucijo LaTeX-a na najnovejšo verzijo. Prvi nasvet je torej, da posodobite svojo distribucijo LaTeX-a na najnovejšo verzijo, v kateri omogočite sprotno nalaganje paketov. Ustrezni distribuciji sta MikTeX in TeX Live.

./fmfdelo.cls ! Undefined control sequence.

Če dobite napako oblike

(./fmfdelo.cls
! Undefined control sequence.
\UseTextAccent ...up \@firstofone \let \@curr@enc
                                                \cf@encoding \@use@text@en...
l.2 ...fmfdelo}[2016/10/13 Zaključna dela na FMF]

morate posodobiti .cls datoteko na najnovejšo verzijo.

The value of the key SMask ... / The key S has a value ...

Napaki The value of the key SMask is an image but must be None. ali The key S has a value Transparency which is prohibited. pomenita, da imate vključeno kakšno prosojno sliko. Za rastrske slike je ponavadi dovolj, da s primernim programom prosojno barvo spremenite v belo, za slike v vektorskih formatih pa je potrebno ponavadi nastaviti ozadje. Pri paketu TikZ pa je npr. namesto \draw[fill=yellow] treba napisati \filldraw[color=yellow].

Manjkajoče velike začetnice v literaturi

BibTeX pri navajanju literature odvisno od stila spreminja velikost črk, na primer

title = {Predloge za zaključna dela na FMF UL}

se bo lahko odvisno od vrste vira izpisalo kot Predloge za zaključna dela na Fmf Ul ali Predloge za zaključna dela na fmf ul. Če želite vsiliti svojo velikost, morate besedilo zaščiti z {}, na primer

title = {Predloge za zaključna dela na {FMF UL}}

Neveljaven znak na začetku datoteke

Če vam LaTeX (ali kakšno drugo orodje) javlja napako pred prvim znakom datoteke, tudi če ga pobrišete, gre najverjetneje za BOM, poseben neviden znak na začetku datoteke. Znebite se ga tako, da v Visual Studio Code spodaj kliknete na UTF-8 with BOM ter izberete Save with encoding > UTF-8.

Ostale napake

Še enkrat, če napake na seznamu ne najdete, ne spreminjajte datoteke ali strukture predloge, temveč opozorite razvijalce, da jo lahko preprečimo tudi za ostale uporabnike.