Help:Extension:Translate/Page translation administration/hi

क्या। पृष्ठ अनुवाद सुविधा की मदद से विकि के पृष्ठों को दूसरी भाषा में नियंत्रण के अंतर्गत अनुवादित किया जा सकता है। इसका मतलब है कि हर अनुवाद की सामग्री आम तौर पर स्रोत पृष्ठ के बराबर होगी। यह विकिपीडिया के लेखों के अलग-अलग भाषा संस्करणों से अलग है, जो एक-दूसरे से पूरी तरह से स्वतंत्र हैं। यह माना जाता है कि पृष्ठों का सिर्फ एक प्राथमिक भाषा से दूसरी भाषाओं में अनुवादित किया जाता है, लेकिन अगर भाषाओं में भी अनुवाद मौजूद हों तो अनुवादक उनका का फ़ायदा उठा सकते हैं।

क्यों। किसी भी मदद के बिना, कुछ भाषाओं में कुछ पृष्ठों से अधिक अनुवादित करना बस समय की बर्बादी होती है, और ज़्यादा से ज़्यादा अनानुरक्षित कचरा। पृष्ठ अनुवाद सुविधा के साथ आप कचरे से बच सकते हैं और अनुवाद प्रक्रिया में संरचना ला सकते हैं। मूल विचार यह है कि स्रोत टेक्स्ट को छोटी इकाइयों में विभाजित किया जाता है, जिनमें से हर इकाई को एक-एक करके अनुवादित किया जाएगा। जब स्रोत टेक्स्ट को इकाइयों में विभाजित किया जाता है, तो सभी बदलाव अलग किए जा सकते हैं और अनुवादकों को सिर्फ उन इकाइयों के अनुवादों को अपडेट करना होगा, जिनमें स्रोत टेक्स्ट में बदलाव हुए हैं। यह अनुवादकों को प्रबंधनीय आकार की इकाइयों पर काम करने और कई अनुवादकों के बीच काम साझा करने या बाद के सत्रों में अनुवाद जारी रखने में सक्षम बनाता है, क्योंकि उन्हें एक साथ सभी को करने की ज़रूरत नहीं होती है।

कौन। यह पृष्ठ, सिस्टम के कार्यों पर गहरी जानकारी प्रदान करके और कई मामलों के लिए सर्वोत्तम प्रथाएँ बताकप पृष्ठ अनुवाद ट्यूटोरियल को विस्तृत करता है। यह पृष्ठ पृष्ठ अनुवाद प्रबंधकों के लिए है और आम तौर पर उन सभी के लिए जो अनुवाद-योग्य पृष्ठों के स्रोत टेक्स्ट को सम्पादित करते हैं, भले ही उनके पास अनुवाद के लिए बदलावों को स्वीकार देने के प्रबंधन सुविधाओं तक पहुँच न हो।

अनुवाद प्रबंधक के रूप में पूरा अधिकार पाने के लिए Project:Requests पर जाएँ।



एक अनुवाद-योग्य पृष्ठ का जीवन
भूमिकाएँ। एकाधिक लोग विकि पृष्ठों को लिखने और अनुवादित करने की प्रक्रिया में शामिल हैं: शुरुआती लेखक एक पृष्ठ बनाता है, कोई वर्तनी त्रुटियों को सुधारता है, एक पृष्ठ अनुवाद प्रबंधक अनुवाद के लिए पृष्ठ को चिह्नित करता है, अनुवादक अनुवाद करता है, कोई पृष्ठ पर बदलाव लाता है, एक पृष्ठ अनुवाद प्रबंधक उन बदलावों को अनुवाद के लिए चिह्नित करता है और अनुवादक अनुवादों को अपडेट करते हैं। उन भूमिकाओं में ओवरलैप हो सकता है, लेकिन पृष्ठ के अनुवाद को आसान बनाने का काम अनुवाद प्रबंधक पर छोड़ दिया जाता है। प्रबंधक फैसला लेता है कि पृष्ठ पहली बार अनुवाद के लिए कब तैयार होगा, सुनिश्चित करता है कि विभाजन अपना काम ठीक से कर रहा है, और बदलाव स्वीकार करता है (या सुधारता है)।

