ACM Student Chapter Pieter Belmans L A TEX

Transcriptie

1 ACM Student Chapter Pieter Belmans L A TEX

2 De les van vandaag Na deze les weet je in grote lijnen hoe L A TEX werkt en kan je al een volwaardige basistekst schrijven.

3 Overzicht Inleiding Software Wat u moet weten Tekstopmaak

4 Aanpak van de cursus Vier lessen, de woensdagmiddagen 16, 23 en 30 november en 7 december telkens van 2 tot 5. Er is een pauze voorzien. Ik voorzie slides waarin in kort alles toelicht, voor meer informatie verwijs ik naar The Not So Short Introduction to L A TEX 2ε, meer bepaald de Nederlandse versie die te downloaden is op Vanaf nu: lshort-dutch. Andere goede bronnen: 1. Wikibooks: 2. TeX.SX: 3. Google

5 Opbouw van de cursus Min of meer gelijklopend met lshort-dutch maar met mijn eigen voorkeuren, de planning: eerste week inleiding, installatie, eerste stappen tweede week bibliografieën, uitzicht, tabellen en figuren derde week wiskunde, gevorderde technieken vierde week naar keuze (waarschijnlijk het (mooi) invoegen van code en het maken van presentaties)

6 Geruststelling Ik ga geen geschiedenisles geven. Voor de geïnteresseerden, ik heb een TechTalk (of TEXtalk zo u wil) gegeven hierover: zie textalk.pdf

7 Bedoeling van de cursus Op een paar lessen alles vertellen dat ik na meerdere jaren L A TEX gebruiken heb geleerd is onmogelijk, daarom: op gang helpen: zelf (basis)documenten kunnen maken; zelfredzaam worden: er is enorm veel informatie te vinden op het internet; best practices: dingen waarvan ik nu denk dat ik ze zelf vroeger had moeten leren maar die te weinig aan bod komen in de meeste tutorials.

8 Tijd voor een eerste stukje interactie. Shoot. Waarom L A TEX?

9 Ik hou me aan volgende conventie: Deze slides

10 Deze slides Ik hou me aan volgende conventie: Waarschuwing Every time you ignore this, God kills a kitten.

11 Deze slides Ik hou me aan volgende conventie: Waarschuwing Every time you ignore this, God kills a kitten. Opmerking Hierin vertel ik wat er onderhuids gebeurt, geef ik alternatieven,...

12 Overzicht Inleiding Software Wat u moet weten Tekstopmaak

13 Werkwijze L A TEX is geen programma, het is een (programmeer)taal en document preparation system. Abstract gezien doen we het volgende: 1. we schrijven code; 2. we geven deze aan een programma (pdflatex in ons geval) dat de code begrijpt; 3. we krijgen output (een pdf of errors).

14 Editor Aan de tweede en derde stap kunnen we weinig veranderen, de eerste kunnen we wél zo aangenaam mogelijk proberen te maken door: zo weinig mogelijk zelf te moeten typen; syntax highlighting; errors markeren; bad boxes aanduiden; templates voor veelgebruikte documenten;...

15 Thuis Moet je eerst zelf MiKTEX (of TEX Live) installeren, download hiervoor de Basic MiKTEX 2.9 installer van miktex.org. Linuxgebruikers: sowieso TEX Live. Moet je vervolgens je favoriete L A TEX editor installeren. Aangezien jullie nog geen voorkeuren hebben wordt dit TEXmaker. Download de installatiebestanden op en na installatie zou alles moeten werken.

16 Thuis Moet je eerst zelf MiKTEX (of TEX Live) installeren, download hiervoor de Basic MiKTEX 2.9 installer van miktex.org. Linuxgebruikers: sowieso TEX Live. Moet je vervolgens je favoriete L A TEX editor installeren. Aangezien jullie nog geen voorkeuren hebben wordt dit TEXmaker. Download de installatiebestanden op en na installatie zou alles moeten werken. Alternatieven Ook te overwegen: TEXstudio, TEXworks (bijgeleverd met MiKTEX), TEXnicCenter (oud maar populair),...

