What is this?

This is a bookmarklet to improve support for right-to-left languages in DHIS2.

(check the video below for a quick walkthrough on how to use it)

What is a bookmarlet?

A bookmarklet is a small software application stored as a bookmark in a web browser, which typically allows a user to interact with the currently loaded web page in some way.

This bookmarklet applies CSS styles that fix some common right-to-left layout and style issues with DHIS2 in general, and the Data Entry app specifically. For example, it changes the layout of forms to be from right-to-left which is more inline with the expectations of users of RTL languages, and reflects better the paper forms in these languages.

The bookmarklet is a temporary solution as we continue to improve right-to-left support natively in DHIS2 without the need for addons.

To install the bookmarklet

Drag the button at the top of this page to your bookmarks bar
Go to your DHIS2 instance -> Data Entry App
Click the bookmarklet on your bookmarks
The RTL style should be applied!

Install the styles permanently on a DHIS2 instance

The fixes applied will be lost when you refresh the page. But if you are happy with the styles and want to apply them to your DHIS2 instance permanently, then you can run the following command (changing the highlighted values to match your DHIS2 instance):


          curl -s https://dhis2.github.io/dhis2-rtl-bookmarklet/style.css | curl
          --data-binary @-
          "https://url_to_dhis_2_instance/api/files/style" -H
          "Content-Type:text/css" -u user:password

For more information, check the README for this project.

Contributing and Getting in touch

If you encounter an issue with right-to-left layout, and have a fix that can be applied globally, then please contribute to the stylesheet by opening a PR to the repo.You can also get in touch with our team by opening an issue or starting a discussion on GitHub.

ما هذا؟

هذه bookmarklet تساعد على تحسين نسق وتصميم تطبيقات DHIS2 للغات التي تُكتب من اليمين لليسار كاللغة العربية.

(شاهد الفيديو أدناه لشرح سريع لكيفية الاستخدام)

ما معنى bookmarklet؟

الـbookmarklet هي تقنية في المتصفحات الحديثة تسمح بالقيام بتغييرات بسيطة على صفحة من حيث التصميم أو السلوك بدون تغيير الصفحة الأصلية.

تقوم هذه الـbookmarklet بتفعيل تغييرات على تصميم ونسق الصفحة (الـCSS) لجعلها أكثر ملاءمة للغة العربية. على سبيل المثال، عند تفعيل التغييرات، ستلاحظ أن عناوين الصفوف في مختلف الاستمارات على اليمين وليست على اليسار كما هو الحال عادة في DHIS2. هذه التغييرات البسيطة تجعل التطبيق عامة واستمارات ادخال البيانات خصوصا متناسقة مع توقعات المستخدم العربي وأقرب شكلا وتصميما للاستمارات الورقية.

الـbookmarklet هي حل مؤقت حتى يتم تحديث تطبيق DHIS2 الأصلي لدعم اللغة العربية بشكل أفضل بدون أي اضافات، وهو أمر يقوم فريقنا بالعمل على تحسينه باستمرار.

لتثبيت الـbookmarklet

اسحب الرابط أعلى الصفحة إلى قائمة المفضلة
اذهب الى DHIS2 ثم برنامج ادخال البيانات
اضغط على الـbookmarklet
سيتم تفعيل التغييرات على الصفحة

لتثبيت التغييرات بشكل دائم على DHIS2

عند تفعيل الـbookmarklet، يمكنكم مشاهدة التغييرات مباشرة على الصفحة لكن هذه التغييرات مؤقتة وستزول عند اعادة تحميل الصفحة. اذا كنتم ترغبون بتثبيت تغييرات التصميم بشكل نهائي على DHIS2 فيمكنكم تشغيل الأمر التالي (مع تغيير القيم المشار إليها في الكود بمعلومات تطبيق DHIS2 الخاص بكم):


          curl -s https://dhis2.github.io/dhis2-rtl-bookmarklet/style.css | curl
          --data-binary @-
          "https://url_to_dhis_2_instance/api/files/style" -H
          "Content-Type:text/css" -u user:password

لمزيد من المعلومات اقرأ الـ README على صفحة المشروع.

المشاركة والاتصال بنا

اذا صادفتكم أي مشكلة بخصوص تنسيق الصفحات بالعربية من اليمين الى اليسار، ولديكم تعديل للـCSS يمكنه حل هذه المشكلة، فيمكنكم مشاركة هذا التعديل حتى تضم اضافته لل bookmarklet حتى يستفيد منه باقي المستخدمين. لمشاركة تحديثاتكم، يمكنكم بدء Pull Request على رابط المشروع. ويمكنكم أيضا استخدام الرابط للاتصال بفريق DHIS2 عن طريق بدء نقاش (GitHub Issues) على نفس الرابط.