तैयारी। कुछ अनुवाद करने के लिए आपको पहले उसे लिखना होगा। अगर आपने अनुवाद एक्सटेंशन के बिना पहले ही अनुवाद कर लिया है, नीचे अनुवादों को माइग्रेट करने के बारे में अनुभाग देखें। अगर आप चाहते हैं कि जल्दी से जल्दी अधिक अनुवाद आए, स्रोत टेक्स्ट का साफ़-सुथरा होना ज़रूरी है। किसी पृष्ठ को अनुवाद के लिए चिह्नित करने से पहले किसी और से कहें कि वह पृष्ठ को एक बार पढ़ें, और किसी भाषा-विशेषज्ञ से कहें कि वह टेक्स्ट को स्पष्ट बना दें। कठिन शब्दावली और समझने में कठिन वाक्य कई स्वयंसेवक अनुवादों को प्रभावशाली प्रदर्शन करने से रोकता हैं। मार्कअप से भी अनुवादकों को समस्याएँ आ सकती हैं, मगर अनुवाद प्रबंधक होने के नाते आप ऐसी समस्याओं से बच सकते हैं। नीचे मार्कअप को हैंडल करने के बारे में अनुभाग देखें। अनुवादों के स्रोत टेक्स्ट में बदलाव होने पर बेशक अनुवादों में भी बदलाव की ज़रूरत होगी, तो पृष्ठ की सामग्री के स्थिर हो जाने तक इंतज़ार करना बेहतर है। मगर बदलाव होते रहते हैं, और सिस्टम उन्हें अच्छी तरह से हैंडल कर लेता है, तो नीचे बदलावों को हैंडल करने के बारे में अनुभाग देखें।

टैग करना। जब टेक्स्ट अनुवाद के लिए तैयार हो जाता है, कोई भी अनुवाद-योग्य हिस्सों को टैग्स में लपेटकर और पृष्ठ पर  बार जोड़कर चिह्नित कर सकता है। बार के टैग से पृष्ठ के सभी अनुवादों की एक सूची जोड़ दी जाती है, जिसमें उनकी पूर्णता और अद्यत प्रतिशत दिखाई जाती है। और ऐसा कोई चिह्न नहीं जो बताता हो कि अनुवाद मौजूद हैं। नीचे देखें कि टैग असल में करना कैसे है। सिस्टम को पता लग जाएगा कि अनुवाद-योग्य पृष्ठ पर टैग्स कब जोड़े जाते हैं, और पृष्ठ पर उसे अनुवाद-योग्य चिह्नित करने की एक कड़ी दिखाई जाएगी। अगर आप, मान लीजिए, कोई टैग बंद करना भूल जाते हैं, यह शिकायत करेगा और आपको सहेजने से रोकेगा। अनुवाद-योग्य पृष्ठ को Special:PageTranslation पर 'चिह्नित करने के लिए तैयार' के रूप में सूचीबद्ध कर दिया जाएगा।

चिह्नित करना। टैग करने के बाद अनुवाद प्रबंधक पृष्ठ को अनुवाद के लिए चिह्नित कर सकता है। इंटरफ़ेस पृष्ठ अनुवाद उदाहरण में समझाया गया है। अनुवाद प्रबंधक की ज़िम्मेदारी यह सुनिश्चित करना है कि विभाजन समझ में आता है और टैग करना उचित है। अगर पृष्ठ इस दौरान बदल जाता है तो इसे दोबारा चिह्नित किया जा सकता है। नीचे देखें कि न्यूनतम बाधाएँ लाने वाले बदलाव कैसे करें। पृष्ठ के चिह्नित किए जाने पर एक बैकग्राउंड प्रक्रिया शुरू हो जाती है जो मीडियाविकि के कार्य कतार का इस्तेमाल करती है। यह प्रक्रिया हर अनुवाद पृष्ठ को छानकर उसे दोबारा बनाता है: अनुवाद पृष्ठ में बदलावों से प्रभाव पड़ेगा और कालग्रस्त अनुवादों को एक गुलाबी बैकग्राउंड से हाइलाइट कर दिया जाएगा। इसके विपरीत, अनुवाद इंटरफ़ेस तुरंत अपडेट किया जाता है।

बदलाव। सदस्य अनुवाद-योग्य पृष्ठ के स्रोत में बदलाव करना जारी रख सकते हैं। बदलाव स्रोत भाषा में पृष्ठ देखने वाले सदस्यों को दिखाई देंगे, लेकिन अनुवाद, अनुवाद-योग्य पृष्ठ के आखिरी चिह्नित संस्करण से लिए गए अनुवाद इकाइयों के लिए किए जाते हैं: अनुवाद पृष्ठों को 100% पर रिपोर्ट किया जाएगा अगर सभी अनुवाद इकाइयाँ अनुवादित हों, हालाँकि पृष्ठ पर नए बदलाव आए हों। आप स्रोत भाषा में अनुवाद-योग्य पृष्ठ को देखते हुए आसानी से देख सकते हैं कि पृष्ठ पर अचिह्नित बदलाव हैं या नहीं: ऊपर एक सूचना होती है जिसमें बताया जाता है कि आप इस पृष्ठ को अनुवादित कर सकते हैं, और अगर बदलाव हों तो उनकी भी एक कड़ी जोड़ देता है।

