diff options
author | Robert Alessi <alessi@robertalessi.net> | 2024-03-07 17:45:52 +0100 |
---|---|---|
committer | Robert Alessi <alessi@robertalessi.net> | 2024-03-07 17:45:52 +0100 |
commit | 5aad232293fe7946fc49e3e03d0f495bf9b4d4e6 (patch) | |
tree | 849a96dde9f9638aef061afb63afde962bf7085a /README.md | |
parent | be39ec164daa140255acd4840fe4231e14d3b6d3 (diff) | |
download | texlive-openbsd-5aad232293fe7946fc49e3e03d0f495bf9b4d4e6.tar.gz |
updated README with more detailed instructions on how TL should be installed
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 72 |
1 files changed, 59 insertions, 13 deletions
@@ -12,7 +12,7 @@ always run on both -stable and -current versions of OpenBSD. | |||
12 | Running TeX Live in *Open*BSD | 12 | Running TeX Live in *Open*BSD |
13 | ----------------------------- | 13 | ----------------------------- |
14 | 14 | ||
15 | There are two ways of using TeX Live in OpenBSD. | 15 | There are two ways of using TeX Live in *Open*BSD. |
16 | 16 | ||
17 | 1. From ports. TeX Live is available in variety of “schemes” to wit | 17 | 1. From ports. TeX Live is available in variety of “schemes” to wit |
18 | different sets of package collections, of which a list can be found | 18 | different sets of package collections, of which a list can be found |
@@ -21,13 +21,13 @@ There are two ways of using TeX Live in OpenBSD. | |||
21 | 2. By installing the “native” TeX Live over the internet, as described | 21 | 2. By installing the “native” TeX Live over the internet, as described |
22 | on [its home page](https://tug.org/texlive). This latter method | 22 | on [its home page](https://tug.org/texlive). This latter method |
23 | facilitates the installation of new packages and the updating of | 23 | facilitates the installation of new packages and the updating of |
24 | existing ones. However, the binaries for OpenBSD are not currently | 24 | existing ones. However, the binaries for *Open*BSD are not |
25 | part of the official TeX Live distribution. The reason for this is | 25 | currently part of the official TeX Live distribution. The reason |
26 | that the TeX Live binaries are published once a year while the | 26 | for this is that the TeX Live binaries are published once a year |
27 | OpenBSD system undergoes two updates a year. | 27 | while the OpenBSD system undergoes two updates a year. |
28 | 28 | ||
29 | This page provides an easy way to build one's own TeX Live binaries | 29 | This page provides an easy way to build one's own TeX Live binaries |
30 | for OpenBSD—either -stable or -current—through a simple script which | 30 | for *Open*BSD—either -stable or -current—through a simple script which |
31 | is nothing but an adapted version of the one used to build TeX Live | 31 | is nothing but an adapted version of the one used to build TeX Live |
32 | for the supported systems.[^2] | 32 | for the supported systems.[^2] |
33 | 33 | ||
@@ -35,7 +35,7 @@ Furthermore, *TeX Live for OpenBSD* provides ready-to-use binary sets | |||
35 | for those who do not wish to compile their own. | 35 | for those who do not wish to compile their own. |
36 | 36 | ||
37 | In addition to the standard binaries supported by TeX Live, TeX Live | 37 | In addition to the standard binaries supported by TeX Live, TeX Live |
38 | for OpenBSD provides the following: | 38 | for *Open*BSD provides the following: |
39 | 39 | ||
40 | - xindy | 40 | - xindy |
41 | - LuaMetaTeX (ConTeXt) | 41 | - LuaMetaTeX (ConTeXt) |
@@ -43,8 +43,8 @@ for OpenBSD provides the following: | |||
43 | 43 | ||
44 | biber will soon be added to this list. | 44 | biber will soon be added to this list. |
45 | 45 | ||
46 | Installing TeX Live on OpenBSD with ready-to-use binaries | 46 | Installing TeX Live on *Open*BSD with ready-to-use binaries |
47 | --------------------------------------------------------- | 47 | ----------------------------------------------------------- |
48 | 48 | ||
49 | Please read first the reference page on this matter: | 49 | Please read first the reference page on this matter: |
50 | <https://tug.org/texlive/custom-bin.html>. | 50 | <https://tug.org/texlive/custom-bin.html>. |
@@ -55,13 +55,19 @@ Please read first the reference page on this matter: | |||
55 | - xz | 55 | - xz |
56 | - p5-Tk | 56 | - p5-Tk |
57 | 57 | ||
58 | 2. Import the public key used to sign the archive: | 58 | 2. Acquire `install-tl-unx.tar.gz` from CTAN as described [on this |
59 | page](https://tug.org/texlive/acquire-netinstall.html). | ||
60 | - do: `zcat < install-tl-unx.tar.gz | tar xf -` | ||
61 | - do: `cd install-tl-<yyyymmdd>` (replace <yyyymmdd> with the | ||
62 | actual date.) | ||
63 | |||
64 | 3. Import the public key used to sign the archive: | ||
59 | 65 | ||
60 | ```sh | 66 | ```sh |
61 | gpg --keyserver pgp.mit.edu --recv 1773E9248085C8C7 | 67 | gpg --keyserver pgp.mit.edu --recv 1773E9248085C8C7 |
62 | ``` | 68 | ``` |
63 | 69 | ||
64 | 3. Clone this git repository and fetch the binaries: | 70 | 4. Clone this git repository and fetch the binaries: |
65 | 71 | ||
66 | ```sh | 72 | ```sh |
67 | git clone https://git.sr.ht/~ralessi/texlive-openbsd | 73 | git clone https://git.sr.ht/~ralessi/texlive-openbsd |
@@ -75,9 +81,49 @@ Please read first the reference page on this matter: | |||
75 | make fetch | 81 | make fetch |
76 | ``` | 82 | ``` |
77 | 83 | ||
78 | 4. Proceed with TL installation, as per the instructions displayed on | 84 | 5. Proceed with TL installation, as per the instructions displayed on |
79 | the terminal. | 85 | the terminal. |
80 | 86 | ||
87 | 6. Post-install actions. (What follows assumes that the installation | ||
88 | has been performed as root. Adapt.) At the end of the | ||
89 | installation, the script offers to create environment | ||
90 | variables. Say no, then: | ||
91 | |||
92 | 1. Edit root's `.profile` file and add the path to the binaries, | ||
93 | like so (replace here and below `<yyyy>` with the actual year): | ||
94 | |||
95 | ```sh | ||
96 | # insert this line: | ||
97 | TLBIN=/usr/local/texlive/<yyyy>/bin/custom | ||
98 | # modify this line like so: | ||
99 | PATH=/sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin:$TLBIN:/usr/local/sbin:/usr/local/bin | ||
100 | ``` | ||
101 | |||
102 | Make sure to insert `$TLBIN` *before* `/usr/local/bin`. Then do | ||
103 | the same in other users' `.profile` files. | ||
104 | |||
105 | 2. Edit `/etc/man.conf` (copy `/etc/examples/man.conf` to `/etc` if | ||
106 | this file doesn't exist) and add the manpath to TL man files, | ||
107 | like so: | ||
108 | |||
109 | ``` | ||
110 | manpath /usr/share/man | ||
111 | manpath /usr/X11R6/man | ||
112 | manpath /usr/local/man | ||
113 | manpath /usr/local/texlive/<yyyy>/texmf-dist/doc/man | ||
114 | ``` | ||
115 | |||
116 | 3. Symlink `texlive-fontconfig.conf` file to | ||
117 | `/etc/fonts/conf.d/09-texlive.conf` and update the font cache: | ||
118 | |||
119 | ```sh | ||
120 | cd /etc/fonts/conf.d | ||
121 | ln -sf /usr/local/texlive/<yyyy>/texmf-var/fonts/conf/texlive-fontconfig.conf 09-texlive.conf | ||
122 | fc-cache -fsv | ||
123 | ``` | ||
124 | |||
125 | 7. Reboot and enjoy TeX Live on *Open*BSD! | ||
126 | |||
81 | ### All by hand | 127 | ### All by hand |
82 | Direct link to the binaries: <https://www.ekdosis.org/texlive>. | 128 | Direct link to the binaries: <https://www.ekdosis.org/texlive>. |
83 | 129 | ||
@@ -143,7 +189,7 @@ Miklavec. | |||
143 | 189 | ||
144 | Notes | 190 | Notes |
145 | ----- | 191 | ----- |
146 | [^1]: More information on how TL is built for OpenBSD here: | 192 | [^1]: More information on how TL is built for *Open*BSD here: |
147 | <https://cvsweb.openbsd.org/cgi-bin/cvsweb/ports/print/texlive> | 193 | <https://cvsweb.openbsd.org/cgi-bin/cvsweb/ports/print/texlive> |
148 | 194 | ||
149 | [^2]: See <https://tug.org/texlive/build.html>. The `Build` script can | 195 | [^2]: See <https://tug.org/texlive/build.html>. The `Build` script can |