Skip to content

Commit 468ec2a

Browse files
authored
Submission document (#1)
1 parent c72f304 commit 468ec2a

21 files changed

+957
-0
lines changed

.gitignore

Lines changed: 265 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,265 @@
1+
# General git ignore file for tex projects
2+
# -------------------------------------------------------------
3+
# https://github.com/github/gitignore/blob/master/TeX.gitignore
4+
# -------------------------------------------------------------
5+
6+
## Core latex/pdflatex auxiliary files:
7+
*.aux
8+
*.lof
9+
*.log
10+
*.lot
11+
*.fls
12+
*.out
13+
*.toc
14+
*.fmt
15+
*.fot
16+
*.cb
17+
*.cb2
18+
.*.lb
19+
20+
## Intermediate documents:
21+
*.dvi
22+
*.xdv
23+
*-converted-to.*
24+
# these rules might exclude image files for figures etc.
25+
# *.ps
26+
# *.eps
27+
# *.pdf
28+
29+
## Generated if empty string is given at "Please type another file name for output:"
30+
.pdf
31+
32+
## Bibliography auxiliary files (bibtex/biblatex/biber):
33+
*.bbl
34+
*.bcf
35+
*.blg
36+
*-blx.aux
37+
*-blx.bib
38+
*.run.xml
39+
40+
## Build tool auxiliary files:
41+
*.fdb_latexmk
42+
*.synctex
43+
*.synctex(busy)
44+
*.synctex.gz
45+
*.synctex.gz(busy)
46+
*.pdfsync
47+
48+
## Build tool directories for auxiliary files
49+
# latexrun
50+
latex.out/
51+
52+
## Auxiliary and intermediate files from other packages:
53+
# algorithms
54+
*.alg
55+
*.loa
56+
57+
# achemso
58+
acs-*.bib
59+
60+
# amsthm
61+
*.thm
62+
63+
# beamer
64+
*.nav
65+
*.pre
66+
*.snm
67+
*.vrb
68+
69+
# changes
70+
*.soc
71+
72+
# comment
73+
*.cut
74+
75+
# cprotect
76+
*.cpt
77+
78+
# elsarticle (documentclass of Elsevier journals)
79+
*.spl
80+
81+
# endnotes
82+
*.ent
83+
84+
*.lox
85+
86+
# feynmf/feynmp
87+
*.mf
88+
*.mp
89+
*.t[1-9]
90+
*.t[1-9][0-9]
91+
*.tfm
92+
93+
#(r)(e)ledmac/(r)(e)ledpar
94+
*.end
95+
*.?end
96+
*.[1-9]
97+
*.[1-9][0-9]
98+
*.[1-9][0-9][0-9]
99+
*.[1-9]R
100+
*.[1-9][0-9]R
101+
*.[1-9][0-9][0-9]R
102+
*.eledsec[1-9]
103+
*.eledsec[1-9]R
104+
*.eledsec[1-9][0-9]
105+
*.eledsec[1-9][0-9]R
106+
*.eledsec[1-9][0-9][0-9]
107+
*.eledsec[1-9][0-9][0-9]R
108+
109+
# glossaries
110+
*.acn
111+
*.acr
112+
*.glg
113+
*.glo
114+
*.gls
115+
*.glsdefs
116+
117+
# gnuplottex
118+
*-gnuplottex-*
119+
120+
# gregoriotex
121+
*.gaux
122+
*.gtex
123+
124+
# htlatex
125+
*.4ct
126+
*.4tc
127+
*.idv
128+
*.lg
129+
*.trc
130+
*.xref
131+
132+
# hyperref
133+
*.brf
134+
135+
# knitr
136+
*-concordance.tex
137+
*.tikz
138+
*-tikzDictionary
139+
140+
# listings
141+
*.lol
142+
143+
# luatexja-ruby
144+
*.ltjruby
145+
146+
# makeidx
147+
*.idx
148+
*.ilg
149+
*.ind
150+
151+
# minitoc
152+
*.maf
153+
*.mlf
154+
*.mlt
155+
*.mtc[0-9]*
156+
*.slf[0-9]*
157+
*.slt[0-9]*
158+
*.stc[0-9]*
159+
160+
# minted
161+
_minted*
162+
*.pyg
163+
164+
# morewrites
165+
*.mw
166+
167+
# nomencl
168+
*.nlg
169+
*.nlo
170+
*.nls
171+
172+
# pax
173+
*.pax
174+
175+
# pdfpcnotes
176+
*.pdfpc
177+
178+
# sagetex
179+
*.sagetex.sage
180+
*.sagetex.py
181+
*.sagetex.scmd
182+
183+
# scrwfile
184+
*.wrt
185+
186+
# sympy
187+
*.sout
188+
*.sympy
189+
sympy-plots-for-*.tex/
190+
191+
# pdfcomment
192+
*.upa
193+
*.upb
194+
195+
# pythontex
196+
*.pytxcode
197+
pythontex-files-*/
198+
199+
# tcolorbox
200+
*.listing
201+
202+
# thmtools
203+
*.loe
204+
205+
# TikZ & PGF
206+
*.dpth
207+
*.md5
208+
*.auxlock
209+
210+
# todonotes
211+
*.tdo
212+
213+
# vhistory
214+
*.hst
215+
*.ver
216+
217+
*.lod
218+
219+
# xcolor
220+
*.xcp
221+
222+
# xmpincl
223+
*.xmpi
224+
225+
# xindy
226+
*.xdy
227+
228+
# xypic precompiled matrices
229+
*.xyc
230+
231+
# endfloat
232+
*.ttt
233+
*.fff
234+
235+
# Latexian
236+
TSWLatexianTemp*
237+
238+
## Editors:
239+
# WinEdt
240+
*.bak
241+
*.sav
242+
243+
# Texpad
244+
.texpadtmp
245+
246+
# LyX
247+
*.lyx~
248+
249+
# Kile
250+
*.backup
251+
252+
# KBibTeX
253+
*~[0-9]*
254+
255+
# auto folder when using emacs and auctex
256+
./auto/*
257+
*.el
258+
259+
# expex forward references with \gathertags
260+
*-tags.tex
261+
262+
# standalone packages
263+
*.sta
264+
265+
out

.pre-commit-config.yaml

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
repos:
2+
- repo: https://github.com/pre-commit/pre-commit-hooks
3+
rev: v4.1.0
4+
hooks:
5+
- id: check-added-large-files
6+
- id: check-case-conflict
7+
- id: check-merge-conflict
8+
- id: check-symlinks
9+
- id: check-toml
10+
- id: check-yaml
11+
- id: detect-private-key
12+
- id: end-of-file-fixer
13+
- id: fix-byte-order-marker
14+
- id: mixed-line-ending
15+
- id: trailing-whitespace
16+
- repo: https://github.com/pre-commit/mirrors-prettier
17+
rev: v2.6.2
18+
hooks:
19+
- id: prettier
20+
name: Prettier
21+
entry: prettier --write --list-different .
22+
files: "\\.(graphql|graphqls|json|md|js|jsx|ts|tsx|yaml|yml|css|less|scss)$"

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2022 Lukas Kucera
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

Makefile

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
DOCUMENT_NAME = main
2+
OUTPUT_DIR = out
3+
4+
.PHONY: all clean build help
5+
6+
default: help
7+
8+
clean: ## Remove output directory.
9+
rm -rf $(OUTPUT_DIR)/*
10+
11+
build: ## Generate PDF from LaTex files.
12+
mkdir -p ../$(OUTPUT_DIR)
13+
latexmk -pdf -jobname=$(OUTPUT_DIR)/$(DOCUMENT_NAME) $(DOCUMENT_NAME)
14+
@echo "pdf document $(OUTPUT_DIR)/$(DOCUMENT_NAME).pdf has been built"
15+
16+
help: ## Display help.
17+
@awk 'BEGIN {FS = ":.*##"; printf "\nUsage:\n make \033[36m<target>\033[0m\n"} /^[a-zA-Z_-]+:.*?##/ { printf " \033[36m%-15s\033[0m %s\n", $$1, $$2 } /^##@/ { printf "\n\033[1m%s\033[0m\n", substr($$0, 5) } ' $(MAKEFILE_LIST)

README.md

Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1 +1,62 @@
11
# documentation
2+
3+
[![made-with-latex](https://img.shields.io/badge/Made%20with-LaTeX-1f425f.svg)](https://www.latex-project.org/)
4+
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/stegoer/documentation/main.svg)](https://results.pre-commit.ci/latest/github/stegoer/documentation/main)
5+
6+
Documentation is written using [LaTex](https://www.latex-project.org/).
7+
8+
Be aware that the text of the document is not written in English.
9+
It will be submitted to the director at my school.
10+
That is its only purpose.
11+
12+
---
13+
14+
Development documentation: https://github.com/stegoer/documentation/blob/main/README.md
15+
16+
Source code: https://github.com/stegoer/documentation
17+
18+
---
19+
20+
## Installation
21+
22+
### Install instructions
23+
24+
1. Install LaTex https://www.latex-project.org/get/
25+
2. Clone this repository
26+
27+
```sh
28+
git clone git@github.com:stegoer/documentation.git
29+
```
30+
31+
## Development
32+
33+
### Build pdf document
34+
35+
```sh
36+
make build
37+
```
38+
39+
### Make
40+
41+
```sh
42+
make help
43+
```
44+
45+
### Assets
46+
47+
If you need to add any assets please add them to the `assets` folder.
48+
49+
### Bibliography
50+
51+
If you need to add bibliography you can do so in the
52+
`bibliography/biblography.bib` file.
53+
54+
## Contributing
55+
56+
```sh
57+
pre-commit install
58+
```
59+
60+
## License
61+
62+
Developed under the [MIT](https://github.com/stegoer/documentation/blob/master/LICENSE) license.

assets/images/color-scheme.png

21.5 KB
Loading

assets/images/docs-accordion.png

62.8 KB
Loading
133 KB
Loading

assets/images/encode-editor.png

34.3 KB
Loading

assets/images/image-detail.png

379 KB
Loading

0 commit comments

Comments
 (0)