25
Wissenschaftliche Dokumentation I SFB 608 Doktorandenseminar Workshop Uwe Ziegenhagen 18. Juli 2012

Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

  • Upload
    others

  • View
    1

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Wissenschaftliche Dokumentation ISFB 608 Doktorandenseminar Workshop

Uwe Ziegenhagen

18. Juli 2012

Page 2: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Über mich

I ursprünglich aus dem „Speckgürtel“ von BerlinI Berlin: BWL & StatistikI 2008: immigriert nach KölnI Bankhaus Sal. Oppenheim⇒ DB Private EquityI Business Analyst, Schnittstelle zwischen

Programmierer und EndanwenderI LATEX: seit ca. 12 Jahren, privat völlig WORD-frei,

gebe Einsteigerkurse in LATEX (Dingfabrik.de oderDante e.V. Tagungen)

I Herbst 2013: Dante e.V. Herbsttagung in Köln

Page 3: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Agenda

LATEX im 21. Jahrhundert

Fragen aus dem Etherpad

Satz von Einheiten

Was gibt’s noch?

Dante e.V.

Page 4: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

LATEX im 21. Jahrhundert

I Aus dem Vortrag von Martin Schröder,http://www.dante.de/events/dante2011/programm/tutorien/folien-ms.pdf

I aktuell LATEX2e, \documentstyle sollte niemandmehr im Dokument stehen haben

I LATEX3: entwickelt sich langsam, aber schon guteBasis für Paketautoren, Fertigstellung?

I XeLATEX: LATEX erweitert um die Möglichkeit,Systemfonts zu nutzen.

I LuaLATEX: LATEX erweitert um dieLua-Programmiersprache, enge Interaktion möglich.

⇒ Fokus für diesen Vortrag: pdfLATEX

Page 5: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

XeTEX

I ursprünglich für Mac OS X entwickelt, jetzt für allePlattformen verfügbar

I kann die Systemfonts recht einfach nutzen, brauchtkeine LATEX-Fontmetriken

I unterstützt auch OpenType-Features (alternativeGlyphen, Ligaturen, etc.

I persönlich genutzt, um in LATEX Dokumente imWord-Layout zu erzeugen

I wird nicht mehr weiterentwickelt, Fokus derEntwicklung liegt bei LuaTEX

Page 6: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

LuaTEX

I Lua = sehr kompakte Skriptsprache, 120 KBI lässt sich sehr leicht in andere Anwendungen

integrierenI wird auch z. B. in World of Warcraft eingesetztI erlaubt viele Dinge, die mit TEX selbst nur über

Klimmzüge machbar wärenI Wissenswertes unter http://www.luatex.deI interessantes Paket: „chickenize“ von Arno

Trautmann, http://www.ctan.org/tex-archive/macros/luatex/generic/chickenize

Page 7: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Welche Distribution soll ich nehmen?

Windows MikTEX oder TEX Live 2012alles andere TEX Live 2012

Persönlicher Favorit: TEX Live 2012 (brandneu). Vorsichtbei den Versionen, die in den Linux-Repositoriesangeboten werden: teilweise komplett veraltet!

Page 8: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Wenn ich mal ’ne Frage habe. . .

aus Büchern LATEX Companion 2e, alles von Herbert Voß,nicht: LATEX von A. Schunk

Foren I tex.stackexchange.comI golatex.deI mrunix.deI de.comp.text.tex oder comp.text.texI lists.uni-koeln.de/mailman/listinfo/tex-ws

vor Ort Kölner LATEX Stammtisch, am letzten Dienstageines Monats, Details zu Ort und Zeit unterhttp://uweziegenhagen.de/?page_id=2010

Page 9: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Effizient LATEXen

I LATEX⇒ jede Menge \, {, }, [, ], begins, endsI Drastische Arbeitserleichterung durch

Kürzel-Expansion (Windows: Autohotkey, Linux:Autokey, Mac OS X: Textexpander)

I Wie gehts? Definiere, dass s# zu \section{}expandiert wird

I Beispiele aus meiner Autohotkey-Datei, mehr unterhttp://uweziegenhagen.de/?s=autohotkey

:*:b#::\begin{{}{}}{LEFT}:*:s#::\section{{}{}}{LEFT}:*:ss#::\subsection{{}{}}{LEFT}:*:doc#::\documentclass[12pt,ngerman]{{}scrartcl{}}‘r‘r\begin{{}document{}}‘r‘r‘r\end{{}document{}}

Page 10: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Sorgen mit UmlautenI \"a ist schlechtes LATEX!I Unicode ist auf allen Systemen (Windows, Linux,

Mac OS X) StandardI wichtig: Editor muss Unicode unterstützen

