The project contains the sources of The Internals of Delta Lake online book.
The project uses the following "toolz":
-
Delta Lake as it comes from my gurus from the Spark SQL / Structured Streaming crew at Databricks (Michael, TD, Burak, zsxwing, and many others)
-
Publishing using GitHub Pages
I'm on macOS Catalina and use Docker to run the Antora image.
$ docker run -u $UID --privileged -v `pwd`:/antora --rm -t antora/antora local-antora-playbook.yml
// alternatively and recommended (as it keeps the container up and running)
// Automating the publishing process is in the works
$ docker run --entrypoint ash --privileged -v `pwd`:/antora --rm -it antora/antora
// Inside the container
/antora # antora version
2.2.0
/antora # antora local-antora-playbook.yml
// On your local computer (outside the container)
$ open .out/local/index.html
I use Atom Editor for editing the files.
Read Giving up on Read the Docs, reStructuredText and Sphinx.