Merge pull request #269 from deadc0de6/notemplate

Notemplate

docs/config-format.md

@@ -31,6 +31,7 @@ Entry    | Description | Default
 `longkey` | use long keys for dotfiles when importing (see [Import dotfiles](usage.md#import-dotfiles)) | false
 `minversion` | (*for internal use, do not modify*) provides the minimal dotdrop version to use | -
 `showdiff` | on install show a diff before asking to overwrite (see `--showdiff`) | false
+`template_dotfile_default` | disable templating on all dotfiles when set to false | true
 `upignore` | list of patterns to ignore when updating, apply to all dotfiles (enclose in quotes when using wildcards, see [ignore patterns](config.md#ignore-patterns)) | -
 `workdir` | path to the directory where templates are installed before being symlinked when using `link:link` or `link:link_children` (absolute path or relative to the config file location) | `~/.config/dotdrop`
 <s>link_by_default</s> | when importing a dotfile set `link` to that value per default | false
@@ -48,6 +49,7 @@ Entry    | Description
 `cmpignore` | list of patterns to ignore when comparing (enclose in quotes when using wildcards, see [ignore patterns](config.md#ignore-patterns))
 `ignoreempty` | if true empty template will not be deployed (defaults to value of `ignoreempty`)
 `instignore` | list of patterns to ignore when installing (enclose in quotes when using wildcards, see [ignore patterns](config.md#ignore-patterns))
+`template` | if false disable template for this dotfile (defaults to value of `template_dotfile_default`)
 `trans_read` | transformation key to apply when installing this dotfile (must be defined in the **trans_read** entry below, see [transformations](config-details.md#entry-transformations))
 `trans_write` | transformation key to apply when updating this dotfile (must be defined in the **trans_write** entry below, see [transformations](config-details.md#entry-transformations))
 `upignore` | list of patterns to ignore when updating (enclose in quotes when using wildcards, see [ignore patterns](config.md#ignore-patterns))
@@ -69,6 +71,7 @@ Entry    | Description
     - "<ignore-pattern>"
   actions:
     - <action-key>
+  template: (true|false)
   trans_read: <transformation-key>
   trans_write: <transformation-key>
 ```

docs/howto/symlink-dotfiles.md

@@ -13,8 +13,8 @@ Note that if the dotfile is using template directives, it will be symlinked into
 `~/.config/dotdrop` instead of directly into your *dotpath*
 (see [Templating symlinked dotfiles](#templating-symlinked-dotfiles))
 
-Although the config entries `link_on_import` and `link_dotfile_default` can be set to `link_children`, it
-is not recommended since operations on a dotfile that is not a directory with the option `link_children`
+Although the config entries `link_on_import` and `link_dotfile_default` can be set to the value `link_children`,
+it is not recommended since operations on a dotfile that is not a directory with the option `link_children`
 will fail.
 
 ## Symlink a dotfile

docs/templating.md

@@ -4,6 +4,19 @@ Dotdrop leverage the power of [jinja2](https://palletsprojects.com/p/jinja/) to
 templating of dotfiles. See [jinja2 template doc](https://jinja.palletsprojects.com/en/2.11.x/templates/)
 or the below sections for more information on how to template your dotfiles.
 
+## Templating or not templating
+
+The dotfile config entry [template](config-format.md#dotfiles-entry)
+and the global config entry [template_dotfile_default](config-format.md#config-entry)
+allow to control if a dotfile is being process by the templating engine.
+
+Obviously if the dotfile uses template directives, it needs to be templated. However if it
+is not, disabling templating will speed up its installation (since it won't have to be
+processed by the engine).
+
+For dotfiles being symlinked (`link` or `link_children`), see
+[the dedicated doc](howto/symlink-dotfiles.md#templating-symlinked-dotfiles)
+
 ## Delimiters
 
 Dotdrop uses different delimiters than