feat: generate the gt command reference from gitea/cli

update_cli_docs.sh runs gt's own generator and lays the pages out for the
site: one directory per command group, front matter, titles, sidebar
order, fenced help text and rewritten links. --released succeeds while no
series is documented. A weekly workflow proposes updates like the runner's.

Signed-off-by: bircni <[email protected]>
This commit is contained in:
bircni committed 2026-10-22 11:28:15 +02:00
1 parent fe618c42be
commit 55c3a392a1
261 files changed
+15116 -2

No files matched your search

+53
View File
@@ -0,0 +1,53 @@
---
sidebar_position: 1
description: "Hide a membership"
---
# gt org member conceal
<!-- Generated by update_cli_docs.sh from the gitea/cli sources, do not edit. -->
Hide a membership
## Synopsis
```text
Make the membership of a user concealed. A public membership shows on the organization's profile.
```
```
gt org member conceal <org> <username> [flags]
```
## Examples
```
$ gt org member conceal acme bob
```
## Options
```
-h, --help help for conceal
```
## Options inherited from parent commands
```
--cwd directory Working directory for repository discovery
--debug Log the method, URL, status, and duration of each HTTP request to stderr
--host URL Gitea instance URL, including any base path
--interactive Allow prompts with machine output
-q, --jq expression Filter JSON output using a jq expression; implies --json
--json fields[="*"] Output JSON with the specified comma-separated fields, or all fields
--no-input Disable prompts and implicit editor/browser interactions
--remote remote Git remote used for repository discovery
-R, --repo OWNER/REPO Select a repository as OWNER/REPO or URL
--sudo user Perform API requests as this user (requires an administrator account)
--user name Account name on the selected instance
-y, --yes Accept confirmations without prompting
```
## SEE ALSO
* [gt org member](../../org/member/index.md): Manage organization membership
+54
View File
@@ -0,0 +1,54 @@
---
sidebar_position: 5
description: "Manage organization membership"
---
# gt org member
<!-- Generated by update_cli_docs.sh from the gitea/cli sources, do not edit. -->
Manage organization membership
## Synopsis
```text
List the members of an organization, remove them, and choose whether a membership is public.
Gitea adds members through teams: add someone to an organization with
gt team member add ORG/TEAM USER.
```
```
gt org member [flags]
```
## Options
```
-h, --help help for member
```
## Options inherited from parent commands
```
--cwd directory Working directory for repository discovery
--debug Log the method, URL, status, and duration of each HTTP request to stderr
--host URL Gitea instance URL, including any base path
--interactive Allow prompts with machine output
-q, --jq expression Filter JSON output using a jq expression; implies --json
--json fields[="*"] Output JSON with the specified comma-separated fields, or all fields
--no-input Disable prompts and implicit editor/browser interactions
--remote remote Git remote used for repository discovery
-R, --repo OWNER/REPO Select a repository as OWNER/REPO or URL
--sudo user Perform API requests as this user (requires an administrator account)
--user name Account name on the selected instance
-y, --yes Accept confirmations without prompting
```
## SEE ALSO
* [gt org](../../org/index.md): Manage organizations
* [gt org member conceal](../../org/member/conceal.md): Hide a membership
* [gt org member list](../../org/member/list.md): List organization members
* [gt org member publicize](../../org/member/publicize.md): Make a membership public
* [gt org member remove](../../org/member/remove.md): Remove a member from an organization
+62
View File
@@ -0,0 +1,62 @@
---
sidebar_position: 2
description: "List organization members"
---
# gt org member list
<!-- Generated by update_cli_docs.sh from the gitea/cli sources, do not edit. -->
List organization members
## Synopsis
```text
List the members of an organization and whether each membership is public or concealed.
Gitea lists every membership as public to administrators, so for them gt checks the visibility
of each membership with one request per member. JSON output without the visibility field
skips those checks (see gt help formatting).
```
```
gt org member list <org> [flags]
```
## Examples
```
$ gt org member list acme
# list only the members everyone can see
$ gt org member list acme --public
```
## Options
```
-h, --help help for list
-L, --limit int Maximum number of results (1..1000) (default 30)
--page int Result page (default 1)
--public List only public memberships
```
## Options inherited from parent commands
```
--cwd directory Working directory for repository discovery
--debug Log the method, URL, status, and duration of each HTTP request to stderr
--host URL Gitea instance URL, including any base path
--interactive Allow prompts with machine output
-q, --jq expression Filter JSON output using a jq expression; implies --json
--json fields[="*"] Output JSON with the specified comma-separated fields, or all fields
--no-input Disable prompts and implicit editor/browser interactions
--remote remote Git remote used for repository discovery
-R, --repo OWNER/REPO Select a repository as OWNER/REPO or URL
--sudo user Perform API requests as this user (requires an administrator account)
--user name Account name on the selected instance
-y, --yes Accept confirmations without prompting
```
## SEE ALSO
* [gt org member](../../org/member/index.md): Manage organization membership
@@ -0,0 +1,53 @@
---
sidebar_position: 3
description: "Make a membership public"
---
# gt org member publicize
<!-- Generated by update_cli_docs.sh from the gitea/cli sources, do not edit. -->
Make a membership public
## Synopsis
```text
Make the membership of a user public. A public membership shows on the organization's profile.
```
```
gt org member publicize <org> <username> [flags]
```
## Examples
```
$ gt org member publicize acme bob
```
## Options
```
-h, --help help for publicize
```
## Options inherited from parent commands
```
--cwd directory Working directory for repository discovery
--debug Log the method, URL, status, and duration of each HTTP request to stderr
--host URL Gitea instance URL, including any base path
--interactive Allow prompts with machine output
-q, --jq expression Filter JSON output using a jq expression; implies --json
--json fields[="*"] Output JSON with the specified comma-separated fields, or all fields
--no-input Disable prompts and implicit editor/browser interactions
--remote remote Git remote used for repository discovery
-R, --repo OWNER/REPO Select a repository as OWNER/REPO or URL
--sudo user Perform API requests as this user (requires an administrator account)
--user name Account name on the selected instance
-y, --yes Accept confirmations without prompting
```
## SEE ALSO
* [gt org member](../../org/member/index.md): Manage organization membership
+53
View File
@@ -0,0 +1,53 @@
---
sidebar_position: 4
description: "Remove a member from an organization"
---
# gt org member remove
<!-- Generated by update_cli_docs.sh from the gitea/cli sources, do not edit. -->
Remove a member from an organization
## Synopsis
```text
Remove a user from an organization and from all of its teams.
```
```
gt org member remove <org> <username> [flags]
```
## Examples
```
$ gt org member remove acme bob
```
## Options
```
-h, --help help for remove
```
## Options inherited from parent commands
```
--cwd directory Working directory for repository discovery
--debug Log the method, URL, status, and duration of each HTTP request to stderr
--host URL Gitea instance URL, including any base path
--interactive Allow prompts with machine output
-q, --jq expression Filter JSON output using a jq expression; implies --json
--json fields[="*"] Output JSON with the specified comma-separated fields, or all fields
--no-input Disable prompts and implicit editor/browser interactions
--remote remote Git remote used for repository discovery
-R, --repo OWNER/REPO Select a repository as OWNER/REPO or URL
--sudo user Perform API requests as this user (requires an administrator account)
--user name Account name on the selected instance
-y, --yes Accept confirmations without prompting
```
## SEE ALSO
* [gt org member](../../org/member/index.md): Manage organization membership