Jens Oliver Meiert

5 Tips To Deal with Right-to-Left Projects

Post from December 11, 2008 (↻ January 2, 2017), filed under .

This and many other posts are also available as a pretty, well-behaved e-book: On Web Development.

  1. Know what goes into your markup and what goes into your style sheets. It’s actually quite simple: When available, you should always use dedicated bidi markup to describe your content. CSS may not be available, and the specs actually say that conforming user agents may ignore the direction and unicode-bidi properties. The only exception is XML which does not offer specific bidi markup, in which case you should use CSS. This is the short version, W3C’s Internationalization Activity provides more detail.

  2. Indicate directionality by the dir attribute on the html element. Almost implied by the former point, set @dir appropriately so that it covers all elements, not just those within the body. To achieve this, make sure to set directionality on the html element.

  3. Avoid a separate RTL style sheet; better customize styling by means of an ID or class on the body element. Usually it’s just a small percentage of declarations that differs between a LTR and its RTL sister style sheet. Some small overhead may well be acceptable, meaning that having a few differing and overwriting declarations can be okay. To go for that (manually, in this case, not automatically), make sure you find all declarations that define anything specific to the left or right (typically referring to float, margin, padding, text-align, and the like), customize those declarations, and use some hook to apply them—like e.g. setting id="rtl" on the body element (well, you really want to use html[dir=rtl]).

    Please note that the best solution would mean to automatically transform a style sheet into its LTR or RTL counterpart. You should also assume a project to benefit from having all rules in the same style sheet for maintenance and ease-of-use. The arguably presentational ID name in the example is not a problem as the contents are presentationally fundamentally different.

  4. Expect RTL issues with your favorite source editor. Yes. This doesn’t need to mean much yet, however my experience with bidirectional projects does know of a fine mess when it comes to appropriate source editors. My favorite one, IntelliJ, can’t fully handle RTL yet. vi improved support with version 7, as far as I know, but it’s far from being good. Textmate and Coda and stuff have problems with RTL contents. And others do, too, politely skipping at least 20 editors that I either tested myself or learned to screw up in one way or the other, too.

    Since I cannot really operate software written in Hebrew or Arabic I usually try to use IntelliJ or vi regardless, or, as a last resort, FCKeditor. If you know a free tool with an English (or German) UI that can deal with both LTR and RTL, please ping me or leave a comment.

  5. Don’t give up; enjoy. Working with international, LTR/RTL projects is a nice challenge that can twist your brain in fascinating ways. It’s also a great topic if you don’t have anything else to talk about. Just kidding. What was that all about.

About the Author

Jens Oliver Meiert, photo of July 27, 2015.

Jens Oliver Meiert is an author, developer (O’Reilly, W3C, ex-Google), and philosopher. He experiments with art and adventure. Here on meiert.com he shares and generalizes and exaggerates some of his thoughts and experiences.

There’s more Jens in the archives and at Goodreads. If you have any questions or concerns (or recommendations) about what he writes, leave a comment or a message.

Comments (Closed)

  1. On December 12, 2008, 17:52 CET, Jabz said:

    Hi Jens,

    I tried to find the name editor a friend recommended to me a while ago…I failed badly. However, I remember I got it from the W3C Internationalization Website at http://www.w3.org/International/

    Please update the post if you find a better editor than FCK. Thanks & Regards - Jonas

  2. On December 23, 2008, 9:00 CET, Marat said:

    Hi, Jens!
    A few month ago my team was developing an arabic version of one of the sites of our customers. I can tell that the third rule (”Try to avoid a separate RTL style sheet”) wouldn’t work on this project because of its huge size. In our case the most comfortable, simple and quick way to make RTL were to make new (not actually new, but kind of exemplair like in OOP) templates and new CSS. Quiete dirty but very quick, stable and effective. It lowers cost a lot.

  3. On December 23, 2008, 9:26 CET, yuval raz said:

    Hi Jens,
    i think this is the first time i see someone (who is not an israeli or an arab) pointing out the problems with rtl documents and editors.

    as a webdeveloper based in israel i get a lot of headaches dealing with support for rtl code and rendering.

    the best editor for rtl i use is aptana, though in the osx version there are some problems (none in the windows version).
    also notepad++ works quite well too.

    notice that some browsers (notably opera) have box-model quirks when working in rtl, especially the padding calculation.

    i’m glad i can tip in my 2NIS worth 😊

  4. On December 30, 2008, 11:57 CET, Jens Oliver Meiert said:

    Marat, I understand, and any advice here certainly “depends”…

    Yuval, awesome! I will look at Aptana and Notepad++ from this angle, thanks!

  5. On May 10, 2012, 15:40 CEST, Jonathan said:

    Hi, it’s not perfect either, but causes us the least problems: GEdit, even when used non-natively under Windows (even though we try to stick to Ubuntu wherever possible). Might want to give it a try.

Read More

Have a look at the most popular posts, possibly including:

Or maybe say hi on Twitter, Google+, or LinkedIn?

Looking for a way to comment? Comments have been disabled, unfortunately.

Flattr? Found a mistake? Email me, jens@meiert.com.

You are here: HomeArchive2008 → 5 Tips To Deal with Right-to-Left Projects

Last update: January 2, 2017

“The end does not justify the means.”