Como converter arquivos Markdown para Dokuwiki, em um PC


13

Estou procurando uma ferramenta ou script para converter arquivos Markdown para o formato Dokuwiki , que será executado em um PC.

Isso é para que eu possa usar o MarkdownPad em um PC para criar rascunhos iniciais de documentos e depois convertê-los para o formato Dokuwiki, para fazer upload para uma instalação do Dokuwiki sobre a qual não tenho controle. (Isso significa que o plug - in Markdown não serve para mim.)

Eu poderia gastar um tempo escrevendo um script Python para fazer a conversão, mas gostaria de evitar gastar tempo com isso, se já existe.

As tags Markdown que eu gostaria de ter suportado / convertidas são:

  • Níveis de título 1 - 5
  • Fonte em negrito, itálico, sublinhado e largura fixa
  • Listas numeradas e não numeradas
  • Hiperlinks
  • Regras horizontais

Existe uma ferramenta desse tipo ou existe um bom ponto de partida disponível?


Coisas que encontrei e considerei


Adicionar filtro ao pandoc para saída DW ?! E, aliás, por solicitado pequeno subconjunto você pode tentar começar com puro Markdown em DW (fez suas regras de sintaxe DW ler ?!)
preguiçoso Badger

@LazyBadger Thanks. Acabei de ler johnmacfarlane.net/pandoc/scripting.html e, tanto quanto posso ver, trata-se de alterar o Pandoc AST. Quero manter o AST inalterado, mas alterar o formato de saída. Ou eu entendi errado?
Clare Macrae

@LazyBadger Re sua segunda sugestão, sim, eu (acredito que) conheço a sintaxe DW muito bem! No entanto, mesmo que o DW apoie o Markdown, desejo converter o texto em sintaxe DW convencional, para o bem dos meus colegas que podem editá-lo.
Clare Macrae

Acabei de descobrir que há um problema Pandoc muito breve solicitando suporte ao DokuWiki.
Clare Macrae

Quando falo sobre a integração pandoc, tenho em mente "adicionar escritor adicional", que, AFAICS, não muda núcleo como leitor MoinMoin mostra - é roteiro apenas adicional Haskell
preguiçoso Badger

Respostas:


11

Stop-Press - agosto de 2014

Desde o Pandoc 1.13 , o Pandoc agora contém minha implementação da escrita do DokuWiki - e muitos outros recursos são implementados lá do que neste script. Portanto, esse script agora é praticamente redundante.


Tendo dito originalmente que não queria escrever um script Python para fazer a conversão, acabei fazendo exatamente isso.

A etapa de economia de tempo real foi usar o Pandoc para analisar o texto do Markdown e gravar uma representação JSON do documento. Esse arquivo JSON era bastante fácil de analisar e gravar no formato DokuWiki.

Abaixo está o script, que implementa os bits do Markdown e do DokuWiki com os quais eu me importava - e mais alguns. (Eu não carreguei o testuite correspondente que escrevi)

Requisitos para usá-lo:

  • Python (eu estava usando 2.7 no Windows)
  • Pandoc insatlled e pandoc.exe em seu PATH (ou edite o script para colocar o caminho completo para Pandoc)

Espero que isso poupe a alguém também ...

Edit 2 : 26/06/2013: Agora coloquei esse código no github, em https://github.com/claremacrae/markdown_to_dokuwiki.py . Observe que o código lá adiciona suporte para mais formatos e também contém testsuite.

Editar 1 : ajustado para adicionar código para analisar amostras de código no estilo backtick do Markdown:

# -*- 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 De nada. (BTW, eu só notei um erro de digitação cosmético: s / jason / json / em vários lugares ... :-))
Clare Macrae

2

Essa é uma abordagem alternativa que venho usando recentemente.

Suas vantagens são:

  • ele converte uma gama muito maior de sintaxe MarkDown do que o script Python na minha outra resposta
  • não requer a instalação de python
  • não requer a instalação do pandoc

A receita:

  1. Abra o arquivo Markdown no MarkdownPad 2

    MarkdownPad 2 Captura de tela

  2. Selecione Editar -> "Copiar documento como HTML"

  3. Execute o Html2DokuWiki

    Captura de tela de HTML para DokuWiki

  4. Cole o HTML no painel superior "Entrada HTML"

  5. Selecione Tudo e Copie todo o texto no painel inferior "Saída do DokuWiki"

Ao utilizar nosso site, você reconhece que leu e compreendeu nossa Política de Cookies e nossa Política de Privacidade.
Licensed under cc by-sa 3.0 with attribution required.