अस्वीकरण। अगर अनुवाद-योग्य पृष्ठ के स्रोत में बदलाव किए जाते हैं, अनुवाद प्रबंधकों को हर अनुभाग के लिए "" वाला एक विकल्प दिया जाएगा। अगर कोई अनुभाग अमान्य हो जाता है, अनुवादित भाषाओं के उन अनुभागों पर एक गुलाबी बैकग्राउंड रंग नज़र आएगा, और अनुवाद इंटरफ़ेस में अनुवादकों को एक घड़ी दिखाई जाएगी। अगर कोई अनुभाग अमान्य नहीं होता है, अनुवादित पृष्ठों को पाठकों को कोई बदलाव नज़र नहीं आएगा, और अनुवादकों को बदलाव देखने के लिए अनुवाद इंटरफ़ेस में अनुभाग को ठीक पढ़ना होगा।

स्रोत भाषा। स्रोत भाषा के भाषा कोड वाला एक अनुवाद पृष्ठ भी है: इसमें पृष्ठ के अनुवाद के लिए उपयुक्त अतिरिक्त टैग्स और मार्कअप नहीं होते हैं जिनका इस्तेमाल अनुवाद-योग्य पृष्ठ पर किया जाता है। इस पृष्ठ की कड़ी इंटरफ़ेस पर जोड़ी नहीं जाती है, मगर यह तब काम आता है जब आप, मान लीजिए, पृष्ठ को ट्रांसक्लूड करना चाहते हों (आम तौर पर अनुवाद-योग्य साँचों के लिए), या इसे निर्यात करना चाहते हों। उदाहरणस्वरूप, जिस पृष्ठ को आप इस समय पढ़ रहे हैं, उसके अंग्रेज़ी संस्करण का एक बिना मार्कअप का संस्करण Help:Extension:Translate/Page translation administration/en पर उपलब्ध है।

स्रोत भाषा को बदलना। एक्सटेंशन यह मान लेगा कि अनुवाद-योग्य पृष्ठ की स्रोत भाषा विकि की डिफ़ॉल्ट भाषा है। प्रबंधक किसी पृष्ठ की भाषा की सेटिंग्स को Special:PageLanguage पृष्ठ की मदद से बदल सकते हैं, ताकि इसका इस्तेमाल अनुवाद के लिए एक स्रोत पृष्ठ के रूप में किया जा सके। विस्तार के लिए पृष्ठ के सामग्री की भाषा देखें।

अनुवाद की भाषा। अगर अनुवाद पृष्ठ पूरी तरह से अनुवादित न हों तो उनपर दूसरी भाषाओं में टेक्स्ट भी हो सकता है। अनुवाद पृष्ठों पर अनानुवादित अनुवाद इकाइयों को उचित भाषा और टेक्स्ट की दिशा के साथ टैग किया जाएगा ताकि CSS के नियम ठीक से लागू हो पाए। मीडियाविकि में इस समय पृष्ठ के स्तर से नीचे पार्सिंग के लिए भाषा को सेट करने की सुविधा उपलब्ध नहीं है। सभी जादूई शब्द और पार्सर फ़ंक्शन्स अनुवाद के लक्ष्य की भाषा का इस्तेमाल करेंगे, हालाँकि उनके आस-पास के टेक्स्ट को अनुवादित न किया गया हो। इससे संख्याओं या दिनांकों को प्रारूपित करते समय अनपेक्षित बेमेल हो सकता है। कुछ जादूई शब्दों और पार्सर टैग्स में आउटपुट की भाषा सेट की जा सकती है, जिस मामले में आप जादूई शब्द  का इस्तेमाल कर सकते हैं जो या तो अनानुवादित इकाइयों के लिए स्रोत भाषा लौटाएगा, या फिर अनुवादित इकाइयों के लिए लक्ष्य भाषा।

बंद अनुवाद अनुरोध। कुछ अनुवाद-योग्य पृष्ठों पर ऐसी सामग्री होती है जो सिर्फ कुछ समय के लिए दिलचस्प होती है। उदाहरणस्वरूप, घोषणाएँ और स्थिति अपडेट्स, जैसे विकिमीडिया के मासिक हाइलाइट्स। आप इन पृष्ठों को अनुवादकों के सामने रख सकते हैं मगर अनुवाद इंटरफ़ेस से छिपा सकते हैं। इससे पृष्ठों पर अनुवादों को रोका नहीं जाता, मगर इससे इस बात की संभावना कम हो जाती है कि कोई सदस्य गलती से पृष्ठ को अनुवादित करना शुरू कर दे। हतोत्साहन और प्रोत्साहन Special:PageTranslation से किए जाते हैं।

