# प्रीफ़्लाइट जाँचें

किसी डॉक्यूमेंट के आपके हाथ से जाने से पहले सोर्स, बिल्ड लॉग, PDF, संदर्भ, एक्सेसिबिलिटी संकेतों और सबमिशन जोखिमों की जाँच करें।

सफल कंपाइल केवल इतना सिद्ध करता है कि कोई PDF बना। यह सिद्ध नहीं करता कि हर साइटेशन हल हुआ, पढ़ने का क्रम सही बनता है, सबमिशन आर्काइव साफ़ है, या फ़ाइल वह एक्सेसिबिलिटी संरचना ले जा रही है जिसका दावा करती है।

Preflight इन सवालों को एक स्थानीय समीक्षा में लाता है। प्रोजेक्ट रेल में **shield** खोलें, डॉक्यूमेंट के अनुरूप जाँचें चुनें, और कोई समस्या ठीक करते समय एक जाँच चलाएँ या सबमिशन से पहले पूरा सेट।

![Oleafly का Preflight पैनल। ज़रूरी जाँचें चुनें, किसी एक को उसकी पंक्ति से चलाएँ, या सभी सक्षम जाँचें सबसे नीचे के बटन से चलाएँ।](https://cdn.oleafly.com/images/screenshots/desktop/docs/preflight-checks-dark-window-v2.png#view=0,45,344,689)

![पेपर भेजने से पहले उस पर Preflight की बिल्ड, सबमिशन और एक्सेसिबिलिटी जाँचें चलाई गईं।](https://cdn.oleafly.com/images/gifs/desktop/preflight.gif?v=2)

## छह स्वतंत्र जाँचें

### Compile & layout

नवीनतम बिल्ड लॉग और PDF को पढ़कर यह विफल बिल्ड, अनसुलझे साइटेशन और संदर्भ, रीरन चेतावनियाँ, ग़ायब ग्लिफ़, ओवरफ़ुल बॉक्स, कटा हुआ टेक्स्ट, डुप्लिकेट PDF गंतव्य और मिश्रित पेज आकार ढूँढता है।

### Submission readiness

प्रोजेक्ट पर चुनी हुई पब्लिकेशन प्रोफ़ाइल लागू करता है। यह डॉक्यूमेंट क्लास, एब्स्ट्रैक्ट और कीवर्ड, फ़िगर फ़ॉर्मैट, एम्बेडेड फ़ॉन्ट, PDF प्रतिबंध, कैप्शन, पोर्टेबल नाम और सोर्स-पैकेज की भीड़ से जुड़ी स्थिर ज़रूरतों की जाँच करता है।

### ATS readiness

रिज़्यूमे को वैसे निकालता है जैसे कोई आवेदक-ट्रैकिंग सिस्टम निकालता। यह संपर्क फ़ील्ड, अपेक्षित सेक्शन और ऐसे लेआउट बताता है जो पढ़ने का क्रम बिखेर सकते हैं।

### Accessibility

टैगिंग, वैकल्पिक टेक्स्ट, भाषा और शीर्षक मेटाडेटा, व्यूअर सेटिंग्स, हेडिंग, टेबल, लिंक, पढ़ने का क्रम, चुनने योग्य टेक्स्ट, जहाँ उपयोगी हो बुकमार्क, और बहुत छोटे टेक्स्ट से जुड़े सोर्स और PDF संकेतों की जाँच करता है।

### References & assets

ग़ायब फ़ाइलें, अनसुलझे साइटेशन और क्रॉस-संदर्भ, डुप्लिकेट लेबल और DOI, अधूरी बिब्लियोग्राफ़ी प्रविष्टियाँ ढूँढता है, और पूरा प्रोजेक्ट उपलब्ध होने पर बिना साइट किए गए संदर्भ भी।

### Privacy & blind review

क्रेडेंशियल, प्राइवेट की, संवेदनशील फ़ाइलें, ड्राफ़्ट नोट्स, आंतरिक टिप्पणियाँ, आभार (acknowledgements), लेखक फ़ील्ड और पहचान का मेटाडेटा खोजता है जो ब्लाइंड रिव्यू तोड़ सकते हैं।

## Typst प्रोजेक्ट

Typst सोर्स को उनकी अपनी जाँचें मिलती हैं। वे आपकी `.typ` फ़ाइलें सीधे पढ़ती हैं, इसलिए LaTeX के नियम कभी Typst सिंटैक्स पर नहीं चलते।

- **References & assets** ऐसे `@` संदर्भ और साइटेशन ढूँढता है जिनका कोई मैचिंग लेबल या बिब्लियोग्राफ़ी प्रविष्टि नहीं है, डुप्लिकेट लेबल, ऐसे इमेज या `#include` पाथ जो किसी प्रोजेक्ट फ़ाइल से मेल नहीं खाते, कोई `#bibliography` फ़ाइल जो प्रोजेक्ट में नहीं है, और ऐसा डॉक्यूमेंट जो स्रोतों को साइट करता है पर कभी `#bibliography` कॉल नहीं करता। साइटेशन कीज़ `.bib` फ़ाइल या Hayagriva की `.yml` फ़ाइल में रह सकती हैं।
- **Accessibility** ऐसी इमेज को चिह्नित करता है जिनका कोई `alt` टेक्स्ट नहीं है, इमेज पर या उस फ़िगर पर जो उसे थामे है, खाली हेडिंग, और ऐसा डॉक्यूमेंट जिसका शीर्षक `#set document(title: ...)` या टेम्पलेट से सेट नहीं है।
- **Submission readiness** जाँचता है कि प्रोजेक्ट ऐसा टेम्पलेट इंपोर्ट करे जो चुनी हुई प्रोफ़ाइल से फिट बैठे, टेम्पलेट को एब्स्ट्रैक्ट और कीवर्ड मिलें, और कोई `#lorem` टेक्स्ट, प्लेसहोल्डर या TODO नोट न बचे। यह कैप्शन, इमेज के आकार और फ़ाइल नाम भी देखता है।
- **Privacy & blind review** टेम्पलेट को दिए गए लेखक नाम, ईमेल और संबद्धताएँ, आभार और स्थानीय फ़ाइल पाथ ढूँढता है।

हर निष्कर्ष फ़ाइल और पंक्ति का नाम बताता है, और उसका विवरण Typst का सुधार दिखाता है, जैसे `#image("chart.png", alt: "Bar chart of yearly sales")`।

## निश्चितता पढ़ें, केवल रंग नहीं

हर परिणाम बताता है कि Oleafly उस तक कैसे पहुँचा:

- **Verified** का अर्थ है कि ऐप ने सोर्स, लॉग, प्रोजेक्ट या PDF में प्रत्यक्ष सबूत देखा।
- **Advisory** का अर्थ है कि किसी प्रलेखित heuristic ने ऐसा कुछ पाया जिसे कोई व्यक्ति जाँचे।
- **Manual** उस जाँच को नाम देता है जिसे फ़ाइलें सुरक्षित रूप से तय नहीं कर सकतीं।

ग़ायब इनपुट कभी पास नहीं बन जाता। केवल-सोर्स निष्कर्ष तब तक अधूरे रहते हैं जब तक कोई मौजूदा PDF न बने।

## पब्लिकेशन प्रोफ़ाइल चुनें

सामान्य पब्लिकेशन, arXiv, IEEE, ACM, जर्नल या थीसिस में से वह प्रोफ़ाइल चुनें जो गंतव्य से सबसे अच्छा मेल खाती हो। प्रोफ़ाइल उन ज़रूरतों को समेटती हैं जो स्वचालित जाँच के लिए काफ़ी स्थिर हैं। Typst प्रोजेक्ट में, प्रोफ़ाइल मैचिंग Typst टेम्पलेट की भी अपेक्षा करती है, और निष्कर्ष उन टेम्पलेटों के नाम बताता है जिन्हें वह स्वीकार करता है।

फिर मौजूदा वेन्यू के निर्देश खोलें। पेज सीमाएँ, मार्जिन, फ़ाइल-आकार की सीमाएँ, गुमनामी के नियम और नामकरण की परंपराएँ इतनी बार बदलती हैं कि कोई सामान्य प्रोफ़ाइल उन्हें तय न कर सके।

## देखें कि दूसरा पाठक क्या पाता है

Preflight पैनल में **Screen Reader** चुनकर **What the reader sees** खोलें, जो PDF टेक्स्ट को पेज-दर-पेज निकालता है। इसका उपयोग करें ऐसी चीज़ें पकड़ने के लिए जैसे कोई दो-कॉलम पेपर का पेज के आर-पार पढ़ा जाना, आइकन-फ़ॉन्ट वाला ग़ायब फ़ोन नंबर, ग़लत जगह पर कैप्शन, या बिना चुनने योग्य टेक्स्ट वाला पेज।

रिज़्यूमे के लिए, **What a parser extracted** नाम, ईमेल, फ़ोन, लिंक और वे स्टैंडर्ड सेक्शन दिखाता है जो ATS सिम्युलेशन निकाल सका।

ये व्यू सबूत हैं, असली सबमिशन पोर्टल, स्क्रीन रीडर या पार्सर से परखने का विकल्प नहीं जिनका उपयोग आपके पाठक करते हैं।

## PDF/UA और एक्सेसिबिलिटी: ईमानदार सीमा

Oleafly, PDF/UA-1 के उस हिस्से की जाँच करता है जिसे वह फ़ाइल से पढ़ सकता है। निष्कर्ष PDF/UA-1, जहाँ वह अलग हो तो PDF/UA-2, Matterhorn Protocol के चेकपॉइंट और WCAG 2.2 की PDF तकनीकों का हवाला देते हैं।

रिपोर्ट मशीन-पठनीय संकेतों को समेटती है, जैसे:

- ऐसा टैग ट्री जिसमें असली सामग्री हो;
- फ़िगरों और सूत्रों पर वैकल्पिक टेक्स्ट;
- टेबल में हेडर सेल;
- हेडिंग का क्रम;
- डॉक्यूमेंट की भाषा और XMP शीर्षक;
- वह व्यूअर प्राथमिकता जो शीर्षक दिखाती है;
- लिंक विवरण और संदिग्ध अनटैग्ड सामग्री;
- क्या घोषित PDF/UA-1 दावे की पुष्टि फ़ाइल से होती है।

पैनल बताता है कि 106 मशीन-जाँच योग्य PDF/UA-1 नियमों में से कितने सत्यापित हुए। यह यह भी बताता है जब कोई नियम पढ़ा नहीं जा सका या लागू नहीं हुआ। बिना जाँचा गया नियम पास नहीं गिना जाता।

:::caution[Preflight PDF/UA प्रमाणित नहीं करता]
यह एक उपसमुच्चय जाँच है, अनुपालन कथन नहीं। Oleafly यह तय नहीं कर सकता कि वैकल्पिक टेक्स्ट सार्थक है, पढ़ने का क्रम किसी व्यक्ति को सही लगता है, रंगों का विरोधाभास पर्याप्त है, या डॉक्यूमेंट किसी पाठक की असिस्टिव टेक्नोलॉजी के साथ ठीक से चलता है। औपचारिक अनुपालन परिणाम के लिए, अंतिम फ़ाइल को veraPDF या PAC 2024 से सत्यापित करें और एक मानव समीक्षा पूरी करें।
:::

## LaTeX से टैग्ड PDF तैयार करना

LaTeX टैगिंग डॉक्यूमेंट क्लास, पैकेज, इंजन और TeX Live संस्करण पर निर्भर करती है। तैयारी का प्रस्ताव देने से पहले Preflight प्रभावी मुख्य डॉक्यूमेंट और उसके द्वारा लोड की गई प्रीएम्बल फ़ाइलों की जाँच करता है।

1. मौजूदा PDF पर **Accessibility** चलाएँ और निष्कर्ष पढ़ें।
2. **Accessible export** खोलें।
3. क्लास और पैकेज संगतता रिपोर्ट देखें। असंगत क्लास तैयारी रोक देता है; आंशिक रूप से संगत या अज्ञात पैकेज चेतावनी के रूप में दिखता है।
4. **Prepare for accessible export** चुनें और प्रस्तावित हर सोर्स बदलाव की समीक्षा करें।
5. हर जेनरेट किए गए वैकल्पिक-टेक्स्ट प्लेसहोल्डर को सार्थक विवरण से बदलें और माँगे जाने पर डॉक्यूमेंट शीर्षक जोड़ें।
6. TeX Live 2026 के, या नवंबर 2025 के बाद अपडेट किए गए TeX Live के, pdfLaTeX या LuaLaTeX से कंपाइल करें। सुगम गणित के लिए LuaLaTeX चाहिए।
7. Accessibility दोबारा चलाएँ, रीडर व्यू देखें, फिर जब अनुपालन मायने रखता हो तो अंतिम PDF को Oleafly के बाहर सत्यापित करें।

तैयारी भाषा, PDF/UA-2 आशय और टैगिंग के साथ `\DocumentMetadata` जोड़ या अपडेट कर सकती है; पहली टेबल-हेडर पंक्ति घोषित कर सकती है; ग़ायब फ़िगर विकल्पों के लिए दिखने वाले प्लेसहोल्डर जोड़ सकती है; और चुने गए इंजन की ज़रूरत होने पर `unicode-math` जोड़ सकती है। यह बदलाव लागू करने से पहले उन्हें दिखाती है।

`\DocumentMetadata` वाली पंक्ति एक संस्करण-जाँच के भीतर रखी जाती है। नवंबर 2025 से पुराना LaTeX, जैसे बंडल किए इंजन का, उसे छोड़ देता है और विफल होने के बजाय डॉक्यूमेंट को बिना टैग के बना देता है, और PDF PDF/UA का कोई दावा नहीं करता। तब Preflight **Tagging was skipped because this LaTeX is too old** रिपोर्ट करता है और बताता है कि बिल्ड ने कौन सा LaTeX चलाया।

बंडल किया हुआ Tectonic इंजन टैग ट्री नहीं बना सकता। **Compile tagged and verify** उपलब्ध सिस्टम TeX डिस्ट्रिब्यूशन या Oleafly के प्रबंधित TinyTeX का उपयोग करता है, और हमेशा LuaLaTeX चलाता है, Tectonic प्रोजेक्ट में भी। अगर टैग्ड कंपाइल किसी ग़ायब फ़ाइल पर रुक जाए, जैसे TinyTeX पर `tagpdf-base.sty`, तो वह सामान्य कंपाइल की तरह उसे इंस्टॉल करने का प्रस्ताव देता है, फिर टैग्ड कंपाइल दोबारा चलाता है। आप तैयार किए गए सोर्स को अपने मौजूदा टूलचेन से भी कंपाइल कर सकते हैं।

:::note[संगतता ही रुकावट बन सकती है]
Preflight, LaTeX Project की प्रकाशित टैगिंग-स्थिति डेटा का उपयोग करता है। असमर्थित क्लास रोक दी जाती हैं, आंशिक रूप से समर्थित क्लास सावधानी के साथ चिह्नित होती हैं, और डेटा में न पाए जाने वाले पैकेज सुरक्षित मान लेने की बजाय अज्ञात माने जाते हैं। `enumitem` इस समय रोका हुआ है क्योंकि उसे टैग्ड वर्कफ़्लो में लोड नहीं किया जा सकता।
:::

TinyTeX, पैकेज स्थिति और सिस्टम TeX के चारों ओर सुरक्षा सीमा के लिए [LaTeX इंजन और पैकेज](/docs/latex-engines/) देखें।

## Typst से PDF मानक

Typst प्रोजेक्ट में तैयार करने के लिए कोई सोर्स नहीं होता। Typst संग्रह-योग्य और सुगम PDF स्वयं लिखता है, इसलिए **Accessibility** जाँच **Accessible export** की जगह **PDF standards** दिखाती है।

1. **Accessibility** चलाएँ और ग़ायब वैकल्पिक टेक्स्ट तथा ग़ायब डॉक्यूमेंट शीर्षक ठीक करें। PDF/UA-1 को दोनों चाहिए।
2. **PDF standards** के अंतर्गत, कोई **Standard** चुनें, जैसे PDF/UA-1 या PDF/A-2b।
3. **Export PDF** चुनें और फ़ाइल सहेजें।
4. जब अनुपालन मायने रखता हो, तो एक्सपोर्ट किए गए PDF को Oleafly के बाहर सत्यापित करें।

Typst 0.14 और बाद के हर PDF को टैग करते हैं, इसलिए कोई अलग टैग्ड कंपाइल नहीं है। पुराने संस्करण कम मानक देते हैं, और Typst 0.11 कोई नहीं देता; पैनल बताता है कि कौन सा लागू होता है। नया संस्करण इस्तेमाल करने के लिए, कंपाइल मेन्यू में **Typst version (this project)** बदलें। देखें [Typst प्रोजेक्ट](/docs/typst/#what-each-version-can-do)।

## एक व्यावहारिक अंतिम दौर

1. ठीक वही सोर्स कंपाइल करें जिसे आप सबमिट करना चाहते हैं।
2. सभी प्रासंगिक Preflight जाँचें चलाएँ।
3. सत्यापित निष्कर्ष ठीक करें और एडवाइज़री की जाँच करें।
4. मौजूदा वेन्यू गाइड के मुकाबले हर मैनुअल आइटम पूरा करें।
5. अंतिम PDF को पहले पेज से अंतिम पेज तक पढ़ें, संदर्भ और परिशिष्ट समेत।
6. एक्सपोर्ट की गई फ़ाइल और सोर्स आर्काइव को उनके सहेजे गए स्थानों से खोलें।
7. समय-सीमा से पहले गंतव्य का अपना सत्यापक इस्तेमाल करें।

Preflight टालने योग्य अचानक समस्याओं को कम करता है। स्वीकृति, एक्सेसिबिलिटी और वैज्ञानिक शुद्धता के लिए फिर भी लेखक, वेन्यू और उन लोगों की ज़रूरत होती है जो डॉक्यूमेंट का उपयोग करेंगे।
