File AsciiDoc¶

Added in version 5.16.1.

Nota

Support for this format is under development. Some features might not yet be available and the behavior can change between releases. Feedback from testing is welcome.

The translatable content is extracted from the AsciiDoc files and offered for the translation.

Nota

Unlike most other formats, the changes in the translation files will not be imported to Weblate because it can not be done reliably. The source of truth for the translations is Weblate not the translated file.

Vedi anche

AsciiDoc

Example file:

== Ahoj světe!

Orangutan has five bananas.

Try Weblate at https://demo.weblate.org/[weblate.org]!

_Thank you for using Weblate._

Funzionalità supportate¶
Estensioni dei file	`.ad`, `.adoc`, `.asciidoc`
Linguality ⓘ	Monolingual
Supports plural ⓘ	`No`
Supports descriptions ⓘ	`No`
Supports explanation ⓘ	`No`
Supports context ⓘ	`No`
Supports location ⓘ	`No`
Supports flags ⓘ	`No`
API identifier	`asciidoc`
Supports read-only strings ⓘ	`No`
Supports removing obsolete strings ⓘ	`No`
Check flags added by this format ⓘ	HTML non sicuro, `strict-same`, `asciidoc-text`

Configurazione Weblate¶

Typical Weblate Component configuration
Maschera del file	`path/*.adoc`
File di lingua a base monolingue	`path/en.adoc`
Modello per le nuove traduzioni	`path/en.adoc`
Formato file	AsciiDoc file
Parametri del formato file	`merge_duplicates=True`

Gestione delle stringhe duplicate¶

By default, Weblate treats each occurrence of a string as a separate translation unit to provide line-based context. This can be problematic in AsciiDoc tables, where reordering rows changes the context and can lead to translation loss.

To consolidate identical strings into a single translation unit, enable Deduplicate identical strings in the Parametri del formato file.

Nota

Enabling this option disables line-based context for the merged units, ensuring that translations remain stable even if rows or sections are moved within the document.