 Okay, can you hear me? Yeah, it's good So I'm Benoit, I'm a community liaison for the Wikimedia Foundation and I will introduce you the extension translate So Yeah, I'm going to give you it will be a short class but as on all classes you will have a short test at the end So let's start bonjour Yeah, like multiple people in our movement, I only speak I not only speak one language and Yeah, many people only speak one language and luckily we have translators that will that will you know make the bridge between Everyone so The extension translate allow people to translate pages. That's not the same thing as content translation You may have heard about content translation The extension translated for is for dynamic pages that are updated often like policies pages Pages documentation things like that So First of all Practical example for translators how to translate Yeah, the process is really easy. I Will show it to you. It will work Well, depending on the language, of course and Most of time depending on the quality of the source Because in most cases, you know, if you don't have a good source Yeah, you will not make a good translation That's the same thing if you want to build a house if you don't have good breaks Your horse your house will not be well built So to access the translation if you go to a page, you will see at the top of the page some Yeah, a banner with all the languages and A link to translate the page you will have here a list of all languages in which that page is available If your language is not there you can click on translate this page and you will have access to the translation A translation interface so that interface is really Simple you have all different messages kind of messages you can find so and translated will require Your effort outdated message that are already translated, but that need some new New effort you also have the unit and reviewed the one for Yeah, a collaborative effort and be sure that at least two people have reviewed the message for quality You can switch to any language you would have Yeah, a research system that will Allow you to find your favorite language and Then when you have chosen the language you prefer you will be able to translate so on the left you will have the source and Yeah, for instance, you have here so for the title you have a source here for a big paragraph and On the right you will put your translation. You just have to click on the elements you want to translate and you will arrive To the translation page There you will find the source again at the top and here you can input your text you can have some suggestions there Depending on the language and when done you just need to save that's basic wiki page system, so You translate you click to next and you translate all the page that way You of course are not alone. You are helped by the tool Each message will have a documentation here at the top for instance, and you can have some suggestions for instance here, I'm trying to translate in Spanish and I have some suggestions based here on the upper term which is a System that provides translations So that's a way to be helped. You can have also messages there that are similar Because you know, you often translate the same title you often translate the same thing So those elements are here really to help you and When you translate you may see some extensions via it's a extension extension variables Sorry, so those variables are created by translate the extension and They help you to translate so here you have an example of A small paragraph to translate you are here you have a source you have to work there and inside of that That paragraph you can see some strange things starting with the dollar sign So to highlight it to highlight them a bit You will see two different things first the You have the variable in blue and also some wiki text markup So for people who are used to translate the page to to work on the wikis wiki text is not a blocker If you are not used to it, yeah, that's not that complicated to to use Especially in translation when people pay attention to when they are creating pages. So in our case we have here a Sentencing italic and here we have a link with translation variable We will we'll go back after in them more practical Way, yeah, we'll explore that later Okay, so who can work on translations like on every on all the wiki we have roles and Everyone with the authorization of doing something can do something different So we have three roles that are editors translation admins and translators All the three of us have different wolf workflows The first one is for editors Basically, you want to change a page and you want that page to be translated. So first you edit the page you add the content I will explain it to you later and Your changes when you will save the page will not be immediately available for translation But translation admin have to review the edit in order to say, yeah, that's good That's done to avoid some vandalism for instance. You have someone, you know editing the source page and Anyone can translate that page. So you will have an elism Reproduced in good faith but other people that would be damageable. So that's why there is that system So editors can you can freely edit a page a wiki page like any wiki page But you will have to rely on someone to To validate what you want to do those people are translation admins and their goal is to check the quality of the page So they will look at the diff look how things have been done Potentially they can make some small changes based on experience or based on best practices that are shared across the wikis Then they click in order to mark mark the page for translations and all edit are live Anyone can now translate the new the page that has been updated and the third role is basically translators There is a page to translate. Okay. That's easy. You translate it like I have just shown to you before and thank you Okay Let's go deeper How to edit the page? Yeah, like I've said, it's a wiki. So You did the page you make some changes actually you have to use wiki texts when you edit the page Because the visual editor is not really yet to welcome Translations and transit tax Yes, because translation Require extra market. We are going to add some new elements inside of the translations We have seen that a bit in our previous example, but let's go deeper Yeah, here is a typical page Marked for translations. Don't be afraid. That's not big deal I will show you the different examples. So let's focus on it. Okay. First you will see the translation units So you can notice them on the on the previous page here. Look you have Small numbers that looks that start with T and they are no HTML comments so Those translation units will be used in order to match the source of the page and the translation all the translations The principle is the follow the following when you open the page You will have, you know the source of the translation like we've seen before you put your text and Here at the top you have the link where that Transition units stored and here you have translation unit number two which matches The translation units in the source Okay, going deeper on how You know translation namespace works and things like that. It's not the goal of that Of that presentation, but if you have any question, you can go on wiki or ask me if you have more questions Very important Translation units are created by software. So don't change them. Don't remove them unless if you perfectly know what you are doing For instance, if you had a new paragraph between Translation unit four and translation unit five, you don't need to rename Translation unit five to have translation six and so on Otherwise, you will basically break quite all translations So, yeah, that's a golden rule for that rule and you will have no surprise in the source Translation units have a particular case. It's for titles Look, yeah, you have the t3 is after the title W equal means title in wiki mark in wiki markup. They are always after for personal reasons That's the only particular case you will see concerning translation units Number two, you have the variables. So we have already seen the variable before in the in the translation interface So here you have in blue a variable So what is the goal of a variable? first you open a variable and then you close it and The goal of those variables is to find Sorry to find Yeah, to have blocks of text that will be stored are as you know small containers So in that translation unit name 18, you will find the number here. You will see that here the variable name talk is there So for people who are familiar with wiki text here starting with the two brackets is supposed to be a link And that link is there is going to a toll page using this allow people allow translators not to worry about the page they want to target The toll page will be the same on all translations translators. That's just need to use that dollar talk element And the link will be built The goal is to avoid mistakes. For instance, if someone I don't know why decided to Translate talk colon wiki of French translation in the language The link will not work in order to find Pages that have a particular language. We are going to add the special column my language inside of a link and of course inside of a translation variable That way It will redirect automatically people to their language if their which is available for translation so Yeah, usually only with his friend. She's as a setup for my my interface. That's my my main language and Visual editor is not the same ease. Yeah in French visual editor is not the same thing as Yeah, if I translate visually there, it will not be Translates in same same way So if I create a link here, for instance without that special my language special page Then people will not go to the transit translated page if I'm using English for my interface visual editor will go to visual editor page if I'm using under the language Due to the use of special column my language. I will go to My full back page. Yeah, French So that way people can go to the to a page they can understand Okay A third element an important one is are the transit tags Transit tags allow you to know where to start the transition and when to end it So when you have a text for instance here, you have a text with 25 translation units The software will know that Transition marking the other transition system must be set up starting there and finishing there in between everything you will put will be Will be an element. It will be a separate element for translation. So if you have 24 paragraphs Every paragraph will become a transition unit with an independent Identifier so if I put translate at the beginning transit slash transit at the end Then in between every paragraph will become if I have 25 paragraph. I will have 25 Translation units So that was the basic concerning how to how to Understand how to edit the page We are going deeper with an example so Here I'm going to edit that quick text only have two paragraph in the title I'm going to add this event will happen in November at the end of the last block First case I'm just adding that at the end That's all what will then happen The edit is going to modify transition unit for because I've added a new sentence inside of the paragraph so when translation admin will mark the page for translation that paragraph will be marked as obsolete for readers and translators will have to update it they will have just you know to take the original text and Add the new translation for the last sentence and agree Let's take another example We have that paragraph and then we have one blank line and we add our new text What will happen in that case number two? That's easy like I've said every new paragraph will be considered as a new translation unit. So in trust translation units Four will not be updated The new thing in green will not be available for translation until it's marked for translation and When it will be marked for translation It will consider not translated so translator will have to translate the new element Here I've marked my page for a translation and the new translation translation unit has been added It's the 28th case number three well That is a bit tricky so You have your three units and you have put your element below and It will not be marked for translation because it has it has been added as a transit tag readers will only see it in English and translator will not be allowed to Update the page and they just translate the translation. So be careful when you edit a page. I've already seen that those cases people put their text after the translate Yeah, the closing The closing translates tag and Unfortunately, the page was not set up for translation. Okay variables. I was mentioning variables earlier So let's say that yeah, my toll page is not the same as before It's obsolete. So let's edit it We have a new toll page. Well, that's really easy You just need to edit what is between the beginning of the variable and the end of the variable You just replace the link and what will happen for transit for translators nothing will happen because On that transition, they will only see dollar toll So they will never see what is the target of the page In that case a transition admin will decide if the unit needs to be updated or not In the case that chance when the page will be marked for transition that change will appear on Yeah, it will be on all pages So people will just click on the page on the link and they will be redirected to the new page variables sometimes you will see some variables multiple variables in the same sentence and in that case I really advise to have unique variables on Here and have explicit variables, of course because I've already seen people having TV our pipe viable one. Yeah For translators, that's a bit Yeah, it can be problematic for translators, you know, because they did not know where that link is supposed to go Or what that variable means So, yeah, my advice to have something clear and also to have unique names for the whole page because you can have The same trans the same viable name for different power That's possible. But at some point if you merge the paragraph, you will have to redefine the levels if you split convert split translation and merge translation, which is Yeah A bit complicated that doable Yeah, you may have some bad spaces So yeah, my advice is to have unique names for a given page. And yeah, don't don't use special characters I've scratched my head during something like yeah, 10 hours, you know to understand why my page wasn't remarkable for transition Okay We only we don't only have text on On pages and sometimes we need to work on structure and you need to work on images. So let's go for those cases Well actually sometimes you need to update the page, but no translation are needed For instance here, I have a list of cities and if I want to add a new city into my list If that city has a pretty international name Yeah, we don't need to update it. So we are going to isolate the list of names between a closing transit tag and a new opening transit tag and if I add a new city randomly Barcelona Where? When the page will be marked for transition the page the list of cities will be automatically updated on all pages All transition at a level and it will have no impact on transitors work But sometimes the names need to be translated Indeed sometimes name need to be translated, but I'm in a case where it doesn't need to be translated For the example if that name needs to be translated I would I would have had that name, you know below the transit time so people can Yeah, of course, but yeah in that case I've randomly decided to take the name Officially spoken in the language of the country I'm good with that Yeah, if I would have added, I don't know, a city in China, I would have a Chinese tag. Yeah I'm good with that. That's a theoretical example Okay, the goal is yeah, the goal there is just to show you it's possible to make some updates without Asking more effort from transitors Transitors are all volunteers and we thank them for all the work they do that we don't need to you know Ask them for things that don't need real changes Yeah, we can also have a way to isolate templates So in that case I want to isolate the on-shore template So that transitors will not accidentally change the target of my intro that can be a bit Yeah, that can be confusing if This or the whole time it's translated. It will not work So yeah, that I will come back to that case later because it's interesting interest want to show you it's possible to isolate templates It's also possible to isolate some lists. So for instance here, I have a list of things. So I Wanted to be a list forever So I don't want for instance to have someone who will you know translate that All the bullet points because someone may want to make paragraphs because that would be better But that was not the purpose the purpose at the beginning So here we are going to create translation unit for every point that is in the bullet list. So Wi-Fi, okay? May not be translated. Okay, we can debate about that. But that's not the point Yeah, not for instance, you have more important information that will require Translation and it may be interested to interesting to isolate those those elements Okay, case of images Okay, here's the wiki syntax another to introduce to add sorry to add an image to the To page. Yeah, we can just put the image on and that's fine. Okay That's English. I translated to French. So I'm going to translate. Well everything so I'm going to add fishier Institute, France, Japan and Yeah, you can be sure of one thing That image doesn't exist on wiki made a comment. So the image will never be displayed So it's really risky. So I really advise you to avoid people sending the image Just in case so how to do that first to identify you didn't if I watched why what's to out you are sorry Just like no kidding Yeah, you have to identify what you need to be translated. So in this case, you have the whole image with a size an alignment and And the explanation of what's that image Then you only take what needs to be translated. So here it's only the caption you need to translate the caption So you have transit tags so that only What is between the orange tags Will be translated and then you'll wrap it up in order to put it inside of the page Here you have an opening translate So you put a close translate before and here you have a closing So you put a new opening in order to have all the elements translated So that's the only thing that will be translated will be the caption It can seems to be a bit tricky, but yeah when you get used to it, that's fine Okay, let's come back to To answer us though That was my previous example here I have a list of cities and somewhere in my text. I want to have a link going directly to that section Well, what happened if I translate the title? Yeah, the new title here in French will not be the same one. So we don't want to have units 26 To be a link we want to have it translated, but it will not be possible to create a link there So we are going to use the intro that will go to list And then We are going to make that that link directly to this Inside of the link when when we need it. So This element if I want to go to the list this element if I click on the on the link that will be created by that We'll go there to there that intro instead of going to that Hypothetic title that is not translated or may not be translated well Of course that list is not exhaustive. There's plenty of other examples. So you can read the documentation that has been created And is available on media. We keep new A new part a new important part after the technical part Let's discuss a bit about how to use translation for successful collaboration And there are some best practices to to to have. Yeah, the first one will be to Actually use the tool and do translations The better, you know, better, you know the tool the easier it will be for you to use it And the easier it will be for you to understand how people use it So, uh, yeah, sometimes you only speak one language it happens, of course, that's not the problem There is another way to Learn how to use the tool. I will show you later Yeah, well, that's obvious keep things short try to avoid to have massive Blocks of text So if you have a big block of text, you can have multiple Translation units instead of one big So that it would be easier for people to translate them Don't forget to use international English I see sometimes some people with a, you know, North American background or British background who make Create pages and sometimes don't manage to understand those pages just because of those differences between languages People some add some cultural references that are, you know Yeah, you know, it's like that very famous American TV show from the 70s. Yep No, I don't know it Some people use jargon, you know, that's our new project that will use the break x y z. Yep. What is it? I advise you to have a glossary somewhere so that people will not be lost Also avoid metaphors, you know Yeah, my project is that is like a new butterfly flying inside of a sun Maybe perceived. I you know, it's not that direct and people may not understand the The point you want to make Yeah, most people we are working with are have on bubble boxes English to level That's not much most people at the nindia ketun. For example, they English to English English three and below level Yeah on above actually. Yeah, so, yeah Sometimes it can be yeah Yeah, there's some tools existing that may help you to to work on that on that I mean, we have for instance the good way to know if your text will be understandable by By different people Okay. Yeah, don't forget that place Keep the titles sometimes you say you can tell yourself The titles I'm going to put here before the slash translate and after New translate tag is so that I'm going to isolate the titles I advise to keep the titles because titles are breaks. It means I can't take a break when I'm translating And I can't come back later. It would be easier to, you know, rhythm my work document It's really important That's also a way for people who only speak one language to practice that too if You are when you are on the translation page to If you type qqq in language search, you will have access to documentation That documentation can be necessary sometimes for instance, if you put a link to Wikipedia article, you can You know, tell people yeah, please add up that link to your Yeah, an article in your language That's a way to do that Uh, you have seen documentation in previous examples and so Yeah, don't forget that it's really really important to have things documented It eases a lot translation work and people can know how to make better translations Here's an example of how documentation is displayed. It's just on top of the page You would see that on yeah every time you have some documentation there Okay Final section how to create a new page Basically, that's really simple, you know how to I've explained you how to make it Happening so you can first create the page you can use v in that case Then you use wiki text to add translate tags You have the different variables you need I advise you to ask for from advice for more experienced users It can be translation admins. They can help you to set up the page best way and explain you, you know better tips than All new theory i'm showing you and yeah, and then that's done You can ask trans ask for translator for translations and Get translations done Last touch that's the cherry on the cake Don't forget to add That important element on top of the page Engages slash it will display the the bar where you can switch between languages That's so from my side So i'm going to let you work with some tests So let's go for test number one case number one Why this edit will not work? Nicholas You're not supposed to reply. Yeah, Nicholas here has created that tool. So he knows the case Okay, yeah Yeah, okay, three before the title and Same thing, okay Nicholas Yes, absolutely it will not work because of two causes you managed to find them Congratulations. The first one is indeed that one With the translation title element and here on that paragraph for translation unit four You have two variables with the same name The correct Version is that one you put the translate you have the translate Unit the transiting tag after the title and you have link one and link two Okay, those two links those two variables may have been improved, but That's a theoretical case case two How many new translation units will be created in that example, okay six and six Because i don't see the translate tags I assume there's somewhere around the example None Yeah, translate tags were missing. Okay, let's let's then assume that we have transit tags wrapping the example So how many translation unit will be created? You said six. Yeah, still six once twice And we assume that the translate extension is installed and everything yeah, yeah, of course everything is installed It's ready. It will be translated. Yeah You said three. Okay, and that's three Because you don't have any blank line between the title and the paragraph. So All that block will be considered at one translation unit that block as the second one Yeah, the correct way to make that this is better You will have one unit for the title then one for the paragraph one for the title One for the paragraph you can make a song based on that That's all. Thank you very much for attending And if you have any questions, you can go online on the wikis and you can you can also ask me right now Yeah, uh, precisely now. I was editing I was trying to translate a text A couple hours ago Can can you have uh twice the same One same text I mean twice or more than twice What the same number of a unit? No, it will be a separated element But the translation memory will identify The the fact that it's the same one and it will suggest to Give you as a suggestion the same text. So you just have to click on the suggestion and the text will automatically be Yeah, it will be used but particularly No, yeah, it will be used at least Oh, so the question is I mean the answer is that the the tool won't say no, but if the the editor The editor may change it So that you can have the same unit twice or or more times, right? Um, yeah, let's go with an example. Um here you have Uh, you have your translation you can add something and if you have somewhere else the same sentence You will have there the translation So here is with french because i'm using a different language, but here you have a percentage Saying it matches at 60 percent or 100 percent So if that if you have already used that element elsewhere in the translation And the page has already been marked for translation You will just have to click here And it will be used for you Yeah, yeah Yeah, okay. Yeah, I understand. I hope i've been clear Yeah, I hope I've been clear and reply to your question Yeah, I I understood And then uh Well, I I'd like to know the the way to to become a Translation Translation I mean okay Uh, you go to the wiki where you are active on there is inferior page where you can request to have your right changed So on uh, I don't have the precise page in mind, but uh, I can I can tell you if that's on um on media wiki It's the same request page to have, you know, all other rights same thing on meta meta, I think I'm concerning other Website using that that system. I don't know Yeah, I'm in meta right now I was just a helping an italian user who was Setting up a contest And an edition contest And I was translating into spanish But then I found out that there are a A couple of things that don't go very well Okay. Yeah, we can we can see that later One translation unit that that is a bunch of code. I mean it's like one one table, but the translation unit doesn't cover the whole table okay One translation unit, but yeah, I really like like to change it. Okay. That's an interesting case. We can see that Yeah, maybe right now if we don't have any other questions No, okay. Thank you very much