This repository contains the documentation for the OpenOST introductory LaTeX workshop.
Figure: Screenshot of TeXWorks under Linux with the sample document samples/gauss-flux.tex
- Install LaTeX on your machine (ideally before the workshop takes place)
- Understand what is TeX, LaTeX, XeLaTeX, CTAN, etc.
- Learn the basics of LaTeX to typeset
- Text documents
- Mathematics
- Understand compiler errors
- Bibliography management
- Integration with version control / Write collaboratively
- Contribute to https://github.com/HSR-Stud !
- Create your own packages and classes
- Add source code listings
- Plots with pgfplots and
- Diagrams and figures with TikZ
- Diagrams with IPE
You're not really convinced? Give LaTeX a try using a free online editor. https://www.overleaf.com/project
On the Official Website of the LaTeX project there are always updated links to the various TeX Distributions. We recommend to pick one of these below depending on your operating system.
Note: A full LaTeX distributions may need a few Gigabytes! You should download and install this in advance before the seminar! You may also install a minimal version (such as TinyTeX), but beware that you may be missing some packages. Though most TeX distributions come with a package manager that will allow you to download some packages later.
Note for Linux users: You may install texlive through your package manager.
If you are using a Debian / Ubuntu derivate the texlive package should install most of what you need.
Note for Windows users: The default MikTeX installation only contains the minimal number of packages. MikTeX then offers a package management system to automatically downlad the missing packages as needed, but that means that your first document will take forever to compile. Be patient.
| Distrubition | OS | Homepage |
|---|---|---|
| TeX Live | Linux | https://www.tug.org/texlive/ |
| MacTeX | MacOS | https://www.tug.org/mactex/index.html |
| MikTeX | Windows | https://miktex.org/ |
| TinyTex (feeling adventurous?) | Linux, MacOS, Windows | https://yihui.org/tinytex/ |
If you don't know which one to pick, TeXWorks is probably the simplest.
Note: Your TeX distribution may already include an editor (for ex. TeXShop for MacTeX).
| Name | Supported OSs | Homepage | Free? |
|---|---|---|---|
| TeXWorks | Linux, MacOS, Windows | https://www.tug.org/texworks/ | Yes |
| TexMaker | Linux, MacOS, Windows | https://www.xm1math.net/texmaker/ | Yes |
| TeXStudio | Linux, MacOS, Windows | https://www.texstudio.org/ | Yes |
| VS Code + LaTeX-Workshop Extension | Linux, MacOS, Windows | https://code.visualstudio.com/ | Yes |
| Overleaf | Firefox, Chrome (online!) | https://www.overleaf.com/ | Yes |
| Texifier | MacOS | https://www.texifier.com/ | No, ~30 CHF |
| TeXnicCenter | Windows | https://www.texniccenter.org/ | Yes |
| GNOME LaTeX | Linux, MacOS | https://wiki.gnome.org/Apps/GNOME-LaTeX | Yes |
| Compositor | MacOS | https://compositorapp.com/ | No, ~30 CHF |
Here is a (pretty old, but still relevant) comparison of various editors: https://tex.stackexchange.com/questions/339/latex-editors-ides
There are a lot of templates online, here's a few:
- Mine (Naoki's)
- Mimosis Thesis
- Clean Thesis
- Informatik OST Beamer template
- Badertscher's OST beamer template
Of course on the internet there are a million other templates, however beware most although good looking may be messy to work with. Check that the source code is not spaghetti before using for the most important work you write at University!
- LaTeX tips and guidelines to avoid terrible typesetting (online)
- Wikibooks LaTeX (online)
- Introduction to LaTeX (online)
- A not so short introduction to LaTeXe (online)
- Detexify LaTeX handwritten symbols recognition (online)
- LaTeX Mathematical Symbols (compact) (online)
- A comprehensive LaTeX Symbol List (online)
- The LaTeX Font Catalogue (online)
- Advanced! Graphics in LaTeX using TikZ (online)
- Advanced! A very minimal introduction to TikZ (online)
- Advanced! CTAN Topic TikZ (online)
- Advanced! Manual for PGF and TikZ (online)
- Advanced! Manual for Package PGFPLOTS (online)
- Advanced! Building a new LATEX document class is illustrated by developing a class forminutes of meetings (online)
- Advanced! LaTeXe for class and package writers (online)
Open\OST-LaTeX-Workshop (c) by Naoki Pross
Open\OST-LaTeX-Workshop is licensed under a
Creative Commons Attribution-ShareAlike 4.0 Unported License.
You should have received a copy of the license along with this
work. If not, see <http://creativecommons.org/licenses/by-sa/4.0/>.