Open smeyfroi opened 2 years ago
I'm trying this and my results:
./build_docker.sh
works and builds an image
./nikola_auto_build.sh
seems to works, last line is INFO: auto: Serving on http://127.0.0.1:8000/ ...
however nothing is listening on :8000
./nikola_serve.sh
says INFO: serve: Serving on http://0.0.0.0:8000/ ...
which does work, and serves the freshly re-built 0.11.2 ofSite (I modified a source .md and the change shows up).
so on the docker side it seems to work!
however, the "documentation" tab is empty (which is the area I'd like to look into)... and also, side-question but: something must be auto-integrating the doxygen from the source? I have a limited understanding of the components involved here so it's not evident where to start looking...!
Oh that's quite promising @artificiel ! I did the smallest thing I could do, without understanding the nicola
build system.
It might be interesting to have someone with a little more knowledge chime in at this point? The problem of the broken ofSite dev environment seems like it could possibly be fixed inside a stable docker container...
Thanks @smeyfroi ! I'm happy to merge this but might be good to make sure the instructions for running it all are clear. And do @artificiel 's notes need to be added?
Thanks again!
Fab, leave it with me a while (life drawing tonight, so maybe weekend)... will clean up and make sure @artificiel comments properly taken into account. I think he had some questions related to the doc build itself: are you able to help with that @ofTheo ?
Done:
bin/build_docker.sh
bin/rm_docker.sh
bin/sh_docker.sh
for debug)bin/nikola_build.sh
(see below)bin/nikola_serve.sh
bin/nikola_auto.sh
(see below)To do:
documentation
and learning
, which are implemented as nikola plugins that are broken on this newer version of nikola. I need to dig in to fix this.auto
fails for a nikola bug apparently recently fixed https://github.com/getnikola/nikola/issues/3761. Need to update and try this again.Questions:
bin
, but I haven't looked at how the "official" build is scripted. I'm assuming this work on the local dev environment is entirely orthogonal to the website build.bin
for local dev scripts).More to come on this PR.
The build instructions in current README fail due to dependency issues on up-to-date MacOS, Ubuntu and Alpine Linux.
This is a WIP attempt to provide an easy-to-install (and cross-platform) docker environment for development work.
To get the dependencies to work, I had to upgrade nikola (which dragged some plugins along with it).
I also had to tweak the call to
markdown
in the customdocumentation
plugin;markdown
has changed one of its method signatures in the newer version I ended up at here. Which means this PR is not backwards-compat with legacy development environments.Dependencies are unpinned at the moment, until it's proven to be working correctly.
At first glance it seems to work, but before taking it any further I want feedback in case this is a wrong direction.