LaTeX-sjabloon voor een artikel

In deze repository vind je een sjabloon voor een artikel of ander kort document dat de huisstijlregels van HOGENT tracht te volgen. Dit sjabloon is niet officieel in die zin dat het niet werd gecreëerd of erkend door de dienst communicatie, maar is wel ontworpen met de bedoeling dat het gebruikt wordt in de opleiding toegepaste informatica.

Het sjabloon is geïnspireerd door:

• Pieter Van der Kloet's thesis-sjabloon (wordt nu hier verder onderhouden)
• Het artikelsjabloon van de Astronomical Society of Australia

Aan de slag

Om dit sjabloon te kunnen gebruiken, heb je het volgende nodig:

• De gebruikte TrueType lettertypes (je kan deze downloaden en installeren via de link):
  • Montserrat (hoofdlettertype)
  • Fira Code (monogespatieerde tekst)
  • Fira Math (wiskundige formules)
• XeLaTeX als compiler (o.a. voor Unicode-ondersteuning)
• Biber voor het beheer van de bibliografie (o.a. voor Unicode-ondersteuning en de APA referentiestijl)

Om zelf een document aan te maken, gebaseerd op deze stijl, heb je volgende bestanden nodig:

• hogent-article.cls (documentclass-definitie)
• img/HOGENT_Logo_Pos_rgb.png (logo)
• Je kan starten met een van de voorbeeld .tex-bestanden en die aanpassen naar je voorkeur.

HOGENT huisstijl

De HOGENT huisstijl kenmerkt zich o.a. door:

• Het Montserrat lettertype
• Specifiek kleurenpallet (zie overzicht hieronder)
• Bronvermeldingen volgens de APA6-stijl

Kleurnaam	RGB
hogent-darkgreen	22,176,165
hogent-pink	241,157,160
hogent-ochre	250,188,50
hogent-orange	239,135,103
hogent-purple	187,144,189
hogent-blue	76,162,213
hogent-lightgreen	165,202,114
hogent-brown	216,176,131
hogent-grey	195,187,175
hogent-yellow	244,222,0

Documentclass-opties

Het sjabloon is gebaseerd op het standaard LaTeX article-sjabloon, met opties a4paper, 10pt.

Het sjabloon heeft momenteel volgende documentclass-opties:

Optie	Effect
dutch	Inhoud in het Nederlands(*)
english	Inhoud in het Engels
onecolumn	Pagina-indeling met 1 kolom
twocolumn	Pagina-indeling met 2 kolommen(*)

(*) Indien opties niet expliciet zijn opgegeven, wordt deze als standaard ingesteld.

Commando's voor document-metadata

In het sjabloon worden een aantal commando's ge(her)definieerd voor het specifiëren van metadata die op een specifieke manier opgemaakt wordt in de PDF. Je gebruikt al deze commando's in de preamble. De meeste zijn optioneel, tenzij anders aangegeven.

• \academicyear: het academiejaar waarin het document geschreven is of van toepassing op is. Indien niet opgegeven wordt \today gebruikt.
• \assignmenttype: het soort opdracht waarvoor het document geschreven wordt, bv.
  • Onderzoeksvoorstel
  • Paper
• \author (verplicht): geef de naam van een auteur. Indien er meerdere auteurs zijn, geef je deze met aparte \author-commando's op.
• \course: de cursus waarbinnen dit document geschreven wordt, bv.
  • Research Methods
  • Bachelorproef
• \email: e-mailadres van de auteur(s). Je geeft best voor elke auteur een email-adres op, telkens met een apart \email-commando.
  • Wanneer je geen email-adressen opgeeft, zal er een waarschuwing verschijnen bij compileren.
• \keywords: enkele sleutelwoorden die het onderwerp van het document beschrijven.
• \projectrepo: URL van de Github-repository waar projectcode wordt bijgehouden
• \specialisation: Specialisatierichting waarbinnen de opdracht of de inhoud van het document zich situeert. In toegepaste informatica zijn dat bv.:
  • Mobile & Enterprise development
  • AI & Data Engineering
  • Functional & Business Analysis
  • System & Network Administrator
  • Mainframe Expert
• \studyprogramme: de opleiding waarbinnen dit document zich situeert, bv.
  • Professionele bachelor toegepaste informatica
  • Postgraduaat it-management
• \supervisor: de lector die de opdracht begeleidt.
  • Je kan dit commando max. 1 gebruiken, dus als er meerdere begeleiders zijn moet je die allemaal samen opgeven.
  • Als de begeleider een andere rol heeft die je wil beschrijven, dan kan dat met een optioneel argument, bv.
    • \supervisor[Co-promotor]{S. Beekman} of \supervisor[Lectoren]{S. Beekman, T. De Smet}

Andere

• Als je bij het begin van het document een samenvatting opgeeft met de abstract environment, dan is het niet nodig om nog apart \maketitle te gebruiken.
  • De titel van het document wordt gegenereerd samen met de abstract.
  • Als je geen abstract opgeeft, dan worden \keywords en \specialisation niet getoond.
  • Let op! Als je geen abstract opgeeft, dan werkt de onecolumn option niet goed.
• Je kan de kleur van de titels of hyperlinks wijzigen door deze in de preamble te definiëren, vb:
  • \colorlet{title}{hogent-darkgreen}
  • \colorlet{links}{hogent-grey}
• In dit sjabloon wordt de APA-stijl gebruikt via de biblatex package. Gebruik dus biber voor het compileren van de bibliografie en volgende commando's om te verwijzen naar bronnen:
  • \textcite{AuthorYear} voor een referentie van de vorm "Auteur (jaar)"
  • \autocite{AuthorYear} voor een referentie van de vorm "(Auteur, jaar)"

Vragen, problemen, verbeteringen

Heb je vragen of problemen bij het gebruik van dit sjabloon, of heb je ideeën voor verbetering? Laat het weten via de Issues.

Concrete voorstellen tot verbetering zijn ook ten zeerste welkom en die kan je via een Pull Request indienen.