{delgosha}

R
package development
RTL languages
Persian
An R package providing a collection of ggplot2 themes for RTL languages (mostly Persian)
Published

June 1, 2023

Overview

{delgosha} is an R package that aims to provide a collection of ggplot2 themes specifically designed for Right-to-Left (RTL) languages, with a primary focus on Persian (Farsi). This package makes it easier for R users to create beautiful, publication-ready visualizations in Persian and other RTL languages.

The Challenge

Creating data visualizations in RTL languages like Persian, Arabic, or Hebrew presents unique challenges:

  • Font support and rendering
  • Text alignment and direction
  • Label positioning
  • Theme compatibility with RTL text

Solution

{delgosha} provides:

  • RTL-Compatible Themes for Persian
  • Font Management
  • Helper Functions
  • Documentation

Key Features

For Users - Ready-to-use themes - Simple API - Persian font integration - Example gallery

Technologies Used

  • R: Package development
  • ggplot2: Visualization framework
  • roxygen2: Documentation
  • testthat: Testing framework
  • GitHub Actions: Continuous integration

Package Philosophy

The name “delgosha” (دلگشا) means “heartwarming” or “delightful” in Persian, reflecting the package’s goal to make data visualization in Persian a delightful experience rather than a frustrating one.

Installation

# Install from GitHub
# install.packages("devtools")
devtools::install_github("mcnakhaee/delgosha")

Basic Usage

library(delgosha)
library(ggplot2)

# Create a plot with Persian theme
ggplot(iris, aes(x = Sepal.Length, y = Sepal.Width)) +
  geom_point() +
  theme_delgosha()