कैसे एक पीसी पर Dokuwiki के लिए Markdown फ़ाइलों को परिवर्तित करने के लिए


13

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

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

मैं स्वयं रूपांतरण करने के लिए एक पायथन स्क्रिप्ट लिखने में समय बिता सकता था , लेकिन मैं इस पर समय बिताने से बचना चाहूंगा, अगर ऐसा कुछ पहले से मौजूद है।

मेरे द्वारा समर्थित / परिवर्तित किए गए मार्कडाउन टैग हैं:

  • स्तर 1 - 5
  • बोल्ड, इटैलिक, अंडरलाइन, निश्चित चौड़ाई का फ़ॉन्ट
  • क्रमांकित और अनावश्यक सूची
  • हाइपरलिंक
  • क्षैतिज नियम

क्या ऐसा कोई उपकरण मौजूद है, या एक अच्छा प्रारंभिक बिंदु उपलब्ध है?


चीजें जो मैंने पाई और मानी हैं


DW आउटपुट के लिए pandoc में फ़िल्टर जोड़ें ?! और, btw, अनुरोधित छोटे सबसेट के लिए आप डीडब्ल्यू में शुद्ध मार्कडाउन के साथ शुरू करने की कोशिश कर सकते हैं (क्या आपके डीडब्ल्यू वाक्यविन्यास नियम पढ़े?)
आलसी बेजर

@LazyBadger धन्यवाद। मैं सिर्फ johnmacfarlane.net/pandoc/scripting.html पढ़ता हूं , और जहां तक ​​मैं देख सकता हूं, यह पंडोक एएसटी को बदलने के बारे में है। मैं एएसटी को अपरिवर्तित रखना चाहता हूं, लेकिन आउटपुट प्रारूप को बदल देता हूं। या मुझे गलत समझा है?
क्लेयर मैक्रै

@LazyBadger अपना दूसरा सुझाव दें, हाँ, मुझे (मुझे विश्वास है) DW सिंटैक्स को अच्छी तरह से जानता है! हालाँकि, भले ही DW ने मार्कडाउन का समर्थन किया हो, लेकिन मैं अपने सहयोगियों के लिए, जो इसे संपादित कर सकते हैं, के लिए पाठ को पारंपरिक DW वाक्यविन्यास में बदलने की इच्छा रखते हैं।
क्लेयर मैक्रै

मैंने अभी पता लगाया है कि डॉक्यूविक समर्थन का अनुरोध करने वाला एक बहुत ही संक्षिप्त पंडोक मुद्दा है
क्लेयर म्राए

जब मैं पंडोक एकीकरण के बारे में बात करता हूं, तो मेरे मन में "अतिरिक्त लेखक जोड़ें" है, जो, AFAICS, मोइनमॉइन रीडर शो के रूप में कोर नहीं बदलता है - यह सिर्फ अतिरिक्त हास्केल स्क्रिप्ट है
आलसी बेजर

जवाबों:


12

स्टॉप-प्रेस - अगस्त 2014

पंडोक 1.13 के बाद से , पंडोक में अब मेरे डॉक्यूविक लेखन का कार्यान्वयन शामिल है - और इस स्क्रिप्ट की तुलना में कई और विशेषताओं को वहां लागू किया गया है। इसलिए यह लिपि अब बहुत अधिक निरर्थक है।


मूल रूप से कहा कि मैं रूपांतरण करने के लिए एक पायथन स्क्रिप्ट लिखना नहीं चाहता था, मैंने बस इतना ही किया।

मार्कडाउन पाठ को पार्स करने के लिए पंडोक का उपयोग करने और दस्तावेज़ के एक JSON प्रतिनिधित्व को लिखने के लिए वास्तविक समय की बचत कदम था। यह JSON फ़ाइल तब पार्स करने के लिए ज्यादातर काफी आसान थी, और DokuWiki प्रारूप में लिखी।

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

आवश्यकताओं का उपयोग करने के लिए:

  • अजगर (मैं विंडोज पर 2.7 का उपयोग कर रहा था)
  • अपने PATH में Pandoc स्थापित, और pandoc.exe

मुझे उम्मीद है कि यह किसी और को भी कुछ समय बचाता है ...

संपादन 2 : 2013-06-26: मैंने अब इस कोड को GitHub में, https://github.com/claremacrae/markdown_to_dokuwiki.py पर डाल दिया है । ध्यान दें कि वहाँ कोड अधिक स्वरूपों के लिए समर्थन जोड़ता है, और इसमें एक परीक्षण सूट भी है।

1 संपादित करें : मार्कडाउन के बैकटिक स्टाइल में कोड नमूने पार्स करने के लिए कोड जोड़ने के लिए समायोजित:

# -*- coding: latin-1 -*-

import sys
import os
import json

__doc__ = """This script will read a text file in Markdown format,
and convert it to DokuWiki format.

The basic approach is to run pandoc to convert the markdown to JSON,
and then to parse the JSON output, and convert it to dokuwiki, which
is written to standard output

Requirements:
 - pandoc is in the user's PATH
"""

# TODOs
# underlined, fixed-width
# Code quotes

list_depth = 0
list_depth_increment = 2

