Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

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

Open
rscaputo opened this issue Jun 29, 2017 · 2 comments
Open

Comments

@rscaputo
Copy link

rscaputo commented Jun 29, 2017

(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
Copy link
Collaborator

edusantana commented Jun 29, 2017

@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
Copy link
Collaborator

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants