Inline `code spans` are now mentioned alongsize bold and italics where it makes the most sense to have them, and the preformatted text document has been updated to show the raw Markdown for each example. Each of these documents also cross-references the other, as an aid to the reader.
Several sections in `preformatted-text.md` have been renamed for clarity, with `<a id="old-section-title"></a>` anchors such that inbound links with [fragment identifiers](https://en.wikipedia.org/wiki/URI_fragment#Basics) (direct section links) should not break as a result.
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/805
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Closes#335.
This is my first attempt coding for eleventy/liquid so I'd be happy to get feedback on making the code cleaner or more idiomatic, or just more like the Codeberg style.
Co-authored-by: David Anselmi <danselmi@intecrowd.com>
Co-authored-by: Gusted <postmaster@gusted.xyz>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/780
Reviewed-by: Gusted <gusted@noreply.codeberg.org>
The linter enforced one style but the introduction should show both
styles, add a ignore lint and make it show the other style.
Reported-by: @mahlzahn
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/724
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
It could be useful to have this information in the documentation.
Co-authored-by: bgg <bgg@bombe>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/718
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: bgg <bgg@noreply.codeberg.org>
Co-committed-by: bgg <bgg@noreply.codeberg.org>
Fixes#646
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/647
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Jan Koll <jan.niklas.koll@gmail.com>
Co-committed-by: Jan Koll <jan.niklas.koll@gmail.com>
This adds a small section to the markdown link section of the docs to also outline the `[[ link ]]` syntax that is supported in markdown texts that are rendered to html.
Closes#524.
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/638
Reviewed-by: Robert Wolff <mahlzahn@posteo.de>
Co-authored-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
Co-committed-by: Bastian Greshake Tzovaras <bgreshake@googlemail.com>
# Changelog
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
## Changed
- Refactor tables to respect `indent_size = 1`.
## Fixed
- Tables with `<tr>` and `<td>` tags in wrong ending order.
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/627
Reviewed-by: Bastian Greshake Tzovaras <gedankenstuecke@noreply.codeberg.org>
Co-authored-by: Javier Pérez <walpo@noreply.codeberg.org>
Co-committed-by: Javier Pérez <walpo@noreply.codeberg.org>
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#152Resolves#368
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/488
Co-authored-by: Gusted <postmaster@gusted.xyz>
Co-committed-by: Gusted <postmaster@gusted.xyz>
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>
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>
Where possible, changed all references from Gitea to Forgejo.
Wherever documentation mentions specifically Gitea, it is preserved.
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/322
Co-authored-by: f0sh <f0sh@mailbox.org>
Co-committed-by: f0sh <f0sh@mailbox.org>
Tried to close some open issues in the issue tracker by submitting the following changes as my first contribution to Codeberg:
- added list on every section index page, should fix#63
- added webhooks documentation, should fix#282
- described behaviour of a limited user profile, should fix#279
- added further explanation to 2fa section, according to Codeberg/Documentation#268, should fix#268
- added codeberg badge generator to first-repository description, should fix#39
- added dns record description to custom-domains, should fix#302
- added description how to use 2fa with git, should fix#278
- added and updated repo migration service description, should fix#312
Feedback highly appreciated.
Co-authored-by: f0sh <f0sh@mailbox.org>
Co-authored-by: Panagiotis "Ivory" Vasilopoulos <git@n0toose.net>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/314
Co-authored-by: f0sh <f0sh@noreply.codeberg.org>
Co-committed-by: f0sh <f0sh@noreply.codeberg.org>
Changes:
* Fallback images links are all lowercase now.
* Fix html redirect (meta tag http-equiv redirect) from ```/git/clone-commit-via-http ```to ```/git/clone-commit-via-web```.
* Added protocol to an email link.
* Fix some pages links.
To detect broken links I used wget:
```
wget --spider --recursive --level=0 --debug -e robots=off --base=http://localhost:8080http://localhost:8080 2>&1 | grep ^Found\ [0-9]*\ broken\ link
```
However, wget detects html redirects (meta tag http-equiv refresh) as false positive.
If broken links have found, then the referer header will be searched for find out where they are:
```
wget --spider --recursive --level=0 --save-headers --debug -e robots=off --base=http://localhost:8080http://localhost:8080 2>&1 | less
```
Co-authored-by: fsologureng <sologuren@estudiohum.cl>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/267
Co-authored-by: Felipe Leopoldo Sologuren Gutiérrez <fsologureng@noreply.codeberg.org>
Co-committed-by: Felipe Leopoldo Sologuren Gutiérrez <fsologureng@noreply.codeberg.org>
Add initial version of a Markdown documentation to explain Markdown to new contributors. Also provides a styleguide to guide to a consistent use of the Markdown markup within Codeberg.
Fixes#59
Co-authored-by: Jan Klippel <c0d3b3rg@kl1pp3l.de>
Reviewed-on: https://codeberg.org/Codeberg/Documentation/pulls/221
Co-authored-by: jklippel <jklippel@noreply.codeberg.org>
Co-committed-by: jklippel <jklippel@noreply.codeberg.org>
