Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
34 changes: 34 additions & 0 deletions docs/examples/light-ibm-plex-arabic.theme
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
# Papyrix Theme: Light with IBM Plex Sans Arabic Fonts
# Copy this file to /config/themes/ on your SD card
# Copy the fonts/ibm-plex-arabic-* folders to /config/fonts/ on your SD card
#
# To create the fonts, run:
# uv run scripts/fontconvert.py ibm-plex-arabic -r IBMPlexSansArabic-Regular.ttf -b IBMPlexSansArabic-Bold.ttf --2bit --arabic --additional-intervals "0xFB50,0xFDFF" --all-sizes -o /tmp/fonts/
#
# Download IBM Plex Sans Arabic from: https://fonts.google.com/specimen/IBM+Plex+Sans+Arabic

[theme]
name = Light IBM Plex Arabic

[colors]
inverted_mode = false
background = white

[selection]
fill_color = black
text_color = white

[text]
primary_color = black
secondary_color = black

[layout]
margin_top = 9
margin_side = 3
item_height = 30
item_spacing = 0

[fonts]
reader_font_small = ibm-plex-arabic-14
reader_font_medium = ibm-plex-arabic-16
reader_font_large = ibm-plex-arabic-18
8 changes: 8 additions & 0 deletions docs/fonts.md
Original file line number Diff line number Diff line change
Expand Up @@ -128,6 +128,14 @@ A sans-serif font with complete Arabic script support including contextual shapi
- **Theme**: `light-arabic.theme`
- **License**: OFL (Open Font License)

### IBM Plex Sans Arabic

IBM's Arabic typeface from the Plex family. A modern, clean sans-serif design with excellent Arabic presentation forms coverage (140/144 in Forms-B), making it highly compatible with Papyrix's Arabic shaper. Provides a refined reading experience for Arabic content.

- **Styles**: Regular, Bold
- **Theme**: `light-ibm-plex-arabic.theme`
- **License**: OFL (Open Font License)

### CJK Fonts (Chinese/Japanese/Korean)

For CJK texts, Papyrix uses external `.bin` format fonts that are streamed from the SD card due to their large size. The `.bin` format uses direct codepoint indexing (1-bit bitmap, MSB first) for the full BMP range (U+0000-U+FFEF).
Expand Down