From 5aad232293fe7946fc49e3e03d0f495bf9b4d4e6 Mon Sep 17 00:00:00 2001 From: Robert Alessi Date: Thu, 7 Mar 2024 17:45:52 +0100 Subject: updated README with more detailed instructions on how TL should be installed --- README.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 59 insertions(+), 13 deletions(-) (limited to 'README.md') 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. Running TeX Live in *Open*BSD ----------------------------- -There are two ways of using TeX Live in OpenBSD. +There are two ways of using TeX Live in *Open*BSD. 1. From ports. TeX Live is available in variety of “schemes” to wit 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. 2. By installing the “native” TeX Live over the internet, as described on [its home page](https://tug.org/texlive). This latter method facilitates the installation of new packages and the updating of - existing ones. However, the binaries for OpenBSD are not currently - part of the official TeX Live distribution. The reason for this is - that the TeX Live binaries are published once a year while the - OpenBSD system undergoes two updates a year. + existing ones. However, the binaries for *Open*BSD are not + currently part of the official TeX Live distribution. The reason + for this is that the TeX Live binaries are published once a year + while the OpenBSD system undergoes two updates a year. This page provides an easy way to build one's own TeX Live binaries -for OpenBSD—either -stable or -current—through a simple script which +for *Open*BSD—either -stable or -current—through a simple script which is nothing but an adapted version of the one used to build TeX Live for the supported systems.[^2] @@ -35,7 +35,7 @@ Furthermore, *TeX Live for OpenBSD* provides ready-to-use binary sets for those who do not wish to compile their own. In addition to the standard binaries supported by TeX Live, TeX Live -for OpenBSD provides the following: +for *Open*BSD provides the following: - xindy - LuaMetaTeX (ConTeXt) @@ -43,8 +43,8 @@ for OpenBSD provides the following: biber will soon be added to this list. -Installing TeX Live on OpenBSD with ready-to-use binaries ---------------------------------------------------------- +Installing TeX Live on *Open*BSD with ready-to-use binaries +----------------------------------------------------------- Please read first the reference page on this matter: . @@ -55,13 +55,19 @@ Please read first the reference page on this matter: - xz - p5-Tk -2. Import the public key used to sign the archive: +2. Acquire `install-tl-unx.tar.gz` from CTAN as described [on this + page](https://tug.org/texlive/acquire-netinstall.html). + - do: `zcat < install-tl-unx.tar.gz | tar xf -` + - do: `cd install-tl-` (replace with the + actual date.) + +3. Import the public key used to sign the archive: ```sh gpg --keyserver pgp.mit.edu --recv 1773E9248085C8C7 ``` -3. Clone this git repository and fetch the binaries: +4. Clone this git repository and fetch the binaries: ```sh git clone https://git.sr.ht/~ralessi/texlive-openbsd @@ -75,9 +81,49 @@ Please read first the reference page on this matter: make fetch ``` -4. Proceed with TL installation, as per the instructions displayed on +5. Proceed with TL installation, as per the instructions displayed on the terminal. +6. Post-install actions. (What follows assumes that the installation + has been performed as root. Adapt.) At the end of the + installation, the script offers to create environment + variables. Say no, then: + + 1. Edit root's `.profile` file and add the path to the binaries, + like so (replace here and below `` with the actual year): + + ```sh + # insert this line: + TLBIN=/usr/local/texlive//bin/custom + # modify this line like so: + PATH=/sbin:/usr/sbin:/bin:/usr/bin:/usr/X11R6/bin:$TLBIN:/usr/local/sbin:/usr/local/bin + ``` + + Make sure to insert `$TLBIN` *before* `/usr/local/bin`. Then do + the same in other users' `.profile` files. + + 2. Edit `/etc/man.conf` (copy `/etc/examples/man.conf` to `/etc` if + this file doesn't exist) and add the manpath to TL man files, + like so: + + ``` + manpath /usr/share/man + manpath /usr/X11R6/man + manpath /usr/local/man + manpath /usr/local/texlive//texmf-dist/doc/man + ``` + + 3. Symlink `texlive-fontconfig.conf` file to + `/etc/fonts/conf.d/09-texlive.conf` and update the font cache: + + ```sh + cd /etc/fonts/conf.d + ln -sf /usr/local/texlive//texmf-var/fonts/conf/texlive-fontconfig.conf 09-texlive.conf + fc-cache -fsv + ``` + +7. Reboot and enjoy TeX Live on *Open*BSD! + ### All by hand Direct link to the binaries: . @@ -143,7 +189,7 @@ Miklavec. Notes ----- -[^1]: More information on how TL is built for OpenBSD here: +[^1]: More information on how TL is built for *Open*BSD here: [^2]: See . The `Build` script can -- cgit v1.2.3