संदर्भसंपादनसदाबहारअपडेट 2026.08पढ़ने में 2 मिनट
हबभाग I · संपादन
भाग I · संपादन

संपादन, ब्लॉक-दर-ब्लॉक

संपादन वैसे ही चलता है जैसे Wikipedia पर वर्तनी की भूल सुधारना: आप उसी अनुच्छेद को संपादित करते हैं जिस पर आपकी नज़र है, पूरा पन्ना थामे किसी विशाल textarea को नहीं। संपादन मोड में (npm run wiki) साइन-इन कीजिए, किसी भी नोट के किसी भी ब्लॉक पर — इस पर भी — होवर कीजिए, और ✎ क्लिक कीजिए।

§1.1चक्र

रेंडर हुआ ब्लॉक छिप जाता है और उसकी जगह CodeMirror संपादक खुल जाता है, जिसमें उसी ब्लॉक का Markdown सोर्स होता है। टाइप करते-करते नीचे जीवंत प्रीव्यू रेंडर होता रहता है — इंजन की बोली और उन प्लगइनों से होकर जो साइट inkbrush({ markdown }) को थमाती है, यानी ठीक वही नियम-सेट जो पन्ने की पाइपलाइन चढ़ाती है — इसलिए प्रीव्यू और पन्ना कभी असहमत हो ही नहीं सकते। ⌘/Ctrl + Enter सहेजता है; Esc रद्द करता है।

frontmatter भी एक ब्लॉक ही है: यहाँ हर नोट के सिर पर बैठी वर्गीकरण-पट्टी अपना ✎ साथ रखती है, जो नोट का YAML खोल देता है — स्थिति या तारीख़ बदलिए, और शीर्ष-पट्टी अपडेट हुए frontmatter से फिर रेंडर हो जाती है।

§1.2दो सुरक्षा-जाल

Optimistic locking — हर ब्लॉक उस सोर्स का hash साथ रखता है जिससे वह काटा गया था। आपकी पीठ पीछे किसी और ने फ़ाइल बदल दी हो, तो सहेजना उनके काम पर चुपचाप लिख देने की जगह conflict के साथ अस्वीकार होता है — पन्ना ताज़ा कीजिए और फिर आज़माइए।

बिल्ड-द्वार — डिस्क पर कुछ भी लिखे जाने से पहले पूरी फ़ाइल साइट की Markdown पाइपलाइन से गुज़रती है — बोली, सामग्री-रक्षक, साइट के अपने प्लगइन, और .mdx के लिए MDX कंपाइलर। जो सहेज पन्ना तोड़ देता — जोड़ा न बैठा **, बंद न हुआ कंपोनेंट-टैग, बिगड़ी हुई अभिव्यक्ति — वह हूबहू error के साथ ठुकरा दिया जाता है, और डिस्क की फ़ाइल जस-की-तस रहती है। रक्षक की अस्वीकृतियों की पूरी सूची पूरे पिटारे के अंत में प्रदर्शन करती है।

§1.3सहेजा हुआ कहाँ जाता है

सहेजना Markdown फ़ाइल लिखता है और, autocommit चालू हो तो, साइन-इन किए उपयोगकर्ता के नाम से एक git commit बन जाता है। कहीं कोई डेटाबेस नहीं है: सामग्री-फ़ाइलें ही सच का इकलौता स्रोत हैं और git ही टिकाऊ इतिहास। ब्लॉक-दर-ब्लॉक वाला महीन जर्नल, जिस पर संशोधन-इतिहास चलता है, इसी के ऊपर सवार है।

बोली खुद — CJK-फ़्रेंडली emphasis-नियम वाली GFM, साथ में वह सामग्री-रक्षक जो चुपचाप विकृत होने वाले Markdown को ठुकराता है — इंजन में एक ही बार परिभाषित है, और पन्ना-रेंडरर, इस संपादक का प्रीव्यू और check-content CLI तीनों उसे साझा बरतते हैं (पाँचों जाँचें)। व्याकरण एक, बरतने वाले तीन, बहाव शून्य।

शीर्षक, अनुभाग और मुख्य पाठ — इसी भाषा में।
    ↑↓ · Enter · Escastro-inkstone