(TEXworks)I kein Grund mehr, nicht UTF8 zu nutzen

1 \documentclass[12pt,ngerman]{scrartcl}2 \usepackage[utf8]{inputenc}3 \usepackage[T1]{fontenc}4 \usepackage[]{babel}5 \begin{document}6

7 äöüÄÜÖß8

9 \end{document}

Page 11: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Verrutschen von Bildern & Tabellen

I Grundsätzlich: Lasst sie rutschen, verweise mit\label{} und \ref{}!⇒http://uweziegenhagen.de/?p=2017

I Optionale Parameter der Float-Umgebung benutzenI Alternative Nr. 1: caption Paket

1 {\centering2 \myfig3 \captionof{figure}[Kurzversion]{Hallo, ich bin

auch ein Bild}}

I Alternative Nr. 2: here Paket, das den Parameter ’H’definiert

Page 12: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Welches TeX nimmt man am besten?

It depends. . .

___TEX alles ohne „La“ im Namen⇒ „Experten“pdfLATEX Brot & Butter LATEX für alle GelegenheitenXeLATEX wenn Systemschriften zwingend benötigt

werden (Achtung: Wird nicht mehrweiterentwickelt!)

LuaLATEX wenn mittels „einfachem“ Lua komplizierteTEX-Wursteleien überflüssig werden

Page 13: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Welcher Editor passt zu meinenAnforderungen?

„Glaubensfrage“, empfehlenswert sind Editoren mit

I UTF8-UnterstützungI Unterstützung der persönlichen Arbeitsweise und

Tools

Ich nutze TEXworks, dennI auf allen Plattformen identischI klein, handlich, ohne SchnickschnackI bei TEXLive automatisch dabei (Windows, Mac OS X)

Page 14: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

LaTeX will mehrere Durchläufe, gibt es dazueine elegante Lösung?

I Ich nutze standardmäßig kein entsprechendes ToolI Für größere Projekte ein Powershell SkriptI Alternativ: Make-Files (Jonas. . . ), ANT-SkripteI MikTEX: texify,

http://docs.miktex.org/manual/texify.htmlI TEXLive: latexmk,

http://tex.stackexchange.com/questions/22343/replacement-for-miktexs-texify-in-tex-live

I weiteres Tool: rubber, http://tex.blogoverflow.com/2011/12/building-documents-with-rubber/

Page 15: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Was sind typische Fehler in LaTeX, die manunbedingt vermeiden sollte? I

Quelle: l2tabu.pdf, „LATEX Sündenregister“, ’texdocl2tabu’

I Anpassungen von Rändern und Satzspiegel nur überKOMA Befehle oder das geometry Paket

I $$a+b=c$$⇒ \[ a+b=c \]I \baselinestretch nicht nutzen, stattdessen das

setspace PaketI manuelle Anpassungen von \parindent und

\parskip vermeiden, stattdessen Option (beiKOMA-Klassen) oder parskip.sty nutzen

Page 16: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Was sind typische Fehler in LaTeX, die manunbedingt vermeiden sollte? II

I Schriftstil-Änderungen nicht per \bf, \it sondernper \textbf{} oder \bfseries

I epsfig.sty, psfig.sty, etc. wurden durchgraphicx.sty ersetzt

I SIstyle.sty und SIunits.sty wurden durchsiunitx.sty ersetzt und werden nicht mehrweiterentwickelt

I Für eqnarray finden sich bessere AMS Alternativen,mit konsistenten Abständen

Page 17: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

PSTricks mit pdfLATEX übersetzen

1 \documentclass[a4paper]{scrreprt}2 \usepackage[pdf]{pstricks}3 \usepackage{pst-barcode}4 %\usepackage{auto-pst-pdf}5 \begin{document}6

7 \begin{pspicture}(1cm,1cm)8 \psbarcode{Uwe Ziegenhagen}{}{qrcode}9 \end{pspicture}

10

11 \end{document}

Page 18: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Was zur Hölle sind diese overfull boxesund wie wird man sie los?

I LATEX muss beim Silbentrennen Absätze umbrechenI je weniger Zeichen pro Zeile, desto schwierigerI wenn Trennstellen unbekannt, dann kein UmbruchI Text umformulierenI Hinweis: „draft“ Option zeigt die Overfull Stellen

grafisch an

Page 19: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Wie breche ich vernünftig zu lange Formelnum?

I AMS PaketI split UmgebungI Beispiel von http://www.nada.kth.se/~carsten/

latex/amsldoc/node12.html

