परिचय
टेम्पलेट आपकी PicoPixel फ़ाइल होती है, जिसे दूसरे लोग अपने काम की शुरुआत के लिए इस्तेमाल कर सकते हैं। उन्हें खाली स्क्रीन से बनाने के बजाय आपका लेआउट, विजेट और स्टाइल तैयार मिलते हैं।
टेम्पलेट GitHub के ज़रिए भेजे जाते हैं। सार्वजनिक रिपॉज़िटरी में अपनी .picopixel फ़ाइल, डिज़ाइन की तस्वीरें और README रखें। स्वीकार होने पर प्रोजेक्ट आपके नाम के साथ टेम्पलेट गैलरी में आता है, जहाँ सभी उसे देख और इस्तेमाल कर सकते हैं।
इस गाइड में रिपॉज़िटरी तैयार करना, फ़ॉर्म भरना, साझा करने की अनुमतियाँ और समीक्षा के लिए ज़रूरी बातें समझें।
शुरू करने से पहले
दो चीज़ें तैयार रखें:
- GitHub खाता। रिपॉज़िटरी GitHub पर होनी चाहिए। खाता नहीं है तो यहाँ बनाएँ।
- तैयार डिज़ाइन।
.picopixelफ़ाइल को जाँचकर PicoPixel से एक्सपोर्ट करें, ताकि उसे रिपॉज़िटरी में रख सकें।
फ़ॉर्म खोलने के लिए PicoPixel ऐप में Google या GitHub से साइन इन करें।
GitHub रिपॉज़िटरी तैयार करें
नई सार्वजनिक रिपॉज़िटरी बनाएँ और ये तीन चीज़ें रखें:
1. .picopixel फ़ाइल
अपनी तैयार .picopixel फ़ाइल रिपॉज़िटरी के मुख्य फ़ोल्डर में रखें। लोग यही फ़ाइल डाउनलोड करके एडिटर में खोलेंगे।
2. डिज़ाइन की तस्वीरें
ऐसी तस्वीरें जोड़ें जो डाउनलोड से पहले डिज़ाइन समझने में मदद करें:
- मुख्य फ़ोल्डर या
images/जैसे फ़ोल्डर में रखें। .png,.jpgया.webpफ़ॉर्मेट इस्तेमाल करें।- कम से कम एक स्क्रीनशॉट में काम करता हुआ डिज़ाइन दिखाएँ। कई स्क्रीन या अलग-अलग दृश्य हों तो और अच्छा है।
- तस्वीर इतनी बड़ी हो कि विवरण साफ़ दिखे, लेकिन फ़ाइल बेवजह भारी न हो।
3. README
मुख्य फ़ोल्डर में README.md लिखें। गैलरी में यही टेम्पलेट का विवरण बनता है, इसलिए इसे नए उपयोगकर्ता को समझाने वाला पेज मानें। इसमें लिखें:
- टेम्पलेट क्या है और किस काम के लिए है।
- रिज़ॉल्यूशन और हार्डवेयर: किस बोर्ड या डिस्प्ले के लिए बनाया गया है।
- क्या शामिल है: स्क्रीन, विजेट और मुख्य सुविधाएँ। जैसे “दो स्क्रीन: मुख्य डैशबोर्ड और सेटिंग पेज, जिनमें स्लाइडर, स्विच और घड़ी का विजेट है।”
- श्रेय: साझा करने की अनुमति वाले बाहरी एसेट इस्तेमाल किए हों तो उनके नाम और स्रोत दें।
मान लें पाठक आपके प्रोजेक्ट के बारे में कुछ नहीं जानता। README से उसे समझ आना चाहिए कि यह क्या है और उसके काम आएगा या नहीं।
यह छोटा उदाहरण देखें:
# Weather Dashboard Template
A clean two-screen weather dashboard designed for 320×240 TFT displays.
## What's included
- **Home screen** — current temperature, humidity, and a 3-day forecast row
- **Settings screen** — unit toggle (°C/°F), update interval slider, and Wi-Fi status
## Built for
- 320×240 resolution
- ILI9341 or similar TFT displays
## Credits
Weather icons from [Meteocons](https://bas.dev/work/meteocons) (MIT license).फ़ॉर्म भरें
रिपॉज़िटरी तैयार हो जाए तो:
- PicoPixel ऐप खोलकर साइन इन करें।
- बाएँ साइडबार में सबसे नीचे अपने खाते पर क्लिक करें और Your account चुनें।
- खाते के साइडबार में Submit Template खोलें।
फ़ॉर्म में तीन फ़ील्ड हैं:
- GitHub Repo Link: सार्वजनिक रिपॉज़िटरी का URL, जैसे
https://github.com/yourname/my-template। टीम को इसे खोलने की पहुँच होनी चाहिए। भेजने से पहले.picopixelफ़ाइल, तस्वीरें और README की मौजूदगी जाँचें। - Author / Credits: निर्माता के रूप में दिखाया जाने वाला नाम। जिन और लोगों को श्रेय देना है, उनके नाम भी जोड़ें।
- Notes: वैकल्पिक जानकारी जो टीम को चाहिए लेकिन सार्वजनिक विवरण में नहीं है। जैसे कोई तस्वीर गैलरी में नहीं दिखानी हो या डिज़ाइन का अतिरिक्त संदर्भ देना हो।
जानकारी जाँचकर फ़ॉर्म भेजें।
अधिकार और अनुमतियाँ
टेम्पलेट भेजने पर आप कुछ अधिकार देते हैं। पहले इन्हें ध्यान से पढ़ें।
ऐसी सामग्री न भेजें जिसे साझा करने का अधिकार आपके पास नहीं है। रिपॉज़िटरी की हर चीज़ — .picopixel फ़ाइल, इमेज, फ़ॉन्ट, आइकन और अन्य एसेट — आपकी अपनी रचना होनी चाहिए या आपके पास उसे सार्वजनिक रूप से साझा करने की स्पष्ट अनुमति होनी चाहिए।
भेजने पर आप PicoPixel को रिपॉज़िटरी की सामग्री खोलने, डाउनलोड करने और समुदाय की गैलरी में सार्वजनिक रूप से प्रकाशित करने की अनुमति देते हैं। प्रकाशित टेम्पलेट बिना कॉपीराइट प्रतिबंध या लाइसेंस संबंधी शर्तों के उपलब्ध होते हैं, ताकि कोई भी उन्हें अपने प्रोजेक्ट में, व्यावसायिक काम के लिए भी, इस्तेमाल कर सके। आपका नाम दिखता रहेगा, लेकिन दूसरों को टेम्पलेट इस्तेमाल करने की स्वतंत्रता होगी।
केवल वही काम भेजें जिसे आप इन शर्तों पर साझा करना चाहते हैं। किसी बाहरी फ़ॉन्ट, आइकन या इमेज को बिना रोक-टोक बाँटने का अधिकार स्पष्ट न हो तो उसे पहले हटा दें। संदेह होने पर उसे शामिल न करना बेहतर है, ताकि टेम्पलेट बाद में हटाना न पड़े।
PicoPixel दूसरों के अधिकारों का उल्लंघन करने वाली सामग्री हटा सकता है। सेवा की शर्तें देखें।
भेजने के बाद क्या होता है?
टीम रिपॉज़िटरी की कॉपी लेकर समीक्षा करती है। इसमें जाँचा जाता है कि .picopixel फ़ाइल खुलती है, तस्वीरें और README उपयुक्त हैं और सामग्री सेवा की शर्तें पूरी करती है।
कुछ स्पष्ट या ठीक करना हो तो टीम संपर्क कर सकती है। स्वीकार होने पर टेम्पलेट गैलरी में आपके नाम और README विवरण के साथ प्रकाशित होता है। फिर कोई भी उसे अपने डिज़ाइन की शुरुआत बना सकता है।
भेजने के बाद रिपॉज़िटरी बनाए रखें। आगे कोई बग ठीक करें, तस्वीर बदलें या विवरण सुधारें तो रिपॉज़िटरी अपडेट करके टीम को बताएँ।
प्रकाशित टेम्पलेट में सुधार या उसे हटाने की ज़रूरत हो तो सामग्री की रिपोर्ट करने का तरीका देखें।
आगे क्या पढ़ें
- टेम्पलेट गैलरी: समुदाय के प्रोजेक्ट देखें।
- Pet भेजें: एनिमेटेड स्प्राइट साझा करें।
- सामग्री की रिपोर्ट करें: pet या टेम्पलेट की समस्या बताएँ।
- सेवा की शर्तें: साझा की गई सामग्री पर लागू नियम पढ़ें।