# Harmattan - Rendering the Allah ligature

In certain types of literature, the name Allah and words related to this name are given unique rendering. Unicode has a presentation form character (U+FDF2 ARABIC LIGATURE ALLAH ISOLATED FORM) that implements this rendering and, while this can work (in some fonts) for the word in isolation, it doesn’t help users obtain special rendering in other contexts where it is desired.

Harmattan provides the special rendering for sequences of Arabic letters that meet specific patterns, giving much more flexibility to document authors.

- Under certain conditions, a sequence of lam-lam-heh will form an Allah ligature:
  - The sequence must include either a preceding isolate alef or a shadda on the second lam, or both.
  - If there is an isolate alef but no shadda, a shadda-superscript-alef will be automatically displayed.
  - The shadda may be followed or preceded by either a superscript-alef diacritic or a fatha.
  - The heh may be either the standard heh (0647) or the heh-goal (06C1).
  - The alef, if present may have marks. Similar characters such as alef-hamza, alef-hamza-below, alef-madda, and alef-wasla will also form the ligature.
  - The first lam may include a kasra, but no other diacritics.
  - The special Unicode character U+FDF2 will always display the Allah ligature.

To disable the special ligature, insert a zero-width joiner character (200D) somewhere in the sequence.

Characters | → | Glyph | Comment
--- | --- | --- | ---
‭ا + ل + ل + ه | → | الله | Ligature is formed (U+0647)
‭ا + ل + ل + ہ | → | اللہ | Ligature is formed (U+06C1)
‭ٱ + ل + ل + ّ + ه | → | ٱللّه | Ligature is formed
‭ا + ل + ل + ّ + َ + ه | → | اللَّه | Ligature is formed
‭ا + ل + ل + ّ + ٰ + ه | → | اللّٰه | Ligature is formed
‭ل + ل + ّ + ه | → | للّه | Ligature is formed
‭ل + ZWJ + ل + ّ + ه | → | ل‍لّه | Ligature is not formed
‭ل + ل + ه | → | لله | Ligature is not formed
‭ل + ِ + ل + ّ + ه + ْ | → | لِلّهْ | Ligature is formed
‭ا + ل + ْ + ا + ل + ل + ّ + ه + ْ | → | الْاللّهْ | Ligature is formed
‭ب + ِ + ل + ل + ّ + ه | → | بِللّه | Ligature is formed
‭ف + ل + ل + ّ + َ + ه | → | فللَّه | Ligature is formed
‭ف + ل + ل + ّ + َ + ه | → | فللَّه | Ligature is formed
‭ف + ل + ل + َ + ه | → | فللَه | Ligature is not formed