27
How to make your project’s website and wiki i18n’d How to make your project’s website and wiki internationalized Ming-Ting “Yao” Wei LXDE.org Core Team Member GNOME.Asia Summit 2009

Gnomeasia 2009 Paper

Embed Size (px)

Citation preview

Page 1: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 1/27

How to make your project’s website and wiki i18n’d

How to make your project’s website and wiki

internationalized

Ming-Ting “Yao” Wei

LXDE.org Core Team Member

GNOME.Asia Summit 2009

Page 2: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 2/27

How to make your project’s website and wiki i18n’d

Who am I?

Who am I?

Ming-Ting “Yao” Wei (Medical-Wei)TaiwaneseA Naïve sophomoreLXDE.org Core Team Member and Site AdminMember of Ubuntu Taiwan LoCo Team

Page 3: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 3/27

How to make your project’s website and wiki i18n’d

Outline

Outline

1 The importance of internationalization

2 The importance of website internationalization

3 Our experience on LXDE.org website internationalization

The beginning

The Drupal partThe MediaWiki part

The phpBB part

Page 4: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 4/27

How to make your project’s website and wiki i18n’d

The importance of i18n

Why internationalization is important?

Make more people use your softwareAccording to Wolfram|Alpha Result, the top 3 usedlanguages are:

Chinese (13.69%)Spanish (5.05%)

English (4.84%)

And there remains more than three-quarter speakers ofother languages.

Make those people familiar with your projectThough there are a lot of people who learns to use English,it is more impressive if we have a native translation for them.

Page 5: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 5/27

How to make your project’s website and wiki i18n’d

The importance of i18n

However...

That’s what most developers know. Most software projects now

already has its internationalization structure of its software.

Page 6: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 6/27

How to make your project’s website and wiki i18n’d

The importance of website i18n

But most of them forget...

The website internationalization is also important...

...especially for those who are not speaking English!

H k ’ b d k ’d

Page 7: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 7/27

How to make your project’s website and wiki i18n’d

The importance of website i18n

Why website internationalization is also important?

The project website is one of the faces to users.

There are many people aware of English; They don’t know

how to get software downloaded if they can’t read  thewebsite.

Users want to find documentations in their language.

Such as Wikipedia, a good multilingual encyclopedia.

They can also give us feedback with their mother tongue.

Only if they know there is the forum available with theirlanguages.

H t k j t’ b it d iki i18 ’d

Page 8: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 8/27

How to make your project’s website and wiki i18n’d

Our experience on LXDE.org website i18n

The beginning

The beginning

In August 2008, Taiwan, LXDE team are talking about its

website rebuild, and I joined them.

We rebuilt the site with CMS (content managementsystem), Blog, Wiki and Forum program rather than simple

HTML.

We chose Drupal as our CMS because of its flexibility  and

simpleness.

WordPress, MediaWiki and phpBB are also chosen

because it is common thus easier to get supported.

How to make your project’s website and wiki i18n’d

Page 9: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 9/27

How to make your project’s website and wiki i18n’d

Our experience on LXDE.org website i18n

The Drupal part

Introduction

LXDE is a new project aimed to provide a new desktop environment which is lightweight and fast. It's

not designed to be powerful and bloated, but to be usable and slim enough, and keep the resource

usage low. Different from other desktop environments, we don't tightly integrate every component.

Instead, we tried to make all components independent, and each of them can be used

independently with few dependencies.

Features

Lightweight , runs with reasonable memory usage

Fast, rund well even on older machines produced in 1999

Good-looking, gtk+ 2 internationalized user interface

Easy-to-use, the user interface is simple, but usable enough

Figure: The LXDE website before September, 2008. It is still in LXDESVN repository, but is out of images.

Page 10: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 10/27

How to make your project’s website and wiki i18n’d

Page 11: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 11/27

How to make your project s website and wiki i18n d

Our experience on LXDE.org website i18n

The Drupal part

English   Português   Español   正體中文

About Download

Figure: The language selection menu on the top of the LXDE website.

How to make your project’s website and wiki i18n’d

Page 12: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 12/27

How to make your project s website and wiki i18n d

Our experience on LXDE.org website i18n

The Drupal part

The Drupal part

Setting up those website applications are easy.

If you haven’t set up your website yet, you can follow thedocumentation in those packages.

We installed i18n (internationalization) module, as well as

gallery and others.

Construct the website contents in English.

Translate those contents from English to other languages.

How to make your project’s website and wiki i18n’d

Page 13: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 13/27

