Skip to content

A tool to replace generic disconnected Arabic letters with their connected counterparts, for the Ruby programming language.

License

Notifications You must be signed in to change notification settings

sinantaifour/arabic-letter-connector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Arabic Letter Connector

Motivation

Arabic is not always well-supported in all libraries. There are two problems that often occur when attempting to present Arabic text:

  1. The letters appear in reverse order (often because there is no right-to-left support).
  2. The letters appear disconnected.

This gem deals with the second problem. If you are this problem, it normally means your string use the generic form of every Arabic letter (that is, without any attributed form, for example a Qaf not a Qaf at the beginning of a word), and the library you are using to present this string doesn't do anything about it.

What this gem does is replace each such generic character to a character with form.

Acknowledgment

This gem is a refactored version of Arabic-Prawn by Dynamix Solutions (Ahmed Nasser).

Installation

Simply run:

gem install arabic-letter-connector

Then require it with:

require 'arabic-letter-connector'

Usage

The gem provides a ArabicLetterConnector.transform(string) method, and also monkey-patches String to include a connect_arabic_letters method.

Below is an example. In the browser, it might appear that this library is doing nothing (since the browser does the work of converting the characters from their generic form considering their correct form). Try it in IRB to get a sense of what is happening.

x = "مرحبا يا العالم"
x[0].unpack("C*")            # [217, 133] 
y = x.connect_arabic_letters # "ﻣﺮﺣﺒﺎ ﻳﺎ ﺍﻟﻌﺎﻟﻢ"
y[0].unpack("C*")            # [239, 187, 163]

This gem is particular useful if you are using prawn to generate PDF files.

require 'prawn'
require 'arabic-letter-connector'
Prawn::Document.generate("arabic.pdf") do
  text_direction :rtl
  font("/path/to/arabic/font.ttf") do # For example: http://www.amirifont.org/
    text "مرحبا يا العالم".connect_arabic_letters
  end
end

About

A tool to replace generic disconnected Arabic letters with their connected counterparts, for the Ruby programming language.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages