योगदान कैसे करें

साइबरवट्टम योगदानकर्ता मार्गदर्शिका में आपका स्वागत है

साइबरवट्टम (Cybervattam) एक खुला, समुदाय-संचालित ज्ञान पुस्तकालय है जिसका उद्देश्य साइबर सुरक्षा, डिजिटल जागरूकता और उभरती प्रौद्योगिकियों को भारतीय भाषाओं में सभी के लिए सुलभ बनाना है। चाहे आप कोई नया पाठ लिखना चाहते हों, किसी मौजूदा अनुवाद को सुधारना चाहते हों, या बेहतर तकनीकी शब्दावली सुझाना चाहते हों — यह मार्गदर्शिका आपको शुरुआत करने में मदद करेगी।

1. आप कैसे योगदान दे सकते हैं?

1. अनुवाद में सुधार या प्रूफरीडिंग करें: यदि आपको हिन्दी, तमिल, मलयालम, तेलुगु या कन्नड़ लेखों में कोई त्रुटि या असहज अनुवाद दिखाई दे, तो GitHub के माध्यम से सुधार सुझाएँ।
2. किसी मौजूदा पाठ का अनुवाद करें: site/content.en/ से कोई अंग्रेज़ी लेख चुनें और उसे अपनी मातृभाषा में अनूदित करें।
3. नया लेख या आरेख (Diagram) बनाएँ: साइबर सुरक्षा या उभरती तकनीक पर नया मार्गदर्शक लिखें या भारतीय भाषाओं में SVG आरेख तैयार करें।
4. “सप्ताह का तकनीकी शब्द” सुझाएँ: site/static/data/terms-of-the-week.json में सटीक स्थानीय तकनीकी शब्द और वास्तविक जीवन के उदाहरण जोड़ें।

2. रिपॉज़िटरी और सामग्री निर्देशिका संरचना (Directory Structure)

सभी पाठ Markdown (.md) में लिखे गए हैं और site/ निर्देशिका के भीतर भाषा के अनुसार व्यवस्थित हैं। प्रत्येक भाषा फ़ोल्डर में content.en/ के समान ही फ़ाइल नाम और पथ रखे जाते हैं ताकि Hugo स्वचालित रूप से सभी भाषाओं के पृष्ठों को आपस में जोड़ सके:

cybervattam.github.io/
└── site/
    ├── content.en/                  # अंग्रेज़ी (मूल स्रोत सामग्री)
    │   ├── _index.md                # मुखपृष्ठ परिचय
    │   ├── events/                  # सामुदायिक कार्यक्रम और कार्यशालाएँ
    │   └── library/                 # मुख्य ज्ञान पुस्तकालय
    │       ├── cyberawareness/      # स्तंभ 1: साइबर जागरूकता
    │       │   ├── cyberhygine/     #   डिवाइस, पासवर्ड और इंटरनेट सुरक्षा
    │       │   ├── familysafety/    #   आयु वर्ग के अनुसार पारिवारिक सुरक्षा
    │       │   └── topscamsfrauds/  #   फ़िशिंग, OTP, UPI और AI धोखाधड़ी
    │       ├── cybersecurity/       # स्तंभ 2: साइबर सुरक्षा
    │       │   ├── cloudsecurity/   #   क्लाउड सुरक्षा, CSPM, CNAPP, ZTNA
    │       │   ├── cryptography/    #   गूढ़लेखन (Encryption), हैशिंग और डिजिटल हस्ताक्षर
    │       │   ├── dns/             #   DNS पदानुक्रम, रिकॉर्ड, DNSSEC, DoH/DoT
    │       │   ├── iam/             #   पहचान और पहुँच प्रबंधन (IAM, MFA, OIDC)
    │       │   ├── icann-iana/      #   इंटरनेट गवर्नेंस (ICANN और IANA)
    │       │   ├── pki/             #   पब्लिक की इन्फ्रास्ट्रक्चर (PKI) और प्रमाणपत्र
    │       │   └── zerotrust/       #   शून्य विश्वास (Zero Trust) सिद्धांत
    │       ├── emergingtech/        # स्तंभ 3: उभरती प्रौद्योगिकियाँ
    │       │   ├── blockchain/      #   ब्लॉकचेन और सहमति तंत्र
    │       │   ├── cloud/           #   क्लाउड सेवा और परिनियोजन मॉडल
    │       │   ├── digitalassets/   #   क्रिप्टो वॉलेट, कस्टडी और डिजिटल संपत्ति
    │       │   └── ipv6/            #   IPv6 एड्रेसिंग और संक्रमण
    │       └── aboutus/             # हमारे बारे में, योगदान, योगदानकर्ता, हमारी टीम
    │
    ├── content.ta/                  # तमिल (தமிழ்)
    ├── content.hi/                  # हिन्दी — content.en/ के समान पथ संरचना
    ├── content.ml/                  # मलयालम (മലയാളം)
    ├── content.te/                  # तेलुगु (తెలుగు)
    ├── content.kn/                  # कन्नड़ (ಕನ್ನಡ)
    │
    ├── i18n/                        # UI अनुवाद फ़ाइलें (en.toml, hi.toml, आदि)
    └── static/
        ├── data/
        │   └── terms-of-the-week.json  # मुखपृष्ठ के तकनीकी शब्द-युग्म
        └── images/                  # आरेख और चित्र (en/, ta/, shared/)

