tags
engine-dmo tags: The tag vocabulary: import the seed, review candidates, promote, merge and reject. Every subcommand, argument and flag.
The tag vocabulary: import the seed, review candidates, promote, merge and reject.
| Command | What it does |
|---|---|
engine-dmo tags add | Add a vocabulary tag under an existing parent, with its label in one locale; a key already there is left as it is |
engine-dmo tags candidates | Freeform tags awaiting promotion, with usage per subject type |
engine-dmo tags export | Capture the live vocabulary as a seed file; a directory gets vocabulary.yaml |
engine-dmo tags import | Seed the vocabulary from config/tags/vocabulary.yaml; existing keys are left alone |
engine-dmo tags merge | Fold one vocabulary tag into another, rewriting its taggings |
engine-dmo tags promote | Promote a candidate into the vocabulary (--as key) or merge it into an existing tag (--into key) |
engine-dmo tags reject | Reject a candidate: it and its taggings are removed, with a reason for the audit log |
engine-dmo tags unused | Tags applied to nothing, candidates included |
engine-dmo tags add
Add a vocabulary tag under an existing parent, with its label in one locale; a key already there is left as it is.
engine-dmo tags add <key> [flags] | Argument | Required | Repeatable |
|---|---|---|
key | yes | no |
| Flag | Type | Default | Meaning |
|---|---|---|---|
--kind | string | topic | topic | audience | operational | internal |
--label | string | the label | |
--locale | string | the label’s locale (default: the source locale) | |
--public | bool | true | render publicly |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo tags candidates
Freeform tags awaiting promotion, with usage per subject type.
engine-dmo tags candidates [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--ready | bool | only candidates at or over the threshold |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo tags export
Capture the live vocabulary as a seed file; a directory gets vocabulary.yaml.
engine-dmo tags export [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--out | string | a file, or a directory such as config/tags/; standard output when empty |
--json prints the command’s own JSON document. Runs in a project.
engine-dmo tags import
Seed the vocabulary from config/tags/vocabulary.yaml; existing keys are left alone.
engine-dmo tags import [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--dry-run | bool | report without writing | |
--file | string | vocabulary file (default config/tags/vocabulary.yaml) |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo tags merge
Fold one vocabulary tag into another, rewriting its taggings.
engine-dmo tags merge [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--dry-run | bool | report without writing | |
--keep | string | the tag that survives | |
--merge | string | the tag folded into it |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo tags promote
Promote a candidate into the vocabulary (--as key) or merge it into an existing tag (--into key)
engine-dmo tags promote [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--as | string | the new vocabulary key | |
--into | string | an existing tag to merge into instead | |
--key | string | the candidate key, pending.something | |
--kind | string | topic | topic | audience | operational | internal |
--label | string, repeatable | locale=text, repeatable | |
--public | bool | true | render publicly |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo tags reject
Reject a candidate: it and its taggings are removed, with a reason for the audit log.
engine-dmo tags reject [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--key | string | the candidate key | |
--reason | string | why |
--json prints the text output in the JSON envelope. Runs in a project.
engine-dmo tags unused
Tags applied to nothing, candidates included.
engine-dmo tags unused [flags] | Flag | Type | Default | Meaning |
|---|---|---|---|
--days | int | 0 | leave out tags created in the last this many days |
--json prints the command’s own JSON document. Runs in a project.