1 \begin{equation*}2 \begin{split}3 H_c&=\frac{1}{2n} \sum^n_{l=0}(-1)^{l}(n-{l})^{p-2}4 \sum_{l _1+\dots+ l _p=l}\prod^p_{i=1} \binom{n_i}{l _i}\\5 &\quad\cdot[(n-l )-(n_i-l _i)]^{n_i-l _i}\cdot6 \Bigl[(n-l )^2-\sum^p_{j=1}(n_i-l _i)^2\Bigr].7 \end{split}8 \end{equation*}

Hc =1

2n

n∑l=0

(−1)l(n− l)p−2 ∑l1+···+lp=l

p

∏i=1

(nili

)

· [(n− l)− (ni − li)]ni−li ·

[(n− l)2 −

p

∑j=1

(ni − li)2].

Page 20: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Welche Pakete sind für eine Dissertation(Diplomarbeit, Masterarbeit, Bachelorarbeit)empfehlenswert und was machen sie?

I Grundsätzlich: KOMA Klasse verwenden, da bessereAnpassung an europäische Satzgewohnheiten.

I todonotes: Einfache \todo Hinweise in den Texteinfügen, mit \listoftodos Liste erzeugen

I lineno.sty für Zeilennummern, gut für dieKorrektur

I booktabs für schönere Tabellen1

I microtype für Mikro-TypografieI siunitx für den Satz von Einheiten

1Keine vertikalen Linien in Tabellen!

Page 21: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Das siunitx Paket ILaden mit\usepackage[decimalsymbol=comma]{siunitx}

\num

\num{<Zahl>} formatiert Zahlen\num{1234567890.123} erzeugt 1 234 567 890.123

\si

\si{<Einheit>} formatiert Einheiten\si{\meter^2 \per \angstrom} erzeugt m2 /Å

\SI

\SI{<Zahl>}{<Einheit>} formatiert Zahlen mit Einheiten\SI{1234567890.123}{\meter} erzeugt1 234 567 890.123 m

Page 22: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Das siunitx Paket II\SIrange\SIrange{<Zahl>}{<Zahl>}{<Einheit>} formatiertZahlenbereiche mit Einheiten\SIrange{10}{20}{\meter} erzeugt 10 m bis 20 m\ang\ang{<Zahl>} formatiert Winkel\ang{180,5} erzeugt 180.5◦

Spaltentypen ’S’ und ’s’

Zahlen m

12.1 m123.12 m

1.2× 104 m1234.123 m

Page 23: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Eine typische Präambel

I Grundsätzlich: nur die Pakete laden, die wirklichgenutzt werden

I nicht alles ins Dokument kopieren, was Googleausspuckt

I Lade-Reihenfolge beachten (hyperref.sty)

1 \documentclass[12pt,ngerman]{scrartcl}2 \usepackage[utf8]{inputenc} %welches Encoding schreibt der Editor?3 \usepackage[T1]{fontenc} % welche Zeichen setzt der Font um?4 \usepackage[english,ngerman]{babel} % switch with \selectlanguage{english}5 \usepackage[babel,german=quotes]{csquotes} % \enquote{}6 \usepackage[version=3, arrows=pgf, arrows=pgf-filled]{mhchem}7 \usepackage[]{todonotes} % \todo{Bild nicht vergessen}8 \usepackage[]{pdfpages} % einfügen von PDF Seiten9 \usepackage[]{microtype} % Mikrotypografie

10 \usepackage[]{siunitx} % Einheitensatz11 \usepackage[]{booktabs} % Tabellen12 \usepackage[]{lineno} % zum Korrekturlesen, \linenumbers13 \usepackage{amssymb} % ams packages14 \usepackage{amscd}15 \usepackage{amsmath}16 \usepackage{amsthm}

Page 24: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Was gibt’s noch?

I sweave, Interaktion von LATEX und RI scrlttr2, Briefe mit LATEX Corporate DesignsI Tufte Klassen, Design von Edward TufteI subversion, Schnittstellen zu VersionsmanagementI . . .

Page 25: Wissenschaftliche Dokumentation Iuweziegenhagen.de/wp-content/uploads/2012/08/folien.pdf · Über mich I ursprünglich aus dem „Speckgürtel“ von Berlin I Berlin: BWL & Statistik

Dante e.V.

I Deutschsprachige Anwendervereinigung TEX e.V.I seit 1989 in HeidelbergI Betreuung und Beratung von TeX-Benutzern im

gesamten deutschsprachigen Raum.I Koordination von nationalen und internationalen

Weiterentwicklungen, SponsoringI Mit-Herausgabe der TEX Live DVDI Herbsttagung in Köln vermutlich 2013I Schnuppermitgliedschaft kostet 15 Euro, verlängert

sich nicht automatisch