भाषाओं को प्राथमिकता देना। आप भाषाओं की एक सूची परिभाषित कर सकते हैं जिनमें आपको विशिष्ट रूप से अनुवाद चाहिए; भाषाओं की सूची को खाली छोड़ने पर मान लिया जाता है कि सभी भाषाओं को अनुमति है। प्राथमिकता सूची में अनुपस्थित भाषाओं के लिए पृष्ठ का स्वभाव एक हतोत्साहित पृष्ठ के रूप में होगा (पिछला अनुच्छेद देखें), और उनमें अनुवादित करते समय अनुवादकों को एक सूचना दी जाएगी। आप दूसरी भाषाओं में अनुवादों को रोक भी सकते हैं, अगर अनुवादों का इस्तेमाल कहीं और हो रहा हो और आप कुछ भाषाओं के अलावा किसी का इस्तेमाल नहीं कर पाएँगे।

समूहीकरण। संबंधित पृष्ठों को समूहीकृत किया जा सकता है। ये समूह दूसरे संदेश समूहों की तरह काम करेंगे। इनकी अपने आँकड़े हैं और इनमें इनके उप-समूहों के सभी संदेश होते हैं: इस मामले में अनुवाद-योग्य पृष्ठों के। यह कार्यक्षमता इस समय Special:AggregateGroups में है। स्थायी संदेश समूहों को डिफ़ॉल्ट से Special:LanguageStats में और Special:Translate के समूह चयनकर्ता में छिपाया जाता है।

स्थानांतरण। आप अनुवाद-योग्य पृष्ठों को दूसरे पृष्ठों की तरह स्थानांतरित कर सकते हैं। ऐसा करते समय आप गैर-अनुवाद उपपृष्ठों को भी साथ में स्थानांतरित करने का विकल्प चुन सकते हैं। सभी संबंधित पृष्ठों को स्थानांतरित करने के लिए एक बैकग्राउंड कार्य का इस्तेमाल किया जाता है। जब स्थानांतरण चल रहा हो, पृष्ठ को अनुवादित करना संभव नहीं होगा। काम हो जाने पर पृष्ठ अनुवाद लॉग में टिप्पणी जोड़ दी जाएगी।

हटाना। स्थानांतरण की तरह, हटाने का काम भी दूसरे पृष्ठों की तरह ही किया जाता है। आप या तो पूरे अनुवाद-योग्य पृष्ठ को हटा सकते हैं, या फिर सिर्फ किसी एक अनुवाद पृष्ठ को। स्रोत पृष्ठ को हटाने पर सभी संबंधित अनुवाद पृष्ठों को भी हटा दिया जाएगा। स्थानांतरण की तरह, पृष्ठों को थोड़ा समय लेकर हटाया जाएगा और काम हो जाने पर पृष्ठ अनुवाद लॉग में टिप्पणी जोड़ दी जाएगी। हटाने के लिए "delete" और "pagetranslation" अनुमतियों की ज़रूरत पड़ती है, मगर अनुवाद पृष्ठों को सिर्फ मानक "delete" से ही हटाया जा सकता है।

पूर्ववत करना। उसी तरह, गलत सम्पादनों को भी दूसरे पृष्ठों की तरह पूर्ववत किया (और वापस भी लिया) जा सकता है: आपको सिर्फ प्रभावित अनुवाद इकाई को सम्पादित करना होगा और अनुवाद पृष्ठ को अपडेट कर दिया जाएगा। अनुवाद पृष्ठ के सम्पादन के अनुवाद इकाई के सम्पादन तक पहुँचने के लिए एडिटर की "" कड़ी पर क्लिक करें और उस समय का सम्पादन खोजें।

सुरक्षित करना: अनुवाद-योग्य पृष्ठ को सुरक्षित करना संभव है। अनुवाद पृष्ठों को सुरक्षित नहीं किया जा सकता, और स्रोत पृष्ठ की सुरक्षा अनुवादों पर लागू नहीं होती है। अनुवादों पर अधिक सम्पादनों को रोकने के लिए आप स्रोत की भाषा को एकमात्र प्राथमिक भाषा के रूप में जोड़कर दूसरी सभी भाषाओं में अनुवादों को अक्षम कर सकते हैं। ऊपर 'भाषाओं को प्राथमिकता देना' देखें। इन दोनों कार्यों के साथ मिलने पर, स्रोत पृष्ठ और अनुवाद पृष्ठ, दोनों से सम्पादनों को रोक दिया जाता है। चुनिंदा अनुवाद इकाई पृष्ठों को सुरक्षित किया जा सकता है, हालाँकि ऐसा करना अनुशंसित नहीं।

