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:

Scores

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.