Codeberg documentation content https://docs.codeberg.org
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Otto Richter ed1ebc8b0d Merge pull request 'Unify SSH and HTTP clone & commit articles (#129)' (#143) from issue-129 into master 3 days ago
assets Expand repo migration guide (#142) 6 days ago
content Merge branch 'master' into issue-129 3 days ago
.eleventy.js Remove Gitea Icons shortcode 1 month ago
.gitignore deploy.sh 10 months ago
CONTRIBUTORS.md how to migrate repositories from one gitea-instance to another (#139) 1 week ago
LICENSE.md Update logo license 1 week ago
README.md Contributor FAQ 9 months ago
deploy.sh Add date and time to deployment script 1 month ago
package-lock.json Bump ws to 7.4.6 and remove node-fetch 6 days ago
package.json Bump ws to 7.4.6 and remove node-fetch 6 days ago

README.md

Codeberg Documentation

This repository contains the documentation for Codeberg, with some code to build it into a static website.

Please have a look into it and consider to help writing the Documentation. This is still very much work-in-progress, the more useful material we collect, the better we can later present it! All contributions are very welcome!

For an introduction on contributing to Codeberg Documentation, please have a look at the Contributor FAQ

Usage

Local Development

If you want to work on the documentation, for example by writing your own articles, the easiest way to do so is to fork the documentation repository and develop locally.

First, run

npm install

to install all dependencies (they will be installed only for this project, not globally). You only have to do this once.

Then run

npm run serve

to start a development web server that by default is listening at http://localhost:8080.

Now you can simply change, add or remove files, save them and the development server should automatically reload all changed pages using the amazing Browsersync.

When you're done, commit your changes to your fork and write a pull request for Codeberg/Documentation. We're happy about every contribution!

Build & Deployment

Like for local development, before building and deploying you first have to install the dependencies (once):

npm install

To build the entire website to the _site directory run

npm run build

Instead, to directly publish the page to Codeberg pages, you can also run

npm run deploy

which includes a call to npm run build.

Technical Information

This website uses Eleventy, a static site generator.

It's supplied as a dev-dependency in package.json and its dependencies are locked with package-lock.json to try to ensure reproducible builds.

License and Contributors

This website (excluding bundled fonts) is licensed under CC BY-SA 4.0. See the LICENSE file for details.

The contributors are listed in CONTRIBUTORS.md.