TechNet Wiki International is expanding with a new Language - Hebrew!


wiki languages

Good day all,

Today I have the pleasure to officially announce that we added the Hebrew language to the TechNet Wiki!

In this post I want to give a short history of the decision to add Hebrew language, and I will present the people behind the decision in a short history timeline. I will mention in brief the challenge and the solution in using RTL languages in the TechNet Wiki, and I will close with invitation to join the new author team and contact info.

You can now find articles in English, which is the main global language, together with a few dozen different languages, including Hebrew. This definitely puts the TechNet Wiki at the top, as one of largest global technical documentation centers, for Microsoft Technologies.

 

hebrewשלום לכולם,
אני שמח להכריז היום על הוספת השפה העברית במערכת TechNet Wiki של מייקרוסופט.
בבלוג קצר זה אני רוצה להציג היסטוריה קצרה של קבלת ההחלטה להוסיף עברית למערכת, וכן להציג את השמות מאחורי הקלעים. אני אזכיר בקצרה את האתגר בכתיבה בעברית במערכת שלא תומכת עבודה עם שפות הכתובות מצד ימין לשמואל (דבר שנכון גם לערבית למשל), ולסיום אסגור את הבלוג עם הזמנה להצטרף אל צוות כותבי המאמרים בעברית.
אז החל מהיום בנוסף למאמרים בשפה האנגלית, שהיא השפה המרכזית, ולמאמרים בעוד כמה עשרות שפות אחרות, אתה יכול גם למצוא את השפה העברית במערכת ה TechNet Wiki.

 

wiki languages

Click here for last Statistics by language

Short history

Several years ago, Naomi and Ed Price suggested me to start write articles in Hebrew language. At that time, I was pretty newbie to the TechNet Wiki, and I did not find people to join me in this. As a result, I postponed the idea temporarily for the future…

Several weeks ago, we recruited judges for the TechNet Wiki Guru contest, and with Peter Geelen's help, I have the pleasure to meet Maor Bracha. Short time later Maor suggested to me, that we will start writing articles in Hebrew, and he brought with him a friend, Avihai Hajaj…. And the future is here….

We have set up a small group of three (at this time) in order to bring the Hebrew language to the TechNet Wiki.

The challenge

Adding Hebrew is not so trivial. Hebrew (like Arabic, for example) is written from right to Left, and the TechNet Wiki interface does not support this feature.

For example, Table Of Content (TOC) is created dynamically based on "anchor links". The anchor links created dynamically based on headers in the article. If the header is written in Hebrew then the anchor link generated behind the scenes also in Hebrew, and Wiki engine does not add the header to the TOC. Moreover, Using RTL languages messes up the order or characters in the text, in several cases. Unfortunately, this is just a taste of the problems associated with the use of RTL languages...

We hope that in the future the supporting for RTL languages will be added.

In the meantime, we had to think about solutions and workarounds that will give us simple option to start write articles in Hebrew.

The solution

In the last several weeks I wrote several articles that should give a starting point, and with the help of Maor and Avihai we tested the procedure and wrote the first several articles in Hebrew. Best practice to write new articles in Hebrew can be seen in this short article. The basic Idea we choose based on creating a template article, which was designed manually using HTML & CSS code, to fit Hebrew. Using this template people can now copy the content into a new article, and edit it as needed. In time, we will add more templates which will give the authors other options to start with.

hebrewכאמור, כתיבה בשפות הנכתבות מימין לשמאל כמו עברית וערבית במערכות שאינן תומכות בכך, יכולה להיות מעט אתגרית.
על מנת להקל את התהליך של כתיבת תכנים בעברית, התחלתי לכתוב כמה מאמרים בסיסיים.
* המאמרים עדיין בשלבי כתיבה וככל שנלמד ונתרגל את העבודה עם עברית נוכל להוסיף ולשפר אותם. זה בדיוק הייתרון במערכות ויקי: אם יש לך רעיונות לשיפור המאמרים אז אתה יכול להיכנס למערכת, לערוך את המאמרים, ולהוסיף טיפים ורעיונות כיצד להקל את כתיבת המאמרים בעברית.
את תחילת הדרך אני ממליץ לבצע בקריאת המדריך הקצר הבא. באופן כללי הרעיון שבחרנו כפתרון הוא לעבוד עם תבניות של מאמרים בעברית אשר הכנו מראש. את התבנית הראשונה יצרתי בצורה פשוטה בעזרת קוד HTML ו CSS, על מנת לעקוף את הבעיות הנפוצות. אם אתה מכיר שפות אלו, אז תוכל גם אתה לכתוב תבניות חדשות ולשפר את התבניות הקיימות. אם אתה לא מכיר שפות אלו או שאתה מחפש דרך מהירה לכתיבת מאמר, אז אתה יכול פשוט ליצור מאמר חדש ריק -> להעתיק את התוכן של התבנית אל המאמר הריק -> ולשנות את תוכן התבנית לתוכן של המאמר שאתה רוצה להעלות.

