standardebooks for Mac

About

A collection of tools Standard Ebooks uses to produce its ebooks, including basic setup of ebooks, text processing, and build tools.

Installing the toolset makes the se command line executable available. Its various commands are described below, or you can use se help to list them.

Installation

The toolset requires Python >= 3.14.4.

To install the toolset locally for development and debugging, see Installation for toolset developers.

Optionally, install Ace and the se build --check command will automatically run it as part of the checking process.

Ubuntu 26.04 through 22.04

Optional: Install shell completions

Fedora 43

Optional: Install shell completions

macOS Install the Homebrew package manager. Or, if you already have it installed, make sure it’s up-to-date: Install the tools with Homebrew:

When building a project with SVG images, a browser instance is used to render SVGs to PNGs. If you don’t have Chrome or Firefox installed then you need to manually allow Safari to be instantiated by the toolset:

Note that Safari currently doesn't support "headless" mode, so you may see Safari windows appear and disappear as se build processes SVGs. If these windows annoy you, install Firefox or Chrome and se build will use them instead of Safari.

Alternative: pipx

If you want a more granular install you can install the dependencies manually and the toolset with pipx:

Windows 11

These instructions install the toolset directly in Windows, without Windows Subsystem for Linux. Open PowerShell and use WinGet to install various dependencies: Close PowerShell and open it again , then install pipx and configure its executable directory in your PATH: Close PowerShell and open it again, then install the toolset:

OpenBSD 6.6

These instructions were tested on OpenBSD 6.6, but may also work on 6.5. Create a text file to feed into pkg_add called ~/standard-ebooks-packages. It should contain the following: Install dependencies using doas pkg_add -ivl ~/standard-ebooks-packages. Follow the linking instructions provided by pkg_add to save keystrokes, unless you want multiple Python and pip versions installed. In my case, I ran doas ln -sf /usr/local/bin/pip3.14 /usr/local/bin/pip. Add ~/.local/bin to your path. Run pip install --user pipx If you’re using KSH from base and have already added ~/.local/bin, you can skip pipx ensurepath because this step is for Bash users. The rest of the process is similar to that used on other platforms:

Installation for toolset developers

If you want to work on the toolset source, it’s helpful to tell pipx to install the package in “editable” mode. This will allow you to edit the source of the package live and see changes immediately, without having to uninstall and re-install the package.

To do that, follow the general installation instructions above; but instead of doing pipx install standardebooks, do the following: