gum: add page (#8314)

pages/common/gum.md

@@ -0,0 +1,28 @@
+# gum
+
+> A tool for making glamorous shell scripts.
+> More information: <https://github.com/charmbracelet/gum>.
+
+- Interactively pick a specific option to print to `stdout`:
+
+`gum choose "{{option_1}}" "{{option_2}}" "{{option_3}}"`
+
+- Open an interactive prompt for the user to input a string with a specific placeholder:
+
+`gum input --placeholder "{{value}}"`
+
+- Open an interactive confirmation prompt and exit with either `0` or `1`:
+
+`gum confirm "{{Continue?}}" --default=false --affirmative "{{Yes}}" --negative "{{No}}" {{&& echo "Yes selected" || echo "No selected"}}`
+
+- Show a spinner while a command is taking place with text alongside:
+
+`gum spin --spinner {{dot|line|minidot|jump|pulse|points|globe|moon|monkey|meter|hamburger}} --title "{{loading...}}" -- {{command}}`
+
+- Format text to include emojis:
+
+`gum format -t {{emoji}} "{{:smile: :heart: hello}}"`
+
+- Interactively prompt for multi-line text (CTRL + D to save) and write to `data.txt`:
+
+`gum write > {{data.txt}}`