Extension:Score/hi

Score एक्सटेंशन की मदद से आप LilyPond के ज़रिए PNG चित्रों के रूप में संगीत स्कोर्स को रेंडर कर सकते हैं, और उन्हें ऑडियो और MIDI फ़ाइलों में भी बदल सकते हैं।

श्रेय

 * मूल को Johannes E. Schindelin द्वारा लिखा गया था।
 * यह एक्सटेंशन Tim Starling द्वारा के एक कोड निरीक्षण पर आधारित है।
 * मूल को River Tarnell द्वारा लिखा गया था।

उपयोग
सेटअप के बाद आप अपने विकिटेक्स्ट पर  टैग की मदद से साधारण LilyPond नोटेशन एम्बेड कर सकते हैं। उदाहरणस्वरूप:

का अंजाम होगा:

आप साधारण रूप में score टैग्स को एट्रीब्यूट्स भी प्रदान कर सकते हैं

.

उदाहरणस्वरूप:

का अंजाम होगा:

निम्नलिखित एट्रीब्यूट्स उपलब्ध हैं:



LilyPond की भाषा
बोल (लिरिक्स) ऐसे जोड़े जा सकते हैं:

उन्नत सदस्य, आवाज़ के MIDI यंत्र को बदलने के लिए कमांड का इस्तेमाल कर सकते हैं।

पूर्व अपेक्षित गुण
निम्नलिखित पैकेजेस अनुशंसित हैं:


 * LilyPond
 * Ghostscript
 * ImageMagick
 * FluidSynth
 * Firejail

यह एक्सटेंशन स्कोर के चित्रों को रेंडर करने के लिए LilyPond का इस्तेमाल करता है, तो आपको LilyPond की एक कार्यरत स्थापना की ज़रूरत होगी (Special:Version पर LilyPond का संस्करण दिखाया जाता है)। अगर आप किसी पैकेज से LilyPond को स्थापित करते हैं, Ghostscript को भी स्थापित कर दिया जाएगा, क्योंकि LilyPond Ghostscript पर निर्भर है। चित्रों को ट्रिम करने के लिए ImageMagick को स्थापित किया जाना चाहिए, वरना इनमें काफ़ी सारा व्हाइटस्पेस होगा।

सुरक्षा के कारणों से, अगर अविश्वसनीय सदस्यों को आपका विकि सम्पादित करने की अनुमति है, आपको firejail को स्थापित करके इसकी मदद से यह सीमित करना चाहिए कि LilyPond और Ghostscript क्या-क्या कर सकते हैं।

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

FluidSynth ही MIDI फ़ाइलों को ऑडियो फ़ाइलों में बदलने के लिए प्राथमिक साधन है, मगर TiMidity++ भी समर्थित है।



सुरक्षा के मुद्दे
Score, LilyPond का इस्तेमाल सेफ़ मोड में करता है, मगर सेफ़ मोड एस्केप में कुछ ज्ञात कमज़ोरियाँ हैं जिन्हें अभी तक ठीक नहीं किया गया है, जिनकी मदद से इच्छानुसार निष्पादन हो जाता है।

अगर आप अपने विकि पर सम्पादित करने योग्य हर सदस्य पर विश्वास नहीं करते हैं, हमारी सलाह होगी कि आप की मदद से LilyPond को सीमित कर दें। सीमित सर्वर को सेट करने के बारे में विस्तार के लिए Shellbox#Server setup देखें, और इसका इस्तेमाल करने के लिए मीडियाविकि को कॉन्फ़िगर करने के लिए नीचे देखें। और यह भी सुनिश्चित करें कि आप LilyPond के किसी हाल ही के संस्करण (2.22.0+) या फिर किसी ऐसे वितरण पैकेज (जैसे Debian से) का इस्तेमाल कर रहे हों जिसमें सुरक्षा के सुधार हैं। सीमा को सुरक्षा के लिए रखते हुए भी सेफ़ मोड को सक्षम रखें। कुछ चीज़ें सेफ़ मोड में काम नहीं करेंगे, और इन्हें सक्षम करने के लिए आपको LilyPond को इस तरह से संशोधित करना होगा ताकि सेफ़ मोड में उस कार्य को किया जा सके।

स्थापना

 * See the extension's  for detailed installation instructions.

कॉन्फ़िगरेशन
ये रहे एक्सटेंशन के कुछ ग्लोबल पैरामीटर्स।

$wgScoreLilyPond
को अपने LilyPond निष्पादनीय के पथ पर सेट करें (आम तौर पर  या  )।

$wgScoreTrim
एक बूलियन है जो  के वैल्यू पर डिफ़ॉल्ट करता है। अगर यह होता है, तो परिणाम में बने PNG चित्रों को ImageMagick की मदद से ट्रिम किया जाता है। अगर आप नहीं चाहते हैं कि चित्रों को ट्रिम किया जाए, या फिर आप ImageMagick को स्थापित नहीं करना चाहते हैं,  को   पर सेट करें।

$wgScoreAbc2Ly
को अपने ABC-से-LilyPond रूपांतरक निष्पादनीय के पथ पर सेट करें (आम तौर पर  या  )।

$wgScoreFluidsynth
को अपने Fluidsynth निष्पादनीय के पथ पर सेट करें (आम तौर पर  या  )।

$wgScoreSoundfont
को अपने soundfont फ़ाइल के पथ पर सेट करें (आम तौर पर  या  )।

$wgScoreLame
को अपने Lame निष्पादनीय के पथ पर सेट करें (आम तौर पर  या  )। अगर बनाए गए ऑडियो फ़ाइल को MP3 होना पड़ेगा, तो यह आवश्यक है।

टिप्पणियाँ
यह एक्सटेंशन कुछ सुरक्षा प्रदान करने के लिए एक Shellbox में कई बाइनरियाँ चलाता है। अगर आपको "out of memory" त्रुटियाँ आती हैं, आपको को बढ़ाना पड़ सकता है।



स्कोर ढूँढ़ना
स्कोर्स वाले पृष्ठों पर "score" पृष्ठ गुणधर्म को सेट कर दिया जाएगा। Special:PagesWithProp की मदद से आप उन पृष्ठों को ढूँढ़ सकते हैं जिनपर स्कोर्स हैं ([$url अंग्रेज़ी विकिपीडिया के लिए उदाहरण क्वेरी]।)



ये भी देखें

 * अंग्रेज़ी विकिपीडिया पर Help:Score और विकिस्रोत पर Help:Sheet music, पर LilyPond सिनटैक्स के अधिक उदाहरण हैं।
 * Vexflow मुक्त स्रोत SVG/Canvas संगीत रेंडरर
 * LilyPond नोटेशन
 * ABC नोटेशन
 * vexflow का GitHub रिपॉज़िटरी