aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorRobert Alessi <alessi@robertalessi.net>2024-03-07 17:45:52 +0100
committerRobert Alessi <alessi@robertalessi.net>2024-03-07 17:45:52 +0100
commit5aad232293fe7946fc49e3e03d0f495bf9b4d4e6 (patch)
tree849a96dde9f9638aef061afb63afde962bf7085a /README.md
parentbe39ec164daa140255acd4840fe4231e14d3b6d3 (diff)
downloadtexlive-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.md72
1 files changed, 59 insertions, 13 deletions
diff --git a/README.md b/README.md
index 9fd5c4c..ba8ad06 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@ always run on both -stable and -current versions of OpenBSD.
12Running TeX Live in *Open*BSD 12Running TeX Live in *Open*BSD
13----------------------------- 13-----------------------------
14 14
15There are two ways of using TeX Live in OpenBSD. 15There are two ways of using TeX Live in *Open*BSD.
16 16
171. From ports. TeX Live is available in variety of “schemes” to wit 171. 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.
212. By installing the “native” TeX Live over the internet, as described 212. 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
29This page provides an easy way to build one's own TeX Live binaries 29This page provides an easy way to build one's own TeX Live binaries
30for OpenBSD—either -stable or -current—through a simple script which 30for *Open*BSD—either -stable or -current—through a simple script which
31is nothing but an adapted version of the one used to build TeX Live 31is nothing but an adapted version of the one used to build TeX Live
32for the supported systems.[^2] 32for the supported systems.[^2]
33 33
@@ -35,7 +35,7 @@ Furthermore, *TeX Live for OpenBSD* provides ready-to-use binary sets
35for those who do not wish to compile their own. 35for those who do not wish to compile their own.
36 36
37In addition to the standard binaries supported by TeX Live, TeX Live 37In addition to the standard binaries supported by TeX Live, TeX Live
38for OpenBSD provides the following: 38for *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
44biber will soon be added to this list. 44biber will soon be added to this list.
45 45
46Installing TeX Live on OpenBSD with ready-to-use binaries 46Installing TeX Live on *Open*BSD with ready-to-use binaries
47--------------------------------------------------------- 47-----------------------------------------------------------
48 48
49Please read first the reference page on this matter: 49Please 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
582. Import the public key used to sign the archive: 582. 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
643. 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
643. Clone this git repository and fetch the binaries: 704. 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
784. Proceed with TL installation, as per the instructions displayed on 845. Proceed with TL installation, as per the instructions displayed on
79 the terminal. 85 the terminal.
80 86
876. 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
1257. Reboot and enjoy TeX Live on *Open*BSD!
126
81### All by hand 127### All by hand
82Direct link to the binaries: <https://www.ekdosis.org/texlive>. 128Direct link to the binaries: <https://www.ekdosis.org/texlive>.
83 129
@@ -143,7 +189,7 @@ Miklavec.
143 189
144Notes 190Notes
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