Auto-update pkgdown build and website deployment

[edwardsmarc]

Configuring a github action to build the pkgdown website and deploy from a dedicated gh-pages branch when the code is updated.

This involves the calling the following from the RStudio project:

use_github_pages()
use_github_action("pkgdown")

Detailed here: https://usethis.r-lib.org/reference/use_pkgdown.html

• We don't call use_pkgdown_github_pages() because we're already using pkgdown so the call to use_pkgdown() is not needed.

[edwardsmarc]

Had to update rlang to 1.1.0 and usethis to 2.2.2 to get this to work.

[edwardsmarc]

Getting an error in the github pkgdown Action.

rcbc package install fails while the Action is loading package dependencies for the pkgdown build.

I'm wondering if I need to install cbc on the runner, similar to what the Ubuntu test Action does:

- name: Install system dependencies
        run: |
          sudo apt-get -y install libcurl4-openssl-dev coinor-libsymphony-dev coinor-libcbc-dev coinor-libclp-dev libudunits2-dev libgdal-dev libgeos-dev libproj-dev libharfbuzz-dev libfribidi-dev

[edwardsmarc]

That seemed to work.

Next error is Error: 'build_site_github_pages' is not an exported object from 'namespace:pkgdown'

This is because our renv.lock uses an older version of pkgdown. I tried updating pkgdown in the renv.lock but that triggered about 20 other dependency updates which led to build_site() failing locally for reasons I couldn't decipher.

I'll now try just installing the newest pkgdown in the github runner to get access to the function without having to edit the wtw package environment.

[edwardsmarc]

Error now when trying to install the new pkgdown after a successful renv::restore.

Error: Error: GitHub record for package 'downlit' has no recorded 'RemoteSha' / 'RemoteRef'

Possibly a pkgdown dependency issue. This might only be solved by updating packages in renv.lock.

[edwardsmarc]

Putting this on hold until we develop a systematic way to periodically update the renv package environment as discussed in #303.

I expect this issue will resolve itself once we have the current version of pkgdown as a dependency in wheretowork.