# कोड इंटेलिजेंस

LaTeX और Typst के लिए IDE-स्तर का नेविगेशन: परिभाषा पर जाना, संदर्भ खोजना, पूरे प्रोजेक्ट में नाम बदलना, होवर कार्ड, गणित प्रीव्यू, दस्तावेज़ की रूपरेखा, और Typst का सिग्नेचर हेल्प व फ़ॉर्मैटिंग।

Oleafly पूरे प्रोजेक्ट को इंडेक्स करता है, जिसमें हर `\label`, उद्धरण कुंजी, कस्टम मैक्रो, थ्योरम, शब्दावली प्रविष्टि और आपकी फ़ाइलों को जोड़ने वाला `\input` ग्राफ़ शामिल है। यही इंडेक्स फ़ाइलों के आर-पार नेविगेशन को चलाता है। Typst फ़ाइलों में यही शॉर्टकट काम करते हैं, और जवाब Typst का लैंग्वेज सर्वर देता है; नीचे [Typst फ़ाइलें](#typst-files) देखें।

शॉर्टकट में macOS की कुंजियाँ दिखाई गई हैं। Windows और Linux पर ⌘ को Ctrl पढ़ें।

## परिभाषा पर जाएँ: F12 या ⌘-क्लिक

कर्सर को किसी `\ref`, `\cite` कुंजी, कस्टम मैक्रो, आपके परिभाषित किए एनवायरनमेंट के `\begin{env}`, या किसी शब्दावली शब्द पर रखें और F12 दबाएँ (या ⌘ दबाए रखकर उस पर क्लिक करें)। एडिटर वहाँ पहुँच जाता है जहाँ वह परिभाषित है, और परिभाषा वाली फ़ाइल प्रोजेक्ट में कहीं और हो तो उसे खोल देता है।

जब कर्सर पहले से किसी परिभाषा पर हो, तब F12 दबाने से उसके संदर्भ खोजने का काम शुरू हो जाता है। IDE भी यही परंपरा अपनाते हैं।

## संदर्भ खोजें: ⇧F12

Shift+F12 बाईं रेल के **References** पैनल में उस सिंबल का हर उपयोग सूचीबद्ध करता है: हर बार आने की एक पंक्ति, जिसमें फ़ाइल, पंक्ति संख्या और प्रीव्यू होता है, और परिभाषा पर खुद एक "def" बैज रहता है। वहाँ पहुँचने के लिए किसी पंक्ति पर क्लिक करें। "क्या मैं यह लेबल हटा सकता हूँ?" या "मैंने यह पेपर कहाँ उद्धृत किया था?" जैसे सवालों का जवाब पाने का यह सबसे तेज़ तरीका है।

![एक समीकरण लेबल का नाम दो फ़ाइलों में एक साथ बदला गया, फिर उसके रेफ़रेंस सूचीबद्ध किए गए।](https://cdn.oleafly.com/images/gifs/desktop/rename-symbol.gif?v=2)

## सिंबल का नाम बदलें: F2

F2 किसी लेबल, उद्धरण कुंजी, मैक्रो, थ्योरम, शब्दावली प्रविष्टि या एनवायरनमेंट का नाम पूरे प्रोजेक्ट में एक ही चरण में बदल देता है: खुली फ़ाइल उसी समय अपडेट हो जाती है, दूसरी फ़ाइलें डिस्क पर दोबारा लिखी जाती हैं, और इंडेक्स फिर से बन जाता है। अगर नया नाम पहले से मौजूद है, तो टकराव पैदा होने से पहले ही नाम बदलना रोक दिया जाता है, और एक टोस्ट बताता है कि कितनी फ़ाइलों में कितने संपादन हुए।

`fig:overview` को `fig:architecture` नाम देना और सभी छह `\ref` का उसके साथ बदल जाना दो सेकंड का काम है।

इसके बजाय कर्सर किसी फ़ाइल पाथ पर हो, जैसे `\input` या `\includegraphics` का आर्ग्युमेंट, तो F2 उस फ़ाइल का नाम बदलता है और उसकी ओर जाने वाले पाथ अपडेट कर देता है। यही Typst में `#include` और `image()` पर, और Markdown में लिंक और इमेज पर भी काम करता है। [पाथ मूव की गई फ़ाइल का पालन करते हैं](/docs/files/#paths-follow-a-moved-file) देखें।

## होवर कार्ड

किसी भी सिंबल पर कर्सर ले जाएँ और एक कार्ड उसे समझाता है:

- **संदर्भ** पर: सिंबल का प्रकार, सोर्स का प्रीव्यू और स्थान। LaTeX बिल्ड सफल होने के बाद, समर्थित संदर्भ कंपाइल की गई संख्या और पेज भी दिखाते हैं।
- **परिभाषा** पर: पूरे प्रोजेक्ट में उसके कितने संदर्भ हैं।
- किसी भी **अनसुलझी** चीज़ पर: साफ़ "Unresolved" लेबल, जो गलत लिखे `\ref` या छूटी हुई `.bib` प्रविष्टि की आपको सबसे पहली चेतावनी है।

होवर करते समय ⌘ (Ctrl) दबाए रखें, तो क्लिक करने योग्य सिंबल लिंक की तरह रेखांकित हो जाते हैं; कूदने के लिए क्लिक करें।

## होवर पर गणित प्रीव्यू

इनलाइन `$…$`, `\(…\)` या डिस्प्ले `\[…\]` गणित पर कर्सर ले जाएँ, तो वह कंपाइल किए बिना KaTeX से रेंडर होकर दिखता है। डिस्प्ले गणित डिस्प्ले शैली में दिखता है। टूटा हुआ व्यंजक अपनी त्रुटि दिखाता है।

## Outline पैनल

फ़ाइल ट्री के नीचे **Outline** पैनल आपके दस्तावेज़ की संरचना दिखाता है: स्तर के अनुसार इंडेंट किए गए सेक्शन, और सभी फ़ाइलों के `\input` शामिल किए गए अंश। दूसरी फ़ाइलों के आइटम पर फ़ाइल नाम का बैज होता है। सीधे वहाँ पहुँचने के लिए किसी भी चीज़ पर क्लिक करें। दर्जन भर अध्याय फ़ाइलों में बँटे शोध-प्रबंध के लिए यही वह विषय-सूची है जिससे आप नेविगेट करते हैं।

सेक्शन के शीर्षक सादे पाठ के रूप में दिखते हैं, इसलिए शीर्षक में रंग का कमांड, फ़ॉन्ट बदलने का कमांड या `\nameref` कच्चे LaTeX के रूप में नहीं दिखता। आपके अपने मैक्रो से बने शीर्षक, जो `\section` को लपेटते हैं, सूची में आते हैं; मैक्रो परिभाषा के भीतर के शीर्षक नहीं आते।

ट्री और आउटलाइन के बीच का पैनल विभाजक खींचकर आकार बदला जा सकता है।

## टूलबार और मेन्यू कहाँ आते हैं

तीनों नेविगेशन कमांड एडिटर टूलबार के **Code intelligence** मेन्यू (ब्रेसेस आइकन) और राइट-क्लिक मेन्यू में भी मिलते हैं, इसलिए शॉर्टकट आदत बनने से पहले भी उन्हें आसानी से खोजा जा सकता है।

## Typst फ़ाइलें

`.typ` फ़ाइलों में इनमें से ज़्यादातर कमांड का जवाब Typst का लैंग्वेज सर्वर Tinymist देता है। Oleafly वही Tinymist रिलीज़ चलाता है जो प्रोजेक्ट के Typst संस्करण से मेल खाती है ([Typst प्रोजेक्ट](/docs/typst/#the-language-server-follows-the-version) देखें)।

- F12 या ⌘-क्लिक किसी लेबल, वेरिएबल या फ़ंक्शन की परिभाषा पर ले जाता है, चाहे वह किसी दूसरी फ़ाइल में हो।
- ⇧F12 **References** पैनल में हर उपयोग सूचीबद्ध करता है।
- F2 पूरे प्रोजेक्ट में किसी लेबल, वेरिएबल या फ़ंक्शन का नाम बदलता है।
- किसी फ़ंक्शन पर कर्सर ले जाकर उसका दस्तावेज़ पढ़ें। `@preview` इंपोर्ट पर कर्सर ले जाने से Typst Universe पर उस पैकेज का लिंक मिलता है।

यही तीन कमांड Typst टूलबार के **Code intelligence** मेन्यू, राइट-क्लिक मेन्यू और ⌘K पैलेट में भी हैं। Typst और LaTeX फ़ाइलों के लेबल अलग-अलग रहते हैं, इसलिए दोनों में इस्तेमाल हुआ लेबल दो बार रिपोर्ट नहीं होता और एक का नाम बदलने से दूसरा नहीं बदलता।

### सिग्नेचर हेल्प और पैरामीटर संकेत

फ़ंक्शन के नाम के बाद `(` टाइप करें, तो एक कार्ड उसके पैरामीटर दिखाता है, और आप जो पैरामीटर टाइप कर रहे हैं वह हाइलाइट रहता है। Esc उसे बंद कर देता है। फ़ंक्शन कॉल में हर आर्ग्युमेंट से पहले पैरामीटर के नाम लिखे देखने के लिए **Settings → Appearance → Editor** में **Typst** के अंतर्गत **Parameter name hints** चालू करें।

`rgb("#1f77b4")` जैसे रंग मानों के बगल में एक छोटा रंग-नमूना दिखता है। सोर्स में किसी लिंक या फ़ाइल पाथ को खोलने के लिए उस पर ⌘-क्लिक करें।

### Typst फ़ाइल फ़ॉर्मैट करें

**Format document** typstyle से पूरी फ़ाइल को सुव्यवस्थित करता है। ⇧⌥F (Shift+Alt+F) दबाएँ, एडिटर में राइट-क्लिक करें, या उसे ⌘K पैलेट में खोजें। **Format selection** केवल चुनी हुई पंक्तियों को फ़ॉर्मैट करता है।

**Settings → Appearance → Editor** का **Typst** समूह फ़ॉर्मैटर को नियंत्रित करता है:

- **Format on save** जब भी आप ⌘S (Ctrl+S) दबाते हैं, Typst फ़ाइल को फ़ॉर्मैट करता है। ऑटोसेव फ़ाइल को नहीं छूता। यह डिफ़ॉल्ट रूप से बंद रहता है।
- **Formatter line width** वह चौड़ाई है जहाँ typstyle लंबी पंक्तियों को तोड़ता है। डिफ़ॉल्ट 120 वर्ण है।
- **Formatter indent** हर स्तर के लिए स्पेस की संख्या है। डिफ़ॉल्ट 2 है।
- **Typst lint checks** हर बार सहेजने पर संभावित गलतियाँ खोजता है। इसे चालू या बंद करने से लैंग्वेज सर्वर फिर से शुरू होता है।

## एक फ़ोल्डर में कई दस्तावेज़

एक फ़ोल्डर में एक से ज़्यादा पेपर हो सकते हैं, जैसे `manuscript.tex` और उसके बगल में `manuscript_v1.tex`, या `latexdiff` का आउटपुट। अपने `\documentclass` वाली हर LaTeX फ़ाइल एक अलग दस्तावेज़ गिनी जाती है, उन फ़ाइलों के साथ जिन्हें वह `\input`, `\include` या `\subfile` से खींचती है। लेबल, थ्योरम, शब्दावली प्रविष्टियाँ और मैक्रो अपने ही दस्तावेज़ के होते हैं, इसलिए किसी पेपर की तीन प्रतियों में एक लेबल तीन बार परिभाषित नहीं दिखता।

परिभाषा पर जाना, संदर्भ खोजना, नाम बदलना, कंप्लीशन, [Preflight](/docs/preflight/) और `oleafly check` उसी दस्तावेज़ के भीतर रहते हैं जिसमें आप काम कर रहे हैं। जिस लेबल को सिर्फ़ कोई दूसरा दस्तावेज़ परिभाषित करता है, उस पर `\ref` अपरिभाषित दिखता है, जो कंपाइल भी यही कहता है। जिन फ़ाइलों को अभी कोई दस्तावेज़ शामिल नहीं करता, उन्हें अब भी हर लेबल दिखता है, और एक ही दस्तावेज़ वाले प्रोजेक्ट पर कोई असर नहीं पड़ता।

## AI को वही इंडेक्स दिखता है

[AI असिस्टेंट](/docs/ai-chat/) के पास इसी इंडेक्स पर बना `project_map` टूल है: आउटलाइन, लेबल, उद्धरण, मैक्रो, फ़ाइल ग्राफ़ और कोई भी अनसुलझे संदर्भ। जब आप उससे "मेथडोलॉजी सेक्शन" के बारे में पूछते हैं, तो वह उसे सच में ढूँढ पाता है।
