From bb098ce77e8c82e20f6e5cf78b2b6976ff5082cc Mon Sep 17 00:00:00 2001 From: quirinecker Date: Thu, 23 Oct 2025 21:14:47 +0200 Subject: [PATCH] updated installation options --- README.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 46 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 3ae1a4e..ed83dbc 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ Docki is cli for converting asciidoctor files into html files. You can build you ### Nix -This installation method is recommended, becuase it is the most maintained due to me using nix in development. +This installation method is recommended, because it will include both asciidoctor and asciidoctor_revealjs. Note: This is the most basic installation. If you are already more experienced, you might want to add it to your shell or home manager configuration. @@ -24,8 +24,11 @@ nix profile install github:quirinecker/docki ### Homebrew +> [!NOTE] +> Installing it via homebrew will not include asciidoctor_revealjs. It can be installed afterwards with `docki install-reveal` + ``` -brew tap quirinecker/docki-homebrew https://gitlab.com/quirinecker/docki-homebrew +brew tap quirinecker/docki-homebrew https://github.com/quirinecker/docki-homebrew ``` ``` @@ -34,9 +37,50 @@ brew install docki ### Cargo +> [!NOTE] +> This is the most basic installation. It will not include asciidoctor_revealjs and asciidoctor itself. Installing asciidoctor has to be done manually, while installing asciidoctor_revealjs can be done with `docki install-reveal` + ```shell cargo install docki ``` +### Nix (Advanced, Flake) +> [!NOTE] +> There are multiple ways to install docki with nix. This is the way I installed it on my machine. + +1. Add it to the flake inputs + +```nix +docki = { + url = "github:quirinecker/docki"; + inputs.nixpkgs.follows = "nixpkgs"; +}; +``` + +2. Add `@inputs` at the end of the outputs (if you haven't already) + +``` +outputs = { + nixpkgs + ... +}@inputs: +...Rest of your flake... +``` + +3. Add the input to your system packages (system configuration) or home packages (home manager configuration) + +```nix +environment.systemPackages = with pkgs; [ + inputs.docki.packages.${system}.default +] +``` + +or + +```nix +home.packages = with pkgs; [ + inputs.docki.packages.${system}.default +] +```