Incluir opção para usar o formato de citação do Pandoc Markdown

[rscaputo]

(A partir de sugestão dada no canal do Limarka no gitter).

Eduardo, no último mês fiz uma extensa pesquisa para ferramentas que possam substituir o Word para escrever minha dissertação de mestrado e o Limarka foi uma das mais promissoras que encontrei... A automatização da formatação da abnt usando a simplicidade do markdown com templates de latex acertou na mosca.

Após a formatação do padrão, acho que o segundo ponto que pode ser facilitado é o uso das citações a partir do arquivo .bib durante a escrita... Nesse ponto alguns editores de texto como o sublime, o brackets e o atom apresentam alguns plugins que tem a intenção de cumprir esse papel para documentos acadêmicos.

Acontece que a maioria desses plugins acadêmicos para editores se utilizam da sintaxe do Pandoc Markdown para as citações [@citekey], o que não é o caso do Limarka (apesar de fazer uso do Pandoc como seu interpretador para markdown, se é que entendi direito)... O que acaba tornando o limarka incompatível com algumas dessas ferramentas de automação da escrita...

Nesse sentido, destaco aqui o plugin autocomplete-bibtex para o atom. Esse plugin pretende mostrar uma lista suspensa abaixo do cursor com base no arquivo .bib após o usuário inserir o código de citação, facilitando a consulta à bibliografia no momento mesmo da escrita. Eu tentei usar o formato de citção do latex na configuração do plugin, mas sem sucesso e o mesmo ocorreu com outras ferramentas do tipo. A única que consegui que funcionasse bem até agora foi Citebibtex para o Sublime, mas só porque essa ferramenta mostra a lista ao pressionar o F10 ao invés de usar o autocomplete.

Resumindo, no fim das contas a falta dessas ferramentas não atrapalha e nem impede o uso do Limarka, mas são recursos extras úteis que podem ser incorporados facilmente no fluxo de trabalho se a compatibilidade total com o Pandoc Markdown for adotada, por isso que penso que uma opção de configuração que permita escolher entre um formato ou outro de citação pode tornar o Limarka mais aberto a diferentes soluções de trabalho e portanto mais completo...

Obrigado!

[edusantana]

@rscaputo vamos aos problemas e as soluções

Latex

Eu acho que nossa solução deve está atrelada ao Latex, não vejo escapatória dele a curto prazo.

Latex/abntex2cite

Para as referências, temo como solução adotada no limarka o abntex2cite - ver documentação do abntex2cite

O latex/abntex possui as seguintes macros/comandos:

\cite
\citeonline
\citeyear
\citeauthor
\citeauthoronline

Para mim, a solução seria substituir algum código/sintaxe de markdown para códigos abntex/latex.

pandoc-citeproc

Qual a sintaxe de Markdown padrão para referências? Eu imagino que seja a do pandoc-citeproc, ver a Documentação.

Exemplos:

Blah blah [see @doe99, pp. 33-35; also @smith04, chap. 1].
Blah blah [@doe99, pp. 33-35, 38-39 and *passim*].
Blah blah [@smith04; @doe99].
Smith says blah [-@smith04].
@smith04 says blah.
@smith04 [p. 33] says blah.

[edusantana]

Para mim, vejo as seguintes relações:

\cite <-> [@key] e/ou (@key)
\citeonline <-> @key
\citeyear <-> ?
\citeauthor <-> ?
\citeauthoronline <-> ?

Também temos que pensar em múltiplas referências.