describe the docker installation
This commit is contained in:
parent
577e00e904
commit
346f7c3d6e
30
README.md
30
README.md
@ -20,11 +20,37 @@ See the [pre-built version](build/thesis.pdf) for details
|
|||||||
4. Write the thesis.
|
4. Write the thesis.
|
||||||
5. Submit and defend the thesis.
|
5. Submit and defend the thesis.
|
||||||
|
|
||||||
|
### Installing LaTeX
|
||||||
|
|
||||||
|
LaTeX installation may be hard (especially on various substandard operating systems). On most BSD and GNU-style Linux distributions, it should be sufficient to install some random `texlive-*` packages (and add more if non-standard TeX functionality is required); see e.g. [a complete list for Debian](docker/Dockerfile).
|
||||||
|
|
||||||
|
- For a single-user distribution on unix, use the provided [installation script](https://www.tug.org/texlive/quickinstall.html).
|
||||||
|
- On windows, use [MiKTeX](https://www.tug.org/texlive/windows.html).
|
||||||
|
- On Mac, use any suitable variant of [MacTeX](https://www.tug.org/mactex/).
|
||||||
|
|
||||||
|
Optionally, you can use a Docker container with TeX. You can either build the image yourself from the supplied `Dockerfile`:
|
||||||
|
```sh
|
||||||
|
cd docker
|
||||||
|
docker build -t exaexa/latex .
|
||||||
|
```
|
||||||
|
|
||||||
|
...or get a pre-built copy (which is usually much faster:
|
||||||
|

|
||||||
|
)
|
||||||
|
```sh
|
||||||
|
docker pull exaexa/latex
|
||||||
|
```
|
||||||
|
|
||||||
|
After that, you should be able to compile the thesis using (roughly) this command:
|
||||||
|
```sh
|
||||||
|
docker run -u $UID -ti --rm -v $PWD:/th -w /th exaexa/latex make
|
||||||
|
```
|
||||||
|
|
||||||
## PDF/A
|
## PDF/A
|
||||||
|
|
||||||
With a bit of luck, you should get PDF/A right out of LaTeX.
|
With a bit of luck, you should get a valid PDF/A right out of LaTeX.
|
||||||
|
|
||||||
A working PDF/A validator that can point out exact problems is here: https://github.com/mff-cuni-cz/cuni-thesis-validator
|
A PDF/A validator that can point out exact problems is available here: https://github.com/mff-cuni-cz/cuni-thesis-validator
|
||||||
|
|
||||||
Common PDF/A problems include:
|
Common PDF/A problems include:
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user