Markdown फ्रंटमैटर (Frontmatter) टेम्पलेट

प्रत्येक Markdown फ़ाइल की शुरुआत YAML फ्रंटमैटर से होती है:

---
title: 'क्रिप्टोग्राफी का परिचय'
date: 2026-10-13
draft: false
weight: 1
verified: true
tags: ["साइबर सुरक्षा", "क्रिप्टोग्राफी"]
---

### क्रिप्टोग्राफी का परिचय

यहाँ अपना पाठ सरल और स्पष्ट भाषा में लिखें।

महत्वपूर्ण नियम: फ़ाइल का नाम (जैसे cryptography-introduction.md) सभी content.<lang>/ फ़ोल्डरों में अंग्रेज़ी में ही रखें ताकि भाषा बदलने वाला स्विचर (Language Switcher) सही ढंग से काम करे।

3. तकनीकी शब्दावली के अनुवाद दिशा-निर्देश (Translation vs. Transliteration)

तकनीकी विषयों को भारतीय भाषाओं में अनूदित करते समय अवधारणा की स्पष्टता और व्यावहारिक उपयोगिता के बीच संतुलन रखना आवश्यक है।

क. मुख्य अवधारणाओं का सहज अनुवाद + पहली बार कोष्ठक में अंग्रेज़ी शब्द

जब किसी तकनीकी शब्द का सटीक और सहज स्थानीय शब्द उपलब्ध हो, तो पहले मातृभाषा का शब्द लिखें और पहली बार उल्लेख करते समय कोष्ठक में अंग्रेज़ी शब्द भी दें:

ख. वैश्विक संक्षिप्त रूपों (Acronyms) और प्रोटोकॉल नामों को यथावत रखें

प्रोटोकॉल नामों, फ़ाइल प्रारूपों या एल्गोरिथ्म के लिए कृत्रिम अनुवाद न गढ़ें। सर्वमान्य संक्षिप्त नामों को रोमन लिपि या मानक लिप्यंतरण में ही रखें:

• संक्षिप्त रूप में रखें: DNS, HTTPS, TLS, IPv6, OTP, UPI, SIM, USB, APK, SHA-256, AES, SAML, OIDC.
• संस्थाएँ और मानक: ICANN, IANA, NIST, WhatsApp, Authy.

ग. शाब्दिक मशीनी अनुवाद के बजाय भावार्थ को प्राथमिकता दें

• तकनीकी शब्दों जैसे “Mouse”, “Worm”, “Patch” या “Pipeline” का अनुवाद उनके तकनीकी संदर्भ में करें (जैसे माउस, नेटवर्क वर्म, सुरक्षा पैच, पाइपलाइन)।
• “क्या करें” और “क्या न करें” (Do’s & Don’ts): सुरक्षा सूचियों में सुनिश्चित करें कि “क्या न करें” के अंतर्गत प्रत्येक बिंदु स्पष्ट निषेधात्मक वाक्य हो (जैसे "…साझा न करें", "…क्लिक न करें")।

4. योगदानकर्ता लाइसेंस और श्रेय (CC-BY-NC-SA 4.0)

साइबरवट्टम की समस्त सामग्री क्रिएटिव कॉमन्स एट्रिब्यूशन-नॉनकमर्शियल-शेयरअलाइक 4.0 इंटरनेशनल (CC-BY-NC-SA 4.0) लाइसेंस के अंतर्गत प्रकाशित की जाती है।

Cybervattam GitHub रिपॉज़िटरी में Pull Request या अनुवाद सबमिट करके आप पुष्टि करते हैं कि यह आपका मौलिक योगदान है और आप इसे CC-BY-NC-SA 4.0 के तहत प्रकाशित करने के लिए सहमत हैं।

5. शुरुआत करने के लिए तैयार हैं?

• सुधार सुझाएँ या नया विषय प्रस्तावित करें: GitHub पर नया Issue खोलें
• अनुवाद या नया पाठ सबमिट करें: GitHub पर Pull Request भेजें
• कोई प्रश्न है?: हमारे संपर्क करें पृष्ठ के माध्यम से हमसे जुड़ें।