Merge remote-tracking branch 'origin/ctan'

# Conflicts:
#	.github/workflows/ci.yml
#	README.md
#	README_en.md
#	elteikthesis.cls
#	elteikthesis.tex
#	samples_en/impl.tex
#	thesis_hu.pdf
This commit is contained in:
Máté Cserép 2022-04-30 14:10:26 +02:00
commit 08f589a831
15 changed files with 146 additions and 128 deletions

View File

@ -1,6 +1,6 @@
MIT License MIT License
Copyright (c) 2013-2021 Máté Cserép <mcserep@inf.elte.hu>, Bálint Bognár Copyright (c) 2013-2022 Máté Cserép <mcserep@inf.elte.hu>, Bálint Bognár
Permission is hereby granted, free of charge, to any person obtaining a copy Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal of this software and associated documentation files (the "Software"), to deal
@ -19,3 +19,10 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE. SOFTWARE.
--------------------------------------------------------------------------------
The original 1.x versions of the CTAN package were developed by
Dániel Majoros, under the LaTeX Project Public License version 1.2 or later.
This updated work is a complete rewrite with no connection
to the original package.

View File

@ -1,73 +1,75 @@
![CI status](https://github.com/mcserep/elteikthesis/workflows/Build%20LaTeX%20document/badge.svg) [![CI status](https://github.com/mcserep/elteikthesis/actions/workflows/ci.yml/badge.svg)](https://github.com/mcserep/elteikthesis/actions/workflows/ci.yml)
See [English version](README_en.md). See [Hungarian version](README_hu.md).
# ELTE IK szakdolgozat és diplomamunka sablon # ELTE FI bachelor and master thesis template
A [thesis_hu.tex](thesis_hu.tex) és a belőle előálló [thesis_hu.pdf](thesis_hu.pdf) szolgál kiindulási példaként. The [elteikthesis_en.tex](elteikthesis_en.tex) and the produced [elteikthesis_en.pdf](elteikthesis_en.pdf) serves as an example of usage.
A sablon alkalmazza a szakdolgozatra / diplomamunkára vonatkozó formai előírásokat, valamint elkészíti a megadott metaadatok alapján a címlapot. A példa dokumentum tartalmi fejezetei a BSc szakdolgozat tipikus felépítését tükrözik. This class template enforces the required formatting rules for bachelor and master theses and generates the cover page given on the provided metadata. The chapters of the example document follows the typical structure of a BSc thesis.
A formai megkötések az ELTE Informatikai Kar szabályzatában rögzítetteknek felelnek meg, de általánosan (a megfelelő módosításokkal) alkalmazható más egyetemek dolgozataihoz is. The formatting rules are defined to meet the requirements for theses submitted at the Eötvös Loránd University, Faculty of Informatics (Budapest, Hungary). However with sufficient modifications the template should be usable at other universities, too.
A sablon tartalmazza az egy és két oldalas nyomtatáshoz szükséges beállításokat is (ld. `twoside` paraméter), alapértelmezetten a javasolt egy oldalas nyomtatásra konfigurált. (Érdemes figyelembe venni, hogy 20-nál kevesebb lapszám kemény kötésben furcsán mutat, továbbá az ábrák könnyen átütnek az általános 80g/m<sup>2</sup> fénymásolópapíron). The template contains configuration both for single and double sided printing (see `twoside` option), by default it is set to the recommended single side format.
A sablon magyar és angol nyelvű dokumentumok elkészítését is támogatja (ld. `\documentlang` parancs). The template supports producing both Hungarian and English theses, which can be easily controlled (see `\documentlang` command).
## Fordítás ## Compilation
```bash ```bash
# thesis_hu.aux fájl generálása (PDF fájl még hibás hivatkozásokat fog tartalmazni) # Generate elteikthesis_en.aux file
pdflatex thesis_hu.tex # (PDF file contains incorrect references yet)
# Irodalomjegyzék generálása pdflatex elteikthesis_en.tex
bibtex thesis_hu # Generate bibliography
# Jelölésjegyzék generálása (ha szükséges) bibtex elteikthesis_en
makeindex -s nomencl.ist -t thesis_hu.nlg -o thesis_hu.nls thesis_hu.nlo # Generate nomenclature (optional)
# Végleges PDF fájl generálása makeindex -s nomencl.ist -t elteikthesis_en.nlg \
pdflatex thesis_hu.tex -o elteikthesis_en.nls elteikthesis_en.nlo
pdflatex thesis_hu.tex # Generate final PDF file
pdflatex elteikthesis_en.tex
pdflatex elteikthesis_en.tex
``` ```
**Megjegyzés:** az irodalomjegyzék változása esetén a `bibtex`, majd a `pdflatex` _kétszeri_ futtatása szükséges a helyes hivatkozások előállításához. **Note:** in case the bibliography changes, executing `bibtex`, then `pdflatex` _twice_ is required to generate to correct references in the PDF output.
A fordításhoz tetszőleges fejlesztő környezet is használható (pl. [TexStudio](https://www.texstudio.org/)), ugyanezen utasítások kiadásával. Compilation might be carried out through a preferred IDE (e.g. [TexStudio](https://www.texstudio.org/)), given the same commands should be executed.
## Kódblokkok szintaxis kiemelése ## Syntax highlighting of code blocks
A *minted* csomag támogatott a forráskódok szedésére és szintaxis kiemelésére. Használatához szükséges a Python interpreter és a `Pygments` csomag telepítése. The minted package is also supported for syntax highlighting. For its usage the Python interpreter and the `Pygments` package must be installed as a prerequisite.
Lásd a `minted-integration.tex` fájlt példaként és ezt a [dokumentációt](https://www.overleaf.com/learn/latex/Code_Highlighting_with_minted). See the `elteikthesis_minted.tex` file for example and this [documentation](https://www.overleaf.com/learn/latex/Code_Highlighting_with_minted).
## Fontosabb függőségi csomagok ## Required packages (without completeness)
**Képkezelés:** **Image handling:**
* Minimális és maximális méret: [adjustbox](https://ctan.org/pkg/adjustbox) * Minimal and maximal size: [adjustbox](https://ctan.org/pkg/adjustbox)
* Alábrák: [subcaption](https://ctan.org/pkg/subcaption) * Subfigures: [subcaption](https://ctan.org/pkg/subcaption)
* Forgatás: [rotating](https://ctan.org/pkg/rotating) * Rotation: [rotating](https://ctan.org/pkg/rotating)
**Táblázatkezelés:** **Table management:**
* Oszlopok és sorok egyesítése: [multirow](https://ctan.org/pkg/multirow) * Multirow and multicolumn support: [multirow](https://ctan.org/pkg/multirow)
* Tördelhető táblázat: [longtable](https://ctan.org/pkg/longtable) * Breakable tables: [longtable](https://ctan.org/pkg/longtable)
* Cellatartalom vertikális igazítása: [array](https://ctan.org/pkg/array) * Vertical positioning of cells: [array](https://ctan.org/pkg/array)
* Többsoros cellák (sortörés): [makecell](https://ctan.org/pkg/makecell) * Multiline cells (line breaks): [makecell](https://ctan.org/pkg/makecell)
**Felsorolások:** **Lists:**
* Szoros térközű felsorolások: [paralist](https://ctan.org/pkg/paralist) * Lists with narrow spacing: [paralist](https://ctan.org/pkg/paralist)
**Matematika és algoritmusok:** **Mathematical formulas and algorithms:**
* Matematikai formulák: [amsmath](https://ctan.org/pkg/amsmath) * Mathematical formulas: [amsmath](https://ctan.org/pkg/amsmath)
* Matematikai definíciók: [amsthm](https://ctan.org/pkg/amsthm) * Mathematical definitions: [amsthm](https://ctan.org/pkg/amsthm)
* Matematikai szimbólumok: [amsfonts](https://ctan.org/pkg/amsfonts) * Mathematical symbols: [amsfonts](https://ctan.org/pkg/amsfonts)
* Algoritmusok: [algpseudocode](https://www.ctan.org/pkg/algorithmicx) * Algorithms: [algpseudocode](https://www.ctan.org/pkg/algorithmicx)
* Kódblokkok: [listingsutf8](https://ctan.org/pkg/listingsutf8), [minted](https://ctan.org/pkg/minted) * Code blocks: [listingsutf8](https://ctan.org/pkg/listingsutf8), [minted](https://ctan.org/pkg/minted)
**Egyebek:** **Miscellaneous:**
* Teendők: [todonotes](https://ctan.org/pkg/todonotes) * Todos: [todonotes](https://ctan.org/pkg/todonotes)
## Előre definiált tételszerű bekezdések ## Predefined theorem-like environments
* *definition*: Definíció * *definition*
* *theorem*: Tétel * *theorem*
* *remark*: Emlékeztető * *remark*
* *note*: Megjegyzés * *note*

BIN
README.pdf Normal file

Binary file not shown.

View File

@ -1,69 +0,0 @@
# ELTE FI bachelor and master thesis template
The [thesis_en.tex](thesis_en.tex) and the produced [thesis_en.pdf](thesis_en.pdf) serves as an example of usage.
This class template enforces the required formatting rules for bachelor and master theses and generates the cover page given on the provided metadata. The chapters of the example document follows the typical structure of a BSc thesis.
The formatting rules are defined to meet the requirements for theses submitted at the Eötvös Loránd University, Faculty of Informatics (Budapest, Hungary). However with sufficient modifications the template should be usable at other universities, too.
The template contains configuration both for single and double sided printing (see `twoside` option), by default it is set to the recommended single side format.
The template supports producing both Hungarian and English theses, which can be easily controlled (see `\documentlang` command).
## Compilation
```bash
# Generate thesis_en.aux file (PDF file contains incorrect references yet)
pdflatex thesis_en.tex
# Generate bibliography
bibtex thesis_en
# Generate nomenclature (optional)
makeindex -s nomencl.ist -t thesis_en.nlg -o thesis_en.nls thesis_en.nlo
# Generate final PDF file
pdflatex thesis_en.tex
pdflatex thesis_en.tex
```
**Note:** in case the bibliography changes, executing `bibtex`, then `pdflatex` _twice_ is required to generate to correct references in the PDF output.
Compilation might be carried out through a preferred IDE (e.g. [TexStudio](https://www.texstudio.org/)), given the same commands should be executed.
## Syntax highlighting of code blocks
The minted package is also supported for syntax highlighting. For its usage the Python interpreter and the `Pygments` package must be installed as a prerequisite.
See the `minted-integration.tex` file for example and this [documentation](https://www.overleaf.com/learn/latex/Code_Highlighting_with_minted).
## Required packages (without completeness)
**Image handling:**
* Minimal and maximal size: [adjustbox](https://ctan.org/pkg/adjustbox)
* Subfigures: [subcaption](https://ctan.org/pkg/subcaption)
* Rotation: [rotating](https://ctan.org/pkg/rotating)
**Table management:**
* Multirow and multicolumn support: [multirow](https://ctan.org/pkg/multirow)
* Breakable tables: [longtable](https://ctan.org/pkg/longtable)
* Vertical positioning of cells: [array](https://ctan.org/pkg/array)
* Multiline cells (line breaks): [makecell](https://ctan.org/pkg/makecell)
**Lists:**
* Lists with narrow spacing: [paralist](https://ctan.org/pkg/paralist)
**Mathematical formulas and algorithms:**
* Mathematical formulas: [amsmath](https://ctan.org/pkg/amsmath)
* Mathematical definitions: [amsthm](https://ctan.org/pkg/amsthm)
* Mathematical symbols: [amsfonts](https://ctan.org/pkg/amsfonts)
* Algorithms: [algpseudocode](https://www.ctan.org/pkg/algorithmicx)
* Code blocks: [listingsutf8](https://ctan.org/pkg/listingsutf8), [minted](https://ctan.org/pkg/minted)
**Miscellaneous:**
* Todos: [todonotes](https://ctan.org/pkg/todonotes)
## Predefined theorem-like environments
* *definition*
* *theorem*
* *remark*
* *note*

71
README_hu.md Normal file
View File

@ -0,0 +1,71 @@
# ELTE IK szakdolgozat és diplomamunka sablon
A [elteikthesis_hu.tex](elteikthesis_hu.tex) és a belőle előálló [elteikthesis_hu.pdf](elteikhesis_hu.pdf) szolgál kiindulási példaként.
A sablon alkalmazza a szakdolgozatra / diplomamunkára vonatkozó formai előírásokat, valamint elkészíti a megadott metaadatok alapján a címlapot. A példa dokumentum tartalmi fejezetei a BSc szakdolgozat tipikus felépítését tükrözik.
A formai megkötések az ELTE Informatikai Kar szabályzatában rögzítetteknek felelnek meg, de általánosan (a megfelelő módosításokkal) alkalmazható más egyetemek dolgozataihoz is.
A sablon tartalmazza az egy és két oldalas nyomtatáshoz szükséges beállításokat is (ld. `twoside` paraméter), alapértelmezetten a javasolt egy oldalas nyomtatásra konfigurált. (Érdemes figyelembe venni, hogy 20-nál kevesebb lapszám kemény kötésben furcsán mutat, továbbá az ábrák könnyen átütnek az általános 80g/m<sup>2</sup> fénymásolópapíron).
A sablon magyar és angol nyelvű dokumentumok elkészítését is támogatja (ld. `\documentlang` parancs).
## Fordítás
```bash
# elteikthesis_hu.aux fájl generálása
# (PDF fájl még hibás hivatkozásokat fog tartalmazni)
pdflatex elteikthesis_hu.tex
# Irodalomjegyzék generálása
bibtex elteikthesis_hu
# Jelölésjegyzék generálása (ha szükséges)
makeindex -s nomencl.ist -t elteikthesis_hu.nlg \
-o elteikthesis_hu.nls elteikthesis_hu.nlo
# Végleges PDF fájl generálása
pdflatex elteikthesis_hu.tex
pdflatex elteikthesis_hu.tex
```
**Megjegyzés:** az irodalomjegyzék változása esetén a `bibtex`, majd a `pdflatex` _kétszeri_ futtatása szükséges a helyes hivatkozások előállításához.
A fordításhoz tetszőleges fejlesztő környezet is használható (pl. [TexStudio](https://www.texstudio.org/)), ugyanezen utasítások kiadásával.
## Kódblokkok szintaxis kiemelése
A *minted* csomag támogatott a forráskódok szedésére és szintaxis kiemelésére. Használatához szükséges a Python interpreter és a `Pygments` csomag telepítése.
Lásd az `elteikthesis_minted.tex` fájlt példaként és ezt a [dokumentációt](https://www.overleaf.com/learn/latex/Code_Highlighting_with_minted).
## Fontosabb függőségi csomagok
**Képkezelés:**
* Minimális és maximális méret: [adjustbox](https://ctan.org/pkg/adjustbox)
* Alábrák: [subcaption](https://ctan.org/pkg/subcaption)
* Forgatás: [rotating](https://ctan.org/pkg/rotating)
**Táblázatkezelés:**
* Oszlopok és sorok egyesítése: [multirow](https://ctan.org/pkg/multirow)
* Tördelhető táblázat: [longtable](https://ctan.org/pkg/longtable)
* Cellatartalom vertikális igazítása: [array](https://ctan.org/pkg/array)
* Többsoros cellák (sortörés): [makecell](https://ctan.org/pkg/makecell)
**Felsorolások:**
* Szoros térközű felsorolások: [paralist](https://ctan.org/pkg/paralist)
**Matematika és algoritmusok:**
* Matematikai formulák: [amsmath](https://ctan.org/pkg/amsmath)
* Matematikai definíciók: [amsthm](https://ctan.org/pkg/amsthm)
* Matematikai szimbólumok: [amsfonts](https://ctan.org/pkg/amsfonts)
* Algoritmusok: [algpseudocode](https://www.ctan.org/pkg/algorithmicx)
* Kódblokkok: [listingsutf8](https://ctan.org/pkg/listingsutf8), [minted](https://ctan.org/pkg/minted)
**Egyebek:**
* Teendők: [todonotes](https://ctan.org/pkg/todonotes)
## Előre definiált tételszerű bekezdések
* *definition*: Definíció
* *theorem*: Tétel
* *remark*: Emlékeztető
* *note*: Megjegyzés

BIN
README_hu.pdf Normal file

Binary file not shown.

View File

@ -1,7 +1,7 @@
%% MIT License %% MIT License
%% %%
%% Version 2.2, 2021/09/20 %% Version 2.3, 2022/04/30
%% Copyright (c) 2013-2021 Máté Cserép <mcserep@inf.elte.hu>, Bálint Bognár %% Copyright (c) 2013-2022 Máté Cserép <mcserep@inf.elte.hu>, Bálint Bognár
%% %%
%% Permission is hereby granted, free of charge, to any person obtaining a copy %% Permission is hereby granted, free of charge, to any person obtaining a copy
%% of this software and associated documentation files (the "Software"), to deal %% of this software and associated documentation files (the "Software"), to deal
@ -20,9 +20,16 @@
%% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, %% LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
%% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE %% OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
%% SOFTWARE. %% SOFTWARE.
%%
%% -----------------------------------------------------------------------------
%%
%% The original 1.x versions of the CTAN package were developed by
%% Dániel Majoros, under the LaTeX Project Public License version 1.2 or later.
%% This updated work is a complete rewrite with no connection
%% to the original package.
\NeedsTeXFormat{LaTeX2e} \NeedsTeXFormat{LaTeX2e}
\ProvidesClass{elteikthesis}[2021/09/20 ELTE FI bachelor and master thesis template] \ProvidesClass{elteikthesis}[2022/04/30 ELTE FI bachelor and master thesis template]
% LaTeX programming tools % LaTeX programming tools
\RequirePackage{etoolbox} \RequirePackage{etoolbox}

View File

@ -5,7 +5,7 @@
%twoside, % Double sided format %twoside, % Double sided format
%draft, % Quicker draft compilation without rendering images %draft, % Quicker draft compilation without rendering images
%final, % Set final to hide todos %final, % Set final to hide todos
]{elteikthesis}[2021/09/20] ]{elteikthesis}[2022/04/30]
% The minted package is also supported for source highlighting % The minted package is also supported for source highlighting
% See minted-intregration.tex for example % See minted-intregration.tex for example
@ -33,7 +33,7 @@
\logo{elte_cimer_szines} % logo \logo{elte_cimer_szines} % logo
% Add bibliography file % Add bibliography file
\addbibresource{thesis.bib} \addbibresource{elteikthesis.bib}
% The document % The document
\begin{document} \begin{document}

View File

@ -5,7 +5,7 @@
%twoside, % Double sided format %twoside, % Double sided format
%draft, % Quicker draft compilation without rendering images %draft, % Quicker draft compilation without rendering images
%final, % Set final to hide todos %final, % Set final to hide todos
]{elteikthesis}[2021/09/20] ]{elteikthesis}[2022/04/30]
% The minted package is also supported for source highlighting % The minted package is also supported for source highlighting
% See minted-intregration.tex for example % See minted-intregration.tex for example
@ -33,7 +33,7 @@
\logo{elte_cimer_szines} % logo \logo{elte_cimer_szines} % logo
% Add bibliography file % Add bibliography file
\addbibresource{thesis.bib} \addbibresource{elteikthesis.bib}
% The document % The document
\begin{document} \begin{document}

BIN
elteikthesis_minted.pdf Normal file

Binary file not shown.

View File

@ -1,11 +1,11 @@
\documentclass{elteikthesis}[2021/09/20] \documentclass{elteikthesis}[2022/04/30]
\usepackage[newfloat]{minted} \usepackage[newfloat]{minted}
\begin{document} \begin{document}
\documentlang{magyar} \documentlang{english}
\chapter{Minted forráskód} \chapter{Minted source code example}
\label{ch:chapter} \label{ch:chapter}
\begin{listing}[H] \begin{listing}[H]

Binary file not shown.