txt: ## dist_zef-ulisesb-RKDS.md
  # RKDS
  
  RKDS (RaKu Deployment System) is a tool that takes a directory filled with
  [ERK](https://raku.land/zef:ulisesb/ERK) templates and *deploys* them to
  another directory. Supports including raku modules defined in a `.rkds/lib`
  directory and customizing the deployment of templates individually.
  
  ## Example
  
  Say you have these directories and files:
  
  * input-dir/
    * .rkds/
      * lib/
        * MyMod.rakumod
    * template1
    * template2
  * output-dir/
  
  Inside `input-dir/.rkds/lib/MyMod.rakumod`:
  
  ```
  unit module MyMod;
  
  sub squared(\n) is export { n ** 2 }
  
  constant $fav-number is export = 42;
  
  ```
  
  Inside `input-dir/template1`:
  
  ```
  Welcome to the first template.
  
  <%- use RKDS -%>
  This was deployed to <%= get-output-dir %>
  
  <%- use MyMod -%>
  The square of my favorite number is <%= squared($fav-number) %> :)
  
  ```
  
  Inside `input-dir/template2`:
  
  ```
  Second template!
  
  I’m not so sure about this one...
  
  <% use RKDS; don't-deploy %>
  
  This will be executed though: <% note "hello!" %>
  
  ```
  
  Running `rkds input-dir output-dir` will output this:
  
  ```
  rkds: template1: executing
  rkds: template1: deploying
  rkds: template2: executing
  template2: hello!
  rkds: template2: not deploying
  
  ```
  
  and create the file output-dir/template1 like so:
  
  ```
  Welcome to the first template.
  
  This was deployed to /path/to/output-dir
  
  The square of my favorite number is 1764 :)
  
  ```
  
  For more information, see `lib/RKDS.rakumod` and `bin/rkds`.
  