2014-08-30 13 views
9

मेरे पास 80 से अधिक पृष्ठों से भरे विकी के साथ एक संग्रह है। मैं प्रोजेक्ट के लिए जेकील (गिटहब पेज) साइट पर सभी विकी पृष्ठों की एक अनुक्रमणिका प्रस्तुत करना चाहता हूं, साथ ही कस्टम लेआउट का उपयोग करके साइट पर प्रत्येक पृष्ठ प्रस्तुत करना और बाकी साइट की शैलियों का उपयोग करना चाहता हूं।एक गिटहब पेज पर गिटहब विकी प्रस्तुत करना जेकिल साइट

ऐसा करने के लिए, मेरी पहली प्रवृत्ति जेकी साइट के रेपो में विकी (जो गिटहब एक गिट रेपो के रूप में उजागर) के पृष्ठों को शामिल करने के लिए गिट सबमिड्यूल का उपयोग करना था। लेकिन जहां तक ​​मुझे मिला है: जहां तक ​​मैं कह सकता हूं, वहां कहीं भी नहीं है कि जेकेल मार्कडाउन फाइलों को स्वीकार करेगा जो एक पद के अनुरूप नहीं हैं। उन्हें एक तारीख के साथ नामित नहीं किया गया है, और उनके पास कोई फ्रंटमेटर नहीं है, इसलिए जैकिल सिर्फ उन्हें अनदेखा करता है।

इसके आसपास पाने के लिए, मैं आमतौर पर जो चाहता था उसे करने के लिए एक प्लगइन लिखता। लेकिन चूंकि साइट गिटहब पृष्ठों पर होस्ट की जाती है, इसलिए यह मेरे द्वारा बनाए गए किसी भी प्लगइन की अनुमति नहीं देगी।

तो, मुझे वास्तव में नहीं पता कि आगे कैसे बढ़ना है। क्या कस्टम प्लगइन्स के बिना भी यह संभव है?

उत्तर

7

विचार है:

  1. मेरी प्लगइन डाउनलोड: https://github.com/djacquel/WikiToJekyll
  2. दस्तावेज़ पढ़
  3. स्थापित करने और घूस
  4. एक बियर

मैं इसे यहाँ परीक्षण किया है पीना: https://github.com/djacquel/JekyllTest/tree/gh-pages इस विकी पृष्ठों के साथ: https://github.com/djacquel/JekyllTest/wiki

क्या raketask/प्लगइन एक बार स्थापित और कॉन्फ़िगर (5 मिनट) कर रहे हैं:

  1. rake wikisub एक Git submodule अपने विकि की ओर इशारा करते जोड़ें। एक सार्वजनिक विकी होना चाहिए, लेकिन एक और भंडार
  2. प्रति पर हो सकता है और YAML सामने साथ markdown के रूप में डाउनलोड विकी पृष्ठों को बदलने बात
  3. Jekyll, निर्माण तो प्लगइन अवरोधन विकी पृष्ठों रूपांतरण लिंक के रूप में Jekyll लिंक
  4. ताकि उन्हें बदलने के लिए कर सकते हैं पिज्जा

अब के लिए केवल एकमात्र समस्या (या नहीं) यह है कि क्रैमडाउन गिथब मार्कडाउन के साथ अच्छा नहीं करता है। आपको रेडकार्प पर स्विच करना होगा।

दो अन्य कार्यों के लिए उपलब्ध हैं:

  • rake wikibuild: सिंक विकि पृष्ठ, निर्माण और वैकल्पिक रूप से Jekyll भंडार

एट हॉप करने के लिए परिवर्तन धक्का: विकी पृष्ठों

  • rake wiki पुनर्निर्माण !

  • +0

    यह एक बहुत अच्छी और विस्तृत प्रतिक्रिया है।मेरे मन में कुछ समान था लेकिन मैं इस तरह कुछ लिखने के लिए बहुत आलसी था :) एक चीज जिसे शायद संबोधित करने की भी आवश्यकता होगी, विकी पृष्ठों (यदि कोई है) के बीच आंतरिक लिंक हैं, जिन्हें बदलने की आवश्यकता हो सकती है github पर पृष्ठों के बजाय साइट पर पृष्ठों पर इंगित करें (मुझे लगता है कि यह लिंक निर्भर करता है कि लिंक पूर्ण या रिश्तेदार हैं और यदि पृष्ठ की मुख्य संरचना github पर उस के समान है)। –

    +0

    @ MitjaBezenšek आपको सही है मैं इस बिंदु को याद किया है। यह एक अच्छा कोड काटा आप के लिए ;-) '" kramdown "' तो जैसे 'kDoc कुछ = Kramdown :: Document.new (fileContent)' की आवश्यकता हो सकता है लेकिन, अभी मैं नहीं कर सकता parser.parse प्राप्त करें wiki पृष्ठों के लिए पार्सर :: link_defs संग्रह को वापस करें। बस रिपोजिटरी यहां होने पर: https://github.com/djacquel/JekyllTest –

    +0

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

    संबंधित मुद्दे