gitea/gitea-docs
1
0
Fork 0
mirror of https://gitea.com/gitea/docs.git synced 2026-06-23 04:35:56 +00:00
Code Issues Packages Projects Releases Wiki Activity
975 Commits 3 Branches 5 Tags
94947e2be5c8fa96cebe4e49294038be7248a649
Commit Graph

961 Commits

Author SHA1 Message Date
Giteabot
94947e2be5 Correctly refer to dev tags as nightly in the docker docs (#26004) (#26017) 
Co-authored-by: John Olheiser <john.olheiser@gmail.com>
 2023-07-20 10:50:33 -05:00
Giteabot
10c7906836 Add link to support page for commercial support (#25293) (#25299) 
Backport #25293 by @techknowlogick

Co-authored-by: techknowlogick <techknowlogick@gitea.io>
 2023-06-16 14:19:26 +08:00
HesterG
d7361ef460 Fix broken links in documents v1.19 (#25142) 
Partially port #24630
 2023-06-08 16:45:29 +08:00
HesterG
37748c6364 Change branch name from master to main in some documents' links (#25126) (#25139) 
Backport #25126

As title. And needs to backport to 1.19
 2023-06-08 04:31:55 -04:00
sillyguodong
849dc1b5f8 add zh-cn for Upgrade from old Gitea in v1.19 (#25022) 
as title

---------

Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
 2023-06-06 11:39:53 -04:00
techknowlogick
0aef2dcb7d update labels link to correct location in 1.19 docs (#25105) 2023-06-06 11:29:16 -04:00
Giteabot
9d5cf12f82 improve permission documentation (#23942) (#25078) 2023-06-05 18:04:59 +08:00
HesterG
f620ccfe37 Add oauth Chinese document for v1.19 (#25020) 2023-06-02 10:52:53 -04:00
HesterG
a732bed8ba Port Chinese document for localization to v1.19 (#25021) 2023-06-02 10:49:33 -04:00
silverwind
7b1a6ed3cb Run markdownlint on drone, fix lint issue (#25040) 
It currently does not run on 1.19 branch, resulting in lint error having
landed in https://github.com/go-gitea/gitea/pull/25016.
 2023-06-01 10:34:40 -05:00
sillyguodong
79ef670d16 Add chinese documentations for Packages (#24914) (#25016) 
backport: #24914
 2023-05-31 15:55:01 +08:00
sillyguodong
907dfa511f Add chinese documentations for installation (#24904) (#25015) 
backport #24904
 2023-05-31 14:17:19 +08:00
HesterG
81648926de Add Chinese docs for help, contribution and development (#24925) (#25011) 
Backport #24925, partially backport #24934
(`docs/content/doc/help/faq.zh-cn.md` file)

Part of backport has already done by #24942

Also backport #24881 to avoid "deadlock"

---------

Co-authored-by: Zettat123 <zettat123@gmail.com>
 2023-05-31 14:12:37 +08:00
HesterG
f99f92385e Unify doc links to use paths relative to doc folder (#24979) (#25000) 
Backport #24979 

Changes:

1. Use uniform links types relative to doc folder (start with `doc/`)
2. According to [docusaurus
links](https://docusaurus.io/docs/markdown-features/links), if `<a>` is
used, the `href` is resolved as URL location, but not file location. So
need to use `[text]({{< relref "path" >}})` instead.
 2023-05-30 18:08:32 +08:00
HesterG
642bd3ea29 Remove unnecessary content on docs (#24976) (#25001) 
Backport #24976
 2023-05-30 17:21:03 +08:00
Giteabot
fcb1d63349 Update from-binary.en-us.md (#24975) (#24999) 
Backport #24975 by @team-epk

Fixed link to the creating a systemd service in Ubuntu document.
 2023-05-30 14:01:06 +08:00
Giteabot
bfe15353dd zh-cn translation for usage docs (#24897) (#24977) 
Backport #24897 by @Zettat123

- [x] agit-support
- [x] clone-filter
- [x] incoming-email
- [x] labels
- [x] linked-references
- [x] merge-message-templates
- [x] permissions
- [x] profile-readme
- [x] protected-tags
- [x] push
- [x] repo-mirror
- [x] secrets
- [x] template-repositories
- [x] webhooks

Co-authored-by: Zettat123 <zettat123@gmail.com>
 2023-05-29 11:53:11 +08:00
Giteabot
c1eb5de177 simple docs fixes: 'pull request' page (en-us & zh-tw) link path to 'issue-pull-request-templates' (#24961) (#24970) 
Backport #24961 by @jonkeim

Co-authored-by: Jon Keim <jon@windless.org>
Co-authored-by: silverwind <me@silverwind.io>
 2023-05-28 21:51:53 -04:00
Giteabot
b0e85b0caf Remove reference to caddy v1 in docs (#24962) (#24964) 
Backport #24962 by @techknowlogick

caddy v1 is loong eol. v2 should be used.

Co-authored-by: techknowlogick <techknowlogick@gitea.io>
 2023-05-28 05:34:50 -04:00
HesterG
2eafb7c224 Fix doc for 1.19 backend guideline (#24942) 
Port the file change in
https://github.com/go-gitea/gitea/pull/24925/files from `main` to
`v1.19` to fix docs
 2023-05-26 17:22:38 +08:00
Giteabot
67852ef2a3 Merge two translation contributing documents (#23939) (#24933) 
Backport #23939 by @lunny

This PR also adjusts the weights.

Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: delvh <dev.lh@web.de>
 2023-05-25 12:07:25 -04:00
Lunny Xiao
8e403bec0d Remove unnecessary prefix usage (#24888) 
Since now all articles have a class, the `Usage:` is unnecessary. This
PR will remove them.
 2023-05-24 00:34:31 +08:00
Giteabot
9e4eee76ad Fix docs documenting invalid @every for OLDER_THAN cron settings (#24695) (#24698) 
Backport #24695 by @yardenshoham

Looks like a copy-paste leftover

- Fixes #20868

Co-authored-by: Yarden Shoham <git@yardenshoham.com>
 2023-05-13 23:47:56 +08:00
Giteabot
77f6ee63ef Don't set meta theme-color by default (#24340) (#24346) 
Backport #24340 by @silverwind

Fixes https://github.com/go-gitea/gitea/issues/24321. By not setting
this meta tag, Safari will use body color for chrome and out-of-viewport
areas, which looks much better then static mismatching green.

As per
[MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/meta/name/theme-color)
it's really only Apple browsers who still support this tag, most others
have dropped support.
 
Before:
<img width="347" alt="Screenshot 2023-04-25 at 19 59 13"
src="https://user-images.githubusercontent.com/115237/234363180-0fe667ef-5469-4f5f-b31a-c9d73aff10ac.png">

After:
<img width="361" alt="Screenshot 2023-04-25 at 20 00 00"
src="https://user-images.githubusercontent.com/115237/234363185-e2d2b62f-0133-4316-944d-b614ffb84eb0.png">

Co-authored-by: silverwind <me@silverwind.io>
 2023-04-26 01:33:15 -04:00
Giteabot
3b5d7f8d06 Update documentation to explain which projects allow Gitea to host static pages (#23993) (#24058) 
Backport #23993 by @6543

close  #23521

Signed-off-by: 6543 <6543@obermui.de>
Co-authored-by: 6543 <6543@obermui.de>
Co-authored-by: delvh <dev.lh@web.de>
Co-authored-by: a1012112796 <1012112796@qq.com>
Co-authored-by: wxiaoguang <wxiaoguang@gmail.com>
 2023-04-11 18:43:35 +02:00
Lunny Xiao
5a393dfbac Merge push to create, open PR from push, and push options docs articles into one (#23744) (#23959) 
backport #23744
 2023-04-07 15:49:26 +08:00
Giteabot
364adca848 docs: make the required backticks in email password more explicit (#23923) (#23926) 
Backport #23923 by @teauxfu

updated the example config to make the needed backticks around the
password more obvious

Co-authored-by: alex <alexmw777@gmail.com>
 2023-04-04 15:06:54 -04:00
Giteabot
dd7dafa72e docs: fix typo (#23924) (#23925) 
Backport #23924 by @teauxfu

fixes a minor typo in the email templates page

Co-authored-by: alex <alexmw777@gmail.com>
 2023-04-04 18:13:09 +02:00
Lunny Xiao
a8a999a709 Update docs markdown file weight to make it clear (#23909) (#23921) 
backport #23909
 2023-04-04 11:27:38 -04:00
Giteabot
dc192247ad Rename actions unit to repo.actions and add docs for it (#23733) (#23881) 
Backport #23733 by @wolfogre

I neglected that the `NameKey` of `Unit` is not only for translation,
but also configuration. So it should be `repo.actions` to maintain
consistency.

## ⚠️ BREAKING ⚠️

If users already use `actions.actions` in `DISABLED_REPO_UNITS` or
`DEFAULT_REPO_UNITS`, it will be treated as an invalid unit key.

Co-authored-by: Jason Song <i@wolfogre.com>
 2023-04-03 12:54:36 +02:00
wxiaoguang
7e8c5930ef Add ONLY_SHOW_RELEVANT_REPOS back, fix explore page bug, make code more strict (#23766) (#23791) 
Follow #21962

After I eat my own dogfood, I would say that
ONLY_SHOW_RELEVANT_REPOS=false is necessary for many private/enterprise
instances, because many private repositories do not have
"description/topic", users just want to search by their names.

This PR also adds `PageIsExploreRepositories` check, to make code more
strict, because the `search` template is shared for different purpose.

And during the test, I found a bug that the "Search" button didn't
respect the "relevant" parameter, so this PR fixes the bug by the way
together.
 2023-03-30 09:09:22 -05:00
wxiaoguang
92f0f923ee Make minio package support legacy MD5 checksum (#23768) (#23770) 
Backport #23768 (no source code conflict, only some unrelated
docs/test-ini conflicts)

Some storages like:

 * https://developers.cloudflare.com/r2/api/s3/api/
 * https://www.backblaze.com/b2/docs/s3_compatible_api.html

They do not support "x-amz-checksum-algorithm" header

But minio recently uses that header with CRC32C by default. So we have
to tell minio to use legacy MD5 checksum.
 2023-03-29 00:02:13 +08:00
Giteabot
0e6875c888 Fix codeblocks in the cheat sheet (#23664) (#23669) 
Backport #23664 by @SuperSandro2000

Conflicts fixed by Andrew Thornton <art27@cantab.net>

Co-authored-by: Sandro <sandro.jaeckel@gmail.com>
Co-authored-by: Andrew Thornton <art27@cantab.net>
 2023-03-23 16:50:56 -04:00
Lunny Xiao
a6ff89b930 Rename develop -> development, contribute -> contributing, administer -> administration (#23662) 
backport #23629 

To make versioned documentation less surprising, 1.19 should have the
same technology.
 2023-03-23 15:44:09 -05:00
Giteabot
b94e932ec9 Add .patch to attachment.ALLOWED_TYPES (#23580) (#23582) 
Backport #23580 by @silverwind

Updated this default to GitHub's latest, adding the `.patch` file
extension to allowed types.

Co-authored-by: silverwind <me@silverwind.io>
 2023-03-19 16:48:44 -04:00
silverwind
a3cbf6aae9 Replace Less with CSS (#23508) 
Backport https://github.com/go-gitea/gitea/pull/23481,
https://github.com/go-gitea/gitea/pull/23504 and
https://github.com/go-gitea/gitea/pull/23520 to 1.19, just so we have an
easier time with future backports.

Seems to work on a basic level. There was a merge conflict in
`RepoActionView.vue`, otherwise it merged cleanly.

---------

Co-authored-by: John Olheiser <john.olheiser@gmail.com>
Co-authored-by: Lauris BH <lauris@nix.lv>
 2023-03-16 21:04:39 -04:00
Giteabot
47e1119416 Scoped label display and documentation tweaks (#23430) (#23433) 
Backport #23430 by @brechtvl

* Fix scoped label left and right part breaking across lines.
* Remove slanted divider in scoped label display, make it straight.
After using this for a while, this feels more visually noisy than
helpful.
* Reduce contrast between scope and item to reduce probability of
unreadable text on background.
* Change documentation to remove mention of non-exclusive scoped labels.

Co-authored-by: Brecht Van Lommel <brecht@blender.org>
Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: John Olheiser <john.olheiser@gmail.com>
 2023-03-15 07:58:38 +08:00
Giteabot
f9339a190f Support reflogs (#22451) (#23438) 
Backport #22451 by @philip-peterson

This PR adds support for reflogs on all repositories. It does this by
adding a global configuration entry.

Implements #14865

Signed-off-by: Philip Peterson <philip.c.peterson@gmail.com>
Co-authored-by: Philip Peterson <philip-peterson@users.noreply.github.com>
 2023-03-13 12:20:10 +00:00
Giteabot
923ed995cd Update documentation for the new YAML label file format (#23020) (#23341) 
Backport #23020

update documentation to include an overview of the yaml label template
that is part of PR #22976

Signed-off-by: Jon Roadley-Battin <jon.roadleybattin@gmail.com>

Co-authored-by: JonRB <4564448+eeyrjmr@users.noreply.github.com>
Co-authored-by: Yarden Shoham <hrsi88@gmail.com>
Co-authored-by: Lauris BH <lauris@nix.lv>
Co-authored-by: John Olheiser <john.olheiser@gmail.com>
Co-authored-by: delvh <dev.lh@web.de>
 2023-03-06 17:52:29 -06:00
Giteabot
7ce7128fb3 Update hacking-on-gitea-zh_cn documentation (#23315) (#23323) 
Backport #23315

This PR fix outdated hacking-on-gitea-zh_cn documentation.

Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
Co-authored-by: Jason Song <i@wolfogre.com>
 2023-03-06 18:44:02 +08:00
Giteabot
bcb3c229f8 Add basic documentation for labels, including scoped labels (#23304) (#23309) 
Backport #23304

Part of #22974

Co-authored-by: Brecht Van Lommel <brecht@blender.org>
Co-authored-by: delvh <dev.lh@web.de>
 2023-03-05 20:38:46 +08:00
Giteabot
e539b056b5 Re-add accidentally removed hacking-on-gitea.zh-cn.md (#23297) (#23305) 2023-03-04 20:09:58 -05:00
Yarden Shoham
8e9f3e54c3 Add InsecureSkipVerify to Minio Client for Storage (#23166) (#23177) 
Backport #23166

Allows using Minio with untrusted certificates

Closes #23128

Signed-off-by: Yarden Shoham <hrsi88@gmail.com>
Co-authored-by: techknowlogick <techknowlogick@gitea.io>
 2023-02-28 00:29:17 +02:00
Yarden Shoham
6edc050d23 Fix secrets overview page missing from docs sidebar (#23143) (#23145) 
Backport #23143

There was a warning while building the docs: `Building sites … WARN
2023/02/25 08:56:37
"/workspace/gitea/docs/content/doc/secrets/overview.en-us.md:1:1":
duplicate menu entry with identifier "overview" in menu "sidebar"`.

### Before

![image](https://user-images.githubusercontent.com/20454870/221348741-55cef254-f2ac-4507-9a66-818b406c668f.png)

### After

![image](https://user-images.githubusercontent.com/20454870/221348757-42066303-e1b7-43fe-9c4f-e05182fbabdd.png)

Signed-off-by: Yarden Shoham <hrsi88@gmail.com>
 2023-02-25 13:30:32 +02:00
Yarden Shoham
a4c41ff6a2 Nest metadata in refactoring docs (#23087) (#23091) 
Backport #23087

Whitespace was missing from refactoring docs metadata.

backport label applied so it is included in versioned docs.

Co-authored-by: techknowlogick <techknowlogick@gitea.io>
 2023-02-23 03:39:30 -05:00
zeripath
99f54b2056 Add Bash and Zsh completion scripts (#22646) 
This PR adds contrib scripts for bash and zsh completion.

Simply call:

```bash
source contrib/autocompletion/bash_autocomplete
```

or for Zsh:

```bash
source contrib/autocompletion/zsh_autocomplete
```

Signed-off-by: Andrew Thornton <art27@cantab.net>

---------

Signed-off-by: Andrew Thornton <art27@cantab.net>
Co-authored-by: a1012112796 <1012112796@qq.com>
Co-authored-by: techknowlogick <techknowlogick@gitea.io>
 2023-02-21 12:32:24 -05:00
wxiaoguang
d1c91610eb Improve frontend guidelines (#23007) 
Some were out-dated, some are added.
 2023-02-21 14:13:37 +08:00
wxiaoguang
06b966c6f8 Add some guidelines for refactoring (#22880) 
Just some brief ideas.

Feel free to complete these guidelines, feel free to edit on this PR
directly.
 2023-02-19 21:25:23 +08:00
zeripath
81543c48ca Provide the ability to set password hash algorithm parameters (#22942) 
This PR refactors and improves the password hashing code within gitea
and makes it possible for server administrators to set the password
hashing parameters

In addition it takes the opportunity to adjust the settings for `pbkdf2`
in order to make the hashing a little stronger.

The majority of this work was inspired by PR #14751 and I would like to
thank @boppy for their work on this.

Thanks to @gusted for the suggestion to adjust the `pbkdf2` hashing
parameters.

Close #14751

---------

Signed-off-by: Andrew Thornton <art27@cantab.net>
Co-authored-by: delvh <dev.lh@web.de>
Co-authored-by: John Olheiser <john.olheiser@gmail.com>
Co-authored-by: Lunny Xiao <xiaolunwen@gmail.com>
 2023-02-19 15:35:20 +08:00
wxiaoguang
5f9636870e Refactor hiding-methods, remove jQuery show/hide, remove .hide class, remove inline style=display:none (#22950) 
Close #22847

This PR:

* introduce Gitea's own `showElem` and related functions
* remove jQuery show/hide
* remove .hide class
* remove inline style=display:none 

From now on:

do not use:
* "[hidden]" attribute: it's too weak, can not be applied to an element
with "display: flex"
* ".hidden" class: it has been polluted by Fomantic UI in many cases
* inline style="display: none": it's difficult to tweak
* jQuery's show/hide/toggle: it can not show/hide elements with
"display: xxx !important"

only use:
* this ".gt-hidden" class
* showElem/hideElem/toggleElem functions in "utils/dom.js"

cc: @silverwind , this is the all-in-one PR
 2023-02-19 12:06:14 +08:00