Skip to content
Snippets Groups Projects
README.md 4.18 KiB
Newer Older
  • Learn to ignore specific revisions
  • Jan Wille's avatar
    Jan Wille committed
    # What this is
    
    Jan Wille's avatar
    Jan Wille committed
    This is a template designed to ease the workflow when writing documents for the Hochschule Hannover. It is intended to be used in all sophisticated
    works, from lab-reports to masters thesis's.  
    
    Jan Wille's avatar
    Jan Wille committed
    The project provides custom document-classes caring the `HsH-` prefix as well as support files. These classes extend the well known KOMA-script
    classes and customize them them with specific configurations, presets and provide commonly needed features.  
    
    Jan Wille's avatar
    Jan Wille committed
    
    
    Jan Wille's avatar
    Jan Wille committed
    **Provided classes are:**  
    
    Jan Wille's avatar
    Jan Wille committed
    
    
    	HsH-article
    	HsH-report
    	HsH-book (planed)
    
    Jan Wille's avatar
    Jan Wille committed
    	HsH-standalone
    
    Jan Wille's avatar
    Jan Wille committed
    
    
    **Version:** 1.1  
    
    **Date:** 21.04.2021  
    Check out the [**Example-Branche**](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/tree/example)
    
    Jan Wille's avatar
    Jan Wille committed
    
    
    Jan Wille's avatar
    Jan Wille committed
    
    
    Jan Wille's avatar
    Jan Wille committed
    This project is distributed under the LaTeX project public license (LPPL), version 1.3c.  
    
    
    Jan Wille's avatar
    Jan Wille committed
    
    
    Jan Wille's avatar
    Jan Wille committed
    # Requirements:
    
    [MikTex is recommended](https://miktex.org/), TexLive doesn't find some packages, if somebody get's it working, let me know.
    
    
    Jan Wille's avatar
    Jan Wille committed
    `biber`-Backend is standart! If you have Problems with that, check the [FAQ](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/faq). 
    
    Jan Wille's avatar
    Jan Wille committed
    
    The `Makefile` is only tested with mingw32-make.
    
    
    Jan Wille's avatar
    Jan Wille committed
    
    
    Jan Wille's avatar
    Jan Wille committed
    
    
    Jan Wille's avatar
    Jan Wille committed
    To get started, create a new folder for your project somewhere on your PC and create your `.tex` file. Copy the classfile (`.cls`) you want to use and
    
    the `HsH-logo.pdf` from the src folder to your projectfolder. You can optionally copy the `config.tex`, but you can also configure everything  in your
    preamble. 
    
    Jan Wille's avatar
    Jan Wille committed
    
    
    Jan Wille's avatar
    Jan Wille committed
    ## using a proper subfolder structure
    
    Jan Wille's avatar
    Jan Wille committed
    The projects also provides a recommendation for a subfolder structure, to keep things organized. Cloning the complete projekt into your projectfolder
    will allow you to use it easily.  
    This has the downside of storing classfiles and other needed files in the *.\src* folder, which means it needs to be added to the path searched when
    
    running your latex command. [How to do that is explained in the wiki](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/Adding-src-folder-to-the-path).  
    
    Jan Wille's avatar
    Jan Wille committed
    The provided Makefile demonstrates how to run a successful build, you might want to check it out.
    
    ## recomendet Software
    As a Tex-Distribution, I recomend [MikTex is recommended](https://miktex.org/). This is only avalible on windows though.  
    To edit the `.tex` files, you could use any texteditor, but I personally like [Visual Studio Code](https://code.visualstudio.com/) the moste, which
    can also be used for pretty much all other programing languages. Use the [Latex Workshop extention](https://marketplace.visualstudio.com/items?itemName=James-Yu.latex-workshop)
    and you can steal my config file from [here](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/snippets/111).  
    If you preffer a Tex-only editor, I used [Texmaker](https://www.xm1math.net/texmaker/) in the past and it's also verry good.
    
    
    # Common additions and expantions (Snippets)
    
    Sadly most Profs have widly different expectaions when it comes to styling of written works. So you might find yourself having to change some
    settings. For some cases this has allready been done and, to help others, uploaded in 
    [the snippets section](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/snippets) of the project. Most of them are only visible when you
    are logged in!!
    
    Jan Wille's avatar
    Jan Wille committed
    Use the wiki [here](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/home):
    
    
    Jan Wille's avatar
    Jan Wille committed
    - [Adding the src folder to the path](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/Adding-src-folder-to-the-path)  
    - [Using a Aux folder](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/Using-a-Aux-Folder)  
    - [What is the config.tex?](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/What-is-the-config.tex)  
    - [Document Options](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/Document-Options)  
    - [Provided commands](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/Provided-commands)  
    - [Provided and recommended packages](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/Provided-and-recommended-packages)
    
    Jan Wille's avatar
    Jan Wille committed
    - [Frequently Asked Questions](https://lab.it.hs-hannover.de/qxx-tul-u1/latex-template-hsh/-/wikis/faq)