docs(latex): add comprehensive README for HSRTReport class structure
This commit is contained in:
parent
c29d0e7748
commit
23d5fbfd72
100
HSRTReport/README.md
Normal file
100
HSRTReport/README.md
Normal file
@ -0,0 +1,100 @@
|
|||||||
|
# HSRTReport LaTeX Class
|
||||||
|
|
||||||
|
A custom LaTeX document class for reports at the University of Applied Sciences Reutlingen (Hochschule Reutlingen).
|
||||||
|
|
||||||
|
## Directory Structure
|
||||||
|
|
||||||
|
```
|
||||||
|
HSRTReport/
|
||||||
|
├── HSRTReport.cls # Main class file
|
||||||
|
├── Assets/ # Fonts and images
|
||||||
|
│ ├── Fonts/ # Custom fonts (Blender, DIN)
|
||||||
|
│ └── Images/ # Logos and graphics
|
||||||
|
├── Config/ # Package imports and configuration
|
||||||
|
│ ├── Imports-Core.tex # Essential LaTeX packages
|
||||||
|
│ ├── Imports-Document.tex # Document structure packages
|
||||||
|
│ ├── Imports-Content.tex # Content formatting packages
|
||||||
|
│ └── Imports-Graphics.tex # Graphics and TikZ packages
|
||||||
|
├── Modules/ # Functional modules
|
||||||
|
│ ├── Content/ # Content-related modules
|
||||||
|
│ │ ├── Floats.tex # Float configuration
|
||||||
|
│ │ ├── GlossarySettings.tex # Glossary configuration
|
||||||
|
│ │ └── Listings.tex # Code listing settings
|
||||||
|
│ ├── Formatting/ # Text and document formatting
|
||||||
|
│ │ ├── Typography.tex # Typography settings
|
||||||
|
│ │ └── ToC.tex # Table of contents formatting
|
||||||
|
│ ├── Layout/ # Page layout modules
|
||||||
|
│ │ ├── InfoBlocks.tex # Info/warning/error boxes
|
||||||
|
│ │ └── Watermark.tex # Watermark configuration
|
||||||
|
│ └── Tools/ # Utility modules
|
||||||
|
│ ├── MeetingPresence.tex # Meeting attendance tables
|
||||||
|
│ └── WordCount.tex # Word counting commands
|
||||||
|
└── Pages/ # Page templates
|
||||||
|
└── Titlepage.tex # Title page layout
|
||||||
|
```
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
To use this document class in your LaTeX document:
|
||||||
|
|
||||||
|
```latex
|
||||||
|
\documentclass[
|
||||||
|
11pt,
|
||||||
|
paper=a4,
|
||||||
|
oneside,
|
||||||
|
DIV=14,
|
||||||
|
onecolumn
|
||||||
|
]{HSRTReport/HSRTReport}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Module Descriptions
|
||||||
|
|
||||||
|
### Config Modules
|
||||||
|
- **Imports-Core**: Basic LaTeX packages (calc, fp, xcolor, etc.)
|
||||||
|
- **Imports-Document**: Document structure packages (babel, geometry, biblatex, etc.)
|
||||||
|
- **Imports-Content**: Content formatting (tables, listings, math, symbols)
|
||||||
|
- **Imports-Graphics**: Graphics and drawing packages (TikZ, PGF, SVG support)
|
||||||
|
|
||||||
|
### Content Modules
|
||||||
|
- **Floats**: Configuration for figures and tables
|
||||||
|
- **GlossarySettings**: Glossary and acronym list styling
|
||||||
|
- **Listings**: Code syntax highlighting configuration
|
||||||
|
|
||||||
|
### Formatting Modules
|
||||||
|
- **Typography**: Font settings and text formatting
|
||||||
|
- **ToC**: Table of contents, list of figures/tables formatting
|
||||||
|
|
||||||
|
### Layout Modules
|
||||||
|
- **InfoBlocks**: Styled boxes for notes, warnings, and errors
|
||||||
|
- **Watermark**: Draft watermark configuration
|
||||||
|
|
||||||
|
### Tools Modules
|
||||||
|
- **MeetingPresence**: Meeting attendance tracking tables
|
||||||
|
- **WordCount**: Commands for automated word counting
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
- Custom fonts (Blender and DIN)
|
||||||
|
- Automatic word counting
|
||||||
|
- Glossary and acronym support
|
||||||
|
- Code listing with syntax highlighting
|
||||||
|
- Custom info/warning/error boxes
|
||||||
|
- Meeting presence tables
|
||||||
|
- IEEE bibliography style
|
||||||
|
- German language support
|
||||||
|
- SVG image support
|
||||||
|
|
||||||
|
## Requirements
|
||||||
|
|
||||||
|
- XeLaTeX (required for custom fonts)
|
||||||
|
- biber (for bibliography)
|
||||||
|
- Various LaTeX packages (automatically loaded through Config modules)
|
||||||
|
|
||||||
|
## Customization
|
||||||
|
|
||||||
|
Document-specific settings should remain in your document's `TeX/` directory:
|
||||||
|
- Document title, author, abstract
|
||||||
|
- Logo selection
|
||||||
|
- Bibliography resources
|
||||||
|
|
||||||
|
Class-wide settings and functionality are contained within this HSRTReport directory structure.
|
||||||
Loading…
Reference in New Issue
Block a user