अनुवाद से हटाना। किसी पृष्ठ को अनुवाद के लिए अचिह्नित किया जा सकता है। आप पृष्ठ को अनुवाद से हटाने के लिए Special:PageTranslation का इस्तेमाल कर सकते हैं या फिर अनुवाद-योग्य पृष्ठ के ऊपर की कड़ी को क्लिक कर सकते हैं। इससे पृष्ठ अनुवाद से जुड़ी सारी संरचना हट जाएगा, मगर सभी मौजूदा पृष्ठों को अपनी जगहों पर छोड़ दिया जाएगा, और उन्हें अब स्वतंत्र रूप से सम्पादित करना संभव होगा।

भाषा-सूचित ट्रांसक्लूशन। किसी अनुवाद-योग्य पृष्ठ को दूसरे पृष्ठों पर साँचे के रूप में जोड़ना संभव है। इस मामले में अगर अनुवाद-योग्य पृष्ठ को लक्ष्य की भाषा में अनुवादित किया गया हो, तो उसे उसमें लोड किया जाएगा। अगर अनुवाद मौजूद नहीं है, अनुवाद-योग्य पृष्ठ को स्रोत की भाषा में लोड किया जाएगा। अनुवाद-योग्य पृष्ठों के इस स्वभाव को, पृष्ठ को अनुवाद के लिए चिह्नित करते समय 'इस पृष्ठ के लिए अनुवाद-सूचित ट्रांसक्लूशन को सक्षम करें' विकल्प की मदद से नियंत्रित किया जाता है। नए अनुवाद-योग्य पृष्ठों पर यह विकल्प डिफ़ॉल्ट से सक्षम होगा।



अनुवाद-योग्य पृष्ठ की संरचना
अनुवाद-योग्य पृष्ठ के अनुवाद में कई पृष्ठ बनाए जाएँगे, जो साथ मिलकर अनुवाद-योग्य पृष्ठ की रचना करते हैं: उनके शीर्षक का पता अनुवाद-योग्य  से लगाया जाता है:


 * - स्रोत पृष्ठ
 * - अनुवाद पृष्ठ, और बिना मार्कअप के स्रोत पृष्ठ की एक प्रतिलिपि
 * - सभी अनुवाद इकाई पृष्ठ

साथ ही, अनुवाद पृष्ठों के साँचें और अनुवाद इकाइयों के स्रोत मौजूद हैं जो स्रोत पृष्ठ से निकालकर डेटाबेस में रखे जाते हैं। यह प्रणाली ट्रैक करती है कि स्रोत पृष्ठ के किन संस्करणों में अनुावाद टैग्स हैं और उनके किन संस्करण को अनुवाद के लिए चिह्नित किया गया है।

अनुवाद पृष्ठ के हर बार अपडेट होने के बाद प्रणाली संबंधित अनुवाद पृष्ठों को दोबारा बनाएगी। इससे दो सम्पादन होंगे। अनुवाद इकाई पृष्ठ को हाल में हुए बदलावों से डिफ़ॉल्ट से छिपाया जाता है और इसे अनुवाद फ़िल्टर से 'अनुवाद दिखाएँ' पर क्लिक करके सक्षम किया जा सकता है। सम्पादन के अलावा अनुवाद इकाइयों पर किसी भी कार्य (जैसे हटाने या स्थानांतरण) से अनुवाद पृष्ठों को दोबारा नहीं बनाया जाएगा।

अगर आपको बिना मार्कअप के, स्रोत पृष्ठ की एक प्रतिलिपि चाहिए, मान लीजिए, अनुवाद एक्सटेंशन का इस्तेमाल न करने वाले किसी दूसरे विकि पर ले जाने के लिए,


 * स्रोत भाषा का कोड पहचानें (अंग्रेज़ी के लिए en ) और  पर जाएँ
 * इस तरह के एक पते पर पहुँचने के लिए "" बटन पर क्लिक करें और पता बार में  को   से बदल दें, फिर Enter दबाएँ
 * टेक्स्ट को दिखाया जाएगा या सहेजा जाएगा

विभाजन
साधारण सिद्धांत:


 * 1) अनुवाद के लिए लक्षित पूरे टेक्स्ट को  टैग्स में लपेटा जाना चाहिए। एक पृष्ठ पर टैग्स की कई जोड़ियाँ हो सकती हैं।
 * 2) उन टैग्स के बाहर की सामग्री को अनुवाद पृष्ठ पर बदला नहीं जाएगा। स्टैटिक टेक्स्ट, और हर अनुवाद इकाई के अनुवादों को सब्सटिट्यूट करने के स्थान को चिह्नित करने वाले प्लेसहोल्डर्स को साथ मिलाकर अनुवाद पृष्ठ का साँचा कहा जाता है।
 * 3) टेक्स्ट में ज़्यादा मार्कअप डालने पर अनुवादकों को अनुवाद करने में दिक्कत आ सकती है। जब ज़्यादा मार्कअप हो,  टैग्स का इस्तेमाल अधिक बारीकी से करें।
 * 4) जब  टैग्स के अंदर के टेक्स्ट में एक या ज़्यादा खाली पंक्तियाँ (दो या ज़्यादा नई पंक्तियाँ) होती हैं, टेक्स्ट को अनुवाद इकाइयों में बाँट दिया जाता है।

प्रतिबंध। पृष्ठ अनुवाद सुविधा टेक्स्ट पर कुछ प्रतिबंध लगाती है। दो या अधिक अनुवाद इकाइयों में फैला कोई मार्कअप नहीं होना चाहिए। In other words, each paragraph should be self-contained. This is currently not enforced in the software, but violating it will cause invalid rendering of the page, the severity depending on whether MediaWiki itself is able to fix the resulting HTML output or not.

Parsing order. Beware, the tags work differently from other tags, because they do not go through the parser. This should not cause problems usually, but may if you are trying something fancy. In more detail, they are parsed before any other tags like or, except for  which is recognized by the Translate extension.

Tag placing. If possible, try to put the tags on their own lines, with no empty lines between the content and the tags. Sometimes this is not possible, for example if you want to translate some content surrounded by the markup, but not the markup itself. This is fine too, for example:

To make this work, the extension has a simple whitespace handling: whitespace is preserved, except if an opening or closing  tag is the only thing on a line. In that case the newline after the opening tag or before the closing tag is eaten. This means that they don't cause extra space in the rendered version of the page.

Variables. It is possible to use variables similar to template variables. The syntax for this is (quotes are optional if the value contains no spaces or any of  ). For translators these will show up only as, and in translation pages will automatically be replaced by the value defined in the translatable page (so they are global "constants" across all its translation pages). Variables can be used to hide untranslatable content in the middle of a translation unit. It also works for things like numbers that need to be updated often. You can update the number in all translations by changing the number in the translatable page source and re-marking the page. You do not need to invalidate translations, because the number is not part of the translation unit pages.

Comma-separated values. For content such as Graph data, that needs to be parsed by the software as comma-separated values, you should separate the translation units between each comma, so that the translating editors don't use localized commas which will confuse the software.

Plain-text values. To prevent any kind of modification of the translation value, use  attribute like this:. By default outdated and untranslated values are modified in order to support highlighting and language tagging.

Markup examples
Below are listed some alternatives and suggested ways to handle different kinds of wiki markup.