17 In de computerklas MiKTEX is geïnstalleerd dus daar moeten we ons geen zorgen over maken. Maar hoe TEXmaker gebruiken? Download hiervoor de stand-alone versie, het bestand heet texmakerwin32usb.zip en pak dit uit. Open nu texmaker.exe

18 In de computerklas MiKTEX is geïnstalleerd dus daar moeten we ons geen zorgen over maken. Maar hoe TEXmaker gebruiken? Download hiervoor de stand-alone versie, het bestand heet texmakerwin32usb.zip en pak dit uit. Open nu texmaker.exe Thuis Enkel in de computerklas gebruiken we de stand-alone versie, thuis mag je het programma gerust installeren.

19 Screenshot

20 Instellingen wijzigen 1. ga naar Opties > Texmaker instellen 2. plaats het volledige pad naar pdflatex bij PdfLaTeX "C:/Program Files/MikTeX 2.9/miktex/bin/pdflatex.exe" [...] -interaction=nonstopmode %.tex 3. plaats het volledige pad naar bibtex bij BibTex en verwijder.aux "C:/Program Files/MikTeX 2.9/miktex/bin/bibtex.exe" %

21 Test Typ volgende code over en druk op F1. Er zou iets moeten verschijnen. \documentclass{article} \begin{document} Hello world. \end{document}

22 Overzicht Inleiding Software Wat u moet weten Tekstopmaak

23 Witruimte Witruimte gedraagt zich niet zoals in pakweg Microsoft Word. Enkele regels: spaties, tabs en regeleindes zijn allemaal equivalent met één spatie; opeenvolgende witruimte wordt samengevoegd; twee regeleindes na elkaar vormen = nieuwe alinea; er zijn (uiteraard) uitzonderingen (zie verbatim).

24 Speciale karakters Zoals in andere programmeertalen zijn er bepaalde symbolen met een bepaalde betekenis: $ & % # _ { } ~ ^ \ De belangrijkste voor het moment zijn: \, {, } en %, voor commando s en commentaar.

25 Speciale karakters: voorbeeld \section{voorbeeld} Dit is een voorbeeldzin. % iets interessants schrijven Dit is een~\emph{tweede} zin. % commentaar op een nieuwe regel, \emph{test} doet niets Aan de slag Werk verder in je testdocument (tussen \begin{document} en \end{document}) en druk op F1 als je klaar bent.

26 Escaping Wat als we toch zo n speciale karakters wensen te gebruiken? Door ze te prefixen met een \: \$ $ \& & \% % \# # \ \{ { \} } En \ dan? Hiervoor gebruik je \textbackslash, je zou geneigd zijn om \\ te gebruiken maar dit heeft een speciale betekenis.

27 Commando s begint met een backslash, gevolgd door een naam (enkel letters!); hoofdlettergevoelig; wordt beëindigd door een spatie (volgende tekst wordt er meteen achter geplaatst); kan parameters meekrijgen (later meer). 1 \LaTeX is leuk \\ 2 \LaTeX~is leuk \\ 3 \LaTeX{} is leuk L A TEXis leuk L A TEX is leuk L A TEX is leuk

28 Terug naar het testbestand Dit zou je nog steeds ergens opgeslagen moeten hebben (eventueel terug leegmaken). Zo nee mag je het nogmaals overtypen. \documentclass{article} \begin{document} Hello world. \end{document}

29 Nu wat uitgebreider \documentclass{article} \author{john Doe} \title{mijn eerste \LaTeX-document} \begin{document} \maketitle Hello world. \end{document}

30 Structuur preamble bevat de configuratie van het bestand, zie je niet rechtstreeks in de output \documentclass{}, packages, definities van commando s. document alles tussen \begin{document} en \end{document}, de eigenlijke tekst

