apptainer-mode

A simple major mode for Apptainer definition files.

Derived from sh-mode, apptainer-mode implements basic font-locking for definition (.def) file headers and section labels.

Installation

To download the release version, download it from the Releases section and unpack the archive.

To download the development version, run the following snippet, filling in the desired destination path:

git clone [email protected]:jrgant/apptainer-mode </path/to/destination>

In either case, add apptainer-mode using one of the following:

(load-file "/path/to/apptainer-mode.el")

;; OR, if you use `use-package`
(use-package
  :load-path "/path/to/apptainer-mode/")

Options

The user can set a handful of variables to tweak font-locking in .def files. These variables consist primarily of flags that allow users to bold, italicize, box, or fill Apptainer header keywords and section headers easily.

All of the variables listed below default to nil.

apptainer-bold-headers	Non-nil bolds header keywords
apptainer-italic-headers	Non-nil italicizes header keywords
apptainer-boxed-headers	Non-nil draws a box around header keywords
apptainer-filled-headers	Non-nil sets a background fill on header keywords
apptainer-bold-sections	Non-nil bolds section headers
apptainer-italic-sections	Non-nil italicizes section headers
apptainer-boxed-sections	Non-nil draws a box around section headers
apptainer-filled-sections	Non-nil sets a background fill on section headers
apptainer-boxed-links	Non-nil draws a box around URLs and email addresses
apptainer-italicize-retriever	Non-nil italicizes $ environment variable retriever

If you use the load-file method above, set these variables before loading the package. If you use use-package, set the variables in the :init section.

(setq apptainer-boxed-headers t
      apptainer-boxed-sections t)

To further customize fonts, use set-face-attribute.

(set-face-attribute 'apptainer-section-face nil :underline t :foreground "red")

Boxed Faces	Filled Faces