QuranPress Documentation

1. Overview

QuranPress is a professional Adobe InDesign plugin that lets you insert and replace authentic Quranic text directly inside your InDesign documents. It handles all the typographic complexity of Quranic Arabic — font selection, right-to-left layout, verse range selection, ornamental brackets, optional prefixes, and attribution — so you can stay focused on your design.

What QuranPress Does

• Insert any verse or range of verses from the full Quran (114 suras, 6,236 ayas)
• Search by Arabic phrase — type any words and find matching verses
• Replace placeholder text or markers with correctly formatted Quranic text
• Style using Standard Orthography or the full Uthmani Script (604 fonts)
• Wrap verses in any of 16 ornamental bracket pairs
• Prepend Basmala or "Qal Taa'ala" automatically
• Append a formatted attribution line in a separately styled font

2. System Requirements

3. Installation

Via Adobe Exchange

1. Open Adobe InDesign.
2. Go to Window → Plugins → Browse Plugins.
3. Search for QuranPress and click Install.
4. The plugin panel appears under Window → Plugins → Quran Press.

Manual Installation (UXP Developer Tool)

1. Download the .ccx or plugin folder from the provided source.
2. Open the UXP Developer Tool from Adobe Creative Cloud.
3. Click Add Plugin and select the plugin's manifest.json.
4. Click Load to load the plugin into InDesign.

Opening the Panel

Go to Window → Plugins → Quran Press. The panel docks to the side of your workspace and can be resized between 230 × 200 px and 2000 × 2000 px.

4. Required Fonts

QuranPress requires specific Arabic fonts. A yellow banner appears at the top of the panel if any are missing.

Installing Fonts

1. Click Download Fonts in the banner or use the link from Arabia IT.
2. Extract the downloaded archive.
3. Install fonts (Windows: right-click → Install for all users; macOS: double-click → Install Font).
4. Restart Adobe InDesign — the banner disappears once all required fonts are detected.

6. Insert Tab

The Insert tab lets you place one or more Quranic verses at the cursor position in your document.

6.2 Inserting by Search Phrase

1. Type any Arabic phrase into the Search Phrase field (with or without diacritics).
2. Click Start Search.
3. Click a result — the sura and verse selectors update automatically.
4. Click Insert.

The search engine strips diacritics, tatweel, and zero-width characters; normalizes Arabic variants (آ/أ/إ → ا, ى → ي, ة → ه); and searches all 6,236 verses.

6.3 Inserting by Range

1. Select Sura from the dropdown listing all 114 suras.
2. Set Aya From and Aya To for the range.
3. Click Insert.

7. Replace Tab

7.1 Direct Detection

1. Select the text in InDesign that you want to replace.
2. Click Detect from Selection in the Replace tab.
3. Choose the correct match from the results.
4. Click Replace.

7.2 Marker-Based Replacement

Set a start/end marker pair (e.g., {{ and }}) in the Settings fields. Then:

1. Place your cursor in the document.
2. Click Start Search — finds the first marker pair.
3. Select the correct match and click Replace or Replace Next.
4. Repeat until "No more markers found."

8. Settings

8.1 Interface Language

Sets the plugin UI language: العربية (RTL), English (LTR), or Français (LTR).

8.2 Text Settings

| Setting | Description |

|---|---|

| Font Style | Standard Orthography (single KFGQPC font) or Uthmani Script (604 page fonts) |

| Font Color | Color picker with Grid, Spectrum, and Slider modes |

| Font Size | Preset sizes 8–72 pt or any value 4–200 pt |

| Brackets | 16 ornamental bracket pairs or No Brackets |

8.3 Additions

Only one can be active at a time:

• Basmala — prepends بِسْمِ اللَّهِ الرَّحْمَٰنِ الرَّحِيمِ (suppressed for Sura 1 Aya 1 and Sura 9)
• Qal Taa'ala — prepends قَالَ تَعَالَى

8.4 Attribution

Appends [Surah name: Aya numbers] after the text, using its own independent font, size, and color.

8.5 Saving Settings

Click Save Settings to persist configuration across InDesign sessions.

11. Troubleshooting

"Please select a text location first" — Click inside a text frame in InDesign to set the cursor, then retry.

"Please open a document first" — Create or open an InDesign document first.

Text appears as boxes/squares — The required font is not installed. Install the missing font(s) and restart InDesign.

"No matching aya found" — The phrase didn't match any verse. Try a longer, more distinctive portion of the verse.

"No markers found" — Verify the marker fields match the document exactly. Try moving the cursor to the beginning and retrying.

Settings not persisting — Click Save Settings again, or reinstall the plugin if the issue persists.