Implement GHA for building docs

[jGaboardi]

This PR resolves

• add gha workflow for publishing docs #179
• reviews and cleans up notebooks

[martinfleis]

That stuff from _static is removed intentionally?

[jGaboardi]

That stuff from _static is removed intentionally?

Not all of it. And what's up here vs. local doesn't seem to match. Let me look back at this. Not sure what went wrong...

[jGaboardi]

@weikang9009 @martinfleis

I think I have resolved to file conflicts and can confirm the docs build locally from within docs/. However:

1. When running make html 1 warning is being thrown:

   /Users/user/giddy/docs/RankBasedMethods.nblink:37: WARNING: undefined label: '/rankbasedmethods.nblink#inter--and-intra-regional-decomposition-of-kendall-tau'
   

2. In the Tutorial notebooks the hyperlinks in the blue "This page was generated from" banner is being generated incorrectly, for example: https://github.com/pysal/giddy//Users/user/giddy/docs/MarkovBasedMethods.ipynb

---

Seems like both issues may be cropping up from nblink? Thoughts?

[martinfleis]

I'm not familiar with nblink

[jGaboardi]

I'm not familiar with nblink

Same...

@weikang9009 Do you mind if I refactor without using nblink? In other project we sync the notebooks directly in Makefile when running make html, e.g. here in mapclassify.

[weikang9009]

@jGaboardi sounds good to me !

[jGaboardi]

@weikang9009 this is ready for review.

• all notebooks reviewed, cleaned, and rerun for Python 3.11
• ensured local docs build runs without errors of doc warnings
• swaps out nblink for rsync notebook syncing

[jGaboardi]

@weikang9009 gentle ping for review on this.

[weikang9009]

@jGaboardi Thank you so much! I have changed the GitHub Page branch from main to the gh-pages branch. The doc website generated from the new github action looks great!