Reproducible and deployable Asciidoctor template based on Nix.
The latest
release containing the
defaultExternal
package, the
Gemfile.lock
and gemset.nix
files, and the flake.lock
file are automatically updated by the .github/workflows/deploy.yml
,
.github/workflows/bundix_lock.yml
, and
.github/workflows/nix_flake_update.yml
GitHub actions respectively.
If the slides are not required, feel free to revert the
de19b8059c410dc49e036d681749c7f8db8d609a
commit to reduce install size and compile time.
Enter the development environment with
nix develop
or direnv allow
.
nix build
builds the specified installables. Installables that resolve to derivations are built (or substituted if possible). Store path installables are substituted.Unless
--no-link
is specified, after a successful build, it creates symlinks to the store paths of the installables. These symlinks have the prefix./result
by default; this can be overridden using the--out-link
option. Each symlink has a suffix-<N>-<outname>,
where N is the index of the installable (with the left-most installable having index 0), and outname is the symbolic derivation output name (e.g.bin
,dev
orlib
).-<N>
is omitted if N = 0, and-<outname>
is omitted if outname =out
(denoting the default output).
Package | Description |
---|---|
Compiles the |
|
Compiles the DocBook at |
|
Compiles the HTML at |
|
Compiles the manpage at |
|
Compiles the PDF at |
|
Compiles the presentation at Due to reproducibility, the |
|
Compiles the presentation at Consequently, this package should not be released without the accompanying
|
nix build github:trueNAHO/asciidoctor.nix#default
nix build github:trueNAHO/asciidoctor.nix#defaultExternal
nix build github:trueNAHO/asciidoctor.nix#defaultLocal
nix build github:trueNAHO/asciidoctor.nix#docbook
nix build github:trueNAHO/asciidoctor.nix#html
nix build github:trueNAHO/asciidoctor.nix#manpage
nix build github:trueNAHO/asciidoctor.nix#pdf
nix build github:trueNAHO/asciidoctor.nix#presentationExternal
nix build github:trueNAHO/asciidoctor.nix#presentationLocal
To build the packages from a local copy at /path/to/repository
using nix
, run one of the following commands:
nix build /path/to/repository#default
nix build /path/to/repository#defaultExternal
nix build /path/to/repository#defaultLocal
nix build /path/to/repository#docbook
nix build /path/to/repository#html
nix build /path/to/repository#manpage
nix build /path/to/repository#pdf
nix build /path/to/repository#presentationExternal
nix build /path/to/repository#presentationLocal