How to make your project s website and wiki i18n d

Our experience on LXDE.org website i18n

The Drupal part

Home

LXDE is a GPL licensed open source desktop environment for Uni

LXDE stands for "Lightweight X11 Desktop Environment".

LXDE is an energy saving and extremely fast and performing des

 

LXDE  View Edit Track Translate

Figure: The “Translate” button to translate articles into a new

language.

How to make your project’s website and wiki i18n’d

Page 14: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 14/27

y p j

Our experience on LXDE.org website i18n

The Drupal part

What we did at then...

Initially, we have set up English and Traditional Chinese

website contents.

We encourage people interest in translating the LXDE

website start from the wiki.

Months after, Henrique P Machado (who also helped us a

lot in LXDE project) translated the whole website into

Portuguese and gave me packages with HTMLs, and I put

the whole translation into the website.Then, Lino Sotomayor gave me a translated Spanish page

and asked me to put into the website, and now it is partly

done.

How to make your project’s website and wiki i18n’d

Page 15: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 15/27

y p j

Our experience on LXDE.org website i18n

The Drupal part

ñol   正體中文

About Download Screenshots Blog Wiki

ñol   正體中文

關於 下載 畫面展示 網誌 Wiki 文件

ñol   正體中文

Sobre Download Screenshots Blog Wiki

Figure: Multilingual menus

A hack is done on the theme to let menu work in multilingual

environment.

http://drupal.org/node/213257

How to make your project’s website and wiki i18n’d

Page 16: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 16/27

Our experience on LXDE.org website i18n

The Drupal part

What will we do next?

Adding more and more languages into our site.

Redesign the look of the website.

Keep it updated.

How to make your project’s website and wiki i18n’d

Page 17: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 17/27

Our experience on LXDE.org website i18n

The MediaWiki part

navigation

Main PageRecent changes

Random page

community portal

LXDE.org

download

Screenshots

Blog

Wiki

Planet

Forum

Join

  discussion view source history

Log in / create account

LXDE

Welcome to the LXDE WikiLXDE is a faster and less resource hungry

free and open source desktop environment.

The wiki has 90 articles so far.

Components

Distributions

Roadmap

Benchmarks

System

Requirements

Projects

Events

Media

FAQ (Frequently Asked Questions) · Support · Installation categories · articles

LXDE, Lightweight X11 Desktop Environment , is a desktop

environment which is li ghtweight and fast. It is des igned to be user

friendly and slim, and keep the re source usage low. LXDE uses le ss

RAM and less CPU w hile being a feature rich operating system.

Because of the low usage of resources it also saves energy. We don't

tightly integrate every component of LXDE. Instead, we try to make all

components independent, so each of them can be used independently

with few dependencies. This makes porting LXDE to different

distributions and Unix syste ms easier. A good starting point is the

General Information a e where ou find information on s stem

page

Figure: The main page of LXDE wiki

How to make your project’s website and wiki i18n’d

Page 18: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 18/27

Our experience on LXDE.org website i18n

The MediaWiki part

supportmore

LXLaun

LXPanel

applicat

from G

files . Th

LXSessi

automa

deskto

remem

restartLXSessi

in other languages

لعربية ا

Deutsch

Español

اریس ف

Suomi

Français

Arpetan

עברית

Magyar

Bahasa Indonesia

Italiano

日本語

한국어

Figure: Language selection with 24 languages available.

How to make your project’s website and wiki i18n’d

Page 19: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 19/27

Our experience on LXDE.org website i18n

The MediaWiki part

The MediaWiki part

Setting up those website applications are easy. (again...)

The module we installed (what I only remember) isreCAPTCHA. It is a CAPTCHA service which also help

digitalizing documents.

For MediaWiki, roughly there are 2 ways to do with

internationalization.

How to make your project’s website and wiki i18n’d

Page 20: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 20/27

Our experience on LXDE.org website i18n

The MediaWiki part

2 ways to internationalization

The simpler way is construct only one wiki and rename itstranslated articles with postfixes.

Easier for a already-built wikis and simpler for managing.

Such as:http://www.mediawiki.org/wiki/MediaWiki/zh-tw 

Or, you can set up multiple wikis, and construct interwikilinks via manipulating database tables.

Much difficult to set up and maintain, but it gives users the

same feeling of Wikipedia.Guide to set up this kind of site:http://www.mediawiki.org/wiki/Manual:Wiki_family

How to make your project’s website and wiki i18n’d

Page 21: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 21/27

