Tufte-css: इसके लिए मार्कडाउन?

Pandoc बनाने के लिए टेम्प्लेट प्रदान करता है, इसलिए Tufte pandoc टेम्प्लेट बनाना सीधा होना चाहिए।

@langford पता चला है कि https://github.com/daveliepmann/tufte-css/issues/30#issuecomment - 128718117

@ xHN35RQ इसे थोड़ा $body$ स्ट्रिंग दी जाती है और बहुत कुछ इसके पहले और बाद में टेक्स्ट डालने की अपेक्षा करता है, और ऐसा प्रतीत नहीं होता है वास्तव में जेनरेट-से-मार्कडाउन टेक्स्ट में हेरफेर करने का इरादा है। आप पैंडोक कस्टम लेखकों का उपयोग करेंगे जिन्हें आप लुआ में लिख सकते हैं (हलेलुजाह)। मैंने एक बेयरबोन कस्टम लेखक लिखा है जो सिर्फ सिडेनोट्स लागू करता है और article टैग जोड़ता है: gist देखें । मैं इसे विस्तारित करने की आशा करता हूं क्योंकि मैं सभी प्रदान की गई सुविधाओं को शामिल करने के लिए टफ्टे-सीएसएस लिखना जारी रखता हूं-आदर्श रूप से पैंडोक मार्कडाउन या इसके पाठकों के बारे में कुछ भी संशोधित किए बिना।

(पूर्णता के लिए मैं पांडोक फिल्टर का उल्लेख कुछ ऐसे के रूप में कर सकता हूं जो अंततः पंडोक मार्कडाउन से पूरी तरह से टफ्टे-सीएसएस-सक्षम एचटीएमएल का उत्पादन करने के लिए आवश्यक हो सकता है, लेकिन शायद केवल बहुत मुश्किल चीजों के लिए। एक कस्टम लेखक को एएसटी दिए जाने से पहले फिल्टर एएसटी में हेरफेर करते हैं। tufte-css-style sidenotes करने का सही स्थान कस्टम लेखक में था, फ़िल्टर के रूप में नहीं।)

@fasiha अच्छा काम। आपने यहां एक आशाजनक शुरुआत की है। :+1:

मुझे नहीं लगता कि मार्कडाउन में टफ्टे-सीएसएस _सेक्शन_ के बराबर आसानी से उपलब्ध है, यानी पैराग्राफ और हेडिंग का समूह। लेकिन मुझे लगता है कि मुझे अनुभागों का विचार पसंद है, मुझे लगता है कि दस्तावेज़ संगठन का एक अतिरिक्त स्तर सड़क के नीचे मददगार होगा।

समुदाय से कोई सुझाव कैसे मार्कडाउन में अनुभागों को इंगित कर सकता है?

@fasiha उस फ़िल्टर के बारे में क्या है जो शीर्षक तत्वों और सभी अनुच्छेद तत्वों को अगले शीर्षक तत्व तक ले जाता है? फिर इन्हें <section> (या कुछ कस्टम <div> ) टैग में लपेटें और इस पर वांछित सीएसएस लागू करें?

@vyp में वजन करने के लिए धन्यवाद। टफ्टे-सीएसएस फ्रंट-पेज के मेरे पढ़ने से, section एक से अधिक शीर्षक, या बिना शीर्षक वाले पैराग्राफ को कैप्चर कर सकता है। अर्थात्, यह केवल एक शीर्षक-और-सामग्री कंटेनर नहीं है। अपने दस्तावेज़ में, मैं अभी के लिए मार्कडाउन में कच्चे HTML के रूप में <section> एम्बेड कर रहा हूं—इसके लिए, मुझे लगता है कि मैं कच्चे HTML को स्वीकार कर सकता हूं।

@fasiha आह क्षमा करें आप सही हैं। चूंकि एक खंड को "पाठ और शीर्षकों के तार्किक समूहन" के रूप में परिभाषित किया गया है, यह निर्धारित करना असंभव है कि मानव इनपुट के बिना दस्तावेज़ में वास्तव में एक अनुभाग क्या है (यानी हम वास्तव में अनुभागों को अर्थपूर्ण जानकारी के रूप में चिह्नित करते हैं, जैसे हम कैसे चिह्नित करते हैं तारांकन या अंडरस्कोर के साथ जोर)। और हाँ, मुझे किसी भी मार्कडाउन स्वाद में इन "वर्गों" के लिए किसी भी पूर्व-मौजूदा वाक्यविन्यास से अवगत नहीं है, इसलिए अच्छी पकड़ है।

इस मामले में कच्चे <section> टैग का उपयोग करना सबसे अच्छा संभव काम है (इसके लिए अपने स्वयं के मार्कडाउन-जैसे सिंटैक्स को परिभाषित करने और इसके लिए एक पार्सर लिखने के अलावा)।

जाने का एक और तरीका इस तथ्य का उपयोग करना होगा कि टफ्टे का कहना है कि यह "सेक्शन हेडिंग" के लिए एच 2 का उपयोग करता है, इसलिए शायद "सेक्शन" को एच 2 टैग के रूप में परिभाषित किया जा सकता है और अगले एच 2 टैग तक सबकुछ और इसी तरह। लेकिन मुझे यकीन नहीं है कि टफ्टे के लेखक का इरादा यही है।

H2 तत्व खंड सीमांकन के विश्वसनीय स्रोत नहीं हैं। उदाहरण के लिए, कुछ दस्तावेज़ इसके बजाय "न्यूथॉट" स्पैन का उपयोग करते हैं। मुझे यकीन है कि जंगली में अन्य विविधताएं सामने आएंगी।

8 AGU 2015, 23:49 पर, vyp [email protected] लिखा है:

@fasiha आह क्षमा करें आप सही हैं। चूंकि एक खंड को "पाठ और शीर्षकों के तार्किक समूहन" के रूप में परिभाषित किया गया है, यह निर्धारित करना असंभव है कि मानव इनपुट के बिना दस्तावेज़ में वास्तव में एक अनुभाग क्या है (यानी हम वास्तव में अनुभागों को अर्थपूर्ण जानकारी के रूप में चिह्नित करते हैं, जैसे हम कैसे चिह्नित करते हैं तारांकन या अंडरस्कोर के साथ जोर)। और हाँ, मुझे किसी भी मार्कडाउन स्वाद में इन "वर्गों" के लिए किसी भी पूर्व-मौजूदा वाक्यविन्यास से अवगत नहीं है, इसलिए अच्छी पकड़ है।

कच्चे का उपयोग करना

टैग इस मामले में करने के लिए सबसे अच्छी चीज है (इसके लिए अपने स्वयं के मार्कडाउन-जैसे वाक्यविन्यास को परिभाषित करने और इसके लिए एक पार्सर लिखने के अलावा)।

जाने का एक और तरीका इस तथ्य का उपयोग करना होगा कि टफ्टे का कहना है कि यह "सेक्शन हेडिंग" के लिए एच 2 का उपयोग करता है, इसलिए शायद "सेक्शन" को एच 2 टैग के रूप में परिभाषित किया जा सकता है और अगले एच 2 टैग तक सबकुछ और इसी तरह। लेकिन मुझे यकीन नहीं है कि टफ्टे के लेखक का इरादा यही है।

-
इस ईमेल का सीधे उत्तर दें या इसे GitHub पर देखें।

मुझे लगता है कि यदि किसी का उपयोग कर से बचने के लिए चाहता है <section> उनके markdown में टैग, कुछ के समान वाक्यविन्यास <hr> के लागू करना मुश्किल हो सकता है। <hr> लिए सिंटैक्स मूल रूप से "तीन या अधिक हाइफ़न, तारांकन, या स्वयं द्वारा एक पंक्ति पर अंडरस्कोर" है। तो उदाहरण के लिए आप मनमाने ढंग से "सेक्शन" सीमांकन को "तीन या अधिक बराबर संकेत" (या जो भी आप पसंद करते हैं) के रूप में परिभाषित कर सकते हैं, और फिर इन अनुच्छेदों के प्रत्येक जोड़े के बीच सब कुछ केवल बराबर संकेतों के साथ लपेटने के लिए एक पैंडोक फ़िल्टर का उपयोग कर सकते हैं।

मैंने केवल "बराबर संकेतों की एक पंक्ति" को चुना क्योंकि मुझे लगता है कि सादे पाठ के साथ विभाजित करने वाले अनुभागों को _look_ पसंद आएगा? और क्योंकि पैंडोक मार्कडाउन इसे केवल एक पैराग्राफ के रूप में पार्स करेगा, जिसका अर्थ है कि आपका फ़िल्टर हर पैराग्राफ की जांच कर सकता है यदि इसमें केवल समान चिह्न हैं या नहीं, और यदि यह केवल बराबर चिह्न से बना है, तो मान लें कि यह एक खंड सीमांकन है।

हाय सब (और मुझे इस धागे पर इंगित करने के लिए @daveliepmann को धन्यवाद)। आपको मेरे ग्लासआई पैकेज में दिलचस्पी हो सकती है जिसमें मैंने Tufte.css का उपयोग किया है (इसलिए इसके लिए सभी को धन्यवाद) और जिसमें मैंने मार्कडाउन, d3 और Tufte लेआउट को एकीकृत करने का लक्ष्य रखा है। फिलहाल यह बहुत सारे कोने काटने के साथ एक प्रोटोटाइप है। जब मेरे पास एक पल होता है तो मैं कोड को साफ करना चाहता हूं और डिजाइन को थोड़ा सा युक्तिसंगत बनाना चाहता हूं (उस समय मैं सीएसएस पर आपकी टिप्पणियों के माध्यम से फंस जाऊंगा)। लेकिन मैं देखना चाहता था कि क्या यह पहले करने लायक था और मुझे लगता है कि यह है। वैसे भी कोई प्रतिक्रिया पसंद आएगी।

क्या रीस्ट्रक्चर्ड टेक्स्ट मार्कडाउन की तुलना में यहां आवश्यक एनोटेशन के प्रकार के लिए अधिक उत्तरदायी होगा?

@coppeliaMLA ग्लासआई का उल्लेख करने के लिए धन्यवाद, यह अविश्वसनीय काम है।

@rbcarson मैं ओपी नहीं हूं, लेकिन यदि प्रश्न यहां सभी पर निर्देशित है और आप मेरी राय चाहते हैं, तो मैं व्यक्तिगत रूप से पुनर्गठित

तो वर्षों से, केवल इतना ही अन्य प्रकार का वाक्यविन्यास है जिसे आप "मार्कडाउन" में रटना कर सकते हैं क्योंकि इसका पूरा बिंदु यह है कि इसे सादे पाठ के रूप में पठनीय माना जाता है। आप सादे पाठ में सिडेनोट्स को दृष्टिगत रूप से कैसे व्यक्त करते हैं? फिर भी, मुझे लगता है कि इस संबंध में पांडोक के विस्तारित मार्कडाउन ने वास्तव में अच्छा काम किया है।

तो मुझे लगता है कि पुनर्गठित टेक्स्ट में निर्देश या कुछ कहा जाता है, जो आपको किसी विशेष प्रकार के डेटा के लिए वाक्यविन्यास (या कुछ?) बनाने की अनुमति देता है? अगर कुछ हद तक ऐसा है, हाँ, मुझे लगता है कि पुनर्गठित टेक्स्ट शायद यहां अधिक उपयुक्त है। लेकिन जैसा कि मैंने कहा, मुझे इसका ज्यादा अनुभव नहीं है, इसलिए मैं आपकी और मदद नहीं कर सकता।

पुनर्गठित पाठ मेरे उद्देश्यों के लिए बेकार होगा, जो पहले से ही मार्कडाउन में प्रलेखित परियोजनाएं हैं

अगस्त 17, 2015, पर 4:24 बजे, vyp [email protected] लिखा है:

@coppeliaMLA ग्लासआई का उल्लेख करने के लिए धन्यवाद, यह अविश्वसनीय काम है।

@rbcarson मैं ओपी नहीं हूं, लेकिन यदि प्रश्न यहां सभी पर निर्देशित है और आप मेरी राय चाहते हैं, तो मैं व्यक्तिगत रूप से पुनर्गठित

