Commons:फ़ाइल कैप्शन्स

फ़ाइल कैप्शन्स

फ़ाइल कैप्शन्स एक सुविधा हैं जो संरचित डेटा (सक्षम होने वाले पहले भाग) के भाग हैं। इनका इस्तेमाल फ़ाइलों के बारे में संक्षिप्त बहुभाषी विवरण रखने के लिए किया जाता है। अधिक जानकारी के लिए Help:फ़ाइल कैप्शन देखें। इन्हें जनवरी 2019 में विकिमीडिया कॉमन्स पर सक्षम किया गया था।

एक अच्छा कैप्शन कैसा दिखता है?

फ़ाइल कैप्शन्स पर सटीक दिशानिर्देश अभी तक विकसित नहीं किए गए हैं।

कैप्शन्स को संक्षिप्त बनाने वाली तकनीकी आवश्यकताएँ हैं (लंबाई में 255 कैरेक्टर्स तक सीमित, और मार्कअप नहीं हो सकता)।

अक्सर पूछे जाने वाले प्रश्न

यह फ़ाइल विवरणों से अलग कैसे है?

• कैप्शन्स को सरल और संक्षिप्त होना चाहिए। जहाँ विवरण काफ़ी विस्तृत हो सकते हैं, कैप्शन्स को लंबाई में 255 कैरेक्टर्स तक सीमित किया जाता है, उनमें मार्कअप नहीं हो सकता (जैसे विकिटेक्स्ट कड़ियाँ या HTMl) और उनपर बाहरी कड़ियाँ जोड़ी नहीं जा सकतीं।
• कैप्शन्स हमारी संरचित डेटा के साथ उपलब्ध होते हैं, जबकि विवरणों के साथ ऐसा नहीं है। तकनीकी शब्दों में, एक विवरण किसी Information साँचे में लपेटे भाषा के साँचे में लपेटा सादा विकिटेक्स्ट होता है; जबकि कैप्शन्स विकिबेस लेबल्स होते हैं। इसलिए इन्हें API की मदद से ढूँढ़ा जा सकता है, जिससे उन्हें मेटाडेटा के रूप में आसानी से फ़ाइलों से ढूँढ़ा/छाना/प्राप्त किया जा सकता है।

कई मामलें में कैप्शन विवरण (या फ़ाइल के शीर्षक!) से मिलता-जुलता या समान होगा। उदाहरणस्वरूप, File:Fire station Hallstatt - October 2017 - 02.jpg पर अंग्रेज़ी भाषा में कैप्शन "Hallstatt fire station in October 2017" है।

इसके विपरीत, Pluto-01 Stern 03 Pluto Color TXT.jpg पर एक काफ़ी बड़ा विवरण (858 कैरेक्टर्स और कड़ियों सहित) और कैप्शन काफ़ी छोटा है (काफ़ी हद तक उस चित्र का इस्तेमाल करने वाले विकिपीडिया पृष्ठों पर इस्तेमाल किया गया कैप्शन ही)।

क्या मैं (या कोई बॉट) कैप्शनों पर विवरणों की प्रतिलिपि नहीं बिठा सकता?

सबसे पहले, कैप्शन विवरणों से काफ़ी छोटे होते हैं; उनमें कड़ियाँ या विकि मार्कअप नहीं हो सकते।

जहाँ विवरणों से कैप्शन तक टेक्स्ट के छोटे टुकड़ो की प्रतिलिपि बनाना संभव हो सकता है, इसमें किसी इंसान को मदद करनी पड़ेगी।

सिर्फ उसी टेक्स्ट की कैप्शनों पर प्रतिलिपि बनाई जानी चाहिए जो इतना छोटा है कि कॉपीराइट के अयोग्य हो, क्योंकि कैप्शनों को CC0 ("सार्वजनिक डोमेन") अधित्याग के अंतर्गत प्रकाशित किया जाता है।

कैप्शन के क्या फ़ायदे हैं?

सबसे बड़े फ़ायदो में से एक है भाषा-जागरूक खोज में सुधार। साधारण फ़ाइल विवरण विकिटेक्स्ट में हैं, और उन्हें सिर्फ पूर्ण-टेक्स्ट खोज से ढूँढ़ा जा सकता है, जो श्रेणियों और लाइसेंस साँचों के साथ पृष्ठ की पूरी सामग्री में खोजता है; और इसका इस्तेमाल किसी विशिष्ट भाषा के लिए नहीं किया जा सकता है। क्योंकि इन्हें API की मदद से खोजा जा सकता है, इससे तृतीय-पक्ष पुनः उपयोक्ता भी मीडिया और कैप्शन्स को ढूँढ़ सकते हैं और उनका पुनः उपयोग कर सकते हैं।

