उपकरण: edit.php.net

इस साल, Yannick Torrès (yannick) ने PHP प्रलेखन के अनुवाद के लिए एक आसान वेब-आधारित उपकरण बनाया। edit.php.net हर किसी को आसानी से और जल्दी से किसी भी पेज का अनुवाद करने की अनुमति देता है।
यह लेख " PHP डॉक्यूमेंटेशन ट्रांसलेशन टीम नीड हेल्प " लेख की तकनीकी निरंतरता है।
UPD : हैबरा प्रभाव के कारण यह साइट पिछड़ सकती है।

---

मैनुअल के प्रत्येक पृष्ठ पर इसे edit.php.net में संपादित करने के लिए एक लिंक है।

उस पर क्लिक करके हम प्रमाणीकरण पृष्ठ पर पहुंच जाएंगे, जहां बिना किसी हिचकिचाहट के हम तुरंत अनुवाद के लिए रूसी भाषा चुनते हैं।

फिर हम अनुशंसा करते हैं कि आप तुरंत अपने Google या facebook खाते का उपयोग करके लॉग इन करें, इससे आप विभिन्न कंप्यूटरों से एक लॉगिन के तहत अनुवाद पर काम कर सकेंगे। (अन्यथा, एक अस्थायी बेनामी #xxxx खाता बनाया जाता है)। ऐसा करने के लिए, पहले दाईं ओर अपने Google या facebook खाते की पुष्टि करें, और फिर इस क्रेडेंशियल्स और बेनामी लॉगिन का उपयोग करें क्लिक करें।

यहाँ सभी प्रकार के उपयोगी विजेट के साथ साइट की होम स्क्रीन है, यद्यपि बहुत मजबूत नहीं है। बाईं ओर साइड मेनू है, जिसे प्रक्रिया में छिपाया जा सकता है, ताकि हस्तक्षेप न हो। अधिकांश मेनू आइटम सहज हैं। हम आपको edit.php.net में फ़ाइलों के अनुवाद का एक अनुमानित चक्र बताएंगे:

1) चुनें कि क्या अनुवाद करना है: अनट्रांसलेटेड फ़ाइलें या गैर-अपडेटेड फ़ाइलें। या आप "प्रूफरीडिंग के लिए फ़ाइलें" अनुभाग से सत्यापन के लिए फ़ाइलों का चयन कर सकते हैं।
2) जैसे ही आप किसी फ़ाइल का अनुवाद करना शुरू करते हैं, यह "प्रगति की फाइल" में चला जाता है और आपको सौंपा जाता है। यदि आप एक गैर-अद्यतन फ़ाइल को संपादित कर रहे हैं, तो आप पुराने संस्करण की तुलना में इसके अंग्रेजी संस्करण को भी देखेंगे और इसमें बदलाव करेंगे।

समाप्त अनुवाद के साथ प्रत्येक फ़ाइल की शुरुआत में, तीन विशेष टैग की आवश्यकता होती है

<!-- EN-Revision: 301114 Maintainer: someone Status: ready --> <!-- Reviewed: no --> <!-- $Revision: 311957 $ --> 

पहला टैग अनुवाद के समय मूल अंग्रेजी फ़ाइल के संशोधन, अनुवाद की स्थिति, साथ ही उस व्यक्ति के उपनाम को इंगित करता है जो भविष्य में इस फ़ाइल का अनुवाद करेगा (यह दुर्भाग्य से आपका उपनाम नहीं है, लेकिन जिम्मेदार प्रतिभागी ru-doc का SVV खाता है)।
उदाहरण: अंग्रेजी फ़ाइल में एक टैग है <! - $ संशोधन: 111111 $ ->, रूसी फ़ाइल में टैग <! - EN-Revision: 111111 रखरखाव: किसी की स्थिति: तैयार ->।

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

अंतिम टैग तकनीकी है, इसमें अनुवादित फ़ाइल का संशोधन शामिल होगा।
यानी यह पर्याप्त है कि यह बस उदाहरण के लिए था, संख्या के बिना <! - $ संशोधन: $ -> बिल्कुल।

3) जब फ़ाइल का अनुवाद या सत्यापन पूरा हो जाता है - फाइल के संदर्भ मेनू में आप सत्यापन के लिए "पैच" बना सकते हैं। UPD : एक पैच होना चाहिए - यह वह है जो हमें संकेत देता है कि आपने फ़ाइलों का अनुवाद करना समाप्त कर दिया है!


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

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

कृपया पहले से ध्यान दें कि हम संख्या में कम हैं और हम अपने समय में अनुवाद में लगे हुए हैं। यदि स्वयंसेवकों की आमद है, तो आपके पैच की जाँच में देरी हो सकती है।

विकल्प

प्रारंभ में, कोई edit.php.net नहीं था, लेकिन एक svn भंडार था। बल्कि, यह नहीं था, लेकिन यह है। संक्षेप में, edit.php.net भी इस भंडार के साथ काम करता है। यह एसवीएन के साथ सीधे काम करने और डॉकबुक टूल का उपयोग करने के लिए अधिक सुविधाजनक है।

तो, ऑनलाइन संपादक आपके लिए असुविधाजनक है, आपके पास अपना खुद का शांत संपादक या आईडीई है, जिसमें आपकी उत्पादकता चार्ट से दूर है। खैर, या सिर्फ इंटरनेट हमेशा उपलब्ध नहीं है, किसी भी मामले में, svn के माध्यम से स्थानीय काम के विकल्प पर विचार करें।

आपको कमांड लाइन (जिसे php cli भी कहा जाता है) से चलने वाले किसी भी XML एडिटर, svn क्लाइंट और php की आवश्यकता होगी।

मैं अन्य प्लेटफार्मों के लिए Ubuntu 11.04 के लिए स्थापना का वर्णन करूंगा, तदनुसार अनुकूलित करें।

इसलिए, दस्तावेज़ीकरण के साथ काम करने के लिए, तथाकथित स्पार्सड रिपॉजिटरी का उपयोग करना सुविधाजनक है, एक बार में 3 रिपॉजिटरी का संयोजन:

• डॉक्टर-बेस (अनुवाद विधानसभा के लिए सिस्टम स्क्रिप्ट)
• एन (अंग्रेजी में प्रलेखन का मूल संस्करण)
• आरयू (रूसी में प्रलेखन का अनुवाद)

 $ svn co https://svn.php.net/repository/phpdoc/modules/doc-ru/ phpdoc-ru 

यह कमांड हमें उन सभी फाइलों को अपलोड करेगा, जिनकी हमें phpdoc-ru फ़ोल्डर में ज़रूरत है (वैसे, एक समान लिंक, svn.php.net/viewvc/phpdoc/modules/doc-ru के माध्यम से वेब ब्राउज़ करना सुविधाजनक है जहां रिपॉजिटरी को व्यूह द्वारा बदल दिया जाता है)।

अपलोड पूरा होने पर, आप पहले से प्राप्त फ़ाइलों के साथ काम कर सकते हैं। कार्य की योजना ऑनलाइन संपादक की तरह ही है:

1) अनुवाद के लिए एक फ़ाइल चुनें
2) जांचें कि वह अब किसी के साथ व्यस्त नहीं है ( doc.php.net/trantools/revcheck_extended_ru.html और edit.php.net के "प्रगति में फ़ाइलें" खंड में)
3) अनुवाद करना चाहिए और अनुवाद को व्यवस्थित करना चाहिए (शीर्ष पर 3 सिस्टम टैग, इंडेंट स्तर 1 स्थान होना चाहिए - कोई टैब नहीं)

महत्वपूर्ण! अनुवाद पूरा होने के बाद, आपको यह सुनिश्चित करने की ज़रूरत है कि आपने कुछ भी नहीं तोड़ा, यानी एक निर्माण। यह निम्नलिखित कमांड के साथ किया जाता है:

 $ php doc-base/configure.php --with-lang=ru 

सफल होने पर निष्कर्ष सभी को अच्छा होना चाहिए। बचत .manual.xml ... किया।
(इसके अलावा, अंत में, एक सेगमेंटेशन दोष क्रैश हो सकता है, यदि आप PHP <5.3.7 का उपयोग करते हैं - तो चिंता की कोई बात नहीं है, यह बिल्ड स्क्रिप्ट की गति को अनुकूलित करने का एक साइड इफेक्ट है। Segfault को अक्षम किया जा सकता है, लेकिन इससे थोड़ी लंबी स्क्रिप्ट का निर्माण होगा - विकल्पों की सूची। बिल्ड स्क्रिप्ट को कमांड का उपयोग करके देखा जा सकता है

 $ php doc-base/configure.php --help 

यदि कमांड कुछ भी प्रदर्शित नहीं करता है, तो चिंता न करें, हैप शिटेंस करता है, तो आपने गलती की है और आपको इसे ठीक करने की आवश्यकता है। उदाहरण के लिए, यह एक अस्पष्ट टैग या प्रकार और त्रुटि की अज्ञात xml इकाई हो सकती है; आप --enable-xml-details विकल्प को जोड़कर उन्नत त्रुटि रिपोर्टिंग सक्षम कर सकते हैं। ध्यान दें कि इस मोड में, विधानसभा बहुत अधिक मेमोरी का उपयोग कर सकती है।

एक पैच प्रस्तुत करना

तो, आपने पाठ का सफलतापूर्वक अनुवाद किया है और बिल्ड एकत्र किया है। चूंकि आपके पास एक svn खाता नहीं है, आप अपना काम खुद नहीं कर सकते, आपको एक पैच बनाने और मेलिंग सूची में भेजने की आवश्यकता है। यह बहुत आसान है।
पैच निम्न कमांड द्वारा बनाया गया है (रूसी रिपॉजिटरी के फ़ोल्डर में इसे निष्पादित करना उचित है, अर्थात हमारे उदाहरण में phpdoc-ru / ru)।

 $ svn diff > good-patch-name.patch.txt 

जहां अच्छा-पैच-नाम उस पैच का अनुकूल नाम है जो बताता है कि आपने क्या अनुवाद किया है। Txt एक्सटेंशन पर भी ध्यान दें - यदि आप किसी अन्य एक्सटेंशन को निर्दिष्ट करते हैं तो मेलिंग सूची आपके पैच को स्वीकार नहीं करेगी।
उसके बाद, आपको मेलिंग सूची को एक पत्र लिखने और इसे बनाए गए पैच को संलग्न करने की आवश्यकता है। वह सब है! :)

आप बाद में कमांड से रिपॉजिटरी को अपडेट कर सकते हैं

 $ svn up 

जिसे रिपॉजिटरी (phpdoc-ru) की जड़ से भी चलाया जाना चाहिए।

अंतभाषण

द्वारा तैयार लेख: conf , irker यदि आपको लेख में कोई टाइपो या गलती मिलती है, तो कृपया मुझे एक निजी संदेश में उनके बारे में लिखें।

अद्यतन: सुस्त में चैट अनुवादक