Skip to content

openhsr/LaTeX-Workshop

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

79 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Open\OST LaTeX Workshop

This repository contains the documentation for the OpenOST introductory LaTeX workshop.

TeXWorks Editor

Figure: Screenshot of TeXWorks under Linux with the sample document samples/gauss-flux.tex

Goals

  • 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

Extras (if there is time)

  • Create your own packages and classes
  • Add source code listings
  • Plots with pgfplots and
  • Diagrams and figures with TikZ
  • Diagrams with IPE

Homeworks

Try LaTeX without installing

You're not really convinced? Give LaTeX a try using a free online editor. https://www.overleaf.com/project

Install a TeX distribution

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/

Get a (La)TeX editor

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

Looking for templates?

There are a lot of templates online, here's a few:

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!

Further readings and useful links

License

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/>.

About

Documentation for the OpenHSR introductory LaTeX workshop

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published