कुछ दूसरे फ़ायदे हैं:

• इन्फ़ोबॉक्सों में भरा जा सकता है
• किसी विशिष्ट भाषा में अनुपलब्ध कैप्शन्स वाली फ़ाइलों को क्वेरी किया जा सकता है
• किसी परियोजना या अभियान के लिए ज़रूरी फ़ाइलों के अनुवाद के लिए सूचियाँ बनाना जिन्हें स्थानीयकृत कैप्शन्स की ज़रूरत है
• …

कैप्शन्स को कहाँ रखा जाता है?

कैप्शन्स को विकिमीडिया कॉमन्स पर विकिबेस के हिस्से के रूप में (यानी विकिटेक्स्ट के साथ नहीं) रखा जाता है। उन्हें विकिडेटा पर नहीं रखा जाता है। हालाँकि विकिबेस विकिडेटा को संचालित करता है, इसे यहाँ विकिमीडिया कॉमन्स पर भी तैनात किया गया है।

मैं कैप्शन से कैसे खोजूँ?

सदस्य किसी भी दूसरी चीज़ की तरह फ़ाइलों को उनके MediaInfo कैप्शनों की मदद से ढूँढ़ सकते हैं। उदाहरणस्वरूप, अगर कोई सदस्य आइफ़ल टावर का एक चित्र अपलोड करता है और बहुभाषी फ़ाइल कैप्शनों के रूप में 'Tour Eiffel' (फ़्रांसीसी) और 'Eiffel Tower' (अंग्रेज़ी) डालता है, आप चित्र को 'Eiffel Tower' या 'Tour Eiffel' की मदद से ढूँढ़ सकते हैं।

X Y और Z भाषाएँ मुझे क्यों दिखाई जाती हैं?

अगर आपने लॉग-इन किया हुआ है, दिखाई जाने वाली भाषाएँ वो भाषाएँ हैं जिन्हें आपने अपने सदस्य पृष्ठ पर बेबल बक्सों में सूचीबद्ध किया है।

मैं कैप्शन्स की दिखावट को कैसे बदलूँ?

आप अपनी वरीयताओं में निम्न गैजेट्स को सक्षम कर सकते हैं ("Interface: Files and categories" के नीचे):

• कैप्शन ब्लॉक को छोटा करके ज़रूरत पड़ने पर उसे विस्तृत करने के लिए एक कड़ी जोड़ने के लिए: 'Collapse Captions' (स्क्रिप्ट का मुख्य कोड, अतिरिक्त स्टाइल कोड)
• कैप्शन ब्लॉक को थोड़ा और कॉम्पैक्ट बनाने के लिए: 'Compact Captions' (कोड)
• कैप्शनों को पूरी तरह से छिपाने के लिए 'Hide Captions' (कोड)

आप चाहें तो 'Collapse Captions' और 'Compact Captions' को एक साथ मिला सकते हैं।

साथ में नीचे का स्टाइलिंग अनुभाग देखें।

तकनीकी

मैं API की मदद से कैप्शन्स को कैसे क्वेरी करूँ?

इस समय API का समर्थन सीमित है, मगर इसे जल्द सुधारा जाएगा।

आप wbgetentities मॉड्यूल की मदद से सत्ता ID से कैप्शन्स प्राप्त कर सकते हैं। हर फ़ाइल के लिए एक विकिबेस सत्ता ID MXXXX है, जहाँ XXXX page_id है। उदाहरणस्वरूप, File:Pluto-01 Stern 03 Pluto Color TXT.jpg के पास पृष्ठ ID 41837276 है, तो सत्ता ID है M41837276, और आप wbgetentities&ids=M41837276 को क्वेरी कर सकते हैं। Mid पाने का एक आसान तरीका है action=query&prop=info&titles=File:Pluto-01_Stern_03_Pluto_Color_TXT.jpg API का इस्तेमाल करना (पृष्ठ ID pageid फ़ील्ड द्वारा दी जाती है)।

मैं लुआ/साँचों की मदद से कैप्शन्स को कैसे क्वेरी करूँ?

लुआ से आप Module:Information के {{File caption}} साँचे के साँचा इंटरफ़ेस वाले '_SDC_Description' फ़ंक्शन से इन तक पहुँच सकते हैं।

मैं अपलोड करते समय कैप्शन्स कैसे सेट करूँ?

अपलोड विज़ार्ड में कैप्शन जोड़ना।

