# SL5 ऑरा के साथ शुरुआत करना

> **आवश्यकताएँ:** आपने सेटअप स्क्रिप्ट पूरी कर ली है और अपनी हॉटकी कॉन्फ़िगर कर ली है।
> यदि नहीं, तो [Installation section in README.md](../../README.i18n/README-hilang.md#installation) देखें।

---

## चरण 0: अपनी हॉटकी कॉन्फ़िगर करें

अपना मंच चुनें:

**लिनक्स/मैकओएस** - [CopyQ](https://github.com/hluk/CopyQ) स्थापित करें और वैश्विक शॉर्टकट के साथ एक कमांड बनाएं:
__CODE_ब्लॉक_0__

**विंडोज़** — [AutoHotkey v2](https://www.autohotkey.com/) या CopyQ का उपयोग करें। सेटअप स्क्रिप्ट दोनों स्वचालित रूप से इंस्टॉल हो जाती है।
ट्रिगर फ़ाइल है: `c:\tmp\sl5_record.trigger`

> पूर्ण विवरण: [README.md#configure-your-hotkey](../../README.i18n/README-hilang.md#configure-your-hotkey)

## चरण 1: आपका पहला श्रुतलेख

1. आभा प्रारंभ करें (यदि पहले से नहीं चल रहा है):
__CODE_ब्लॉक_1__
स्टार्टअप ध्वनि की प्रतीक्षा करें - इसका मतलब है कि ऑरा तैयार है।

2. किसी भी टेक्स्ट फ़ील्ड (संपादक, ब्राउज़र, टर्मिनल) पर क्लिक करें।
3. अपनी हॉटकी दबाएं, **"हैलो वर्ल्ड"** कहें, हॉटकी फिर से दबाएं।
4. पाठ को प्रकट होते हुए देखें।

> **कुछ नहीं हुआ?** त्रुटियों के लिए `log/aura_engine.log` जांचें।
> कैचीओएस/आर्क के लिए सामान्य समाधान: `सुडो पैक्मैन -एस मिमलोक`

---

## चरण 2: अपना पहला नियम लिखें

व्यक्तिगत नियम जोड़ने का सबसे तेज़ तरीका:

1. `config/maps/plugins/sandbox/de-DE/FUZZY_MAP_pre.py` खोलें
2. `FUZZY_MAP_pre = [...]` के अंदर एक नियम जोड़ें:
__CODE_ब्लॉक_2__
3. **सहेजें** - आभा स्वचालित रूप से पुनः लोड होती है। पुनरारंभ की आवश्यकता नहीं है.
4. 'हैलो वर्ल्ड' लिखिए और इसे 'हैलो वर्ल्ड' बनते हुए देखिए।

> संपूर्ण नियम संदर्भ के लिए `docs/FuzzyMapRuleGuide.md` देखें।

### ओमा-मोडस (शुरुआती शॉर्टकट)

अभी तक रेगेक्स नहीं पता? कोई बात नहीं।

1. सैंडबॉक्स में कोई भी खाली `FUZZY_MAP_pre.py` खोलें
2. अपनी पंक्ति में केवल एक सादा शब्द लिखें (कोई उद्धरण नहीं, कोई टुपल नहीं):
__CODE_ब्लॉक_3__
3. सहेजें - ऑटो-फ़िक्स सिस्टम स्वचालित रूप से नंगे शब्द का पता लगाता है
इसे एक वैध नियम प्रविष्टि में परिवर्तित करता है।
4. फिर आप प्रतिस्थापन टेक्स्ट को मैन्युअल रूप से संपादित कर सकते हैं।

इसे **ओमा-मोडस** कहा जाता है - यह उन उपयोगकर्ताओं के लिए डिज़ाइन किया गया है जो बिना परिणाम चाहते हैं
पहले रेगेक्स सीखना।

---

## चरण 3: कोअन्स के साथ सीखें

कोअन छोटे अभ्यास हैं जो प्रत्येक एक अवधारणा सिखाते हैं।
वे `configmaps/koans deutsch/` और `configmaps/koans english/` में रहते हैं।

यहाँ से शुरू:

| फ़ोल्डर | आप क्या सीखते हैं |
|---|---|
| `00_koan_oma-modus` | ऑटो-फ़िक्स, रेगेक्स के बिना पहला नियम |
| `01_koan_erste_schritte` | आपका पहला नियम, पाइपलाइन मूल बातें |
| `02_कोन_सुनें` | सूचियों के साथ कार्य करना |
| `03_koan_schwierige_namen` | मुश्किल से पहचाने जाने वाले नामों के लिए अस्पष्ट मिलान |
| `04_koan_kleine_helper` | उपयोगी शॉर्टकट |

प्रत्येक koan फ़ोल्डर में टिप्पणी किए गए उदाहरणों के साथ एक `FUZZY_MAP_pre.py` होता है।
किसी नियम को अनटिप्पणी करें, सहेजें, ट्रिगर वाक्यांश को निर्देशित करें - हो गया।

---

## चरण 4: आगे बढ़ें

| क्या | कहाँ |
|---|---|
| पूर्ण नियम संदर्भ | `docs/FuzzyMapRuleGuide.md` |
| अपना खुद का प्लगइन बनाएं | `docs/CreatingNewPluginModules.md` |
| नियमों से पायथन स्क्रिप्ट चलाएँ | `docs/advanced-scripting.md` |
| DEV_MODE + लॉग फ़िल्टर सेटअप | `docs/Developer_Guide/dev_mode_setup.md` |
| संदर्भ-जागरूक नियम (`only_in_windows`) | `docs/FuzzyMapRuleGuide.md` |