# Short Description Short description: The schemata package helps the creation of topical outlines that illustrate the breakdown of concepts and categories in academic texts from the late medieval to early modern periods. # Files |Filename |Description | |----------------|---------------------------------------| |`schemata.dtx` |commented style file; source file | |`Makefile` |For use with GNU make; with source file| |`schemata.ins` |installation driver (generated file) | |`schemata.pdf` |Documentation (generated file) | |`README.md` |This file (generated file) | |`schematest.tex`|Test file for Plain TeX or Eplain | |`schemata.png` |Image file used for the manual | # Obtaining the Package 1. Packaged in your current TeX distrbution: See the appropriate documentation. 2. Otherwise, download `schemata.zip` from [CTAN](www.ctan.org/tex-archive/macros/generic/schemata). 3. Unpack `schemata.zip` in an appropriate directory. 4. Change to the directory containing the `schemata` files. # File Generation ## Automatic Installation This method requires GNU `make` on a POSIX-compliant environment, such as GNU/Linux, various BSD flavors, perhaps MacOS (e.g., with various porting systems), and even Cygwin on Windows. 0. A quick install in one's home directory using some of the included files from the `zip` archive just requires the following steps: tex schemata.dtx make inst Otherwise we use the LaTeX installation on the host machine to build the package. When using `make`, any `dvi` files that are created will also be converted to `pdf` format. 1. Type `make distclean release` to generate the release files using `pdflatex`. 3. To use another TeX engine, type one of the following: make ENGINE=latex make ENGINE=lualatex make ENGINE=dvilualatex make ENGINE=xelatex 4. Type `make inst` to install the files in the user's personal TDS-compliant directory tree. 5. Type `sudo make install` to install the files in the system-wide, local TDS-compliant directory tree. ## Manual Compilation Otherwise, the following steps are used for manual installation. See the general information at the [TeX FAQ](https://www.texfaq.org/FAQ-installthings). 0. To use some of the included files from the `zip` archive and only extract files from the `dtx` file, just do the following step and proceed to installation: tex schemata.dtx 1. To build the package on the host system, generate the installation files and a copy of the documentation without the table of contents and cross-references. We use `pdflatex` by default: pdflatex --shell-escape --recorder --interaction=batchmode schemata.dtx 2. Generate the TOC and cross-references for the documentation: pdflatex --recorder --interaction=nonstopmode schemata.dtx 3. Generate the index files using `makeindex`: makeindex -q -s gglo.ist -o schemata.gls schemata.glo makeindex -q -s gind.ist -o schemata.ind schemata.idx 4. Integrate the glossary (changes) and index into the documentation. The second run updates the TOC: pdflatex --recorder --interaction=nonstopmode schemata.dtx pdflatex --recorder --interaction=nonstopmode schemata.dtx One can substitute, e.g., `latex`, `xelatex`, `lualatex`, and `dvilualatex` for `pdflatex`, but the documentation may look different in some cases. ## File Installation Different TeX distributions have somewhat different ways to store TDS-compliant configuration and package data. See, for example, [MikTeX](https://miktex.org/kb/texmf-roots) and the [TeX FAQ](https://www.texfaq.org/FAQ-privinst). Two approaches below conform generally to a Unix-based system: ## User's Home Directory `TEXMFHOME` is a variable that points to the root of a TDS-compliant directory tree available to a user. Use `kpsewhich --var-value TEXMFHOME` to obtain its value. Quite often it is equivalent to `$HOME/texmf`. The dollar sign in front of the variable denotes the value of the variable instead of its name. So if `$HOME` is `/home/bob`, then `$TEXMFHOME` would be `/home/bob/texmf`, and we can understand the following paths to be under that directory: |Path |Description | |------------------------------------|--------------------------------------------| |`$TEXMFHOME/source/generic/schemata`|`ins` and `dtx` files, Makefile, `png` file | |`$TEXMFHOME/tex/generic/schemata` |`sty` file | |`$TEXMFHOME/doc/generic/schemata` |`pdf` file, `README.md`, `schematest.tex` | On older TeX distributions, run `mktexlsr` on $TEXMFHOME to complete the install process. ## System-Wide Directory `TEXMFLOCAL` is a variable that points to the root of a TDS-compliant directory tree available to all users on a local site, system-wide installation. Use `kpsewhich --var-value TEXMFLOCAL` to obtain its value. See the [TeX FAQ](https://www.texfaq.org/FAQ-what-TDS). We can understand the following paths to be under that directory: |Path |Description | |-------------------------------------|--------------------------------------------| |`$TEXMFLOCAL/source/generic/schemata`|`ins` and `dtx` files, Makefile, `png` file | |`$TEXMFLOCAL/tex/generic/schemata` |`sty` file | |`$TEXMFLOCAL/doc/generic/schemata` |`pdf` file, `README.md`, `schematest.tex` | Run `mktexlsr` with the appropriate permissions on `$TEXMFLOCAL` to complete the install process. # Testing ## Compiling `schematest.tex` 1. Either go to the directory used when unpacking the `zip` file or copy the file `schematest.tex` from the `doc/generic/schemata` branch of whatever TDS-compliant tree to a directory of your choice. 2. If one has access to GNU `make`, use either `Makefile` in the directory where one unpacked the `zip` file or copy `Makefile` from either `src/generic/schemata` or `doc/generic/schemata` in whatever TDS-compliant tree it exists. When using `make`, any `dvi` files that are created will also be converted to `pdf` format. 3. To compile the test file using `make` and `pdftex`, simply type `make testing`. 4. For multi-format testing using `make` in addition to that above, one can do the following: make testing TESTENGINE=tex make testing TESTENGINE=eplain make testing TESTENGINE=lollipop make testing TESTENGINE=luatex make testing TESTENGINE=dviluatex make testing TESTENGINE=xetex make testing TESTENGINE=pdflatex make testing TESTENGINE=latex make testing TESTENGINE=lualatex make testing TESTENGINE=dvilualatex make testing TESTENGINE=xelatex 5. If one does not have `make`, one can use any one of the following commands: pdftex --interaction=nonstopmode schematest tex --interaction=nonstopmode schematest eplain --interaction=nonstopmode schematest lollipop --interaction=nonstopmode schematest luatex --interaction=nonstopmode schematest dviluatex --interaction=nonstopmode schematest xetex --interaction=nonstopmode schematest pdflatex --interaction=nonstopmode schematest lualatex --interaction=nonstopmode schematest dvilualatex --interaction=nonstopmode schematest xelatex --interaction=nonstopmode schematest The manual is also a test suite. # Copyright Copyright (C) 2020 by Charles P. Schaum ------------------------------------------------------- This file may be distributed and/or modified under the conditions of the LaTeX Project Public License, either version 1.3 of this license or (at your option) any later version. The latest version of this license is in: [http://www.latex-project.org/lppl.txt](http://www.latex-project.org/lppl.txt) and version 1.3 or later is part of all distributions of LaTeX version 2005/12/01 or later.