Commit graph

391 commits

Author SHA1 Message Date
Panagiotis "Ivory" Vasilopoulos
3374948e11 Keycloak: Add organization owner note (#604)
Fixes https://codeberg.org/Codeberg/Documentation/issues/541

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/604
2025-05-27 18:31:30 +02:00
Alex
6c4867c76c codeberg-translate: describe direct push config option (#481)
Weblate can also be configured to push directly to the Codeberg repo
but that requires adding the `translate` user as a collaborator in the
respective repo.

Also use this opportunity to improve grammar/formulations.

Closes: #324

Co-authored-by: Gusted <postmaster@gusted.xyz>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/481
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Alex <alex@puer-robustus.eu>
Co-committed-by: Alex <alex@puer-robustus.eu>
2025-04-29 20:45:41 +00:00
yaroze
3468da80a4 Update documentation for enabling Forgejo Actions (#590)
Clarified where the user should Forgejo Actions.

Thanks to @gusted:matrix.org

Co-authored-by: plfarinha <plfarinha@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/590
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: yaroze <yaroze@noreply.codeberg.org>
Co-committed-by: yaroze <yaroze@noreply.codeberg.org>
2025-04-29 20:38:52 +00:00
Bene
20e5862bcf Pages: Add a warning that the availability is only best effort (#585)
I'm approaching the "transparency" proposal by @fnetX in Codeberg-e.V./Discussion#124

This should set the expectations of users using this feature to a more realistic setting (at least if they read the documentation). If this MR gets accepted, we can adapt the landing page afterward to include the same text.

cc @crapStone

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/585
Reviewed-by: Otto <otto@codeberg.org>
Reviewed-by: crapStone <codeberg@crapstone.dev>
Co-authored-by: Bene <bene64@posteo.de>
Co-committed-by: Bene <bene64@posteo.de>
2025-04-24 20:32:36 +00:00
crystal
9a55f7bf8b update Codeberg Pages IP addresses (#556)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/556
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: crystal <crystal@noreply.codeberg.org>
Co-committed-by: crystal <crystal@noreply.codeberg.org>
2025-04-23 13:43:54 +00:00
Gusted
ca2f628ce4 ci: update link (#551)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/551
2025-03-26 00:44:44 +00:00
ninthcircle
8649e50afa
fix: update instructions for adding custom key path in ssh-keygen (#535) 2025-02-22 21:17:35 +05:30
Panagiotis "Ivory" Vasilopoulos
89d1b10f9f Remove link to Codeberg chatroom (#529)
It is not possible to join the room directly anymore.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/529
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-committed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
2025-02-05 08:16:21 +00:00
DeanLemans
8e0c2ce042 Forgejo is a hard-fork now (#526)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/526
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: DeanLemans <deanlemans@noreply.codeberg.org>
Co-committed-by: DeanLemans <deanlemans@noreply.codeberg.org>
2025-01-30 13:51:49 +00:00
Gusted
b6438bfbd9 fix: update instructions to enabling the wiki
Update the wiki instructions to reflect the UI changes from forgejo/forgejo#2221

Resolves #520
2025-01-24 05:33:09 +00:00
Gusted
f169569807 chore: disable avif transcoding (#495)
The trade-off is not worth it, it isn't *that* good for screenshots and
it uses too much memory and increases build time by a order of magnitude

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/495
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
2024-11-30 13:13:22 +00:00
Gusted
03342e98ec feat: use Eleventy's image plugin for image transformation (#488)
Use https://www.11ty.dev/docs/plugins/image/ to transform images on build time to avif, webp and jpeg.

Images are moved to `/content/images`.

`<picture>` is no longer needed, the plugin does this automatically.

Remove webp images from the source.

Resolves #152
Resolves #368

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/488
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
2024-11-29 06:12:05 +00:00
Clea F. Rees
8e6ea413b1 Avoid conflicts if local source tree already exists (#489)
Add instructions for when you already have a local source tree.

Co-authored-by: Clea F. Rees <ReesC21@cardiff.ac.uk>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/489
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Clea F. Rees <cfr@noreply.codeberg.org>
Co-committed-by: Clea F. Rees <cfr@noreply.codeberg.org>
2024-11-28 20:28:00 +00:00
Gusted
87c587f7bc Add CAA record value (#486)
Resolves #469

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/486
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
2024-11-27 02:49:34 +00:00
FedericoCeratto
7c674730eb Add link to https://codeberg.org/actions/meta (#483)
Update doc to reflect the introduction of hosted Actions

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/483
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: FedericoCeratto <federico.ceratto@posteo.com>
Co-committed-by: FedericoCeratto <federico.ceratto@posteo.com>
2024-11-27 00:51:50 +00:00
Gusted
b66ba78d58 Update links (#484)
Update Gitea link to Forgejo link.

Add GNU link to ignore.

Remove recommendation for Atom (no longer maintained) instead recommend VSCodium.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/484
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
2024-11-27 00:40:44 +00:00
egnun
3bd7c665c7 Updated paragraph "Telling Git about your SSH key" (#470)
I don't know, if it makes a difference, but  for the "user.signingKey" option it should probably say "<PATH TO PUBLIC SSH KEY>".

The official git documenation says, that git expects a public key.
https://git-scm.com/docs/git-config#Documentation/git-config.txt-gpgsshdefaultKeyCommand

Also some other guides use the public key:
https://blog.dbrgn.ch/2021/11/16/git-ssh-signatures/
https://dev.to/ccoveille/git-the-complete-guide-to-sign-your-commits-with-an-ssh-key-35bg

So, I updated the paragraph accordingly.

Signed-off-by: egnun <egnun@mailbox.org>

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/470
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: egnun <egnun@mailbox.org>
Co-committed-by: egnun <egnun@mailbox.org>
2024-08-19 22:39:01 +00:00
r12t
24dde65bd4 Fix custom dns CNAME record (#457)
Fixes #456

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/457
Reviewed-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: r12t <r12t@noreply.codeberg.org>
Co-committed-by: r12t <r12t@noreply.codeberg.org>
2024-07-29 08:02:10 +00:00
hippietrail
37d56479d6 Some English fixes (#450)
- The danger are low→The danger is low
- on own hardware→on our own hardware
- rackspace→rack space
- awareness on the topic→awareness of the topic

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/450
Reviewed-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: hippietrail <hippietrail@noreply.codeberg.org>
Co-committed-by: hippietrail <hippietrail@noreply.codeberg.org>
2024-07-29 07:59:01 +00:00
Eric
0cf4c81ed3 Update content/ci/actions.md (#423)
Update version of runner from 3.3.0 to 3.4.0

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/423
Reviewed-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: Eric <eric@pedr0.net>
Co-committed-by: Eric <eric@pedr0.net>
2024-07-29 07:58:26 +00:00
newur
7774ef9d62 Add EPC QR code for donations (#436)
The QR code is based on the EPC standard: https://en.wikipedia.org/wiki/EPC_QR_code

I created it via qr-code-generator dot com.

Just an idea :)

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/436
Reviewed-by: Otto <otto@codeberg.org>
Co-authored-by: newur <newur@mailbox.org>
Co-committed-by: newur <newur@mailbox.org>
2024-06-18 14:50:15 +00:00
Mark Pitblado
193b4cf639 Define acronyms on first use, add reference to codeberg-ci/examples, and remove reference to knut org (#435)
- All acronyms should be defined in first use. This adds this for Continuous Integration (CI) and Role Based Access Control (RBAC).
- Changes language around acceptance to soften tone, and shift from guaranteed to conditional acceptance.
- Specifies that login to woodpecker-ci is via codeberg account, and that repositories are automatically available to link.
- Adds reference to codeberg-ci/examples repository.
- Removes reference to knut organization.

Co-authored-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/435
Reviewed-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: Mark Pitblado <mark@pitblado.me>
Co-committed-by: Mark Pitblado <mark@pitblado.me>
2024-06-12 20:02:39 +00:00
pat-s
74e8925bec add spellchecker (#439)
fix #148

Adds a spell checker via `cspell` and fixes some spelling issues in the docs.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/439
Co-authored-by: pat-s <patrick.schratz@gmail.com>
Co-committed-by: pat-s <patrick.schratz@gmail.com>
2024-06-12 10:20:37 +00:00
niko4u
1b84cd41a4 Minor rewording (#428)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/428
Reviewed-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Co-authored-by: niko4u <niko4u@noreply.codeberg.org>
Co-committed-by: niko4u <niko4u@noreply.codeberg.org>
2024-06-12 08:57:35 +00:00
pat-s
3cab99a27f
fix liberapay lint issues and broken link 2024-06-12 10:25:04 +02:00
fnetX
c6c7b418e7 Fix typo
Build was failing. This was overlooked, because CI was only added after the PR was last updated.
2024-06-11 11:51:51 +00:00
Igor
0d872ea674 Integrating LiberaPay with Codeberg (#406)
This should resolve issue #327 opened by @n0toose

I have written a little bit of example, how do I see it

Co-authored-by: I <igor@its.rel.pl>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/406
Co-authored-by: Igor <309631@noreply.codeberg.org>
Co-committed-by: Igor <309631@noreply.codeberg.org>
2024-06-11 11:47:25 +00:00
crapStone
da1b77aa6a Add woodpecker ci & many linters (and their required fixes) (#377)
closes #238

Co-authored-by: pat-s <patrick.schratz@gmail.com>
Co-authored-by: Patrick Schratz <pat-s@noreply.codeberg.org>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/377
Co-authored-by: crapStone <crapstone01@gmail.com>
Co-committed-by: crapStone <crapstone01@gmail.com>
2024-06-11 07:51:22 +00:00
Sammy Hori
8bd521c7f6 Codeberg Pages: Add warning for setting up records on some registrars (#431)
Many users setting up Codeberg Pages that use the records have limited experience with DNS.

Therefore, adding this warning to make it clear what they may need to be entering into
their records will likely save them time and effort in troubleshooting why their page may
not be loading correctly.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/431
Co-authored-by: Sammy Hori <sammyhori@noreply.codeberg.org>
Co-committed-by: Sammy Hori <sammyhori@noreply.codeberg.org>
2024-06-09 14:23:36 +00:00
adbagio
79d2ac2682 Getting Started: Add detail to use of git push --mirror (#422)
Based on discussion in the Forgejo repository (#2834)

See: https://codeberg.org/forgejo/forgejo/pulls/2834

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/422
Co-authored-by: adbagio <h759bkyo4@mozmail.com>
Co-committed-by: adbagio <h759bkyo4@mozmail.com>
2024-06-07 11:05:44 +00:00
adagio
ca0475ad93 Updates styleguide wording and terminology (#429)
Based on https://codeberg.org/forgejo/forgejo/issues/3844

Equivalent PR in the Forgejo documentation: https://codeberg.org/forgejo/docs/pulls/681

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/429
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: adagio <h759bkyo4@mozmail.com>
Co-committed-by: adagio <h759bkyo4@mozmail.com>
2024-06-05 08:09:38 +00:00
Abdur-Rahman Mansoor
8e0118c9c5
refactor: use american spelling convention and fix grammar 2024-05-24 20:51:47 -04:00
Skye
51da37c7d4 Pedantic capitalization changes to brand names (#425)
Some instances of Github and Gitlab have been changed to GitHub and GitLab
respectively.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/425
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: Skye <skyeforeverblue@outlook.com>
Co-committed-by: Skye <skyeforeverblue@outlook.com>
2024-05-19 21:24:00 +00:00
Sergey Volkov
d475852dc2 Add SSH commit signing content (#420)
Add the SSH commit signing section to the SSH key management page. Git has had this feature for a while now and SSH keys are easier to manage since they can be used for both authentication and signing, so I think it makes sense to document this.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/420
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: Sergey Volkov <ser121512@yandex.ru>
Co-committed-by: Sergey Volkov <ser121512@yandex.ru>
2024-05-16 13:55:48 +00:00
0ko
60d471874b Improve contact/support information 2024-04-10 22:43:53 +05:00
Andrew Kvalheim
0b3c45ce4b Detect slash key by value, not physical position (#415)
The solution is trivial; read the [property](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent#instance_properties) for actual meaning instead of physical position.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/415
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: Andrew Kvalheim <andrew@kvalhe.im>
Co-committed-by: Andrew Kvalheim <andrew@kvalhe.im>
2024-04-03 12:12:54 +00:00
Igor
91bc7ec69f added notes about obtaining webp (#408)
Resolves #407

Co-authored-by: I <igor@its.rel.pl>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/408
Reviewed-by: Otto <otto@codeberg.org>
Co-authored-by: Igor <309631@noreply.codeberg.org>
Co-committed-by: Igor <309631@noreply.codeberg.org>
2024-04-03 11:51:57 +00:00
Gusted
adf276bea6
pages: Correct statement about CAA record
- Resolves https://codeberg.org/Codeberg/Documentation/issues/413
2024-03-23 22:15:22 +01:00
Panagiotis "Ivory" Vasilopoulos
b9a17086c9 Style Guide: Markdown Code Blocks (#403)
Fixes #401.

Refs: https://codeberg.org/Codeberg/Documentation/issues/401
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/403
Reviewed-by: Leo Heitmann Ruiz <eo@noreply.codeberg.org>
2024-03-12 18:38:42 +00:00
Earl Warren
465aaaa107 CI (Actions): Clarify compatibility & link to the latest docs (#405)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/405
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: Earl Warren <contact@earl-warren.org>
Co-committed-by: Earl Warren <contact@earl-warren.org>
2024-03-12 17:58:13 +00:00
Andre601
7a9017e760 Fix broken link for Git LFS Migrate Man page (#404)
The URL for the man page of Git LFS migrate was broken. This is fixed in this PR.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/404
Co-authored-by: Andre601 <github@andre601.ch>
Co-committed-by: Andre601 <github@andre601.ch>
2024-03-11 12:19:54 +00:00
Panagiotis "Ivory" Vasilopoulos
2ce0c26e3d Pages: Repositories currently have to be public (#395)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/395
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
2024-03-10 16:13:45 +00:00
And4po
d852c5ac0d Getting Started: Fix small typo (#402)
It fixes a small typo on the "First repository" document.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/402
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: And4po <anderromeroaldana@proton.me>
Co-committed-by: And4po <anderromeroaldana@proton.me>
2024-03-06 12:27:05 +00:00
Leo Heitmann Ruiz
364a316007 Remove unnecessary mention of Git Bash (#400)
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/400
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: Leo Heitmann Ruiz <eo@noreply.codeberg.org>
Co-committed-by: Leo Heitmann Ruiz <eo@noreply.codeberg.org>
2024-03-06 10:19:01 +00:00
kouett
85d333f48b Fix typo in sphinx quickstart cmd (#397)
I believe the "pip" in front is extraneous. This is a small change.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/397
Co-authored-by: kouett <lou@ynh.kouett.net.eu.org>
Co-committed-by: kouett <lou@ynh.kouett.net.eu.org>
2024-02-22 12:48:37 +00:00
Otto Richter
d5f6f22999 Refresh Contact, Getting Started, Contributing Pages (#394)
Update contact page

Prefer references to Forgejo, more relevant to users

Updates to Getting Started Pages / FAQ
- a lot of content was outdated and generally rewritten or rephrased
- implement procedure for size limits as determined by annual assembly
  2023, see Codeberg-e.V./Discussion#92
- people are sometimes confused wheter you need to be a paying member in
  Codeberg e.V. in order to use the platform

Update improving Codeberg guides
- reduce redundancy in code contribution guide and reference the
  Contributing Issue Tracker instead
- separate (and ideally more appealing) donation page (deserves even
  more love IMHO)
- shorten and strip outdated information

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/394
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: Otto Richter <git@otto.splvs.net>
Co-committed-by: Otto Richter <git@otto.splvs.net>
2024-02-17 22:04:10 +00:00
thatonecoder
2b85a21e70 Licensing: Licence -> License (#392)
This should make it comply a bit more with the style guide.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/392
Reviewed-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Co-authored-by: thatonecoder <thatonecoder@noreply.codeberg.org>
Co-committed-by: thatonecoder <thatonecoder@noreply.codeberg.org>
2024-02-12 13:14:41 +00:00
Mark Pitblado
8a32b7cec9 Pages: General typo and grammatical fixes (#391)
Main changes include switching language from ISP to domain registrar, and standardization around the phrase "Codeberg Pages".

Signed-off-by: Mark Pitblado <mark@pitblado.me>

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/391
Reviewed-by: crapStone <codeberg@crapstone.dev>
Co-authored-by: Mark Pitblado <mark-pitblado@noreply.codeberg.org>
Co-committed-by: Mark Pitblado <mark-pitblado@noreply.codeberg.org>
2024-02-09 08:18:50 +00:00
ToaKraka
6c2ced0ab3 Remove references to a specific version of CommonMark (#390)
The current text refers to CommonMark 0.30, but the latest version of CommonMark is 0.31.2, and the latest version of GoldMark is compatible with that version of CommonMark.

Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/390
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
Co-authored-by: ToaKraka <toakraka@noreply.codeberg.org>
Co-committed-by: ToaKraka <toakraka@noreply.codeberg.org>
2024-02-06 22:15:06 +00:00
kita
d13287b3a8
fix configuring git link 2024-02-03 13:10:00 +08:00