D 2021-03-23T09:08:57.224
L settings
N text/x-markdown
P 775c216955410ea2900bf5d765cbc385eecfaed3f5895bbb77460aae9dc66cd4
U mario
W 3333

Use →File→Settings to access the cookiedough options menu.

 * Options are grouped by modules there.
 * Some may only take effect after a restart (e.g. hook_prompt).
 * Stored in ~/.config/cookiedough/settings.json.
 * There is no plugin handling in CD, so ticking the modules has no effect.


## Options

| name          | description                                                    |
|---------------|----------------------------------------------------------------|
| colorize      | Colorize the readme preview a bit                              |
| sort          | Primary scoring/sorting property                               |
| show_counts   | Show number of entries per language/api category               |
| editor        | Text editor (only used for cookiecutters config editing)       |
| no_params     | Don't prompt for template vars. Use terminal prompts instead.  |
| update_ccjson | Update parameters from cookiecutter.json files                 |
| hook_prompt   | Display any additional prompts as GUI inputs                   |


### Sort

 Influences how templates are listed in the left pane. Normally they're
 ordered by "all" (a virtual score). But there's more fields internally:

| name          |avg/weight| description                                                    |
|---------------|----------------------------------------------------------------|
| **all**       | = 5.0   | cumulative weighted score                            |
| size          | 64      | overall size of repository (in kb)                   |
| stars         | 20      | project watchers/stars                               |
| forks         | 5       | number of github forks                               |
| tickets       | 10      | number of open tickets in repo                       |
| vars          | 7       | number of templating variables                       |
| files         | 32      | number of files in template                          |
| readme        | 2048    | length of README                                     |
| lang          | -0.9    | non-english text                                     |
| age           | 9 months| age of last release                                  |
| **bonus**     | +2.5    | tree listing, keywords, curated, descriptions        |
| curated       | +0.8    | previously listed in CC README                       |
| keywords      | +0.5    | has a _keywords field                                |
| descriptions  | +1.25   | contains field descriptions in README                |
| score.find    | +0.5*len| additional content/filenames to reward               |


Note that alphabetically sorting works best with the "short" project name, while the "name" represents the vnd/pkg title, so won't look very sorted in the tree list. Take note of →Template→Details to see how the scoring works on each entry (usually at the bottom).

Not all fields are selectable in the config window. (Though you could edit the `~/.config/cookiedough/settings.json`)


### no_params / hook_prompt

Enabling **no_params** will avoid the input window when rolling out a
teplate.

If disabled, **hook_prompt** will keep input fields pop up as GUI windows.
Else you would get CLI prompts from cookiecutter directly.


Z a787566229346d5fedf9fbe5b7f2625b