Urdu Layout Requirements

W3C Group Draft Note

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

Abstract

This document describes or points to requirements for the layout and presentation of Urdu text when it is used by Web standards and technologies, such as HTML, CSS, Mobile Web, Digital Publications, and Unicode.

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 describes the basic requirements for Urdu layout and text support on the Web and in eBooks. These requirements provide information for Web technologies such as CSS, HTML and digital publications about how to support users of Arabic scripts.

The editor's draft of this document is being developed as part of the Arabic script enablement initiative, part of 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 a separate issue for each comment, and at the start of the issue add a URL pointing to the section you are commenting on.

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.

1. Introduction

The aim of this document is to describe the basic requirements for Urdu layout and text support on the Web and in eBooks. These requirements provide information for Web technologies such as CSS, HTML and digital publications, and for application developers, about how to support users of Urdu.

1.1 Contributors

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

See also the GitHub contributors list for the Arabic Script Enablement project, and the discussions.

1.2 About this document

The aim of this document is to describe the basic requirements for Urdu layout and text support on the Web and in eBooks. These requirements provide information for Web technologies such as CSS, HTML and digital publications, and for application developers, about how to support users of Urdu.

The document focuses on typographic layout issues. For a deeper understanding of the Urdu orthography and how it works see Urdu (Nastaliq Arabic) Orthography Notes, which includes topics such as: Phonology, Vowels, Consonants, Encoding choices, and Numbers.

To complement any content authored specifically for this document, the sections in the document also point to related, external information, tests, GitHub discussions, etc.

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 in W3C working groups related to Arabic scripts. 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

Arabic script is written from right to left. Numbers, even Arabic numbers, are written from left to right, as is text in a script that is normally left-to-right.

When the main script is Arabic, the layout and structure of pages and documents are also set from right to left.

3.2 Vertical text

4. Glyph shaping & positioning

4.1 Fonts & font styles

4.2 Context-based shaping & positioning

4.3 Cursive text

Arabic script is a cursive writing system; i.e, letters can join to their neighboring letters. Besides the core behavior of the script, there are some details on how content is encoded in Unicode, and some rules around joining behavior when rendering special cases.

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 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.

Arabic script ascenders and descenders extend much further than those of the Latin script, and care must be taken to correctly align text in the different scripts when they appear together.

7.5 Lists, counters, etc.

7.6 Styling initials

8. Page & book layout

8.1 Footnotes, endnotes, etc