README.txt 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122
  1. vutinfth LaTeX2e document class
  2. Academic thesis template
  3. by Thomas Auzinger <thomas@auzinger.name>
  4. Description
  5. -----------
  6. The vutinfth document class is a LaTeX2e-based template for all theses written
  7. at the Faculty of Informatics at the TU Wien. This package includes the
  8. document class and its documentation as well as an example document that
  9. includes a short introduction to LaTeX.
  10. Support
  11. -------
  12. The vutinfth document class is developed using a GitLab-supported Git
  13. repository. You can find it at
  14. https://gitlab.com/ThomasAUZINGER/vutinfth
  15. where a history of the development process is given. If you encounter problems
  16. with using vutinfth, use the Issues section of GitLab to provide a description
  17. and to alert the developers of your issue. Furthermore, you can use the Issues
  18. section to request features or give suggestions.
  19. Installation
  20. ------------
  21. To use the vutinfth class, it has first to be generated from the documented
  22. source file vutinfth.dtx. This is achieved by executing the build script for
  23. Windows systems (build-all.bat) or Unix-based systems (build-all.sh). Since the
  24. generation process uses LaTeX itself, make sure that the LaTeX installation is
  25. up-to-date.
  26. The generated document class vutinfth.cls has then to be placed in a directory
  27. that is part of the search path of the LaTeX compiler. The folder of the thesis
  28. file is a valid location.
  29. The build scripts also generate an exemplary LaTeX document that serves both as
  30. an introduction to LaTeX and as a verification of the installed typesetting
  31. system. The example document is compiled to example.pdf and it should match the
  32. provided reference solution example-ref.pdf.
  33. Usage
  34. -----
  35. When writing the actual thesis, the build functionalities of the used editor
  36. are usually employed. For advanced functionalities of LaTeX, such as
  37. glossaries, acronyms or indices, more complex build commands have to be used,
  38. which often lead to difficulties.
  39. Thus, additional build scripts for the thesis documents are provided for
  40. Windows systems (build-thesis.bat) and Unix-based systems (build-thesis.sh).
  41. These scripts do not rebuild the class file.
  42. When using these scripts, the file name of the thesis file has to be provided
  43. by directly editing these files.
  44. Documentation
  45. -------------
  46. The documentation can be found in vutinfth.pdf, which is generated directly
  47. from vutinfth.dtx.
  48. This document class is derived from the memoir class at
  49. https://www.ctan.org/pkg/memoir
  50. where additional documentation can be found.
  51. Files
  52. -----
  53. build-all.bat The batch file to generate all necessary files on Windows
  54. systems.
  55. build-all.sh The batch file to generate all necessary files on Unix-based
  56. systems.
  57. build-thesis.bat The batch file to generate the thesis on Windows systems.
  58. build-thesis.sh The batch file to generate the thesis on Unix-based systems.
  59. example-ref.pdf The reference solution for the compiled example document.
  60. example.tex An LaTeX source file showing the use of the vutinfth
  61. document class.
  62. intro.bib The bibliography file of intro.tex.
  63. intro.tex The LaTeX source file of a document that gives an
  64. introduction to LaTeX.
  65. lppl.txt The LaTeX Project Pulic License v1.3c.
  66. README.txt This file.
  67. vutinfth.dtx The documented source code and documentation file of the
  68. vutinfth document class.
  69. vutinfth.ins The installer file of the vutinfth document class.
  70. graphics/*.* Corporate identity graphics of the TU Wien and its Faculty
  71. of Informatics.
  72. Known Issues
  73. -------------
  74. The minitoc package is incompatible with this document class since the
  75. incompatibility of the memoir document class is inherited. Use the titletoc
  76. package as a replacement.
  77. Acknowledgements
  78. ----------------
  79. Hiroyuki Sakai provided valuable feedback that accounts for several
  80. improvements in version 1.4.
  81. Copyright Notice
  82. ----------------
  83. Copyright (C) 2014-2020 by Thomas Auzinger <thomas@auzinger.name>
  84. This work may be distributed and/or modified under the
  85. conditions of the LaTeX Project Public License, either version 1.3
  86. of this license or (at your option) any later version.
  87. The latest version of this license is in
  88. http://www.latex-project.org/lppl.txt
  89. and version 1.3 or later is part of all distributions of LaTeX
  90. version 2005/12/01 or later.
  91. This work has the LPPL maintenance status `maintained'.
  92. The Current Maintainer of this work is Thomas Auzinger.
  93. This work consists of the files vutinfth.dtx and vutinfth.ins
  94. and the derived file vutinfth.cls.
  95. This work also consists of the file intro.tex.
  96. The 'TU Wien' logo and 'Fakultät für !nformatik' logo are copyright of the TU
  97. Wien.