raucao
c0e0c730cb
Add a "Writing text for Gitea" section and gotcha rule: compose PR/issue bodies, comments, reviews, release notes and wiki pages as normal paragraphs, without arbitrary line breaks — and unwrap text copied from hard-wrapped commit messages. Cross-reference from pr/issue create and release create.
2.9 KiB
Releases (gt release)
Releases and their assets. gt <cmd> --help is authoritative. Global/repository
selection flags are in SKILL.md.
gt release <command>
asset create delete download edit list publish upload view
release list aliases release ls; release create aliases release new;
release delete aliases release rm.
JSON fields: assets, author, body, created_at, draft, id, prerelease, published_at, tag, target, title, url.
create
gt release create [<tag>] [<file>...] with -t/--title, -n/--notes,
-F/--notes-file, -e/--editor, -d/--draft, -p/--prerelease,
--target branch|commit (for a new tag), --asset File, --verify-tag.
Files after the tag are uploaded as assets; the title defaults to the tag.
Without a tag and flags on a terminal, a form asks for the tag, title, notes,
target, and draft/prerelease.
Release notes (-n/--notes-file) are normal paragraphs: do not hard-wrap them
(see SKILL.md's "Writing text for Gitea").
gt never pushes: commits and tags that exist only in your clone are not on
the server, so push them first (git push <remote> <tag>). A tag that exists
only in your clone is refused unless --target says where Gitea creates it;
--verify-tag refuses any tag not on the server yet.
gt release create v1.0.0 dist/tool-linux dist/tool-darwin --notes-file CHANGELOG.md
gt release create v1.1.0-rc1 --target release/1.1 --draft --prerelease --title "1.1 RC 1"
upload / download
upload <tag> <file>... [--name NAME] [--clobber]— an asset of the same name is replaced only with--clobber. JSON per asset:created_at, download_count, id, name, size, url.download [<tag>] [<asset>...] [-A|--archive {zip|tar.gz}] [-p|--pattern glob] [-D|--dir dir] [-O|--output file|-] [--clobber] [--skip-existing]— latest release without a tag;--archivedownloads source code instead.
gt release upload v1.0.0 dist/tool-linux --clobber
gt release download v1.0.0 --pattern '*linux*' --dir dist
gt release download v1.0.0 --archive zip
asset
asset {list|upload|download|edit|delete} — manage assets individually,
addressed by their exact, case-sensitive name or by ID. edit renames.
gt release asset list v1.0.0
gt release asset edit v1.0.0 tool-linux --name gt-linux-amd64
edit / publish / delete / list / view
edit <tag>... [-t title] [-n notes] [-F notes-file] [-e] [-d] [-p] [--tag new-tag] [--target ref]— without flags on a terminal, a form starts from each release's current values and sends only what changed.--tagchanges the tag of a single release.publish <tag>...— publish draft releases.delete <tag>... [--delete-tag] [-y]— the tag stays unless--delete-tag.list [-L n] [--page n],view [<tag>] [-w](latest without a tag).
gt release edit v1.0.0
gt release edit v1.0.0 --title "1.0.0" --notes-file CHANGELOG.md
gt release publish v1.1.0