Working with ATF to edit texts

Building a project can comprise any one or more of the following functions:

Working with CDLI ATF

Oracc and CDLI use slightly different versions of ATF. CDLI ATF is called Canonical ATF (C-ATF) and it is described in these pages:

CDLI ATF primer
If you are preparing texts for insertion directly into the CDLI repository you should read this document first.
Numbers and metrology in CDLI corpora
This page gives basic guidelines for entering numbers and metrological transliterations for CDLI.
Date specifications for CDLI/Oracc
This document describes the conventions used for specifying dates in the CDLI catalogs and gives a list of kings and dynasties.

You may also find some or all of the Oracc webtools useful.

Learning Oracc ATF

These pages help you start using Oracc-style ATF. You will probably want to install Emacs before you begin.

Oracc ATF primer
A very quick start to get you up and running with your first ATF texts by giving some annotated examples.
ATF structure tutorial
This document gives a tutorial on how to type the block structure features of texts in ATF, the ASCII Transliteration Format.
ATF inline tutorial
This page gives a tutorial on how to type graphemes and other inline content in ATF.

Creating ATF files

For regular creators of ATF files, the following documentation gives more detailed information about particular aspects of this work:

ATF quick reference
A quick reference sheet for the ATF format.
Overview of ATF labelling conventions
Labels are generated for lines by the ATF processor and are used to reference lines in some parts of the ATF system. This document describes the syntax of labels.
ATF translation conventions
Translations may be input as interlinear, within the ATF files, or extralinear either within ATF files or separately. The Oracc translation format and the special facilities it provides are described here.
Numbers and metrology in Oracc corpora
This document describes how to transliterate weights and measures in ATF for Oracc corpora.
Overview of ATF protocols
Protocols are statements which are interpreted or stored by the ATF processor but are not part of the text edition proper. This page offers an overview of the protocols which may be used in ATF documents.

You may also find some or all of the Oracc webtools useful.

Working with specific ATF formats

If you are working on particular genres of cuneiform text you may find this specialist documentation particularly helpful:

This document describes how to create synoptic and matrix scores using Oracc.
Composite texts
This document describes ATF features which are available when entering composite texts.
Base text and commentary
This page describes the ATF mechanism for linking a scholarly commentary to its base text.
ATF linkage
This document describes the ATF mechanisms for intertext linking, for instance between scores and composite texts
Bilingual and multilingual texts
This page describes how to transliterate bilinguals using Oracc (the same principles apply to trilinguals, etc.).
ATF lexical conventions
This page describes the ATF features for working with lexical texts.
Mathematical notations in Oracc corpora
Mathematical notations use some conventions which are specific to mathematical and astronomical texts, as well as employing a variant of the standard CDLI method of notating sexagesimal numbers. They are described here.
Complex layouts
This document describes how to deal with complex layouts, such as tabular formatting, in ATF.
ATF advanced conventions
This document describes ATF features which are not needed for everyday documents and which some users will never need.
18 Dec 2019 osc at oracc dot org
Back to top ^^

Released under a Creative Commons Attribution Share-Alike license 3.0, 2014. [] [] []
Oracc uses cookies only to collect Google Analytics data. Read more here; see the stats here []; opt out here.