Commit 26062ec4 authored by Bernhard Grotz's avatar Bernhard Grotz

Erster Commit.

parents
# Ignore any directories named "_build" ,but still
# notice regular files and symbolic links with
# that name.
_build/
.hg/
# Ignore this specific file
grundkurs-latex.pdf
.hgignore
*.log
Lizenz
======
Diese Dokumentation wird unter folgender Lizenz veröffentlicht:
Creative Commons 3.0 by-nc-sa
Weitere Informationen hierzu gibt es unter folgender Adresse:
http://creativecommons.org/licenses/by-nc-sa/3.0/
# Makefile for Sphinx documentation
#
# You can set these variables from the command line.
SPHINXOPTS =
SPHINXBUILD = sphinx-build
PAPER =
BUILDDIR = _build
# Internal variables.
PAPEROPT_a4 = -D latex_paper_size=a4
PAPEROPT_letter = -D latex_paper_size=letter
ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest
help:
@echo "Please use \`make <target>' where <target> is one of"
@echo " html to make standalone HTML files"
@echo " dirhtml to make HTML files named index.html in directories"
@echo " singlehtml to make a single large HTML file"
@echo " pickle to make pickle files"
@echo " json to make JSON files"
@echo " htmlhelp to make HTML files and a HTML help project"
@echo " qthelp to make HTML files and a qthelp project"
@echo " devhelp to make HTML files and a Devhelp project"
@echo " epub to make an epub"
@echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
@echo " latexpdf to make LaTeX files and run them through pdflatex"
@echo " text to make text files"
@echo " man to make manual pages"
@echo " changes to make an overview of all changed/added/deprecated items"
@echo " linkcheck to check all external links for integrity"
@echo " doctest to run all doctests embedded in the documentation (if enabled)"
clean:
-rm -rf $(BUILDDIR)/*
html:
$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
@echo
@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
dirhtml:
$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
@echo
@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
singlehtml:
$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
@echo
@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
pickle:
$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
@echo
@echo "Build finished; now you can process the pickle files."
json:
$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
@echo
@echo "Build finished; now you can process the JSON files."
htmlhelp:
$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
@echo
@echo "Build finished; now you can run HTML Help Workshop with the" \
".hhp project file in $(BUILDDIR)/htmlhelp."
qthelp:
$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
@echo
@echo "Build finished; now you can run "qcollectiongenerator" with the" \
".qhcp project file in $(BUILDDIR)/qthelp, like this:"
@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/LaTeX.qhcp"
@echo "To view the help file:"
@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/LaTeX.qhc"
devhelp:
$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
@echo
@echo "Build finished."
@echo "To view the help file:"
@echo "# mkdir -p $$HOME/.local/share/devhelp/LaTeX"
@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/LaTeX"
@echo "# devhelp"
epub:
$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
@echo
@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
latex:
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
@echo
@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
@echo "Run \`make' in that directory to run these through (pdf)latex" \
"(use \`make latexpdf' here to do that automatically)."
latexpdf:
$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
@echo "Running LaTeX files through pdflatex..."
make -C $(BUILDDIR)/latex all-pdf
@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
text:
$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
@echo
@echo "Build finished. The text files are in $(BUILDDIR)/text."
man:
$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
@echo
@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
changes:
$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
@echo
@echo "The overview file is in $(BUILDDIR)/changes."
linkcheck:
$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
@echo
@echo "Link check complete; look for any errors in the above output " \
"or in $(BUILDDIR)/linkcheck/output.txt."
doctest:
$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
@echo "Testing of doctests in the sources finished, look at the " \
"results in $(BUILDDIR)/doctest/output.txt."
Grundkurs LaTeX
===============
In dieser Dokumentation aus der `Grund-Wissen <http://www.grund-wissen.de>`_
-Reihe geht es um eine Einführung in die Textsatzungs-Sprache LaTeX.
Das Projekt verwendet `Sphinx <http://sphinx-doc.org/>`_ als Programm zum
Erstellen der HTML- bzw. PDF-Dokumente. Die Dokumentation wird kontinuierlich
ausgebaut, Unterstützung bei der Weiterentwicklung ist gerne willkommen.
Eine HTML-Version dieser Seite ist unter folgender Adresse abrufbar:
http://www.grund-wissen.de/informatik/latex/
Lokale Kopien und eigene Änderungen
-----------------------------------
Um lokale Kopien der Dokumentation zu erstellen, müssen einige Pakete
installiert sein. Unter Debian, Ubuntu oder Linux Mint können diese
folgendermaßen installiert werden:
.. code-block:: bash
aptitude install python3-setuptools
easy_install3 -U Sphinx
Anschließend kann das Repository heruntergeladen werden:
.. code-block:: bash
git clone https://github.com//grund-wissen/grundkurs-latex.git
Im Projektverzeichnis können dann aus den Quelldateien wahlweise HTML-Seiten
oder ein PDF-Dokument erstellt werden:
.. code-block:: bash
# HTML-Seiten erzeugen:
make html
# PDF-Dokument erzeugen:
make latexpdf
Die fertigen Dokumente befinden sich anschließend im Verzeichnis ``_build/html``
beziehungsweise ``_build/latex``.
Sollen eigene, lokale Änderungen an der Dokumentation in dieses Repository
übernommen werden, so wird um einen entsprechenden Pull-Request gebeten.
Herzlichen Dank an alle Mitwirkenden!
<META HTTP-EQUIV="Refresh" CONTENT="0; URL=http://www.grund-wissen.de" />
{% extends "!layout.html" %}
{% block rootrellink %}
<li><a href="{{ pathto('home') }}">Home</a>&nbsp;|&nbsp;</li>
<li><a href="{{ pathto('index') }}">LaTeX</a> &raquo;
{% endblock %}
{% block header %}
{% endblock %}
import sys, os
sys.path.append(os.path.abspath('_exts'))
extensions = [
'matplotlib.sphinxext.mathmpl',
'matplotlib.sphinxext.only_directives',
'matplotlib.sphinxext.plot_directive',
'sphinx.ext.autodoc',
'sphinx.ext.doctest',
'sphinx.ext.intersphinx',
'sphinx.ext.todo',
'sphinx.ext.coverage',
'sphinx.ext.pngmath',
'sphinx.ext.ifconfig',
'sphinx.ext.viewcode',
# "sphinxcontrib.blockdiag",
# "sphinxcontrib.seqdiag",
]
# 'ipython_console_highlighting',
# 'inheritance_diagram',
# 'numpydoc', 'lily',
templates_path = ['_templates']
source_suffix = '.rst'
master_doc = 'index'
project = 'Grundkurs LaTeX'
htmlhelp_basename = 'Grundkurs LaTeX'
html_short_title = 'Grundkurs LaTeX'
version = '0.0.5b'
release = '0.0.5b'
copyright = '2015-2016, Bernhard Grotz'
language = 'de'
spelling_lang = 'de_DE'
pygments_style = 'sphinx'
html_theme = 'sphinxdoc'
html_logo = "logo.png"
html_favicon = "favicon.ico"
html_static_path = ['_static']
html_last_updated_fmt = '%d. %b %Y'
html_use_smartypants = True
html_additional_pages = {'home': 'home.html'}
html_domain_indices = False
html_use_index = True
html_show_sourcelink = True
html_show_sphinx = False
html_show_copyright = False
html_search_language = 'en'
html_search_options = {'type': 'default'}
# latex_logo = "logo.png"
latex_preamble = r'''
\usepackage[T1]{fontenc}
\usepackage[version=3]{mhchem}
\usepackage{amsmath, units, cancel,soul}
\usepackage{amsfonts, mathrsfs, amssymb, color}
\usepackage{nicefrac,marvosym,mathtools,wasysym,textcomp,gensymb}
\setcounter{secnumdepth}{-1}
\setlength{\headheight}{15pt}
\setcounter{tocdepth}{2}
\sloppy
'''
pngmath_latex_preamble = latex_preamble
latex_elements = {
"preamble": latex_preamble,
"babel": "\\usepackage[ngerman]{babel}",
"classoptions": 'oneside,openany',
"papersize": 'a4paper',
"pointsize": '12pt',
"fontpkg": '',
"fncychap": '\\usepackage[Conny]{fncychap}'
}
latex_domain_indices = False
# latex_show_pagerefs = True
latex_documents = [
('index', 'grundkurs-latex.tex', 'Grundkurs LaTeX',
'Bernhard Grotz', 'manual'),
]
intersphinx_mapping = {
'gw':('http://grund-wissen.de/', None),
'gwm':('http://grund-wissen.de/mathematik/', None),
'gwp':('http://grund-wissen.de/physik/', None),
'gwe':('http://grund-wissen.de/elektronik/', None),
'gwl': ('http://grund-wissen.de/linux/', None),
'gwic':('http://grund-wissen.de/informatik/c/', None),
'gwip':('http://grund-wissen.de/informatik/python/', None),
}
This diff is collapsed.
This diff is collapsed.
.. _LaTeX:
.. _Grundkurs LaTeX:
Grundkurs LaTeX
===============
.. only:: html
... Erst im Aufbau ...
.. sidebar:: Hinweis
Eine Druckversion dieser Seite ist als :download:`PDF-Dokument
<grundkurs-latex.pdf>` verfügbar.
LaTeX ist definitiv der Standard als wissenschaftliches Textsatzungssystem. Es
wurde bereits ab Beginn der 1980er Jahre von `Donald Knuth
<http://de.wikipedia.org/wiki/Donald_Ervin_Knuth>`_ entwickelt und wurde bzw.
wird seitdem beständig weiterentwickelt und ergänzt. Lag die Stärke von LaTeX
ursprünglich in der Darstellung von mathematischen Formeln und Quellcode,
existieren inzwischen ausgereifte Pakete für Briefe, Präsentationen, Notensatz
uvm.
Dokumente werden in LaTeX nicht mittels einer graphischen Bedienoberfläche
gesetzt, sondern gewissermaßen "programmiert". Dies ermöglicht nicht nur ein
Aufteilen von umfangreichen Werken in kleinere Bestandteile und eine
Wiederverwertbarkeit von Code-Stücken, es macht obendrein das Erstellen von
PDF-Dateien "skriptbar". Einige Wiki-Werkzeuge, beispielsweise :ref:`Sphinx
<gwl:Sphinx>`, können so aus einer eigenen (meist kürzeren) Syntax heraus
LaTeX- bzw. PDF-Dokumente erzeugen.
.. toctree::
:maxdepth: 2
installation.rst
einfuehrung.rst
gewoehnliche-textsatzung.rst
wichtige-umgebungen.rst
mathematischer-formelsatz.rst
seitenlayout.rst
links.rst
.. bibtex.rst
.. hilfreiche-pakete.rst
.. tips.rst
:.. _LaTeX:
.. _Grundkurs LaTeX:
Grundkurs LaTeX
===============
.. only:: html
... Erst im Aufbau ...
.. sidebar:: Hinweis
Eine Druckversion dieser Seite ist als :download:`PDF-Dokument
<grundkurs-latex.pdf>` verfügbar.
LaTeX ist definitiv der Standard als wissenschaftliches Textsatzungssystem. Es
wurde bereits ab Beginn der 1980er Jahre von `Donald Knuth
<http://de.wikipedia.org/wiki/Donald_Ervin_Knuth>`_ entwickelt und wurde bzw.
wird seitdem beständig weiterentwickelt und ergänzt. Lag die Stärke von LaTeX
ursprünglich in der Darstellung von mathematischen Formeln und Quellcode,
existieren inzwischen ausgereifte Pakete für Briefe, Präsentationen, Notensatz
uvm.
Dokumente werden in LaTeX nicht mittels einer graphischen Bedienoberfläche
gesetzt, sondern gewissermaßen "programmiert". Dies ermöglicht nicht nur ein
Aufteilen von umfangreichen Werken in kleinere Bestandteile und eine
Wiederverwertbarkeit von Code-Stücken, es macht obendrein das Erstellen von
PDF-Dateien "skriptbar". Einige Wiki-Werkzeuge, beispielsweise :ref:`Sphinx
<Sphinx-Tool>`, können so aus einer eigenen (meist kürzeren) Syntax heraus
LaTeX- bzw. PDF-Dokumente erzeugen.
.. toctree::
:maxdepth: 2
installation.rst
einfuehrung.rst
gewoehnliche-textsatzung.rst
wichtige-umgebungen.rst
mathematischer-formelsatz.rst
seitenlayout.rst
bibtex.rst
tips.rst
links.rst
.. hilfreiche-pakete.rst
.. _Installation von LaTeX:
Installation von LaTeX
======================
.. only:: latex
LaTeX ist definitiv der Standard als wissenschaftliches Textsatzungssystem. Es
wurde bereits ab Beginn der 1980er Jahre von `Donald Knuth
<http://de.wikipedia.org/wiki/Donald_Ervin_Knuth>`_ entwickelt und wurde bzw.
wird seitdem beständig weiterentwickelt und ergänzt. Lag die Stärke von LaTeX
ursprünglich in der Darstellung von mathematischen Formeln und Quellcode,
existieren inzwischen ausgereifte Pakete für Briefe, Präsentationen, Notensatz
uvm.
Dokumente werden in LaTeX nicht mittels einer graphischen Bedienoberfläche
gesetzt, sondern gewissermaßen "programmiert". Dies ermöglicht nicht nur ein
Aufteilen von umfangreichen Werken in kleinere Bestandteile und eine
Wiederverwertbarkeit von Code-Stücken, es macht obendrein das Erstellen von
PDF-Dateien "skriptbar". Einige Wiki-Werkzeuge, beispielsweise :ref:`Sphinx
<Sphinx-Tool>`, können so aus einer eigenen (meist kürzeren) Syntax heraus
LaTeX- bzw. PDF-Dokumente erzeugen.
Für wissenschaftliche Publikationen, insbesondere für mathematische und
naturwissenschaftliche Formeln, ist ein umfangreiches LaTeX-System
empfehlenswert. Sofern genügend Festplattenspeicher vorhanden ist, sollten
folgende Pakete installiert werden:
.. code-block:: bash
sudo aptitude install texlive-base texlive-common texlive-latex-base \
texlive-latex-recommended texlive-latex-extra texlive-math-extra \
texlive-science texlive-extra-utils texlive-lang-german
Zur Installation der obigen Pakete wird insgesamt etwa 1 GB an
Festplattenspeicher benötigt.
.. index:: CTAN, Paket, texhash, mktexlsr
.. _CTAN-Zusatzpakete installieren:
.. rubric:: CTAN-Zusatzpakete installieren
LaTeX in seiner Grundform kann durch zahlreiche Pakete erweitert werden. Eine
ausführliche Übersicht (inklusive der Paket-Dokumentationen) findet sich im so
genannten `CTAN <http://www.ctan.org/>`_ ("Comprehensive TeX Archive Network").
.. `CTAN-Paket-Index <http://www.bitlib.net/mirror/ctan/help/Catalogue/alpha.html>`_.
Um ein CTAN-Paket zu installieren, lädt man die jeweilige ``.zip``-Datei
herunter, entpackt sie und kopiert sie mit Superuser-Rechten in den LaTeX-Pfad,
unter Linux meist ``/usr/share/texmf/tex/latex``. Anschließend muss die
Veränderung der LaTeX-Datenbank noch mitgeteilt werden. Hierzu gibt man in einem
Shell-Fenster folgendes ein:
.. code-block:: bash
sudo texhash && sudo mktexlsr
Anschließend kann das Paket in der Dokument-Präambel (meist) als
``\usepackage{paketname}`` eingebunden werden. Nähere Beschreibungen finden sich
in den jeweiligen Paket-Dokumentationen.
.. _Links:
Links
=====
.. rubric:: Dokumentationen:
* `LaTeX-Kurs <http://lefti.amigager.de/latex/main.html>`_
* `LaTeX-Tutorial der TU Graz <http://latex.tugraz.at/latex/tutorial>`_
.. rubric:: Tutorials:
* `LaTeX-Tutorial für Einsteiger (de, PDF) <http://latex.tugraz.at/latex/tutorial>`_
* `LaTeX-Tutorial für Fortgeschrittene (de, PDF) <http://latex.tugraz.at/latex/fortgeschrittene>`_
* `Einführung in LaTeX (Sascha Frank) <http://www.namsu.de/latex/latexeinfuehrung_2/Latexeinfuehrung.html>`_
* `Ein LaTeX-Skript (de, PDF) <http://mschimmels.de/?q=DasBuch.pdf>`_
* `LaTeX-Grundlagen (de, PDF) <http://www2.hs-esslingen.de/~dhommel/skript.pdf>`_
* `LaTeX-Einführung 1 (Fernuni Hagen) <http://www.fernunihagen.de/imperia/md/content/zmi_2010/a026_latex_einf.pdf>`_
* `LaTeX-Einführung 2 (Fernuni Hagen) <ftp://ftp.fernuni-hagen.de/pub/pdf/urz-broschueren/broschueren/a0279510.pdf>`_
* `LaTeX 2e Kurzbeschreibung <http://sunsite.informatik.rwth-aachen.de/ftp/pub/mirror/ctan/info/lshort/german/l2kurz.pdf>`_
* `LaTeX-Linksammlung <http://www.matthiaspospiech.de/latex/dokumentation/einfuehrung/>`_
* `LaTeX for Complete Novices (en) <http://www.dickimaw-books.com/latex/novices/index.html>`_
.. rubric:: Referenzen:
* `Latex-Befehlsübersicht <http://www.weinelt.de/latex/>`_
* `LaTeX-Woerterbuch <https://de.wikibooks.org/wiki/LaTeX-Wörterbuch:_InDeX>`_
* `Mathematische Symbole (de) <https://de.wikipedia.org/wiki/Liste_mathematischer_Symbole>`_
* `Mathematische Symbole (en, 1) <https://en.wikibooks.org/wiki/LaTeX/Mathematics>`_
* `Mathematische Symbole (en, 2) <https://en.wikibooks.org/wiki/LaTeX/Advanced_Mathematics>`_
* `Mathematische Symbole (en, PDF) <http://mirrors.ctan.org/info/symbols/comprehensive/symbols-a4.pdf>`_
.. rubric:: Typographie:
* `Practical Typography (en) <http://practicaltypography.com/>`_
.. rubric:: Tips:
* `Briefe mit "scrlttr2" <https://meinnoteblog.wordpress.com/2010/11/12/latex-vorlagen-fur-briefe-und-rechnung/>`_
.. * `Tips zum Inhaltsverzeichnis <http://faculty.uoit.ca/bohun/latex/toc.html>`_
.. `Geschäftsbriefe mit "scrlttr2" <http://www.akademie.de/wissen/geschaeftsbriefe-rechnungen-mit-latex/geschaeftsbriefe-mit-scrlttr2-erstellen>`_
.. http://www.volkerschatz.com/tex/tpacks.html
.. tabbing: http://noodle.med.yale.edu/latex/latex2e-html/ltx-58.html
.. tabbing: http://www.cognitionis.com/it/latex/latex-tabbing/
.. http://noodle.med.yale.edu/latex/latex2e-html/ltx-2.html
.. http://texblog.net/latex/layout/
.. http://mo.mathematik.uni-stuttgart.de/kurse/kurs44/seite28.html
.. http://mo.mathematik.uni-stuttgart.de/kurse/kurs44
.. `LaTeX unter Windows ("Miktex") <http://www.tuutz.de/category/tutorials/latex/>`_
.. https://de.wikibooks.org/wiki/LaTeX-Kompendium:_Baukastensystem
..
Pakete:
texlive-lang-german
.. `Getting started with LaTeX (en.) <http://www.maths.tcd.ie/~dwilkins/LaTeXPrimer/Index.html>`_
.. `Begin LaTeX (PDF, en.) <http://www.tex.ac.uk/tex-archive/info/beginlatex/beginlatex-3.6.pdf>`_
.. Silbentrennung unter Latex http://homepage.ruhr-uni-bochum.de/Georg.Verweyen/silbentrennung.html
.. http://latex.bekaan.org/Silbentrennung.html
.. Fussnoten und Verweise
.. http://latex.hpfsc.de/content/latex_tutorial/fussnote_querverweis/
.. http://meta-x.de/faq/LaTeX-Einfuehrung.html
.. http://www.gierhardt.de/TeX/l2kurz2.pdf
.. http://www.math.uiuc.edu/~hildebr/tex/course/intro2.html
.. http://crab.rutgers.edu/~karel/latex/class4/class4.html
.. https://tex.stackexchange.com/questions/53773/left-align-to-the-page-displayed-math
.. https://www.sharelatex.com/learn/Aligning_equations_with_amsmath
.. http://moser-isi.ethz.ch/docs/typeset_equations.pdf
This diff is collapsed.
.. _Seitenlayout:
Seitenlayout
============
... to be continued ...
.. Das für ein Dokument geltende Standard-Seitenlayout wird in der Präambel eines
.. LaTeX-Dokuments
.. todo:: Seitenlayout (scrheadings)
.. todo:: geometry, margins
.. \usepackage{setspace} % \onehalfspaceing
.. https://tex.stackexchange.com/questions/118939/add-watermark-that-overlays-the-images
Weitere Dokumentklassen
=======================
``scrlttr2`` -- Briefe und Serienbriefe
---------------------------------------
This diff is collapsed.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment