AsciiDoc format (.adoc, .asciidoc, .adfm, .asc)
AsciiDoc-formatet leser .adoc- og .asciidoc-dokumenter – det lette prosamarkeringsspråket som er mye brukt i teknisk dokumentasjon. Leseren trekker ut det logiske tekstinnholdet og bevarer alt annet byte for byte.
Overskrifter (dokumenttittelen = og seksjonsoverskrifter ==…======), avsnitt, listeelementer (ordnede og uordnede, med nesting), blokktitler (.Title), admonition-tekst (NOTE:, TIP:, WARNING:, …) og tabellceller blir hver sin blokk med en normalisert strukturell rolle (heading, paragraph, list-item, caption, table-cell). Tabeller rekonstrueres som table/table-row-grupper slik at cellegeometrien bevares. Innebygd markup lineariseres til kanoniske inline-kode-sekvenser: *bold*, _italic_, `mono`, ^super^/~sub~, URL- og link:-makroer, attributtreferanser {name} og krysskoblinger <<id,text>>. Den synlige teksten forblir oversettbar; markup lekker aldri inn i den.
Verbatim-blokker (listing/literal/source/passthrough), kommentarer, attributtoppføringer og dokumenthodet er ikke-oversettbare og går i rundtur som skjelett: et uendret dokument reproduseres byte for byte, og bare endrede verdier sys inn igjen.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
extractBlockTitles | boolean | true | Send ut AsciiDoc-blokktitler (`.Title`) som oversettbare blokker. Når usann, bevares de ordrett som skjelett. |
extractTableCells | boolean | true | Send `|===` tabellceller som oversettbare blokker gruppert i tabell-/tabellrad-grupper. Når denne er falsk, bevares tabellen uendret. |
Configure it live
Examples
Behold blokktitler uoversatt
Behandle .Title-linjer som skjelett i stedet for oversettbare undertekster.
extractBlockTitles: false
Bevar tabeller verbatim
Ikke trekk ut tabellceller; la hele tabellen gå gjennom rundturen uendret.
extractTableCells: false
Processing notes
Overskrifter bærer nivået sitt i Properties["level"] (antallet
=), slik at strukturen overlever oversettelse og eksport på tvers av formater.Tabeller rekonstrueres som tabell-/tabellrad-grupper; overskriftsceller har rollen table-header, innholdsceller har rollen table-cell.
Inline-markering (fet/kursiv/mono/super/sub, lenker, attributtreferanser, kryssreferanser) beskyttes som inline-kode-sekvenser og må ikke oversettes.
Utdata er bytettro: et uendret dokument går gjennom en rundtur nøyaktig; kun endrede blokkverdier skrives om. Verbatim-blokker, kommentarer, attributtoppføringer og dokumenthodet bevares som skjelett.
← Back to the Format Reference