search

neo4j-documentation / asciidoctor-jupyter

A Jupyter converter for Asciidoctor.js. Write your Notebook in AsciiDoc!
16 stars 1 forks source link

Integrate in Antora? #2

Closed prudhomm closed 2 years ago

prudhomm commented 2 years ago

Dear @Mogztter thanks for the very nice tool

since it is based on asciidoctor.js, could this become an extension of antora to generate jupyter like notebooks in antora ?

ggrossetie commented 2 years ago

This converter won't become an Antora extension but it's definitely possible to create an Antora extension that uses this converter. That's basically what we are doing in https://neo4j.com/graphgists/first-steps-with-cypher/

image

You can click on "Download as Jupyter Notebook" to download a Jupyter notebook that was generated by Antora.

prudhomm commented 2 years ago

Very nice

prudhomm commented 2 years ago

@Mogztter I managed to use it. However, asciidoctor does not know antora and its file layout, hence include directive or image directive fail. I would guess that the jupyter hook would need to have a pure asciidoc file without antora's specific no ? it would need somehow to be preprocessed before entering your tool, no ?

ggrossetie commented 2 years ago

That's a good question... but I don't know what is the best strategy. You should ask at https://chat.antora.org, Dan will probably have an opinion on this.

I'm closing this issue since it won't happen in this repository. Let's continue the discussion on https://chat.antora.org.

prudhomm commented 1 year ago

@Mogztter I managed to get a working version, now we need to improve the converter to support more advanced asciidoc. it is a combination of asciidoc-jupyter, antora-collector and some handlebars helpers for proper href computations