31 \documentclass{} \documentclass{ class } beschrijft het soort document, in L A TEX zijn (onder andere) voorzien: article korte verslagen, artikels report langere verslagen, cursussen letter brieven (automatische hoofdingen, handtekeningen, etc.) maar er zijn ook nog (onder meer) memoir veel meer controle over layout beamer voor slides (u ziet hier het resultaat)

32 \documentclass{}: opties \documentclass[ opties ]{ class } n pt lettergrootte, default is 10pt, n {10, 11, 12} a4paper papierformaat, default is het Amerikaanse letterpaper titlepage zorgt voor een titelpagina, article default niet, report en book wel, ook notitlepage... Zie lshort-dutch voor meer.

33 Uitgebreid voorbeeld met correcte opties \documentclass[a4paper,11pt]{article} \usepackage[dutch]{babel} \author{john Doe} \title{mijn eerste \LaTeX-document} \begin{document} \maketitle Hello world. \end{document}

34 Packages Het wiel heruitvinden is nergens voor nodig, daarom zijn er packages die specifieke problemen oplossen. \usepackage[ opties ]{ naam }

35 Voorbeelden van packages babel bevat informatie over talen, meestal te gebruiken met optie [dutch] amsmath maakt wiskunde schrijven makkelijker amsfonts wiskundige lettertypes: R, m amssymb symbolen die met wiskunde te maken hebben (zie ook symbols/comprehensive): lim,,... graphicx werken met afbeeldingen...

36 Gebruik van packages Lawinegevaar Gebruik enkel packages in je document die je daadwerkelijk nodig hebt, kopieer niet telkens dezelfde lijst om er dan nog aan toe te voegen. Je krijgt op den duur conflicten. Packages hebben vaak erg goede documentatie, gebruik deze: naam

37 Gebruik van packages Lawinegevaar Gebruik enkel packages in je document die je daadwerkelijk nodig hebt, kopieer niet telkens dezelfde lijst om er dan nog aan toe te voegen. Je krijgt op den duur conflicten. Packages hebben vaak erg goede documentatie, gebruik deze: naam Oefening Probeer dit voor amsmath, pgf en thmtools.

38 Eigenlijke document \begin{document} % alles hiertussen vormt je document \end{document} zal vaak een \maketitle bevatten, de rest komt later

39 Ons afgewerkte voorbeeld \documentclass[a4paper,11pt]{article} \usepackage[dutch]{babel} \usepackage{amsfonts} \author{john Doe} \title{mijn eerste \LaTeX-document} \begin{document} \maketitle De gehele getallen worden aangeduid met~$\mathbb{z}$. \end{document}

40 Overzicht Inleiding Software Wat u moet weten Tekstopmaak

41 Tekstopmaak De structuur van tekst Speciale karakters en symbolen Verwijzingen Stijl van het lettertype wijzigen Omgevingen Overzicht

42 Lokale structuur Alles draait om alinea s. Een nieuwe alinea beginnen gebeurt door twee witregels te maken: Dit is een eerste alinea. Dit is een tweede alinea. Dit is geen derde alinea, de nieuwregel wordt genegeerd. Gebruik deze om je tekst lokaal structuur te geven.

43 Andere manieren voor lokale structuur een regel afbreken (dus een nieuwe starten): \\ of \newline; een nieuwe pagina beginnen: \clearpage en \newpage; nog wat varianten: zie lshort-dutch. Een wijze raad: ik gebruik deze zo goed als nooit, er is geen reden om aan te nemen dat jullie ze wel excessief nodig hebben, je doet misschien iets verkeerd in dat geval.

44 Opmerking bij \clearpage en \newpage De enige echte waarheid \clearpage zorgt er voor dat tabellen en figuren die nog getypeset moeten worden geplaatst worden voor de nieuwe pagina, bij \newpage gebeurt dit niet. Er zijn ook \nopagebreak[ n ], \pagebreak[ n ] en \nolinebreak[ n ] die een bepaalde mate van het doorbreken der voorgeprogrammeerde regels bepalen.

