It turns out we cannot enable GitHub pages for private repos through GitHub Actions automatically due to security constraints. You will have to enable GitHub pages yourself. I have edited the Actions workflow to provide more helpful error messages, where possible indicating that you have to enable this yourself. If you try to make a change in your docs you should see the new error messages come up.
I’m reviewing my side now, as I thought I had created the nbdev-cards repository as public. I was able to successfully complete the getting started tutorial with full completion through deployment to my github pages site. So is it as simple as ensuring that the working repository for the project be created as public?
I found my problem. I had inadvertently started working on the “main” branch on my github repository. I branched main to a new “master” branch and re-initialized my local repository to that branch and everything worked correctly. This has always been a bit of a confusion for me. It seems like most of the CI/CD tools like to work off of “master” branch but github defaults to “main” when a new repo is created.
@rbagdazian could you try again with the main branch? This shouldn’t cause an error and I would love to try to troubleshoot this as for some reason I cannot reproduce this (but I can see the error on your repo). I’ve made some tweaks to show an more helpful error message that should help us.
@hamelsmu I made sure I had the latest version of nbdev installed in my environment, switched to main branch, made a change to the code base. Then executed pip install -e ., and pushed the updated code back to git, and this time it all worked! I’m not exactly sure what I changed but it seems to be working now. Thanks !
If I clone your repo at the gh-pages branch and open index.html, it looks like the expected Quarto documentation. Could it be that GitHub Pages is not correctly configured to deploy from the gh-pages branch? See the docs here: nbdev - End-to-end walkthrough.
By the way, you seem to have a very deeply nested directory starting at _proc. I’m not sure how that happened, but I think it’s safe to delete. You probably also want to add _proc to your .gitignore file. We’ll update nbdev-template to include that automatically moving forward.
@seem Thanks for your help. I did have the wrong branch selected in the GitHub pages configuration. I got rid of the wierd _proc folder and added it to .gitignore and everything is working as expected!