def process_list( list_marker, value ):
    global list_depth
    list_depth += list_depth_increment
    result = ""
    for item in value:
        result += '\n' + list_depth * unicode( ' ' ) + list_marker + process_container( item )
    list_depth -= list_depth_increment
    if list_depth == 0:
        result += '\n'
    return result

def process_container( container ):
    if isinstance( container, dict ):
        assert( len(container) == 1 )
        key = container.keys()[ 0 ]
        value = container.values()[ 0 ]
        if key == 'Para':
            return process_container( value ) + '\n\n'
        if key == 'Str':
            return value
        elif key == 'Header':
            level = value[0]
            marker = ( 7 - level ) * unicode( '=' )
            return marker + unicode(' ') + process_container( value[1] ) + unicode(' ') + marker + unicode('\n\n')
        elif key == 'Strong':
            return unicode('**') + process_container( value ) + unicode('**')
        elif key == 'Emph':
            return unicode('//') + process_container( value ) + unicode('//')
        elif key == 'Code':
            return unicode("''") + value[1] + unicode("''")
        elif key == "Link":
            url = value[1][0]
            return unicode('[[') + url + unicode('|') + process_container( value[0] ) + unicode(']]')
        elif key == "BulletList":
            return process_list( unicode( '* ' ), value)
        elif key == "OrderedList":
            return process_list( unicode( '- ' ), value[1])
        elif key == "Plain":
            return process_container( value )
        elif key == "BlockQuote":
            # There is no representation of blockquotes in DokuWiki - we'll just
            # have to spit out the unmodified text
            return '\n' + process_container( value ) + '\n'

        #elif key == 'Code':
        #    return unicode("''") + process_container( value ) + unicode("''")
        else:
            return unicode("unknown map key: ") + key + unicode( " value: " ) + str( value )

    if isinstance( container, list ):
        result = unicode("")
        for value in container:
            result += process_container( value )
        return result

    if isinstance( container, unicode ):
        if container == unicode( "Space" ):
            return unicode( " " )
        elif container == unicode( "HorizontalRule" ):
            return unicode( "----\n\n" )

    return unicode("unknown") + str( container )

def process_pandoc_jason( data ):
    assert( len(data) == 2 )
    result = unicode('')
    for values in data[1]:
        result += process_container( values )
    print result

def convert_file( filename ):
    # Use pandoc to parse the input file, and write it out as json
    tempfile = "temp_script_output.json"
    command = "pandoc --to=json \"%s\" --output=%s" % ( filename, tempfile )
    #print command
    os.system( command )

    input_file = open(tempfile, 'r' )
    input_text = input_file.readline()
    input_file.close()

    ## Parse the data
    data = json.loads( input_text )
    process_pandoc_jason( data )

def main( files ):
    for filename in files:
        convert_file( filename )

if __name__ == "__main__":
    files = sys.argv[1:]

    if len( files ) == 0:
        sys.stderr.write( "Supply one or more filenames to convert on the command line\n" )
        return_code = 1
    else:
        main( files )
        return_code = 0

    sys.exit( return_code )

@OliverSalzburg आपका स्वागत है। (बीटीडब्लू, मैंने अभी-अभी एक कॉस्मेटिक टाइपो देखा: s / jason / json / in
many

2

यह एक वैकल्पिक तरीका है जिसका मैं हाल ही में उपयोग कर रहा हूं।

इसके फायदे हैं:

  • यह मेरे अन्य उत्तर में पाइथन स्क्रिप्ट की तुलना में मार्कडाउन सिंटैक्स की एक बहुत व्यापक श्रेणी में परिवर्तित करता है
  • इसे स्थापित करने के लिए अजगर की आवश्यकता नहीं है
  • इसे स्थापित करने के लिए पैंडॉक की आवश्यकता नहीं है

विधि:

  1. MarkdownPad 2 में Markdown फ़ाइल खोलें

    MarkdownPad 2 स्क्रीनशॉट

  2. संपादन का चयन करें -> "HTML के रूप में दस्तावेज़ कॉपी करें"

  3. Html2DokuWiki चलाएं

    DokuWiki स्क्रीनशॉट के लिए HTML

  4. HTML को शीर्ष "HTML इनपुट" फलक में पेस्ट करें

  5. सभी का चयन करें, और नीचे "DokuWiki आउटपुट" फलक में सभी पाठ को कॉपी करें

1

आदर्श नहीं है, लेकिन कार्यात्मक समाधान है

मार्कडाउन -> एचटीएमएल -> डॉकूवीकी

पंडोक द्वारा किया गया पहला रूपांतरण

दूसरा - HTML-WikiConverter-DokuWiki Perl मॉड्यूल

संकेत: मौजूदा कोड की क्रियाओं को उलट देना

Dokwiki से Markdown में परिवर्तित करने के लिए सिल्वरस्ट्रिप-डॉक-रीस्ट्रक्चरिंग git-repo में कोड (PHP) होता है।


मैंने इसे आज़माया, लेकिन, पर्ल से परिचित नहीं होने के कारण, मैं काम करने के लिए मॉड्यूल प्राप्त करने के करीब नहीं आया।
क्लेयर मैक्रे
हमारी साइट का प्रयोग करके, आप स्वीकार करते हैं कि आपने हमारी Cookie Policy और निजता नीति को पढ़ और समझा लिया है।
Licensed under cc by-sa 3.0 with attribution required.