45 Globale structuur Om hoofdstukken en varianten aan te duiden gebruiken we commando niveau opmerking \part{} -1 niet in letter \chapter{} 0 niet in letter en article \section{} 1 niet in letter \subsection{} 2 niet in letter \subsubsection{} 3 niet in letter \paragraph{} 4 niet in letter \subparagraph{} 5 niet in letter

46 Wat niet te doen? zelf alinea s forceren met behulp van \\; zelf met vette tekst, eigen nummeringen of wat dan ook structuur proberen aan te brengen; te veel niveaus gebruiken: ik heb nog nooit \subsubsection{} of \subparagraph{} gebruikt;...

47 \tableofcontents \tableofcontents L A TEX maakt automatisch een inhoudsopgave op basis van de gebruikte \section{}-commando s en aanverwanten. Om de diepte te controleren: \setcounter{tocdepth}{3}

48 \tableofcontents Tip Voeg \usepackage{hyperref} toe aan je preamble om een inhoudsopgave in je pdf reader te krijgen.

49 Tekstopmaak De structuur van tekst Speciale karakters en symbolen Verwijzingen Stijl van het lettertype wijzigen Omgevingen Overzicht

50 Aanhalingstekens We willen als resultaat test, gebruik hiervoor test dus eerst back-ticks en daarna vertical quotes. Tip Gebruik nooit ". Het resultaat: "test".

51 Enkele aanhalingstekens Heel simpel: gewoon één back-tick om te openen en één vertical quote om te sluiten. test test

52 Liggende streepjes Niet minder dan viér soorten liggende streepjes: naam input output doel hyphen - - splitsen in lettergrepen en dash -- reeksen jaartallen, pagina s,... em dash --- gedachtestreepje minteken $-$ in wiskundige uitdrukking

53 Liggende streepjes: voorbeeld vergeet-me-nietje, $n$-dimensionaal pagina s , , de vlucht New York--London Jan gaf de pennenzak --- inclusief slijper --- aan Tim. Hoeveel is~$5-3$?

54 Het beletselteken Niet zo... maar zo... (in dit lettertype maakt het weinig verschil, in andere gevallen wél) Niet zo... maar zo\ldots

55 ò \ o ó \ o ô \^o õ \~o ō \=o ȯ \.o ö \"o ç \c ŏ \u o ǒ \v o ő H o o \c o œ \oe Œ \OE æ \ae Æ \AE ø \o Ø \O ł \l Ł \L ı \i j \j!? Accenten

56 Accenten: de belangrijke accent grave à accent aigu é cédille ç 1 \ a 1 \ e 1 \c c trema ä ë ë 1 \"a \"e \"{e}

57 Taal en woordsplitsing Een klein uitstapje: herinner je de lessen Nederlands nog waar je leerde splitsen in lettergrepen? L A TEX doet dit automatisch voor je! 1. \usepackage[dutch]{babel} 2. afbreking verhinderen: \mbox{} 3. je kan het handmatig aanpassen indien nodig (bijvoorbeeld via \hyphenation{} en \discretionary{}{}{} of lokaal met \-), zie lshort-dutch

58 Taal en woordsplitsing: voorbeelden \hyphenation{fortran wis-kun-de} \discretionary{diner-}{tje}{dineetje} elementaire\-deeltjes\-fysica\-fanaat \mbox{bestand} Ik wijs je op het bestaan hiervan voor moest je ooit in een situatie komen waarbij het grondig fout loopt, maar ik heb het nog nooit nodig gehad.

