Eu tenho uma estrutura de pastas como a seguinte:
chapters/
01-chapter.md
02-chapter.md
03-chapter.md
format.sh
parse.sh
parse.sh
pandoc -t html5+smart -so dist/book.html --html-q-tags chapters/*.md
format.sh
for f in chapters/*.md;
do
pandoc "$f" -o "$f" -t \
markdown+smart+footnotes-escaped_line_breaks+example_lists \
--columns=80;
done
Minha ideia era basicamente usar o Pandoc não só como conversor, mas também como formatador - isso funcionou muito bem até que comecei a usar notas de rodapé:
Quando executo format.sh , todos os nomes de referência que uso para minhas notas de rodapé são substituídos por um número - o que seria bom, mas o problema é que, se eu executar parse.sh , recebo a seguinte mensagem:
[WARNING] Duplicate note reference '1' at line 360 column 1
O problema é 01-chapter.md
e 02-chapter.md
ambos têm uma nota de rodapé [^1]
. Basicamente, gostaria que o Pandoc lidasse com as notas de rodapé de cada arquivo separadamente e não permitisse referência cruzada em meus arquivos de remarcação, mas não consigo ver nenhuma maneira de fazer isso.
Alguém tem alguma ideia?
Não precisa de lua
Acabei de tropeçar na
--file-scope
opção. Adicione issoparse.sh
e você terá problemas ...O Pandoc não foi projetado para funcionar como um formatador, mas funciona razoavelmente bem na maioria das vezes.
Não há como fazer com que o pandoc preserve as notas de rodapé originais, então você terá que encontrar um método diferente. O desafio é fazer com que o pandoc leia os arquivos sequencialmente como documentos individuais e, em seguida, combine os documentos dentro do pandoc no documento final. Apenas passar todos os arquivos de entrada (via
*.md
) faz com que o pandoc concatene esses arquivos em um único documento antes de analisar o markdown.Minha sugestão seria usar um arquivo "index" (ou mestre). O Pandoc Markdown não possui sintaxe integrada para a inclusão de arquivos filhos, mas podemos criar nossa própria sintaxe com um filtro Pandoc Lua . Por exemplo, defina um arquivo que unirá todos os seus capítulos, onde os arquivos são listados um por linha em um bloco de código:
Coloque o seguinte código em um arquivo
include.lua
(retirado deste gist )Em seguida, chame pandoc com o filtro Lua e o arquivo master/index como entrada:
Isso tem a desvantagem de que você terá que editar
index.md
sempre que adicionar um novo arquivo Markdown; além disso, apenas os metadados definidos no arquivo de índice farão parte da saída (embora essas duas limitações possam ser evitadas com um pouco de codificação). Fora isso, deve fazer exatamente o que você está procurando.