search

tomeichlersmith / hdtree

columnar, ragged data with a dynamic, runtime-defined schema
https://tomeichlersmith.github.io/hdtree/
2 stars 1 forks source link

build documentation website in actions #9

Closed tomeichlersmith closed 1 year ago

tomeichlersmith commented 1 year ago

I started trying to do this but the first pass at building attempts are failing - using the same workflow I use on my machine displays a "Permission Denied" issue when running on actions and I'm not sure why.

jekyll 3.9.2 | Error:  Permission denied @ dir_s_mkdir - /srv/jekyll/_site

I'd really like to figure out why because my local build has the custom sidebar that I like more than the more simple sidebar that is built by the default GitHub build-deploy workflow that is "unable to resolve my Gemfile dependencies".

tomeichlersmith commented 1 year ago

I think I want to switch to mdbook rather than jekyll - I like the theme out of the box and it is easier to use for someone like me without much web-design experience.

I just need to check if it can import files into the markdown like jekyll. If it can't I'll need to write a pre-processor to copy in the examples for me.

tomeichlersmith commented 1 year ago

mdbook can include files and so I'm switching to it

This will eventually lead to me deleting the gh-pages branch since it is no longer necessary; however, I would like to keep it around for the time being in case I forgot some docs over there in the move.