Skip to content

Commit cb489e2

Browse files
committed
Add more information to the README
1 parent 623ef97 commit cb489e2

File tree

1 file changed

+81
-2
lines changed

1 file changed

+81
-2
lines changed

README.md

Lines changed: 81 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,85 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
2020
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
2121
SOFTWARE. -->
2222

23+
# Inhoudsopgaven
2324

24-
# TTS-latexTemplate
25-
Een latex template voor de minor Teaching Technology and Science en de Educatieve minor van de hogeschool van amsterdam.
25+
- <h3><a href="#inleiding">Inleiding</a> </h3>
26+
- <h3><a href="#structuur">Structuur</a> </h3>
27+
- <h3><a href="#latex">Latex</a> </h3>
28+
- <h3><a href="#issues">Issues</a> </h3>
29+
- <h3><a href="#mergeRequests">Merge requests</a> </h3>
30+
31+
# Inleiding
32+
33+
<div id="Inleiding"></div>
34+
Dit latex template kan gebruikt worden voor het schrijven van verslagen voor de minor Teaching Technology and Science en de Educatieve minor van de Hogeschool van Amsterdam (HvA).
35+
36+
# Structuur
37+
38+
<div id="structuur"></div>
39+
De verschillende bestanden en directories die in dit template worden gebruikt hebben verschillende doelen. De bestanden structuur wordt <a href="#fileStructure">hier</a> getoond.
40+
41+
<div id="fileStructure">
42+
<pre>
43+
├── LICENSE
44+
├── README.md
45+
├── hvaFoo.sty
46+
├── hvaTemplate.sty
47+
├── references.bib
48+
├── img/
49+
├── Logos/
50+
│ ├── HvA_compact_zwart_RGB.pdf
51+
│ └── HvA-Lerarenopleidingen-zwart-RGB.pdf
52+
└── report.tex
53+
</pre>
54+
<p style="text-align:center;">Bestanden structuur van de TTS-latexTemplate</p>
55+
</div>
56+
57+
### De belangrijkste bestanden
58+
59+
- `hvaFoo.sty`
60+
Implementeert twee commando's, een commando om een lesplan formulier in te vullen en een commando om een observatie lesuitvoer in te vullen.
61+
- `hvaTemplate.sty`
62+
Hierin staan een aantal standaard latex packages en wordt de pagina indeling mee opgezet. Daarnaast zorgt dit bestand er voor dat er een titel pagina/voorblad kan worden gegenereerd in een HvA stijl en kan er voor worden gekozen uit een tweetal copyrights.
63+
- `references.bib`
64+
Hierin komen alle bibtex referenties te staan waarnaar wordt verwezen.
65+
- `report.tex`
66+
Hierin wordt het verslag geschreven. Om het latex project in meerdere bestanden op te kunnen delen kan er bijvoorbeeld gebruik worden gemaakt van `\input{<relative path to tex file>}`.
67+
68+
### De belangrijkste directories
69+
70+
- `img/`
71+
Bevat alle afbeeldingen die in het latex project worden gebruikt.
72+
- `Logos/`
73+
Bevat alle afbeeldingen/logo's die door `hvaTemplate.sty` worden gebruikt.
74+
75+
# Latex
76+
77+
<div id="latex"></div>
78+
Latex kan gebruikt worden voor het schrijven van verslagen en genereert op basis van de `.tex` bestanden een pdf. Het zogenaamd compileren van een latex bestand kan lokaal (op de eigen computer) gedaan worden als mede in de cloud.
79+
80+
## Latex in de cloud compileren
81+
82+
De meest gebruiksvriendelijke manier om latex projecten te compileren voor een nieuwe gebruiker is door gebruik te maken van <a href="https://www.overleaf.com">Overleaf</a>. Om Overleaf te kunnen gebruiken moet je een gratis account aanmaken. Na het aanmaken van een nieuw project kunnen de bestanden van dit repository naar het nieuwe project worden geüpload en kan er verder worden gewerkt in de Overleaf omgeving.
83+
84+
## Latex lokaal compileren
85+
86+
Het compileren van grotere projecten in Overleaf kost erg veel tijd en kan een reden zijn om een latex project lokaal te willen compileren. Er bestaan een aantal editors die hiervoor gebruikt kunnen worden.
87+
- <a href="https://www.texstudio.org">texstudio</a>
88+
- <a hfef="https://code.visualstudio.com">vscode</a> met de <a href="https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop">latex-workshop</a> extensie
89+
90+
De eisen voor de installatie is terug te vinden via de links hierboven en zal hier niet verder worden toegelicht.
91+
92+
# Issues
93+
94+
<div id="issues"></div>
95+
Indien er een bug of fout is gevonden in dit repository wordt er vriendelijk verzocht hier een issue voor aan te maken. Het is fijn als er in een issue wordt beschreven wat het probleem is en hoe het probleem gereproduceerd kan worden.
96+
97+
Wanneer er een feature mist kan ook hiervoor een issue worden aangemaakt. Beschrijf in een dergelijk issue wat de gewenste feature is en waarom die nodig is.
98+
99+
# Merge requests
100+
101+
<div id="mergeRequests"></div>
102+
Verbeteringen op deze template worden natuurlijk erg gewaardeerd. Als je een verbetering wilt maken is het de bedoeling dat je eerst een issue aanmaakt met daarin beschreven wat je beoogde verbetering inhoud waarna je bij een merge request naar de start issue kunt verwijzen. Op deze manier blijft het overzichtelijk om de veranderingen bij te houden.
103+
104+
Voordat een merge request wordt geaccepteerd zal er worden gekeken naar de aanpassingen van de merge request. Het is de bedoeling dat een merge request een enkel issue oplost. Als een merge request meerdere issues tegelijkertijd oplost zal deze worden geweigerd en moet de merge request worden opgesplitst in meerdere losse merge requests.

0 commit comments

Comments
 (0)