OpenType shaping documents

        🆆 🅰 🆁 🅽 🅸 🅽 🅶

This repository is an active WORK IN PROGRESS.

NONE of the documents you currently see here are complete nor are they suitable for reference. PLEASE do not use them as a guide or as a general information source.

As long as this warning text remains visible, the above holds true.

At present, we are seeking comments and bugfixes on the Indic-script, Arabic-like, Hangul, Hebrew, Thai/Lao, Tibetan, Khmer, Myanmar, default, and USE documents. Interested readers and contributors can begin at the

• Indic General
  • (Devanagari, Bengali, Gujarati, Gurmukhi, Kannada, Malayalam, Oriya, Tamil, Telugu, Sinhala)
• Arabic General
  • (Arabic, N'Ko, Syriac, Mongolian)
• Hangul
• Hebrew
• Khmer
• Thai and Lao
• Tibetan
• Myanmar
• Universal Shaping Engine (USE)
  • All complex scripts that are not handled by a dedicated script-specific shaping model
• Default
  • All non-complex scripts

shaping documents and are encouraged to submit their feedback on the text or images of any of the linked scripts.

In its final form, this repository will hold documentation describing the shaping behavior used for layout of OpenType text. In particular, it will focus on complex scripts.

These documents draw from the following existing resources:

1. The Microsoft Script development specifications, which document the behaviors expected for OpenType Layout fonts and provide guidance & examples for type designers.
2. Related portions of the OpenType specification, such as the OpenType Layout tag registry and OpenType Layout common table formats, which list and define feature tags, script & language tags, and other internals of compliant OpenType font binaries.
3. The HarfBuzz project, which includes a free-software/open-source implementation of OpenType Layout shaping with full source code and documentation.
4. The Allsorts project, which includes a free-software/open-source implementation of OpenType Layout shaping with full source code and documentation.
5. The Unicode Standard and related Unicode Consortium projects such as the Unicode Character Database, which defines Unicode code points and formal character properties used in shaping.
6. The YesLogic text corpus, which includes real-world text data for several Indic scripts, scraped from Wikipedia, Reddit, and multiple online news sources. This data is used to test shaping in Allsorts and Prince.
7. Known but unofficial information about other shaping-engine projects. Primarily this includes tests and reproducible issues found via HarfBuzz, because HarfBuzz intentionally aims to produce results that will 100% match the output of Microsoft Uniscribe (not counting cases where Uniscribe's output is known to be incorrect, of course).

   Note: occasionally, tests or issues documenting the behavior of Apple CoreText are also included, but CoreText compatibility is not an explicit goal for HarfBuzz.