2016-02-19 8 views
26

पर README.md में लेटेक्स प्रतिपादन क्या GitHub भंडार में README.md में LaTex प्रस्तुत करने का कोई तरीका है? मैंने इसे गुमराह किया है और स्टैक ओवरफ़्लो पर खोज की है लेकिन संबंधित उत्तरों में से कोई भी व्यवहार्य नहीं लगता है।गीथब

+1

यह सीधे संभव नहीं है। क्या कोई विशिष्ट चीज है जो आपको लगता है कि आपको लाटेक्स की आवश्यकता है? उदाहरण के लिए, यदि आप गणित समीकरण चाहते हैं, तो यह कुछ विशिष्ट चाल के साथ किया जा सकता है। हमें बताएं कि आप क्या प्रस्तुत करना चाहते हैं, और कोई आपको कामकाज पर इंगित करने में सक्षम हो सकता है। – Waylan

+0

हां मैं गणित समीकरणों और गठबंधन समीकरणों के साथ, रेखांकित गणित प्रतीकों के साथ चाहता हूं। तो इतना ही है। – user90593

+0

इस संबंधित पोस्ट को देखें: [सामान्य गीथब के मार्कडाउन में गणित समीकरण कैसे दिखाएं (जिथब के ब्लॉग नहीं)] (http://stackoverflow.com/a/11256862/866026)। – Waylan

उत्तर

6

Readme2Tex

मैं एक स्क्रिप्ट है कि LaTeX Github के स्वाद का markdown में अच्छी तरह से हो रही है टाईपसेट से बाहर cruft के सबसे को स्वचालित पर काम कर रहा है: https://github.com/leegao/readme2tex

Github के लिए LaTeX प्रतिपादन के साथ कुछ चुनौतियों रहे हैं । सबसे पहले, गिथब-स्वाद वाले मार्कडाउन अधिकांश टैग और अधिकांश विशेषताओं को स्ट्रिप्स करता है। इसका मतलब जावास्क्रिप्ट आधारित पुस्तकालयों (जैसे मथजैक्स) और न ही कोई सीएसएस स्टाइल है।

प्राकृतिक समाधान तब प्रीकंपील्ड समीकरणों की छवियों को एम्बेड करना प्रतीत होता है। हालांकि, आपको जल्द ही एहसास होगा कि लाटेक्स छवियों में डॉलर-चिह्न संलग्न सूत्रों को मोड़ने से भी ज्यादा कुछ करता है।

enter image description here

सीधे शब्दों में embedding छवियों ऑनलाइन compilers से अपने दस्तावेज़ में यह वास्तव में अप्राकृतिक प्राप्त होती है। असल में, मैं तर्क दूंगा कि यह आपके दैनिक x^2 गणितीय स्लैंग में jumpy की तुलना में और भी अधिक पठनीय है।

मेरा मानना ​​है कि यह सुनिश्चित करना कि आपके दस्तावेज़ एक प्राकृतिक और पठनीय तरीके से टाइपसेट हैं, महत्वपूर्ण है। यही कारण है कि मैंने एक स्क्रिप्ट लिखी है कि, छवियों में सूत्रों को संकलित करने से परे, यह भी सुनिश्चित करता है कि परिणामस्वरूप छवि ठीक से फिट हो और बाकी पाठ को गठबंधन किया जाए।

enter image description here

आप उम्मीद कर सकते हैं, शीर्ष पर समीकरणों के सेट द्वारा निर्दिष्ट किया जाता:

उदाहरण के लिए, यहाँ readme2tex का उपयोग कर टाइपसेट नियमित अभिव्यक्ति के कुछ गणनासूचक गुणों के बारे में एक .md फ़ाइल से एक अंश है बस इसी align* पर्यावरण शुरू करने

**Theorem**: The translation $[\![e]\!]$ given by 
\begin{align*} 
... 
\end{align*} 
... 

सूचना जबकि इनलाइन समीकरणों ($ ... $) के साथ टेक्स्ट, प्रदर्शन ई चलने वाले quations (जो \begin{ENV}...\end{ENV} या $$...$$ द्वारा सीमित हैं) केंद्रित हैं। यह उन लोगों के लिए आसान बनाता है जो उत्पादक बने रहने के लिए पहले से ही लाटेक्स के आदी हैं।

यह कुछ मदद कर सकता है की तरह लगता है, तो यह बाहर की जाँच करना सुनिश्चित करें। https://github.com/leegao/readme2tex

+3

इस काम के आधार पर मैंने एक गिटहब ऐप बनाया है जो प्रतिपादन प्रक्रिया को स्वचालित करता है, हर बार पुश बनने पर इसे ट्रिगर करता है। मुझे लगता है कि यह उपयोगी है इसलिए मैं उन लोगों के लिए लिंक साझा करता हूं जो इसे आज़माएं: https://github.com/agurz/github-texify – agurz

+2

अच्छा! यह वास्तव में आप करने के लिए वास्तव में कमाल है :) – Lee

1

कोई भी इस ऑनलाइन संपादक का उपयोग कर सकता है: https://www.codecogs.com/latex/eqneditor.php जो फ्लाई पर SVG फ़ाइलों को उत्पन्न करता है। ![](https://latex.codecogs.com/svg.latex?y%3Dx%5E2) जिसमें परिणाम: आप इस तरह अपने दस्तावेज़ में एक लिंक डाल सकते हैं।

7

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

- <img src="https://latex.codecogs.com/gif.latex?O_t=\text { Onset event at time bin } t " /> 
- <img src="https://latex.codecogs.com/gif.latex?s=\text { sensor reading } " /> 
- <img src="https://latex.codecogs.com/gif.latex?P(s | O_t)=\text { Probability of a sensor reading value when sleep onset is observed at a time bin } t " /> 

कौन सा अगले

अद्यतन की तरह कुछ में परिणाम चाहिए: यह ग्रहण में लेकिन GitHub दुर्भाग्य से नहीं में अच्छा काम करता है । चारों ओर एकमात्र काम अगला है:

अपना लेटेक्स समीकरण ले लो और उस क्षेत्र के निचले हिस्से में http://www.codecogs.com/latex/eqneditor.php पर जाएं, जहां आपका समीकरण प्रदर्शित होता है वहां एक छोटा ड्रॉपडाउन मेनू होता है, यूआरएल एन्कोड किया जाता है और फिर उसे अपने जीथब मार्कडाउन में पेस्ट करें अगली तरफ:

![equation](http://latex.codecogs.com/gif.latex?O_t%3D%5Ctext%20%7B%20Onset%20event%20at%20time%20bin%20%7D%20t) 
![equation](http://latex.codecogs.com/gif.latex?s%3D%5Ctext%20%7B%20sensor%20reading%20%7D) 
![equation](http://latex.codecogs.com/gif.latex?P%28s%20%7C%20O_t%20%29%3D%5Ctext%20%7B%20Probability%20of%20a%20sensor%20reading%20value%20when%20sleep%20onset%20is%20observed%20at%20a%20time%20bin%20%7D%20t)