Our experience on LXDE.org website i18n

The MediaWiki part

How do we internationalize our wiki?

We set up multiple wikis, one language per a wiki, butshare the same program by switching LocalSettings.php.

Of course, creating a new wiki for a new language needs ainstallation.

We use the same database, but differ wikis with different

schemes.

The image information is shared, not to waste the stroagingspace.

How to make your project’s website and wiki i18n’d

Page 22: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 22/27

Our experience on LXDE.org website i18n

The MediaWiki part

What will we do next?

Applying a bot which automatically coping with interwiki

links in different wikis.

How to make your project’s website and wiki i18n’d

Page 23: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 23/27

Our experience on LXDE.org website i18n

The phpBB part

ForumHome Down load S cre ens hots B log Wiki P lane t Forum Join

Board index

FAQ Register Login

View unanswered posts • View active topics

L I G H T W E I G H T X 1 1 D E S K T O P E N V I R O N M E N T

It is currently Fri Nov 20, 2009 7:20 pm

Search…   Search

ANNOUNCEMENTS REPLIES VIEWS LAST POST

Read this first if you want to report a bug or send a patch!by PCMan on Thu Jul 30, 2009 6:24 am

0 651 by PCMan 

Thu Jul 30, 2009 6:24 am

Next generation PCManFM is now under development!by PCMan on Sun Jun 07, 2009 4:33 pm

8 2308 by phillipe 

Tue Sep 22, 2009 7:14 am

Please join xdg mail ing list if you can.by PCMan on Fri Jun 05, 2009 3:31 pm

0 695 by PCMan 

Fri Jun 05, 2009 3:31 pm

  -  

Figure: The main page of LXDE forums

How to make your project’s website and wiki i18n’d

O i LXDE b i i18

Page 24: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 24/27

Our experience on LXDE.org website i18n

The phpBB part

LOGIN •¨ © 

GI  © ¨  

rn   P r   n i ll h i i in

L 7 8    ¡ # @ 5  

 N  $ A # 6 B  

Links and infos how to connect to the LXDE community on social networks

like Facebook, MySpace, LinkedIn, Xing, Orkut and others.

7 14 by C ¢ £ ¤ D  

 

Mon Jun 29, 2009 2:26 pm

GLOBAL E 

ILLAGE TOPICS POSTS LAST POST

C F  G   ¥  L 7 8  E H  orum / LXDE 中文討論區

This is the LXDE forum for Chinese users. Feel free to ask here in Chinese.

這是 LXDE 的中文討論區,歡迎在本討論區使用中文表達。

Moderator: Medical-Wei

35 116 by jackpapa 

Tue Nov 17, 2009 3:34 am

German language LXDE Forum / Deutschsprachiges LXDE Forum

The German language LXDE Forum. Das deutschsprachige LXDE-Forum.Moderator: maces

14 40 by chaot1983 

Fri Sep 18, 2009 9:31 pm

Portuguese LXDE Forum / Fórum do LXDE em português

Moderator: ZehRique

1 1 by giorgio 

Tue Jun 16, 2009 12:19 am

French LXDE Forum / Forum français LXDE

Moderator: Mario Behling

4 9 by aramis_qc 

Sat Oct 24, 2009 8:45 pm

Figure: The group for other languages than English

How to make your project’s website and wiki i18n’d

O i LXDE b it i18

Page 25: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 25/27

Our experience on LXDE.org website i18n

The phpBB part

The phpBB part

Setting up those website applications are easy. (again and

again...)

Installed all the language packages, and some mods

(modifications) for the convenience of users.When users register their account, they can choose whatinterface language do they want.

However, you may also need the translations of mods. Inthis case, please do not hesitate to ask for help from people

in the forums.Make a group called “Global village” which people can post

in their languages.

How to make your project’s website and wiki i18n’d

Ending i18n vs l10n vs m17n

Page 26: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 26/27

Ending - i18n vs l10n vs m17n

Internationalization vs Localization vs

Multilingualization

Localization is, you tell people your things are ready forbeing translated, and volunteers translate it for you.

Then, multilingualization thus can be done.

To do or not to do, it is a question.

- adapted from Hamlet by William Shakesphere

How to make your project’s website and wiki i18n’d

Q&A

Page 27: Gnomeasia 2009 Paper

8/4/2019 Gnomeasia 2009 Paper

http://slidepdf.com/reader/full/gnomeasia-2009-paper 27/27

Q&A

É Ù × Ø Ó Ò × ² Ò × Û Ö ×