आप अपलोड विज़ार्ड की मदद से अपलोड करते समय कैप्शन्स भर सकते हैं। आप कड़ी की मदद से अपलोड विज़ार्ड को कॉल करते समय URL-पैरामीटर 'caption' और 'captionlang' की मदद से कैप्शन को प्री-फ़िल कर सकते हैं, जैसे किसी अपलोड अभियान के लिए।

अपलोड करने के दूसरे साधनों के लिए समर्थन भविष्य में जोड़ी जाएगी − आप अलग-अलग बग ट्रैकर्स पर कार्य पर ध्यान रख सकते हैं Pywikibot के लिए, कॉमन्स के Android ऐप के लिए या Pattypan के लिए।

मैं API की मदद से कैप्शन्स को कैसे सम्पादित करूँ?

आप विकिबेस सत्ता ID MXXXX के साथ API के wbsetlabel मॉड्यूल का इस्तेमाल कर सकते हैं (अधिक विस्तार के लिए क्वेरी करने के बारे में अनुभाग देखें)।

स्टाइलिंग

कैप्शन्स फ़ॉर्म फ़ील्ड को कैस्केडिंग स्टाइल शीट्स की मदद से स्टाइल किया जा सकता है। नियमों को अपनी common.css फ़ाइल या फिर Stylus Userstyles Manager या xStyle जैसे किसी ब्राउज़र ऐड-ऑन पर जोड़ें। द्वितीय मामले में आपको इसे commons.wikimedia.org डोमेन तक सीमित करना होगा।

छोटे मोड में कैप्शन दिखाएँ

'Collapse Captions' गैजेट की मदद से आपको डिफ़ॉल्ट से छोटे मोड में 'विस्तृत करें' स्ट्रिंग के अलावा सिर्फ एक खाली बक्सा नज़र आएगा। निम्न कोड कैप्शन को इस स्थिति में दृश्य बना देगा (यानी आपकी भाषा में Captions):

.mw-collapsible-content { display: initial !important; }
.mw-slot-header,
.wbmi-entityview-captionsPanel.mw-collapsed .mw-collapsible-content *:not(.wbmi-entityview-captions-header)
	{ display: none; }
.wbmi-entityview-captionsPanel.mw-collapsed .wbmi-entityview-captions-header	{
	display: block;
	border-bottom: none;
	margin-bottom: 0;
	padding-top: 0;
	font-style: italic;
	font-weight: normal;
}
.ltr .mw-collapsible-content .wbmi-entityview-captions-header { text-align: right; }
.rtl .mw-collapsible-content .wbmi-entityview-captions-header { text-align: left; }
.rtl .mw-collapsible-toggle { float: left; }

नोट्स:

• जिस विधि से इस प्रदर्शन में पंक्ति क्रमांक दिखाया जाता है, उसकी वजह से नियमों की प्रतिलिपि बनाने पर आपको हर पंक्ति के बाद एक खाली पंक्ति मिल सकती है। आप चाहे तो उन खाली पंक्तियों को हटा सकते हैं। एक टैब कैरेक्टर की मदद से इनडेंटेशन भी है, जिसे यहाँ पर नहीं दिखाया गया है।
  यह पंक्ति क्रमांक सहित निम्न नियमों पर भी लागू होता है।
• पंक्ति 1: परीक्षणों में !important वााल हिस्सा ज़रूरी था। यह यहाँ कॉमन्स पर common.css के कोड एडिटर में एक चेतावनी पैदा करेगा। शायद इस फ़ाइल के इस्तेमाल के दौरान इसे हटा भी दिया जा सकता है (सिर्फ ब्राउज़र ऐड-ऑन के साथ परीक्षित)
• पंक्ति 2: यह हैडर (आपकी भाषा में Structured data) को हटा देगा। अगर आप इसे दिखाना चाहते हैं, कॉमा सहित इस पंक्ति को हटा दें।
• पंक्तियाँ 10 से 12 दृश्य कैप्शन के प्रारूपण के लिए हैं। अगर आपको डिफ़ॉल्ट सीधा बोल्ड स्ट्रिंग चाहिए, इन पंक्तियों को हटा दें।
• पंक्तियाँ 13 से 14: ज़्यादातर मामलों में आपको इन दोनों पंक्तियों में से सिर्फ किसी एक की ज़रूरत होगी, लेकिन आप दोनों की एक साथ भी प्रतिलिपि बना सकते हैं। उनके शुरुआती हिस्से को देखकर तय करें कि आपको किसकी ज़रूरत है:
  • .ltr: लातिन लिपि जैसी बाईं-से-दाईं लेखन प्रणालियाँ (उदाहरण: अंग्रेज़ी)।
  • .rtl: अरबी लिपि जैसी दाईं-से-बाईं लेखन प्रणालियाँ।
