Press / to focus
Codeberg Documentation

Getting Started with Codeberg
What is Codeberg? Your First Steps on Codeberg Install Git Your First Repository The Basics of Issue Tracking Integrated Wiki Email Settings Licensing on Codeberg Frequently Asked Questions
Collaborating with Others
Citable Code Pull requests and Git flow Invite Collaborators Create and Manage an Organization Repository Permissions Resolve Conflicts
Working with Git Repositories
Using .gitignore Configuring Git Clone & Commit via CLI Clone & Commit via Web Merge multiple commits into one Tags and Releases Working with large files
Writing in Markdown
Introduction to Markdown Using Links Topics Preformatted Text Using Images Using Lists Tables in Markdown Markdown FAQ
Security
Setting up two-factor authentication Adding an SSH key to your account Verifying you're connected to Codeberg using SSH fingerprints Adding a GPG key to your account
Codeberg Pages
Using Custom Domains Troubleshooting Example: Docs as Code with Sphinx Pushing output from SSGs into Codeberg Pages Redirects
Advanced Usage
Using Webhooks Generating an Access Token Migrating Repositories
Working with Codeberg's CI
Using Forgejo Actions (Self-hosted)
Integrations with Other Services
Integrating with Keycloak Integrating with Matrix Integrating with Read the Docs
Codeberg Translate
Getting started Manual Component configuration Introduction to Weblate
Improving Codeberg
Contributing Code
Improving the Documentation
Style Guide How to create a new article? Can I preview my article? How to make screenshots for Codeberg Documentation? Documentation Contributor FAQ
Contact

Manual Component configuration

This article will teach how, how to manually configure a Weblate component, in case, it's not working automatically. You will not need this in most cases.

What is monolingual and bilingual?

Weblate differs into 2 translation formats: monolingual and bilingual.

Bilingual

Bilingual means, that the source text live inside the code. See for example the following example from gettext:

printf(_("This is some text"))

That means you have language file for the source text. Rather, the source text is in all translation files itself as reference.

Monolingual

With Monolingual, you have a extra translation file for your source language.

Where can I find these Options:

When creating a new Component, you will land on a Page where you can enter them. For existing Components, go to the Component Manage>Settings>Files.

Configuration options

You have the following options to configure the component: File format: Choose one of the available formats File mask: This is the path, in which your translations will be placed * is the placeholder for the language. e.g. if you enter translations/*.ts, a German translation would be placed as translations/de.ts. Monolingual base language file: If you have a Monolingual format, enter the path to your source file here. If not, leave empty. Edit base file: If you enable this, the source file can be edited in Weblate. If not ticked, it is read only in Weblate. Only available for monolingual formats. Adding new translation: You can choose, what happens, if a User wan's to add a new language. The Options should be self-explanatory. Template for new translations: If you choose "Create new language file" in the Box above, this file will be used as a template.

Hey there! 👋 Thank you for reading this article!

Is there something missing, or do you have an idea on how to improve the documentation? Do you want to write your own article?

You're invited to contribute to the Codeberg Documentation at its source code repository, for example, by adding a pull request or joining in on the discussion in the issue tracker.

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

© Codeberg Docs Contributors. See LICENSE