dpix opgaveredigering i Emacs en tutorial Svend Daugaard Pedersen 11. januar 2014
Indhold 1 Indledning 1 2 Start Emacs og opret et LATEX-projekt 1 3 En skabelon til opgaveredigering 2 4 Indlæs en opgave 3
1 INDLEDNING 1 1 Indledning I dette lille skrift beskrives, hvorledes man kommer i gang med opgaveredigering i Emacs med dpix. Det forudsættes, at man har et basalt kendskab til LATEX og Emacs. 2 Start Emacs og opret et L A TEX-projekt Efter start af en tom Emacs viser der sig et vindue som nedenfor Nu skal vi skifte til latex-mode (og dermed også til dpix-mode). Det gøres ved indtastning af ESC x latex-mode. Indtastningen ses i minibufferen nederst i vinduet (se billede). M et står for meta-tast, som findes på nogle computere (det er en tast på linje med CTRL-tasten). Det er dog de færreste, der har denne tast, så i stedet benyttes ESC. Nu tastes ENTER og der skiftes til LATEX/dPiX-mode (det kan ses på menuerne og de nye knapper se billede). På MAC med AquaMacs kan det alt sammen ske via et menupunkt i File-menuen. Til slut vil vi gemme filen i et LATEX-projekt. Slet de tre linjer og vælg dpix-menuen menupunktet Save As Latex Project... Der åbnes en filvælger, hvor du finder frem til det sted, hvor projektet skal anbringes. Derpå skrives navnet på det nye projekt i indtastningsfeltet Folder name (det er navnet på en mappe, der navngives). Slut af med at taste ENTER.
3 EN SKABELON TIL OPGAVEREDIGERING 2 Resultatet er oprettelse af en mappe og inde i mappen ligger en tex-fil med navnet main.tex. Den får snart selskab af et hav af andre filer og mapper. 3 En skabelon til opgaveredigering Nedenfor ses en (minimal) skabelon, der kan danne udgangspunkt for redigering af opgaver. \ d o c u m e n t c l a s s [12 pt, a 4 paper, f l e q n ] { r e p o r t } \ u s e p a c k a g e [ d a n i s h ] { b a b e l } \ u s e p a c k a g e [ l a t i n 9]{ i n p u t e n c } 5 \ u s e p a c k a g e [ T1]{ f o n t e n c } \ u s e p a c k a g e { matematik } \ u s e p a c k a g e {icomma} \ parindent = 0 p t 10 \ parskip = 1 pc \ s e t l e n g t h { \ m a t h i n d e n t }{4em} \ b e g i n { document } 15 \ p a g e s t y l e { empty } \ b e g i n { enumerate } \ item 20 \ end{ enumerate } \ end{ document } Bemærk linje 6. Her indlæses matematik-pakken, der en del af local-pakken. Den bruges i de fleste af de opgaver, man indlæser, og er derfor absolut nødvendig. local-pakken installeres sammen med dpix (se evt. vejledningen dpix-installation.pdf). En udvidet udgave af den viste skabelon kan hentes ved i dpix-menuen at vælge menupunktet Use template (vælg undermenuen mat-opgaver). Den indlæste skabelon rummer de ovenfor viste linje samt et antal udkommenterede linjer (det er en stor lettelse senere at kunne tilføje nye linjer ved blot at fjerne en kommentar). Bemærk at valgmulighederne i Use template-undermenuen er navne på tex-filer i mappen HOME/dpix.custom/tex-templates. Du kan selv fjerne nogle af filerne, tilføje dine egne skabelonfiler eller redigere i de eksisterende.
4 INDLÆS EN OPGAVE 3 4 Indlæs en opgave Nu vil vi indlæse en opgave. Placér markøren, hvor opgaven skal placeres (linje 19 i listningen ovenfor se også billede). Tryk nu på knappen øverst til højre i værktøjsbjælken (alternativt: vælg menupunktet Insert Problem... i dpix-menuen). Der åbner sig et vindue som vist nedenfor. Hvis det er første gang, der skal indlæses en opgave, er der endnu ingen opgaver og i løbet af kort tid tænder den røde knap Opdatér... i nederste højre hjørne som vist på billedet. Tryk på knappen og i det nye vindue, der herved åbnes, trykkes på knappen Hent filer. Nu starter hentningen af opgaverne. Det kan tage noget tid (afhængig af internet-forbindelsen). Når indlæsningen er færdig, lukkes opdateringsvinduet og opgavevælgeren har fået tilføjet en mappe MatEksamen. Opgavevælgerens venstre side fungerer som en normal filvælger. I højre side vises
4 INDLÆS EN OPGAVE 4 indholdet af den opgave, man har valgt (se billede nedenfor). Hvis ingen opgave er valgt, er højre side tom. Find frem til en opgave (for at følge denne beskrivelse, bør det være den viste, som er en STXBopgave) og indlæs den i Emacs ved at dobbelt-klikke på den eller trykke på ENTER. Den indlæste opgave placeres i Emacs på markørens position (se billede).
4 INDLÆS EN OPGAVE 5 Bemærk den første linje i det indlæste %% source: ALMMA:STXB130529/opg10 Den fortæller, hvor opgaven stammer fra. Men linjen bruges også af opgavevælgeren, når den søger efter brugte opgaver. Undgå derfor at ændre linjen. Gem ændringerne i Emacs, formatér teksten og se indholdet. Det er ikke afgørende, om man bruger LATEX eller PDF-LATEX (som på billederne). Lad os indlæse endnu en opgave. Prøv med STXB/2012.08.15/opg07. Billedet nedenfor viser Emacsbufferen efter indlæsningen. Denne opgave rummer et billede, der indlæses med linjen \includegraphics[width=9.0cm]{almma-stxb120815-opg07-oerred} Makroen \includegraphics er defineret i pakken graphicx. Det er derfor nødvendigt at tilføje følgende to linjer i starten af Emacs-bufferen (preamble-sektionen) \usepackage{graphicx} \graphicspath{{jpg/}{eps/}}
4 INDLÆS EN OPGAVE 6 Hvis man har benyttet mat-opgaver-skabelonen, kan man klare det ved at afkommentere de relevante linjer. Gem, formatér og se igen resultatet. Lad os indlæse en tredje opgave. Prøv med STXB/2012.08.15/opg03. Billedet nedenfor viser Emacsbufferen efter denne indlæsning. Denne opgave laver en figur v.hj.a. pakken pstricks, som derfor skal indlæses. Det gør vi via pakken dpix, idet vi tilføjer linjen (hvis man ikke bruger PDF-LATEX, skal,pdf udelades): \usepackage[pst,pdf]{dpix} I starten af opgaven (under source-kommentaren) er endnu en kommentar. Den oplyser om, at endnu en pake er nødvendig. Tilføj denne (igen kan man måske nøjes med at afkommentere relevante linjer). Hvis du benytter PDF-LATEX, opdagede du måske, at knappen ved siden af opgavevælger-knappen blev gjort aktiv. For at formatere teksten, er det nødvendigt (med PDF-LATEX) først at generere billedet i et format, som PDF-LATEX kan bruge. Det gøres ved at trykke på denne knap (eller ved i dpixmenuen at vælge menupunktet Make pst/mfpic graphics). Formatér og se resultatet. Prøv nu at indlæse STXB/2012.08.15/opg05. Nedenfor ses Emacs-bufferen efter indlæsningen.
4 INDLÆS EN OPGAVE 7 Her skal man lægge mærke til linjen \includedpix{almma-stxb120815-opg05-graf} som indlæser en fil med pst-grafik. For at formatere teksten skal linjen \usepackage[pst,pdf]{dpix} derfor tilføjes. Det er allerede gjort, så vi kan formaterer (hvis der bruges PDF-LATEX, skal billederne dog først genereres påny ved tryk på ). Filen, der blev indlæst med linjen \includedpix{almma-stxb120815-opg05-graf}, indeholder som nævnt pst-grafik. Den er genereret af et C++-program, hvis kildekode kan ses ved at placere markøren på include-linjen og taste ESC s (eller benytte menupunktet Edit Source... i dpix-menuen). Her skal vi ikke komme nærmere ind på, hvorledes man selv laver sådanne grafikfiler (det er beskrevet indgående i en særlig vejledning). Vi bruger den blot, som den er.