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

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

Open
ramalho opened this issue Mar 14, 2023 · 1 comment
Open

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

ramalho opened this issue Mar 14, 2023 · 1 comment
Labels
melhoria melhoria na tipografia, layout, usabilidade do HTML do livro

Comments

@ramalho
Copy link
Contributor

ramalho commented Mar 14, 2023

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 ramalho added the melhoria melhoria na tipografia, layout, usabilidade do HTML do livro label Mar 14, 2023
@jairhenrique
Copy link
Contributor

jairhenrique commented Mar 16, 2023

@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!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
melhoria melhoria na tipografia, layout, usabilidade do HTML do livro
Projects
None yet
Development

No branches or pull requests

2 participants