gh-workflow: add page

pages/common/gh-workflow.md

@@ -0,0 +1,36 @@
+# gh workflow
+
+> List, view, and run GitHub Actions workflows.
+> More information: <https://cli.github.com/manual/gh_workflow>.
+
+- Interactively select a workflow to view the latest jobs for:
+
+`gh workflow view`
+
+- View a specific workflow in the default browser:
+
+`gh workflow view {{id|workflow_name|filename.yml}} --web`
+
+- Display the YAML definition of a specific workflow:
+
+`gh workflow view {{id|workflow_name|filename.yml}} --yaml`
+
+- Display the YAML definition for a specific Git branch or tag:
+
+`gh workflow view {{id|workflow_name|filename.yml}} --ref {{branch_or_tag_name}} --yaml`
+
+- List workflow files (use `--all` to include disabled workflows):
+
+`gh workflow list`
+
+- Run a manual workflow with parameters:
+
+`gh workflow run {{id|workflow_name|filename.yml}} --raw-field {{param1}}={{value1}} --raw-field {{param2}}={{value2}}`
+
+- Run a manual workflow using a specific branch or tag with JSON parameters from stdin:
+
+`echo '{{{"param1":"value1", "param2":"value2"}}}' | gh workflow run {{id|workflow_name|filename.yml}} --ref {{branch_or_tag_name}}`
+
+- Enable or disable a specific workflow:
+
+`gh workflow {{enable|disable}} {{id|workflow_name|filename.yml}}`