LibreOffice Calc फ़ॉर्मूला हेल्पर


LibreOffice Calc फ़ॉर्मूले जल्दी बनाने, टेस्ट करने और प्रबंधित करने का Python टूल – फ़ेवरिट सिस्टम, टीम सिंक्रोनाइज़ेशन, बहुभाषी समर्थन और प्लगइन मैनेजर सहित।

🚀 मुख्य विशेषताएँ


  • 📑 4 टैब, 60 से अधिक फ़ंक्शन

  • 🌐 38 भाषाएँ (हिंदी के लिए स्वचालित फ़ॉन्ट इंस्टॉलेशन सहित)

  • ⭐ फ़ेवरिट सिस्टम (लोकल & नेटवर्क ड्राइव के ज़रिए टीम सिंक्रोनाइज़ेशन)

  • 🛠 टीम फ़ेवरिट के लिए एडमिन पैनल (पासवर्ड से सुरक्षित)

  • 📋 सिंटैक्स हाइलाइटिंग के साथ सीधे कॉपी करने योग्य फ़ॉर्मूले

  • ✏️ Undo/Redo समर्थन के साथ संपादन योग्य आउटपुट फ़ील्ड

  • 📖 एकीकृत सहायता & फ़ंक्शन संदर्भ (प्रत्येक भाषा में)

  • 💾 स्वचालित सेव (JSON, atomic write)

  • 🌙 डार्क मोड

  • 🔌 अपने फ़ॉर्मूला प्लगइन बनाने के लिए प्लगइन मैनेजर

  • 🔤 RTL समर्थन (दाएँ से बाएँ) – लेखन दिशा की स्वचालित पहचान

  • 🗄️ बैकअप & रिस्टोर – नाम और पासवर्ड के साथ सभी सेटिंग्स और फ़ेवरिट सहेजें

  • ⌨️ मिनिमाइज़/रिस्टोर के लिए ग्लोबल शॉर्टकट Ctrl+F12
  • 🔍 JSON सत्यापक – languages.json और formula_explanations.json की स्वचालित जांच और सुधार

    • 🖥️ उपयोग विधि


    1. इनपुट दर्ज करें

  • सेल रेंज (जैसे: A1:A10)

  • सेल 1 / सेल 2 (जैसे: A1, B1)

  • वैकल्पिक पैरामीटर (जैसे: टेक्स्ट या इंडेक्स)

  • एब्सोल्यूट रेफ़रेंस मोड चुनें: A1, $A1, A$1, $A$1

    • 2. फ़ंक्शन चुनें कोई टैब चुनें और फ़ंक्शन पर क्लिक करें – फ़ॉर्मूला तुरंत बन जाएगा।

    3. फ़ॉर्मूला संपादित करें बना हुआ फ़ॉर्मूला आउटपुट फ़ील्ड में सीधे एडिट किया जा सकता है।

    4. कॉपी करें एक क्लिक में क्लिपबोर्ड पर कॉपी करें (सिंटैक्स हाइलाइटिंग सहित)।

    5. फ़ेवरिट का उपयोग करें

  • ⭐ सेव → वर्तमान फ़ॉर्मूला सहेजें (Ctrl+S)

  • 📂 लोड → फ़ॉर्मूला दोबारा उपयोग करें

  • ❌ डिलीट → Delete कुंजी या बटन

  • 🕐 इतिहास → हाल ही में उपयोग किए गए फ़ॉर्मूले

    • 📊 टैब अवलोकन


    टैब 1 – बेसिक फ़ंक्शन + - \* / ^ SUM, AVERAGE, MIN, MAX, MEDIAN, COUNT, COUNTA, SUMPRODUCT

    टैब 2 – उन्नत फ़ंक्शन IF, AND, OR, NOT, SUMIF, COUNTIF, AVERAGEIF, SUMIFS, STDEV, VAR, COUNTBLANK, LARGE

    टैब 3 – दिनांक & टेक्स्ट TODAY, NOW, YEAR, MONTH, DAY, DATE, DATEDIF, WEEKDAY, CONCATENATE, LEN, LEFT, RIGHT, MID, UPPER, LOWER, TRIM

    टैब 4 – लुकअप & राउंडिंग VLOOKUP, HLOOKUP, INDEX, MATCH, INDEX+MATCH, ROUND, ROUNDUP, ROUNDDOWN, INT, TRUNC, ABS, MOD, SQRT, RAND


    📖 LibreOffice दस्तावेज़ से सूत्र स्पष्टीकरण


    फ़ाइल formula_explanations.json सीधे LibreOffice Calc की आधिकारिक दस्तावेज़ीकरण (https://help.libreoffice.org) से भरी जाती है।

    डेटा स्रोत और अपडेट


  • विवरण, सिंटैक्स जानकारी और उदाहरण LibreOffice की आधिकारिक सहायता वेबसाइट से लिए जाते हैं
  • समर्थित भाषाएं वेबसाइट पर उपलब्ध अनुवादों पर निर्भर करती हैं
  • फ़ाइल में प्रत्येक फ़ंक्शन के लिए: नाम, सिंटैक्स, विवरण, उदाहरण और श्रेणी शामिल है
  • जोड़ या सुधार मैन्युअल रूप से किए जा सकते हैं (JSON सत्यापक देखें)

    • formula_explanations.json की संरचना


    `json
    {
    "SUM": {
    "hi": {
    "syntax": "SUM(संख्या1; संख्या2; ...)",
    "description": "सेल रेंज में सभी संख्याओं को जोड़ता है।",
    "example": "=SUM(A1:A10)"
    },
    "en": {
    "syntax": "SUM(Number1; Number2; ...)",
    "description": "Adds all numbers in a cell range.",
    "example": "=SUM(A1:A10)"
    }
    }
    }
    `

    | फ़ील्ड | आवश्यक | विवरण |
    |--------|--------|-------|
    | syntax | ✅ | पैरामीटर के साथ सूत्र सिंटैक्स |
    | description | ✅ | फ़ंक्शन का संक्षिप्त विवरण |
    | example | ✅ | तैयार सूत्र के रूप में उपयोग उदाहरण |
    | note | ❌ | वैकल्पिक नोट |

    💡 नोट: यदि किसी भाषा के लिए कोई प्रविष्टि नहीं है, तो ऐप स्वचालित रूप से अंग्रेज़ी संस्करण पर वापस आ जाता है।

    ---

    🔍 भाषा फ़ाइलों के लिए JSON सत्यापक


    एकीकृत JSON सत्यापक languages.json और formula_explanations.json की स्थिरता, पूर्णता और सही देश नामों के लिए जांच और सुधार करता है।

    सेटिंग्स → 🔍 JSON सत्यापक के माध्यम से पहुंचें।

    क्या जांचा जाता है?


    #### languages.json

  • ✅ सभी 38 भाषाएं मौजूद हैं (ISO 639-1 कोड के अनुसार)
  • ✅ सही देश और भाषा नाम (जैसे "hi" → "हिंदी")
  • ✅ कोई डुप्लीकेट भाषा कोड नहीं
  • ✅ आवश्यक फ़ील्ड मौजूद: name, native_name, flag, rtl
  • ✅ RTL फ्लैग सही ढंग से सेट (अरबी, हिब्रू, फारसी, उर्दू → "rtl": true)

    • #### formula_explanations.json

  • ✅ 4 टैब के सभी फ़ंक्शन दर्ज हैं
  • ✅ आवश्यक फ़ील्ड मौजूद: syntax, description, example
  • ✅ कोई खाली फ़ील्ड नहीं ("" या null)
  • ✅ भाषा कोड languages.json से मेल खाते हैं

    • सुधार कार्य


    | त्रुटि प्रकार | स्वचालित सुधार |
    |-------------|---------------|
    | गलत देश नाम | ISO मानक के अनुसार सही नाम से बदला |
    | भाषा प्रविष्टि गायब | अंग्रेज़ी बैकअप से भरा |
    | खाली आवश्यक फ़ील्ड | मैन्युअल समीक्षा के लिए "[MISSING]" के रूप में चिह्नित |
    | डुप्लीकेट प्रविष्टि | डुप्लीकेट हटाए, अधिक पूर्ण प्रविष्टि रखी |
    | गलत RTL फ्लैग | ज्ञात RTL कोड के आधार पर स्वचालित रूप से सुधारा |

    उपयोग


    1. सेटिंग्स → 🔍 JSON सत्यापक खोलें
    2. फ़ाइल चुनें: languages.json या formula_explanations.json (या दोनों)
    3. 🔎 जांचें – सभी पाई गई समस्याएं दिखाता है
    4. 🛠 स्वतः सुधारें – सभी स्वचालित रूप से हल करने योग्य त्रुटियां ठीक करता है
    5. 💾 सहेजें – सुधारी गई फ़ाइल को परमाणु रूप से लिखता है
    6. 📋 रिपोर्ट निर्यात करें (वैकल्पिक) – सभी निष्कर्षों के साथ टेक्स्ट फ़ाइल सहेजता है

    ⚠️ नोट: प्रत्येक स्वचालित सुधार से पहले मूल फ़ाइल की बैकअप कॉपी बनाई जाती है (languages.json.bak / formula_explanations.json.bak)।

    ⭐ फ़ेवरिट सिस्टम


  • अपने फ़ॉर्मूले सहेजें और दोबारा उपयोग करें

  • व्यक्तिगत और टीम फ़ेवरिट अलग-अलग

  • टीम फ़ेवरिट केवल पढ़ने योग्य (केवल एडमिन ही संपादित कर सकता है)

  • डुप्लीकेट एंट्री से बचाव

  • अपने फ़ेवरिट को मनचाहे क्रम में सॉर्ट करें

  • नेटवर्क ड्राइव के ज़रिए सिंक्रोनाइज़ेशन (वैकल्पिक रूप से कॉन्फ़िगर करने योग्य)

    • टीम सिंक्रोनाइज़ेशन


    सेटिंग्स → 🌐 नेटवर्क पाथ से नेटवर्क ड्राइव दर्ज किया जा सकता है (जैसे: \\\\\\\\Server\\\\Share\\\\formeln)।

  • स्टार्टअप पर: नेटवर्क फ़ेवरिट लोकल में सेव होते हैं (ऑफ़लाइन फ़ॉलबैक)

  • सेव करने पर: अपने फ़ॉर्मूले नेटवर्क पर लिखे जाते हैं, टीम फ़ॉर्मूले अपरिवर्तित रहते हैं

    • 🛠 एडमिन पैनल


    🛠 बटन से एक्सेस करें। पहली बार क्लिक करने पर पासवर्ड सेट होता है (PBKDF2-SHA256, केवल हैश सेव होता है)।

  • टीम फ़ॉर्मूले जोड़ें, संपादित करें, डिलीट करें

  • पासवर्ड बदलें

  • बदलाव सीधे नेटवर्क ड्राइव पर सेव करें

    • 🔌 प्लगइन मैनेजर


    प्लगइन मैनेजर (plugin\_manager.py) Calc2 के लिए अपने फ़ॉर्मूला प्लगइन बनाने और प्रबंधित करने का एक स्वतंत्र टूल है। यह Calc2.py के साथ एक ही फ़ोल्डर में होता है और 🔌 बटन से चालू होता है।

    विशेषताएँ


  • नया प्लगइन बनाएँ – चरण-दर-चरण विज़ार्ड (नाम, फ़ॉर्मूले, अनुवाद, सारांश)

  • फ़ॉर्मूले जोड़ें – किसी मौजूदा प्लगइन में फ़ॉर्मूले जोड़ें

  • अनुवाद संपादित करें – फ़ॉर्मूला नाम 38 भाषाओं में अनुवाद करें

  • प्लगइन फ़ोल्डर खोलें – फ़ाइल एक्सप्लोरर में सीधे खोलें

  • प्लगइन डिलीट करें – पुष्टि संवाद सहित

    • प्लगइन संरचना


    प्रत्येक प्लगइन plugins/ में एक सब-फ़ोल्डर के रूप में होता है और दो फ़ाइलों से बना होता है:

    `
    plugins/
    mera\_plugin/
    plugin.json ← मेटाडेटा (नाम, वर्शन, लेखक, विवरण)
    formulas.json ← अनुवाद सहित फ़ॉर्मूले
    `

    plugin.json उदाहरण:

    `
    \{
    "id": "mera\_plugin",
    "enabled": true,
    "version": "1.0",
    "author": "आपका नाम",
    "icon": "💰",
    "name": \{ "en": "Finance Formulas", "hi": "वित्त फ़ॉर्मूले" \},
    "description": \{ "en": "Useful formulas for financial calculations." \}
    \}
    `

    formulas.json उदाहरण:

    `
    \[
    \{
    "formula": "=SUM(A1:A10)",
    "name": \{ "en": "Sum of range", "hi": "रेंज का योग" \},
    "description": \{ "en": "Adds all values in A1:A10." \},
    "category": \{ "en": "Basic", "hi": "बेसिक" \}
    \}
    \]
    `

    महत्वपूर्ण सूचना (⚠️ Important Notice)


    प्लगइन मैनेजर में ⚠️ Important Notice बटन है। क्लिक करने पर सही प्लगइन बनाने के सभी नियम अंग्रेज़ी में दिखते हैं। वही जानकारी IMPORTANT\_NOTICE.md में भी उपलब्ध है।

    🌐 बहुभाषी समर्थन


    38 भाषाएँ सीधे ऐप में स्विच की जा सकती हैं। 🌍 बटन के लैंग्वेज विज़ार्ड से नई भाषाएँ जोड़ी जा सकती हैं।

    हिंदी नोट: पहली बार हिंदी पर स्विच करने पर *Noto Sans Devanagari* फ़ॉन्ट एक बार सिस्टम-वाइड इंस्टॉल होता है। Windows एडमिनिस्ट्रेटर अनुमति माँगता है।

    🔤 RTL समर्थन (दाएँ से बाएँ)


    दाएँ से बाएँ लिखी जाने वाली भाषाएँ स्वचालित रूप से पहचानी जाती हैं और पूरा इंटरफ़ेस मिरर हो जाता है:

  • अरबी (عربي) – स्वचालित RTL पहचान
  • हिब्रू (עברית) – स्वचालित RTL पहचान
  • फ़ारसी (فارسی) – स्वचालित RTL पहचान
  • उर्दू (اردو) – स्वचालित RTL पहचान

    • RTL मोड में क्या बदलता है: पूरा UI लेआउट मिरर होता है, इनपुट फ़ील्ड RTL एलाइनमेंट उपयोग करते हैं, फ़ॉन्ट स्वचालित रूप से RTL-संगत फ़ॉन्ट पर स्विच होता है (जैसे *Noto Sans Arabic*, *Noto Sans Hebrew*)।

    💡 नोट: जेनरेट किए गए LibreOffice फ़ॉर्मूले हमेशा LTR सिंटैक्स में रहते हैं – केवल यूज़र इंटरफ़ेस दिशा बदलता है।


    🗄️ बैकअप & रिस्टोर


    बैकअप बनाएँ


    सेटिंग्स → 🗄️ बैकअप बनाएँ के ज़रिए:

    1. नाम – स्वतंत्र लेबल (जैसे Backup_May_2025)
    2. पासवर्ड – बैकअप AES से एन्क्रिप्ट होता है; इसके बिना रिस्टोर संभव नहीं
    3. सेव लोकेशन – लोकल या नेटवर्क ड्राइव
    4. 💾 बैकअप बनाएँ पर क्लिक करें – .calc2backup फ़ाइल बनती है

    सामग्री: सभी फ़ेवरिट, सेटिंग्स, टीम फ़ेवरिट (वैकल्पिक), इंस्टॉल किए गए प्लगइन।

    बैकअप रिस्टोर करें


    सेटिंग्स → 📂 बैकअप रिस्टोर करें के ज़रिए:

    1. बैकअप फ़ाइल चुनें (.calc2backup)
    2. पासवर्ड दर्ज करें
    3. रिस्टोर का दायरा चुनें: केवल फ़ेवरिट / केवल सेटिंग्स / सब कुछ
    4. 🔄 रिस्टोर पर क्लिक करें

    ⚠️ रिस्टोर के दौरान मौजूदा डेटा ओवरराइट हो जाता है। रिस्टोर से पहले वर्तमान डेटा का स्वचालित बैकअप ऑफ़र किया जाता है।


    💡 सुझाव


  • $A$1 → एब्सोल्यूट रेफ़रेंस (सेल फ़ील्ड के बगल में ड्रॉपडाउन)

  • Ctrl+S → फ़ॉर्मूला फ़ेवरिट में सेव करें

  • Ctrl+C → फ़ॉर्मूला कॉपी करें (इनपुट फ़ील्ड के बाहर)

  • Ctrl+Z / Ctrl+Y → Undo / Redo

  • Ctrl+F12 → विंडो मिनिमाइज़ / रिस्टोर (Calc2 के मिनिमाइज़ होने पर भी काम करता है)

  • फ़ेवरिट सूची में Delete कुंजी → एंट्री डिलीट करें

  • फ़ॉर्मूला बनने के बाद आउटपुट फ़ील्ड में सीधे बदलाव किया जा सकता है

    • 📁 प्रोजेक्ट संरचना


    `
    Calc2.py ← मुख्य प्रोग्राम
    plugin\_manager.py ← प्लगइन मैनेजर
    IMPORTANT\_NOTICE.md ← प्लगइन बनाने की जानकारी
    data/
    README\_de.md / README\_en.md / ... ← भाषा-अनुसार सहायता
    REFERENZ\_de.md / REFERENZ\_en.md / ... ← भाषा-अनुसार फ़ंक्शन संदर्भ
    language/
    languages.json ← UI अनुवाद (38 भाषाएँ)
    formula\_explanations.json
    services/
    language\_tool.py ← विज़ार्ड: नई भाषा जोड़ें
    settings\_service.py
    auth\_service.py
    favorites\_service.py
    network\_sync.py
    install\_service.py
    json\_validator.py ← languages.json / formula_explanations.json की जांच और सुधार
    plugins/ ← प्लगइन फ़ोल्डर (स्वचालित रूप से बनता है)
    mera\_plugin/
    plugin.json
    formulas.json
    fonts/
    NotoSansDevanagari-Regular.ttf ← हिंदी फ़ॉन्ट
    NotoSansArabic-Regular.ttf ← अरबी फ़ॉन्ट (RTL)
    NotoSansHebrew-Regular.ttf ← हिब्रू फ़ॉन्ट (RTL)
    python/ ← एम्बेडेड Python
    python.exe
    ...
    settings.json ← स्वचालित रूप से बनता है
    favoriten.json ← लोकल फ़ेवरिट (स्वचालित रूप से बनता है)
    `

    🧠 तकनीकी विशेषताएँ


  • Atomic File Writes → सेव करते समय फ़ाइल करप्शन से बचाव

  • सर्विस आर्किटेक्चर → लॉजिक और UI पूरी तरह अलग

  • स्वचालित माइग्रेशन → पुराने फ़ेवरिट फ़ॉर्मैट स्वचालित रूप से पहचाने और कन्वर्ट किए जाते हैं

  • मज़बूत एरर हैंडलिंग → खराब फ़ाइलों से प्रोग्राम क्रैश नहीं होता

  • सिंटैक्स हाइलाइटिंग → फ़ॉर्मूले रंगों में दिखाए जाते हैं

  • डार्क मोड → पूरी तरह समर्थित

  • प्लगइन सिस्टम → अपने फ़ॉर्मूला प्लगइन से Calc2 को बढ़ाएँ

  • RTL इंजन → RTL भाषाओं की स्वचालित पहचान, उचित फ़ॉन्ट सहित पूर्ण UI मिरर

  • बैकअप & रिस्टोर → नाम और पासवर्ड के साथ AES-एन्क्रिप्टेड बैकअप, चयनात्मक रिस्टोर

  • JSON सत्यापक → languages.json और formula_explanations.json की स्वचालित जांच और सुधार सहित देश नाम और आवश्यक फ़ील्ड

  • LibreOffice स्रोत → formula_explanations.json LibreOffice Calc की आधिकारिक दस्तावेज़ीकरण (https://help.libreoffice.org) से भरी जाती है

  • JSON सत्यापक → languages.json और formula_explanations.json की स्वचालित जांच और सुधार सहित देश नाम और आवश्यक फ़ील्ड

  • LibreOffice स्रोत → formula_explanations.json LibreOffice Calc की आधिकारिक दस्तावेज़ीकरण (https://help.libreoffice.org) से भरी जाती है

  • ग्लोबल शॉर्टकट → Ctrl+F12, keyboard लाइब्रेरी (बैकग्राउंड थ्रेड) के ज़रिए पूरे सिस्टम में काम करता है

    • लाइसेंस


    व्यक्तिगत और व्यावसायिक उपयोग के लिए स्वतंत्र रूप से उपलब्ध।