पीडीएफ दस्तावेज बनाने के लिए डॉक्सिजन के लाटेक्स आउटपुट को नियंत्रित करना

Question

मैं अपने कोड के लिए दस्तावेज़ उत्पन्न करने के लिए डॉक्सीजन का उपयोग कर रहा हूं। मुझे इसका पीडीएफ संस्करण बनाना होगा और डॉक्सिजन के लाटेक्स आउटपुट का उपयोग करना ऐसा करने का तरीका प्रतीत होता है।

हालांकि मैंने कई परेशान करने वाली समस्याओं में भाग लिया है, और लाटेक्स के बारे में कुछ भी नहीं जानते हैं, पहले उन्हें वास्तव में उनसे संपर्क करने के बारे में कोई जानकारी नहीं मिली है, और लाटेक्स से संबंधित चीजों के अनगिनत संदर्भ बहुत मदद नहीं हैं ...

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

1. दस्तावेज़ के शुरू में सामग्री तालिका बहुत से आइटम ईद बल्कि यह नहीं था के रूप में यह सामग्री बहुत लंबी हो जाती है शामिल हैं। वहाँ करने के लिए इस सामग्री को सीमित करने के लिए कोई रास्ता है बस प्रत्येक दो अलग-अलग फ़ंक्शन, वेरिएबल इत्यादि के लिए प्रविष्टियां करने के बजाय पहले दो स्तरों को कहें? आईडी सभी बुकमार्क्स को रखना पसंद है। मैंने "COMPACT_LATEX" विकल्प को आजमाया लेकिन सामग्री पृष्ठों पर आइटम को निकालने का प्रयास किया , इसने प्रत्येक अनुभाग की शुरुआत में बुकमार्क और सदस्य सूचियों को हटा दिया, जिसे मैं वास्तव में रखना चाहता हूं।

2. क्या चीजों के क्रम को बदलने का कोई तरीका है, जैसे सभी सदस्यों और विशेषताओं के बजाय अनुभाग की शुरुआत में पूर्ण श्रेणी का विवरण डालना?

Answer 1

वाह, यह डॉक्सिजन की तरह की बुराई है।

ठीक है, tocdepth काउंटर समस्या को हल करने के लिए, निम्न पंक्ति अपने .sty फाइल करने के लिए जोड़ें:

% requires you \usepackage{hyperref} first 
\hypersetup{ 
    bookmarksdepth = section, % of whatever level you want 
} 

इसके अलावा:

\AtBeginDocument{\setcounter{tocdepth}{2}}% or whatever level you want 

आप एक अलग मूल्य के लिए PDF बुकमार्क गहराई सेट कर सकते हैं ध्यान दें कि यदि आपके पास आंकड़े/तालिकाओं की एक सूची है, तो tocdepth उनके लिए दिखाने के लिए कम से कम 2 होना चाहिए।

मुझे उन वस्तुओं को लाटेक्स फ़ाइलों के भीतर पुनर्व्यवस्थित करने का कोई तरीका नहीं दिख रहा है --- डॉक्सिजन बस उन्हें वहां बंद कर देता है, इसलिए हम ज्यादा कुछ नहीं कर सकते हैं। मुझे लगता है कि ऑर्डर निर्दिष्ट करने का कोई तरीका है या नहीं, यह देखने के लिए आपको Doxygen दस्तावेज़ों के चारों ओर पोक करना होगा। (यहां उम्मीद है!)

Answer 2

आप तो ही वाले हैं।

"लेटेक्स सामग्री स्तर" पर Googling मुझे LaTeX - customizing the depth of the table of contents for different parts of the thesis जिससे पता चलता है करने के लिए लाया

\setcounter{tocdepth}{n} 

जहां केवल उच्चतम स्तर विभाजन के लिए शून्य पर n शुरू होता है। यह सभी डिफ़ॉल्ट शैलियों में अनुमानित परिभाषित है, लेकिन डॉक्सिजन में प्रयास करने योग्य है।

Answer 3

आप सामग्री की तालिका से अवांछित लाइनों को हटाने के लिए एक पर्ल/Awk स्क्रिप्ट लिख सकते हैं।

 
\contentsline {subsection}{Class F rewrites}{38} 
\contentsline {subsection}{Class M rewrites}{39} 
\contentsline {section}{\numberline {7}Definition and properties of the translation}{44} 
\contentsline {paragraph}{Well-formedness}{54} 

सरल regexes की पहचान करेगा जो स्तरों प्रत्येक पंक्ति के अंतर्गत आता है, और आप उस के आधार पर फ़ाइल फ़िल्टर कर सकते हैं: फ़ाइल burble.tex के लिए, लेटेक्स फ़ाइल burble.toc है, जो इस तरह के रूप पंक्तियां होती हैं उत्पन्न होगा। एक बार आपके पास सामग्री की तालिका जिस तरह से आप चाहते हैं, उचित स्थान (स्टाइल शीट?) में \nofiles डालें, जिसका अर्थ है कि लेटेक्स सहायक फाइलें पढ़ेगा लेकिन उन्हें ओवरराइट नहीं करेगा।