{| class=wikitable
 * - style="visibility:collapse"
 * colspan="3" |
 *  Categories 
 * width=40% | Categories can be added in two ways: in the translation page template or in one of the translation units.
 * width=40% | Categories can be added in two ways: in the translation page template or in one of the translation units.

If you have the categories in the translation page template, all translations will end up in the same category.

If you have categories inside translation units, you should teach the users a naming scheme.

On the right we show two possible schemes which are independent of the technical means to adopt them. Translation by adding language suffix: Category:Cars/fi (recommended)


 * Category page name not translated (just like the page names).
 * One category for each language.
 * Page translation could be used for the category itself: the categories would be linked together and the headings would be translated (but not the name of the category in links and such).

 No translation : Category:Cars


 * All translations in same category (good if only few languages, bad if many).
 * Category name not translated (can be put as is in the translation template).
 *  Headings 
 * Headings can in principle be tied to the following paragraph, but it is better to have them separated with an empty line. This way someone can quickly translate the table of contents before going into the contents.
 * Headings can in principle be tied to the following paragraph, but it is better to have them separated with an empty line. This way someone can quickly translate the table of contents before going into the contents.

When tagging headings, it is important to include the heading markup inside the tags and insert a newline between the opening translate tag and the heading markup, or MediaWiki will no longer identify them properly. For example, section editing only works with the recommended mark-up given in the example. The markup also immediately gives translators a context: they are translating a heading.  Wrong:  (no newline after tag, heading out of translate tags) {{#tag:syntaxhighlight|

translateCulture/translate

 * lang="html"}}

 Wrong:  (no newline)

 Recommended segmentation:  {{#tag:syntaxhighlight| {{^(}}translate{{)^}}

Culture
Lorem ipsum dolor. /translate
 * lang="html"}}


 *  Images 
 * Images that do contain language specific content like text should include the full image syntax in an unit. Other images can only tag the description with optional hint in message documentation of the page after it has been marked.
 * Images that do contain language specific content like text should include the full image syntax in an unit. Other images can only tag the description with optional hint in message documentation of the page after it has been marked.


 *  Links 
 * Links can be included in the paragraph they are inside. This allows changing the link label, but also changing the link target to a localized version if one exists.
 * Links can be included in the paragraph they are inside. This allows changing the link label, but also changing the link target to a localized version if one exists.

If the target page is (or should be) also translatable, you should link to it by prepending  to its title. Only the link label will need to be translated, because this automatically redirects users to the translation page in their own interface language, as selected for instance via the UniversalLanguageSelector. However, to achieve a constant behavior the syntax must be used for all links.

Because headings are translated, you cannot rely on the automatically generated id's for headings. You can add your own anchors. To have them outside of the translation template you need to break up the page into multiple tag pairs around each heading you want to have an anchor to.  Internal links: 

 Links to translatable pages: 

 External links: 

 Links within a page:  {{#tag:syntaxhighlight| span id=culture{{^(}}/span{{)^}} {{^(}}translate{{)^}}

Culture
Lorem ipsum dolor.

...

For more about food, see section about culture. /translate
 * lang="html"}}

Do so only if the items are sufficiently independent to be translated separately in all languages: don't create "lego messages". For instance, you must avoid to split a single sentence in multiple units, or to separate logically dependent parts which may affect each other (with regard to punctuation or style of the list, for instance). To split a list, use -tags for each item without including leading asterisks/hashes/semicolons. Do not insert blank lines as this will break the HTML output.
 *  Lists 
 * Lists can get long, so might want to split them into multiple parts with one item in each unit.
 * Lists can get long, so might want to split them into multiple parts with one item in each unit.

or


 *  Numbers 
 * With numbers and other non-linguistic elements you may want to pull the actual number out of translation and make it a variable. This has multiple benefits:
 * With numbers and other non-linguistic elements you may want to pull the actual number out of translation and make it a variable. This has multiple benefits:


 * You can update the number without invalidating translations.
 * Translation memory can work better when the changing number is ignored.

Note that this prevents the translators from localising the number by doing currency conversion. The  call makes sure the number is formatted correctly in the target language.


 *  Templates 
 * Templates have varying functions and purposes, so the best solution depends on what the template is for. If the template is not a part of longer paragraph, it should be left out, unless it has parameters that need to be translated. If the template has no linguistic content itself, you don't need to do anything for the template itself.
 * For an example of templates translated with page translation, see . To use this template, you need to have another template similar to Translatable navigation template, because you cannot include the template by  anymore. This is not yet provided by the Translate extension itself, but that is in the plans.
 * For an example of templates translated with page translation, see . To use this template, you need to have another template similar to Translatable navigation template, because you cannot include the template by  anymore. This is not yet provided by the Translate extension itself, but that is in the plans.

Another way is to use the unstructured element translation to translate the template, but then the language of the template will follow the user's interface language, not the language of the page they are viewing.

In some circumstances the additional markup added by this wrapping is not suitable.
 *  Attributes 
 * By default the Translate extension may wrap outdated translation units to highlight them and untranslated units to set proper language metadata.
 * By default the Translate extension may wrap outdated translation units to highlight them and untranslated units to set proper language metadata.

can be used to avoid that. 2020-09-15 is The above input may render as:
 *  Translation language 
 * When text is using language-dependent formatting methods, a mismatch may appear for untranslated sections.
 * When text is using language-dependent formatting methods, a mismatch may appear for untranslated sections.
 * : 2020-09-15 is Tuesday.
 * : 2020-09-15 on tiistai.

Without the magic word, untranslated text on a Finnish translation page would render as:
 * 2020-09-15 is tiistai
 * }

Changing the source text
General principles:


 * Avoid changes
 * Make the changes as isolated as possible
 * Do not add translation unit markers yourself

Unit markers. When page is marked for translation, the system will update the translatable page source and add unique identifiers, called "unit markers", for each translation unit. See example below. An example of a unit marker is. These unit markers are crucial for the system, which uses them to track changes to each translation unit. You should never add unit markers yourself. The unit markers are always on the line before the unit; or, if it starts with a heading, after the first heading on the same line. The different placement for headings is needed to keep section editing working as expected.

{{#tag:syntaxhighlight| {{^(}}translate{{)^}}

Birds
!--T:1-- Birds are animals which....

!--T:2-- Birds can fly and... /translate
 * lang=html}}

