feat: Added Hebrew translations and RTL language support (#335)

Author: DenverCoder1

src/card.php

@@ -135,6 +135,9 @@ function generateCard(array $stats, array $params = null): string
     // add missing translations from English
     $localeTranslations += $translations["en"];
 
+    // whether the locale is right-to-left
+    $direction = $localeTranslations["rtl"] ?? false ? "rtl" : "ltr";
+
     // get date format
     // locale date formatter (used only if date_format is not specified)
     $dateFormat = $params["date_format"] ?? ($localeTranslations["date_format"] ?? null);
@@ -168,7 +171,8 @@ function generateCard(array $stats, array $params = null): string
         $longestStreakRange .= " - " . $longestStreakEnd;
     }
 
-    return "<svg xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink' style='isolation:isolate' viewBox='0 0 495 195' width='495px' height='195px'>
+    return "<svg xmlns='http://www.w3.org/2000/svg' xmlns:xlink='http://www.w3.org/1999/xlink'
+                style='isolation:isolate' viewBox='0 0 495 195' width='495px' height='195px' direction='{$direction}'>
         <style>
             @keyframes currstreak {
                 0% { font-size: 3px; opacity: 0.2; }

src/translations.php

@@ -17,6 +17,10 @@
  * 2016.8.10        8.10        [Y.]n.j
  *
  * For info on valid date_format strings, see https://github.com/DenverCoder1/github-readme-streak-stats#date-formats
+ *
+ * Right-to-Left Language Support
+ * ------------------------------
+ * To enable right-to-left language support, add `"rtl" => true` to the locale array (see "he" for an example).
  */
 
 return [
@@ -52,6 +56,13 @@
         "Longest Streak" => "Plus longue séquence",
         "Present" => "Aujourd'hui",
     ],
+    "he" => [
+        "rtl" => true,
+        "Total Contributions" => "סכום התרומות",
+        "Current Streak" => "רצף נוכחי",
+        "Longest Streak" => "רצף הכי ארוך",
+        "Present" => "היום",
+    ],
     "hi" => [
         "Total Contributions" => "कुल योगदान",
         "Current Streak" => "निरंतर दैनिक योगदान",

tests/TranslationsTest.php

@@ -16,7 +16,7 @@ public function testAllPhrasesValid(): void
     {
         $translations = include "src/translations.php";
         $locales = array_keys($translations);
-        $valid_phrases = ["date_format", "Total Contributions", "Current Streak", "Longest Streak", "Present"];
+        $valid_phrases = ["rtl", "date_format", "Total Contributions", "Current Streak", "Longest Streak", "Present"];
         foreach ($locales as $locale) {
             $phrases = array_keys($translations[$locale]);
             $this->assertEmpty(array_diff($phrases, $valid_phrases), "Locale $locale contains invalid phrases");