# AsciiDoc

> AsciiDoc file localization

URL: https://store.crowdin.com/adoc
Identifier: adoc
Category: File Formats
Type: System
Author: Crowdin

AsciiDoc is a natively supported file format, you can use it without an additional installation. Just upload it to your projects and start the localization.

## Available Configurations


The AsciiDoc file format can be configured to optimize its use with Crowdin for better content handling. The following is a list of available configuration options.


- Enable content segmentation.

- Custom segmentation rules.

## File Format Details

| Attribute | Value |
| --------- | ----- |
| File Extension | .adoc |
| [API Type](https://developer.crowdin.com/api/v2/#operation/api.projects.files.post) | adoc |
| Source can be edited in Crowdin | No |
| Generating translated files via [Bundles](https://support.crowdin.com/bundles/) | [Search Crowdin Store](https://store.crowdin.com/tags/string-exporter) |
| Supports pluralization | No |
| WYSIWYG Preview in the editor | Yes |
| Supported types of contextual information | Text comments, Screenshots |
| Custom attributes | No |
| Existing translations import possibility | ML-based technology |

## Sample File

```asciidoc

= The Article Title
Name Surname <name@gmail.com>
1.0, Jan 01, 2022: AsciiDoc article sample
:toc:
:icons: font
:url-quickref: https://docs.asciidoctor.org/asciidoc/latest/syntax-quick-reference/

Article preamble.

== Level 1 Section Title

The paragraph with font styles: a *bold* word and an _italicized_ word.

.Image caption
image::image-file-name.png[Image Alt Text]

The paragraph with a footnote.footnote:[Footnote text that will be displayed at the bottom of the article.]

=== Level 2 Section Title

.Unordered list title
* list item 1
** nested list item
*** nested nested list item 1
*** nested nested list item 2
* list item 2

The paragraph.

==== Level 3 Section Title

.Table title
|===
|Column heading 1 |Column heading 2

|Column 1, row 1
|Column 2, row 1

|Column 1, row 2
|Column 2, row 2
|===

== Level 1 Section Title

TIP: There are five admonition labels: Tip, Note, Important, Caution and Warning.

// Some comment that won't be rendered.

. ordered list item
.. nested ordered list item
. ordered list item

== Level 1 Section Title

This is a link to the https://docs.asciidoctor.org/home/[Asciidoctor documentation].
This is an attribute reference {url-quickref}[that links this text to the AsciiDoc Syntax Quick Reference].
```

## Translating AsciiDoc


**Note:** The ADOC document attributes are not translatable.



**Translating ADOC Files in WYSIWYG View**



**Note:** Translation files exported from Crowdin might have slightly different formatting than in a source file.



While translating an ADOC file in addition to a regular string list view, its content can be displayed in a WYSIWYG view, in a form close to how the file looks rendered. This allows for translating strings taking into account the context of the entire document, which in turn results in higher quality translation.