Changing unit text. Changing is the most common operation for translation units. You can fix spelling mistakes, correct grammar or do other changes to the unit. When re-marking the page for translation, you will see the difference in the unit text. The same difference is also shown to translators when they update their translations. For simple spelling fixes and other cases where you don't want the existing translations to be highlighted on the translated pages, you can avoid invalidating them: translators will still see the difference if they ever update the translation for any reason.

Adding new text. You can freely add new text inside tags. Make sure that there is one empty line between adjacent units, so that the system will see it as a new unit. You can also add tags around the new text, if it is not inside existing  tags. Again, do not add unit markers yourself, the system will do it.

Deleting text. You can delete whole units. If you do so, also remove the unit marker.

Splitting units. You can split existing units by adding an empty line in the middle of a unit, or by placing tags so that they split the unit. You can either keep the unit marker with the first unit or remove it altogether. In the first case, translators see the old text when updating the old translation. If you removed the unit marker, both units will behave as if no translation ever existed, after the page is re-marked for translation.

Merging units. If you merge units, you have to remove at least all but one unit marker.

Moving units. You can move units around without invalidating translations: just move the unit marker together with the rest of the unit.

Before marking the new version of the page for translation, ensure that the best practices are followed, especially that translators get a new translation unit if the content has changed. Also make sure that there are no unnecessary changes to prevent wasting translators time. If the source page is getting many changes, it may be worthwhile to wait for it to stabilize, and push the work for translators only after that.

Unused unit translations are not deleted automatically, but that should not cause trouble.

Migrating to page translation
If you have been translating pages before using the page translation system, you might want to migrate the pages to the new system, at least the ones you expect to have new translations and want statistics for. You will probably have existing templates for language switching and maybe different page naming conventions.

You can start migration by cleaning up, tagging and marking the source page. You can keep the existing language-switching templates while you migrate the old translations. If your pages follow the language code subpages naming convention, they will be replaced with the source text after marking the source page for translation, but you'll still be able to access translations from history.

This manual task has been partly automated by Special:PageMigration, which shows the source and target units besides each other and allows the user to adjust the units by providing a set of features mentioned later in this page.

How to use?
500px| Screenshot showing an example use of Special:PageMigration for "Help:Special pages" as page name and "fr" as language code.
 * 1) Go to Special:PageMigration
 * 2) Enter the title of the page and the language code. For example, "Help:Special pages" & "fr"
 * 3) The source text which was divided into units by Translate and the imported translations will be shown besides each other with some initial alignment.
 * 4) Use the actions available for each unit to manually do the remaining alignment
 * 5) As translated units are editable, do required manual improvements (for add translation variables, fix links and markup, etc.)
 * 6) Click on the "" button. This will create pages under the Translations namespace of the form  . The old translations have been imported into Translate.
 * 7) Else, if you wish to abort the importing, click on the 'Cancel' button.

Actions available
Each row consisting of source and target unit has a set of action icons. They are used as follows:
 * 1) Add: Clicking on this action icon adds a new empty unit below the current one. Use this feature if you want to split the current unit and need a unit below.
 * 2) Swap: Clicking on this action icon swaps the content of the current unit with the unit below it. You can use this feature when the units get aligned improperly due to different ordering of sections. Or when you need to drag a unit below or above. In either case, remember it swaps with the unit below and does not create any additional units.
 * 3) Delete: Clicking on this action icon completely removes the corresponding target unit from the page and shifts the remaining target units up by one unit. Use this to remove unwanted content like code or imported translations which are present completely in the source language. Note: this irrevocable action (in the current session).

Troubleshooting

 * 1) If you mark a page for translation and immediately go to the special page and try to import translations, you may get an error message like "". This is because FuzzyBot didn't fuzzy the messages on the old page yet: the tool won't find an edit by FuzzyBot on the translation page. In this case, simply wait for FuzzyBot to do its job. Once an edit is seen, you can proceed with the imports.
 * 2) Please wait for some time after pressing the "" button. While the button background remains gray, there is an ongoing process of importing non-empty units. Once the button becomes colored again, the import is completed.

Tips

 * 1) Migration will be easier if you first (before the mark to translation) check whether existing translations are similar to the original English text, and manually edit the structure of pages: break paragraphs and lists, add the missing headings (even if empty).
 * 2) Will be useful to check the result in the core translation interface - some of the units may be immediately marked as obsolete because of errors markup or if not all of the translation variables was added.
 * 3) Translation of the page title will have to be added manually. If you do not know very well the language of the imported page, you can try to find the translation of the page title among the "links here" or sometimes in redirects.