• अगर आप शुरुआत में डिफ़ॉल्ट स्ट्रिंग को रखना चाहते हैं (LTR प्रणालियों के लिए बाईं ओर, RTL प्रणालियों के लिए दाएँ ओर), इन पंक्तियों को हटा दें।
• पंक्ति 15 की ज़रूरत सिर्फ RTL प्रणालियों को पड़ेगी। यह छोटा और विस्तृत करने के टॉगल को पृष्ठ के बाएँ ओर भेज देता है। यह नियम दूसरे कॉमन्स पृष्ठों पर दूसरे सभी टॉगल्स के लिए भी सक्रिय होगा।

बस दिखावट के लिए अतिरिक्त स्टाइलंग; इन्हें उपरोक्त नियमों के नीचे जोड़ें:

.wbmi-entityview-captionsPanel.mw-collapsed .wbmi-entityview-captions-header::after { content: " …"; }
.wbmi-entityview-captionsPanel:not(.mw-collapsed) .wbmi-entityview-captions-header {
	border-bottom: none;
	text-decoration: underline;
}

टिप्पणियाँ

• पंक्ति 1: अगर content: " …"; के अंदर का एलिप्सिस आपकी भाषा के साधारण स्टाइल के अनुसार नहीं है, इसे इच्छानुसार बदल दें, मगर उद्धरण चिह्नों को न हटाएँ! अगर जोड़ी गई सामग्री आपकी लेखन प्रणाली के अनुसार गलत दिशा में है, after को before से बदल दें।
• पंक्तियाँ 2 से 5 विस्तृत मोड में कैप्शन के लिए हैं। अगर आप इसे रेखांकित नहीं करना चाहते हैं, पंक्ति 4 को हटा दें।

अधिक कॉम्पैक्ट छोटा मोड

… मगर 'Compact Captions' गैजेट जितना कॉम्पैक्ट नहीं

छोटे रेसोल्यूशन्स पर यह उन सभी फ़ाइलों पर पूर्वावलोकन और आकार की जानकारी के साथ छेड़छाड़ करेगा जहाँ मीडिया वीक्षक मौजूद नहीं है (यानी फ़ाइलें जो image फ़ाइल प्रकार के नहीं है)। नीचे का पहला नोट देखें।

.mw-slot-header { display: none; }
.wbmi-entityview-captionsPanel:not(.mw-collapsed) .wbmi-entityview-captions-header
	{ border-bottom: none; }
.wbmi-entityview-captionsPanel {
	border: none;
	margin-top: -1.5em;
}
.wbmi-entityview-captionsPanel .wbmi-entityview-captions-header {
	margin-bottom: 0;
	padding-top: 0;
}
.wbmi-entityview-captionsPanel .wbmi-entityview-entitycontent {
	padding: 0.3em 0;
}

नोट्स:

• अगर ब्लॉक पहले के टेक्स्ट ब्लॉक के साथ छेड़छाड़ करता है, पंक्ति 6 को हटा दें या कम-से-कम वैल्यू की मात्रा को घटाएँ। margin-top: -0.5em; का इस्तेमाल किया जा सकता है।
• पंक्तियाँ 1 से 3 को हटा दिया जा सकता है अगर आप ऊपर के नियमों पर कोई बदलाव नहीं करते हैं, लेकिन भविष्य के सम्पादनों में इस बारे में याद रखने पर इससे कोई नुकसान नहीं होगा।

बस दिखावट के लिए अतिरिक्त स्टाइलिंग:

.wbmi-entityview-captions-header .wbmi-entityview-editButton { font-size: smaller; }
.ltr .wbmi-entityview-editButton { margin-left: 0.25em !important; }
.rtl .wbmi-entityview-editButton { margin-right: 0.25em !important; }
.wbmi-entityview-editButton::before { content: "("; }
.wbmi-entityview-editButton::after { content: ")"; }

नोट्स:

• पंक्तियाँ 2 से 3: .ltr और .rtl के लिए नोट्स पढ़ें।
• पंक्तियाँ 4 से 5: अगर आप सम्पादन स्ट्रिंग (आपकी भाषा में Edit) के आस-पास कोष्ठकों को हटाना चाहते हैं, या तो दोनों नियमों को हटा दें या फिर उन्हें content: "…"; के अंदर इच्छानुसार किसी कैरेक्टर से बदल दें, मगर उद्धरण चिह्नों को न हटाएँ!