pythonfluente2e icon indicating copy to clipboard operation
pythonfluente2e copied to clipboard

Oferecer versão com um capítulo por arquivo HTML

Open ramalho opened this issue 2 years ago • 1 comments

O asciidoctor é especializado em gerar livros, então por padrão ele lê varios arquivos .adoc e combina todos em um único arquivo .html.

Seria bom separar em vários .html, um por capítulo.

Desafios:

  • manter as referências cruzadas entre diferentes capítulos
  • gerar o sumário (TOC)

Não encontrei forma de fazer isso no asciidoctor. Se souber como, conta aí.

Uma alternativa é usar fazer o parsing do HTML único e gerar os HTML por capítulo alterando os HREF das referências cruzadas e das entradas na TOC. O HTML gerado pelo asciidoctor é muito bem estruturado.

ramalho avatar Mar 14 '23 23:03 ramalho

@ramalho existe um plugin chamado asciidoctor-chunker feito em node.

Eu fiz um teste local e aparentemente funciona bem.

npm install -g asciidoctor asciidoctor-chunker
asciidoctor livro.adoc && asciidoctor-chunker livro.html -o output && open output/index.html

Quando puder, dá uma olhada no resultado!

jairhenrique avatar Mar 16 '23 22:03 jairhenrique