59 Spatiegebruik Er zijn drie soorten spaties: de gewone spatie, de tilde en \. Gebruik de eerste bij gewone tekst, de tweede als non-breakable space en de derde wanneer een punt bij een afkorting geen einde van een zin aanduidt of na een commando (waarom?). gewone tekst L A TEX is leuk ik zag 2 beren 1 gewone tekst \\ 2 \LaTeX\ is leuk \\ 3 ik zag 2~beren

60 Franse stijl L A TEX gebruikt een iets bredere spatie na het einde van een zin, wil je dit niet, gebruik dan \frenchspacing.

61 Tekstopmaak De structuur van tekst Speciale karakters en symbolen Verwijzingen Stijl van het lettertype wijzigen Omgevingen Overzicht

62 Verwijzingen We kunnen verwijzen naar objecten met een nummer: hoofdstukken, figuren, tabellen, alinea s, opsommingen,...

63 Markers Maak een label aan met \label{ marker }. Een tip: voeg aan de marker toe wat voor type het is: \label{fig:zeemeeuw} \label{figure:zeemeeuw} \label{enumerate:pythagoras-2} Figuren en tabellen We weten nog niet hoe we deze maken, maar het label komt na de caption! Het commando \label{} onthoudt enkel de laatst gegenereerde nummer.

64 Verwijzen Door \ref{ marker } en \pageref{ marker }, de eerste geeft een numerieke identificatie (het hoofdstuknummer, de opsomming,... ), de tweede de pagina waarop deze zich bevindt. Two passes L A TEX werkt hier met een two-pass systeem: je moet je document twee keer builden om het resultaat te zien: de eerste keer slaat hij op waar welke verwijzingen staan, de tweede keer kan hij ze ook weergeven.

65 Voorbeeld \section{meeuwen} \label{sec:meeuw} Meeuwen zijn vogels. \section{conclusie} In Hoofdstuk~\ref{sec:meeuw} op pag.~\pageref{sec:meeuw} zagen we dat meeuwen vogels zijn. Spatiegebruik Merk op dat wat we geleerd hebben over spatiegebruik hier belangrijk is!

66 Voetnoten Een simpel commando: \footnote{ tekst }. Voetnoten\footnote{Zoals deze.} zijn populair bij \LaTeX-gebruikers. Voetnotitis Overdrijf niet met voetnoten a. a Nee, écht niet. Let ook goed op de interpunctie, zoals in het voorbeeld duidelijk wordt.

67 Tekstopmaak De structuur van tekst Speciale karakters en symbolen Verwijzingen Stijl van het lettertype wijzigen Omgevingen Overzicht

68 Nadruk Er zijn verschillende manieren om nadruk te leggen: onderlijnen, schuin, vet of gewoon benadrukt. L A TEX weet zelf wat goed is, probeer dus niet je eigen wil op te dringen. Vette en onderlijnde tekst wordt afgeraden en wat als je binnen een schuingedrukt stuk tekst nog iets wil benadrukken?

69 Nadruk: voorbeelden onderlijnd italic slanted vet typewriter benadrukt 1 \underline{onderlijnd} \\ 2 \textit{italic} \\ 3 \textsl{slanted} \\ 4 \textbf{vet} \\ 5 \texttt{typewriter} \\ 6 \emph{benadrukt}

70 Slanted vs. italic Slanted type is gewone tekst maar enigszins verbogen, italic is een ander font waarin dus de letters daadwerkelijk anders zijn. Mijn voorkeur ligt bij slanted. Dit is slanted tekst en dit is italic. Zoals je ziet is er in dit lettertype spijtig genoeg geen verschil, maar laten we het eens zelf proberen.

71 Waarom nu \emph? \emph{dit is een benadrukte tekst, \emph{let op} voor de extra nadruk} Deze situatie komt bijvoorbeeld voor als je stellingen en definities opschrijft, je je quotation omgeving aanpast,...

72 Tekstopmaak De structuur van tekst Speciale karakters en symbolen Verwijzingen Stijl van het lettertype wijzigen Omgevingen Overzicht

73 Omgevingen We zagen reeds commando s, maar L A TEX ondersteunt ook grotere entiteiten: \begin{ naam }{ opties }[ opties ]... \end{ naam }

74 Omgevingen We zagen reeds commando s, maar L A TEX ondersteunt ook grotere entiteiten: \begin{ naam }{ opties }[ opties ]... \end{ naam } Opmerking De syntax zoals ik ze hier schets is niet helemaal wat er écht gebeurt, maar dit is (gelukkig voor jullie) geen cursus TEX hacken.

75 Lijsten We hebben 3 omgevingen voor lijsten: itemize ongenummerde opsomming enumerate genummerde opsomming description beschrijvingen (u ziet er één)

76 itemize eerste item; tweede item; derde item Een nieuwe alinea. 1 \begin{itemize} 2 \item eerste item; 3 \item tweede item; 4 \item derde item 5 6 Een nieuwe alinea. 7 \end{itemize}

77 enumerate 1. eerste item; 2. tweede item; 3. derde item Een nieuwe alinea. 1 \begin{enumerate} 2 \item eerste item; 3 \item tweede item; 4 \item derde item 5 6 Een nieuwe alinea. 7 \end{enumerate}

78 description hond kwijlend zoogdier walvis zeezoogdier Willy bekend kalf 1 \begin{description} 2 \item[hond] kwijlend zoogdi 3 \item[walvis] zeezoogdier 4 \item[willy] bekend kalf 5 \end{description}

79 description hond kwijlend zoogdier walvis zeezoogdier Willy bekend kalf 1 \begin{description} 2 \item[hond] kwijlend zoogdi 3 \item[walvis] zeezoogdier 4 \item[willy] bekend kalf 5 \end{description} Tijdsgewrocht Merk op welke Woestijnvisreeks op het moment van opstellen populair was.

80 Nesting Deze lijsten kunnen meerdere niveaus diep gaan: 1. dit is een eerste item op het eerste niveau 2. dit is een tweede item op het eerste niveau dit is een eerste item op het tweede niveau en dit een tweede 3. dit is een derde item op het eerste niveau 3.1 we kunnen ook genummerd nesten Waarschuwing Overdrijf niet!

81 Uitlijnen links uitlijnen: \begin{flushleft}...\end{flushleft} rechts uitlijnen: \begin{flushright}...\end{flusright} centreren: \begin{center}...\end{center}

82 Centreren bij tabellen of figuren We hebben nog niet gezien hoe tabellen of figuren werken, maar hier is al a word of advice: \centering Gebruik de \centering macro als je figuren of tabellen wil centreren, hier komt geen extra verticale witruimte bij.

83 Verbatim Om tekst letterlijk over te nemen heb je verbatim nodig: inline is dit \verb...\verb waar eender welk karakter behalve letters, een asterisk of een spatie mag zijn. \verb* twee spaties geeft twee spaties. Grotere stukken doe je met een omgeving: \begin{verbatim}... \end{verbatim}

84 Heb ik dit nodig? Bijvoorbeeld output van Matlab, R. Voor code kan het ook gebruikt worden maar beter is om hier listings of minted te gebruiken.

85 Heb ik dit nodig? Bijvoorbeeld output van Matlab, R. Voor code kan het ook gebruikt worden maar beter is om hier listings of minted te gebruiken. Laatste les Is er hier interesse voor? Momenteel is er hier iets kleins over voorbereid.

86 Abstract Een korte inhoud geven doe je simpelweg via \begin{abstract} korte inhoud \end{abstract}

87 Opgave Met wat we geleerd hebben moet het mogelijk zijn om de opgave die ik nu uitdeel na te maken. Aarzel niet om vragen te stellen. Het is mogelijk om de opgave exact na te maken, door wat ik de beste manier om te TEX en vind toe te passen en die jullie gewoon moeten leren wat mij betreft :).