Arabic Script Resources

W3C Group Draft Note

More details about this document
This version:
https://www.w3.org/TR/2024/DNOTE-arab-lreq-20240716/
Latest published version:
https://www.w3.org/TR/arab-lreq/
Latest editor's draft:
https://w3c.github.io/alreq/arab/
History:
https://www.w3.org/standards/history/arab-lreq/
Commit history
Editor:
(W3C)
Feedback:
GitHub w3c/alreq (pull requests, new issue, open issues)

Abstract

This document points to resources related to the layout and presentation of text in languages that use the Arabic script. The target audience is developers of Web standards and technologies, such as HTML, CSS, Mobile Web, Digital Publications, and Unicode, as well as implementers of web browsers, ebook readers, and other applications that need to render text in the Arabic script.

Status of This Document

This section describes the status of this document at the time of its publication. A list of current W3C publications and the latest revision of this technical report can be found in the W3C technical reports index at https://www.w3.org/TR/.

This document points to resources for Arabic script layout and text support on the Web and in eBooks. These resources provide information for Web technologies such as CSS, HTML and digital publications about how to support users of languages written using the Arabic script. The information here is developed in conjunction with a document that summarises gaps where the Web fails to adequately support the Arabic script.

The editor's draft of this document is being developed in the GitHub repository Language Enablement for Arabic Script languages (alreq), with contributors from the W3C Internationalization Interest Group. It is published by the Internationalization Working Group. The end target for this document is a Working Group Note.

To make it easier to track comments, please raise separate issues or emails for each comment, and point to the section you are commenting on using a URL.

This document was published by the Internationalization Working Group as a Group Draft Note using the Note track.

Group Draft Notes are not endorsed by W3C nor its Members.

This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.

The W3C Patent Policy does not carry any licensing requirements or commitments on this document.

This document is governed by the 03 November 2023 W3C Process Document.

Some links on this page point to repositories or pages to which information will be added over time. Initially, the link may produce no results, but as issues, tests, etc. are created they will show up.

Links that have a gray color led to no content the last time this document was updated. They are still live, however, since relevant content could be added at any time. When the document is updated, links that now point to results will have their live colour restored.

1. Introduction

1.1 Contributors

The initial information in this document was created by Richard Ishida (W3C).

See also the GitHub contributors list, and the discussions.

1.2 About this document

This document points to resources for Arabic script layout and text support on the Web and in eBooks. These resources provide information for developers of Web technologies such as CSS, HTML and digital publications, and for application developers, about how to support languages written using the Arabic script. They include requirements, tests, GitHub discussions, type samples, and more,

A large number of languages are written using the Arabic script. Often the script is adapted in order to write a given language. For example, Arabic, Persian, and Urdu abjads write vowels using a mixture of letters and diacritics, but the diacritics are only ever used when it is necessary to clarify certain vowel sounds and are rarely found in normal text; Uighur, on the other hand, uses letters only for vowel sounds, behaving like an alphabet; languages such as Kashmiri and African ajami also use a mixture of letters and diacritics to write vowels, but the diacritics are not dropped, making their use of the script also alphabetic.

The document focuses on typographic layout issues. For a deeper understanding of the Arabic script itself and how it works see Modern Standard Arabic Orthography Notes, which includes topics such as: Phonology, Vowels, Consonants, and Numbers.

1.3 Gap analysis

This document is pointed to by a separate document, Arabic Script Gap Analysis, which describes gaps in language support for users of the Arabic script, and prioritises and describes the impact of those gaps on the user.

Gap reports are brought to the attention of spec and browser implementers, and are tracked via the Gap Analysis Pipeline. (Filter for Arabic script items)

The Language enablement index points to this document and others, and provides a central location for developers and implementers to find information related to various scripts.

The W3C also has a repository with discussion threads related to the Arabic script, including requests from developers to the user community for information about how scripts/languages work, and a notification system that tracks issues related to Arabic scripts in W3C working groups. See a list of unresolved questions for Arabic script experts. Each section below points to related discussions. See also the repository home page.

2. All topics

3. Text direction

3.1 Bidirectional text

3.2 Vertical text

4. Glyph shaping & positioning

4.1 Fonts & font styles

4.2 Context-based shaping & positioning

4.3 Cursive text

4.4 Letterform slopes, weights, & italics

5. Typographic units

5.1 Characters & encoding

5.2 Grapheme/word segmentation & selection

6. Punctuation & inline features

6.1 Phrase & section boundaries

6.2 Quotations & citations

6.3 Emphasis & highlighting

6.4 Abbreviation, ellipsis & repetition

6.5 Inline notes & annotations

6.6 Text decoration & other inline features

6.7 Data formats & numbers

7. Line & paragraph layout

7.1 Line breaking & hyphenation

7.2 Text alignment & justification

7.3 Text spacing

7.4 Baselines, line height, etc.

7.5 Lists, counters, etc.

7.6 Styling initials

8. Page & book layout

8.1 General page layout & progression

8.2 Grids & tables

8.3 Footnotes, endnotes, etc

8.4 Page headers, footers, etc

8.5 Forms & user interaction