What's Next?

It's time to start writing articles in Hebrew language! Let's put the Hebrew language on the map!

A Call for technical authors in Hebrew!

If you speak Hebrew and you are familiar with Microsoft technologies, if you want to contribute and you want to join the TechNet Wiki Ninjas family, then we invite you to join us and write new articles, translate existing documentations to Hebrew, and improve the content of existing articles. Join us and become a TechNet Wiki Guru in Hebrew.

Please feel free to contact us (Maor Bracha, Avihai Hajaj, and myself) for any question, suggestion, or feedback. We will try to give the basic support for all Hebrew authors, according to our short experience and the time that we have. You can find us at the TechNet Wiki group on Facebook.

hebrewקריאה לכותבי מאמרים בעברית!

אם אתה דובר עברית ועובד עם טכנולוגיות מייקרוסופט השונות, בכל התחומים החל מתכנות, ניהול תשתיות IT, ניהול מסדי נתונים כמו SQL Server, או שאתה פשוט עבד עם הענן של מייקרוסופט Azure, אז אנחנו מזמינים אותך לקחת חלק בכתיבת מאמרים חדשים בעברית, תרגום מאמרים קיימים לשפה העברית, ושיפור מאמרים קיימים בשפה העברית. הצתרף אלינו והפוך לטק-נט נינג'ה אמיתי.

אנא הרגש חופשי ליצור עימנו קשר דרך הקבוצה הרשמית של מערכת TechNet Wiki בפייסבוק. אתה מוזמן להציג על רעיון, הערה, פידבק, הצעת ייעול, או שאלה. אתה מוזמן להגיב לבלוג הנוכחי בכל פנייה בנושאים אלו, ואם יש צורך בפנייה אישית ואתה מתכוון להצטרף לצוות כותבי המאמרים, אז אתה יכול ליצור עימי קשר דרך פייסבוק או linkedin.

 

TNWiki NinjasArticles do not write themselves!
Join us as Wiki authors, and become a TechNet Wiki Guru!

Ronen Ariely,
Facebooklinkedin, Blog, MSDN

 

wiki languages

 

 

Read Some of the first articles in Hebrew

 

Comments (15)

  1. Nice Share Ronen "Articles do not write themselves!
    Join us as Wiki authors, and become a TechNet Wiki Guru!" I love this line 🙂

  2. I liked it - 'Articles do not write themshelves', its just awesome Ronen.

    1. pituach says:

      Thanks Gaurav,
      I start to get the feeling that we can use this sentence as promo phrase for the TNWiki 🙂
      We need stickers with the promo 🙂

  3. This is awesome! A great milestone for TechNet Wiki!

    1. pituach says:

      Thank Ed,I hope it will be...
      Now we "only" need to bring the call to the right people - these that can actually write technical articles in Hebrew, and we need to bring them. only then the real work start, with writing the articles.

  4. Great work Ronen. I see you got the TOC to work properly.

    1. pituach says:

      Thanks Richard,

      Yes... the TOC was a bit challenge.
      Not only the content but the design as well...
      I needed several attempts 🙂

      In the Wiki code, there is a CSS code that is poorly design, which fit only to LTR but not RTL. It can be fixed in less then a second. This is the source of the issue ( padding-left, without padding-right):
      .table-of-contents .hierarchy-item .hierarchy-item {
      padding-left: 11px;
      }

      If I add wrapper DIV with properties (as should be for Hebrew):
      direction: rtl; text-align: right;
      Then the text in the TOC lose the hierarchy structure 🙁 my solution was to use "float" properties

      Microsoft developer team should add:
      padding-right: 11px;
      as well, and all was great for RTL and LTR language, but seems like no one tried to make the Wiki fit for RTL languages yet 🙁

      * There are lot of issue like this in the code behind the scene, and these types of issues could be fixed in seconds each. But I cannot control the website code, so I workaround it with code in the article itself (This what is done in the template)

  5. Thank you for well written Ronen and great achievements

    1. pituach says:

      Thanks Santhakumar 🙂

  6. Thank you for your helpful information, Ronen!
    Go Hebrew!!

  7. pituach says:

    Thanks guys 😉

Skip to main content