kramdown é uma biblioteca Ruby gratuito que pode ser usado para a análise de um super conjunto de Markdown & nbsp;. Ele é completamente escrito em Ruby, suporta Markdown standard (com algumas pequenas modificações) e várias extensões que foram feitos populares pelo PHP Markdown pacote extra e Maruku.
É provavelmente o mais rápido conversor puro-Rubi Markdown disponível (novembro de 2009), sendo 5x mais rápido do que Maruku e cerca de 10x mais rápido que bluefeather.
A sintaxe kramdown é baseado em Markdown, um muito fácil de escrever, fácil de ler marcação para escrever documentos HTML em texto simples. Desde a sintaxe básica Markdown tem algumas deficiências, as implementações (especialmente o pacote extra PHP Markdown) tentaram superar esse deficiências com sintaxe adicional. kramdown suporta todas as funcionalidades da sintaxe Markdown originais (embora com algumas pequenas correções), bem como novas funcionalidades implementadas no pacote extra PHP Markdown e Maruku.
Uso:
O pacote kramdown oferece duas maneiras para usá-lo:
* A partir de uma biblioteca
& Nbsp; kramdown utiliza basicamente a mesma API como RedCloth, BlueCloth e Maruku:
& Nbsp; require 'kramdown'
& Nbsp; Kramdown :: Document.new (texto) .to_html
& Nbsp; O segundo parâmetro para a nova chamada é um hash de opções para (des) ativar certas características. Para mais informações, dê uma olhada na documentação da API.
* Como uma aplicação
& Nbsp; Junto com a biblioteca de arquivos de um binário chamado kramdown é enviado, que pode ser usado para converter texto em sintaxe kramdown para HTML. Ele quer lê os arquivos especificados como os argumentos de linha de comando ou da entrada padrão. Por exemplo:
& Nbsp; kramdown caminho / para / kramdown / doc / syntax.page
O que é novo nesta versão:
- 2 minor alterações:
- Adicionado um analisador para Github Flavored Markdown (resolve GH # 68 por Arne Brasseur que desde a implementação inicial)
- atributos HTML são agora de saída para linhas horizontais
- 5 de bugs:
- A codificação correta sobre a seqüência de resultado está agora definido, mesmo quando a opção de modelo é usado
- Fixo GH # 72, GH # 74: Todos os modos de configurar um ID cabeçalho agora seguem o mesmo esquema que é compatível com IDs HTML (exceto que os pontos não são permitidos) (relatados e correção inicial por Matti Schneider)
- Fixo GH # 73: O modelo HTML padrão agora tem um DOCTYPE e define a codificação corretamente (remendo inicial por Simon Lydell)
- Fixo GH # 67: URLs de elementos de ligação estão agora escapou no conversor de LaTeX para evitar problemas (remendo por Henning Perl)
- Fixo GH # 70: Qualquer versão da biblioteca stringex agora é suportado (relatada por Simon Lydell)
Correções
O que é novo na versão 1.1.0:
- 2 pequenas alterações:
- Nota de rodapé podem agora ser repetido (resolve GH # 62 e # 63 GH por Theodore Pak que forneceu o patch inicial)
- O pacote sigla LaTeX agora é usado para abreviaturas (resolve GH # 55 por Tim Besard que forneceu o patch inicial)
- 3 de bugs:
- Fixo GH # 60: Os números são agora reconhecidos, além de caracteres da palavra ao converter sublinhados (remendo por Trevor Wennblom)
- Fixo GH # 66: elementos HTML, e estão agora convertido corretamente pelo conversor LaTeX (remendo por Henning Perl)
- Fixo GH # 57: Melhor manipulação citação inteligente quando sublinhados são diretamente após ou antes de aspas (relatada por Bill Tozier)
Marcadores
Correções
O que é novo na versão 1.0.2:
- A página de testes foi atualizado para incluir tempos relativos no índice de referência para que seja possível avaliar melhor o desempenho dos kramdown (solicitado pelo pós-moderno).
- O kramdown Wiki agora contém uma lista de bibliotecas que se estendem kramdown (idéia por pós-moderna).
O que é novo na versão 1.0.0:
- 4 pequenas alterações:
- Novos transliterated_header_ids opção para transliterando texto do cabeçalho em ASCII antes de gerar um ID de cabeçalho que é útil para a linguagem como Vietnamita (GH fixo # 35, solicitado pelo Kỳ Anh)
- A entidade aspa & quot; agora é convertido em seu equivalente personagem quando entity_output = as_char.
- A advertência é agora de saída para IALs / ALDs que não contém um atributo defintion.
- saída nota HTML é alterado para usar a classe em vez de rel para alcançar (X) HTML4 / 5 compatibilidade
- 3 de bugs:
- Fixo GH # 38: Codificação problema em 1.9 / 2.0, devido às codificações incompatíveis - a seqüência de origem agora é convertido para UTF-8 antes da análise e convertido novamente após a conversão (relatada por Simon Lydell)
- Fixo RF # 29647: abreviações com não-palavra primeiro personagem no início do chumbo texto a exceção (relatada por Stephan Dale)
- Fixo RF # 29704: ID especificado nos cabeçalhos estilo atx nem sempre foram detectados corretamente (relatada por Kyle Barbour)
Correções
O que é novo na versão 0.14.2:
- 1 pequena alteração:
- Novos link_defs opção para as definições da ligação pré-definem
- 1 correção de bug:
- erros gerados fixos nos cabeçalhos atx sem texto
O que é novo na versão 0.14.1:
- Somente elementos de HTML que não deve conter um corpo ( like) são emitidos sob esta forma, todos os outros elementos agora usar uma tag de fechamento explícito (resolve entre outras questões com as coisas)
- A especificação de um bloco IAL antes de uma lista de definição agora funciona corretamente
- Corrigido o erro GH # 30: corpo vazio para uma definição em uma vantagem de lista de definição de uma exceção (relatado por Mark Johnson)
O que é novo na versão 0.14.0:
- 2 grandes mudanças:
- linguagem de código é agora especificado via .language-CODELANG em vez de lang = "CODELANG '
- Implementado suporte para configuração de idioma no código cercado linha bloco de partida (remendo inicial por Bran)
- 1 pequena alteração:
- cabeçalhos com um ID pode ser impedido de mostrar no TOC, atribuindo a classe .no_toc a eles (remendo por Tim Bates)
- 1 correção de bug:
- numérico em vez de entidades HTML simbólicos são agora o fallback default (remendo por Gioele Barabucci)
O que é novo na versão 0.13.5:
- 2 pequenas alterações:
- atributos HTML sem valores são agora suportadas (bug fixes RF # 29490 relatado por Nat Welch)
- atributos HTML nomes agora são sempre convertidos para minúsculas para a consistência
- 5 de bugs:
- Document Fixo # method_missing para aceitar nome da classe snake_cased (remendo por tomykaira)
- Corrigido o problema com falta constante REXML em mais velha versão do Ruby 1.8.6 (relatada por Dave Everitt)
- Corrigido o erro RF # 29520: inline Valid declaração matemática não aciona bloco matemático mais (relatada por Gioele Barabucci)
- Corrigido o erro RF # 29521: saída matemática HTML agora é sempre compatível com XHTML (relatada por Gioele Barabucci)
- id atributos vazios são agora tratadas melhor pelos HTML e kramdown conversores (relatados por Jorg Sommer)
- 1 documentação:
- Fixo declaração opções inválidas no exemplo na página de referência rápida (relatada por Jorg Sommer)
Correções
Fix
O que é novo na versão 0.13.4:
- Adicionado um conversor que extrai o TOC de um documento (solicitado por Brendan Hay). Note-se que isso só é útil se você usar kramdown como uma biblioteca!
- Corrigido um erro: Deve ser --output e não --ouput (patch, pós-moderna)
- conversor de HTML fixa Para corretamente saída tags span vazias (Patch por John Croisant)
- Corrigido o erro RF # 29350: Análise de tags HTML com caso incompatíveis agora trabalha
- Corrigido o erro RF # 29426: Conteúdo de marcas de estilo é tratado como texto simples agora
- conversor de HTML agora usa rel em vez de rev para ser compatível HTML5 (remendo por Joe Fiorini)
- Fixa do Ruby 1.9.3 avisos relacionados
- parser HTML fixo para trabalhar em torno de uma mudança implementação de Array # delete_if em Ruby 1.9.3
Requisitos :
- Rubi
Comentários não encontrado