@@ -24,31 +24,31 @@ Install the `MacTeX distribution <http://tug.org/mactex/>`_.
24
24
If you are on a slow network, you'll want to get the `BasicTeX package <http://tug.org/mactex/morepackages.html >`_ instead,
25
25
then run the following command to install the other packages that the draft requires:
26
26
27
- sudo tlmgr install latexmk isodate substr relsize ulem fixme rsfs extract layouts enumitem l3packages l3kernel imakeidx splitindex xstring
27
+ `` sudo tlmgr install latexmk isodate substr relsize ulem fixme rsfs extract layouts enumitem l3packages l3kernel imakeidx splitindex xstring ``
28
28
29
29
---------------------------------------
30
30
Getting Started on Debian-based Systems
31
31
---------------------------------------
32
32
33
33
Install the following packages:
34
34
35
- sudo apt-get install latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended lmodern
35
+ `` sudo apt-get install latexmk texlive-latex-recommended texlive-latex-extra texlive-fonts-recommended lmodern ``
36
36
37
37
-------------------------
38
38
Getting Started on Fedora
39
39
-------------------------
40
40
41
41
Install the following packages:
42
42
43
- dnf install latexmk texlive texlive-isodate texlive-relsize texlive-ulem texlive-fixme texlive-extract texlive-l3kernel texlive-l3packages texlive-splitindex texlive-imakeidx
43
+ `` dnf install latexmk texlive texlive-isodate texlive-relsize texlive-ulem texlive-fixme texlive-extract texlive-l3kernel texlive-l3packages texlive-splitindex texlive-imakeidx ``
44
44
45
45
-----------------------------
46
46
Getting Started on Arch Linux
47
47
-----------------------------
48
48
49
49
Install the following packages:
50
50
51
- pacman -S make texlive-latexextra texlive-binextra texlive-plaingeneric texlive-fontsrecommended
51
+ `` pacman -S make texlive-latexextra texlive-binextra texlive-plaingeneric texlive-fontsrecommended ``
52
52
53
53
-----------------------------
54
54
Getting Started on Microsoft Windows
@@ -59,6 +59,10 @@ See `sample instructions <https://bennierobinson.com/programming/2016/01/24/perl
59
59
60
60
Install `MiKTeX <https://miktex.org/download >`_
61
61
62
+ Alternatively, you can `install WSL <https://learn.microsoft.com/en-us/windows/wsl/install >`_
63
+ and a Linux distribution,
64
+ and follow the instructions for Linux above.
65
+
62
66
------------
63
67
Instructions
64
68
------------
@@ -80,6 +84,22 @@ For example::
80
84
81
85
make figvirt.pdf
82
86
87
+ Verifying input and output when making changes
88
+ ==============================================
89
+
90
+ While in the ``source `` directory,
91
+ you can check for common mistakes such as misaligned comments with::
92
+
93
+ ../tools/check-source.sh
94
+
95
+ After typesetting the document,
96
+ you can also check the output for further problems with::
97
+
98
+ ../tools/check-output.sh
99
+
100
+ GitHub Actions will also run these checks when you create a pull request,
101
+ but it's often faster if you run them locally first.
102
+
83
103
----------------
84
104
Acknowledgements
85
105
----------------
0 commit comments