तो वर्षों से, केवल इतना ही अन्य प्रकार का वाक्यविन्यास है जिसे आप "मार्कडाउन" में रटना कर सकते हैं क्योंकि इसका पूरा बिंदु यह है कि इसे सादे पाठ के रूप में पठनीय माना जाता है। आप सादे पाठ में सिडेनोट्स को दृष्टिगत रूप से कैसे व्यक्त करते हैं? फिर भी, मुझे लगता है कि इस संबंध में पांडोक के विस्तारित मार्कडाउन ने वास्तव में अच्छा काम किया है।

तो मुझे लगता है कि पुनर्गठित टेक्स्ट में निर्देश या कुछ कहा जाता है, जो आपको किसी विशेष प्रकार के डेटा के लिए वाक्यविन्यास (या कुछ?) बनाने की अनुमति देता है? अगर कुछ हद तक ऐसा है, हाँ, मुझे लगता है कि पुनर्गठित टेक्स्ट शायद यहां अधिक उपयुक्त है। लेकिन जैसा कि मैंने कहा, मुझे इसका ज्यादा अनुभव नहीं है, इसलिए मैं आपकी और मदद नहीं कर सकता।

-
इस ईमेल का सीधे उत्तर दें या इसे GitHub पर देखें।

@coppeliaMLA बहुत दिलचस्प !: विशेष टैग के साथ HTML को आउटपुट करने के लिए pandoc का उपयोग करें, और फिर दूसरे चरण के रूप में, विशेष टैग को जावास्क्रिप्ट और HTML में विस्तारित करने के लिए किसी अन्य प्रोग्राम का उपयोग करें। मेरा दृष्टिकोण एक पांडोक कस्टम लेखक बनाना है जो विशेष टैग का उपभोग करता है, लुआ में प्रभावी रूप से glasseye.py कर रहा है, सुंदर सूप पार्सिंग के बजाय पांडोक एएसटी का उपयोग कर रहा है, लेकिन ऐसा लगता है कि ग्लासआई मूल रूप से ठीक काम कर रहा है। मैं अपने दस्तावेज़ों को देखने की कोशिश करूँगा और किसी भी मुद्दे के बारे में आपको इसके रेपो पर बताऊंगा। पांडोक लेखक में जो चीजें करना मुश्किल है, पोस्ट-प्रोसेसिंग करना आसान हो सकता है, और इसके विपरीत, लेकिन पता लगाने का एकमात्र तरीका दस्तावेजों का एक समूह लिखना है :)

@fasiha धन्यवाद। आपका तरीका अधिक कुशल लगता है और मुझे लगता है कि संभवतः मैं अंत में उस दिशा में जा सकता हूं। मैं अजगर के लिए गया क्योंकि इसने मुझे एक त्वरित प्रोटोटाइप बनाने की अनुमति दी। लेकिन जैसा कि आप कहते हैं कि बहुत सारे दस्तावेज़ों पर प्रयोग करने से सबसे अच्छी विधि बन जाएगी। मैं इसे अपने दिन-प्रतिदिन के काम के लिए जितना संभव हो सके उपयोग करने की योजना बना रहा हूं यह देखने के लिए कि यह मुझे कहां मिलता है। अगर आप इसे आजमा सकते हैं तो बहुत अच्छा होगा। यह कैसे जाता है यह सुनना पसंद है!

#31 देखें और #58 . भी देखें

इसके लायक क्या है: मार्कडाउन में साइड नोट्स लिखने की समस्या को हल करने के लिए मैंने अभी tufte-pandoc-css को एक साथ रखा है। यह सिर्फ एक शोकेस है कि मैंने pandoc-sidenote नामक एक कस्टम पांडोक फ़िल्टर का उपयोग कैसे किया है।

इसे क्रिया में देखने के लिए:

• पांडोक-स्वाद वाले मार्कडाउन में एक पुन: कार्यान्वयन tufte-css/index.html
• कुछ अन्य पांडोक सुविधाओं का एक डेमो, जैसे सिंटैक्स हाइलाइट किए गए कोड ब्लॉक।

@ जेज़ कूल! मैं देखूंगा कि क्या मुझे इसे एक चक्कर देने के लिए कोई प्रोजेक्ट मिल सकता है।

Google के माध्यम से अभी-अभी यह सूत्र मिला

आप लोग xmark पर एक नज़र मार्कडाउन को XSLT के माध्यम से Tufte-CSS में परिवर्तित करता है।

@vieiro वाह यह अच्छा है। बढ़िया काम