search

elixir-europe-training / ELIXIR-TrP-LessonTemplate-MkDocs

Template for ELIXIR Lessons
https://elixir-europe-training.github.io/ELIXIR-TrP-LessonTemplate-MkDocs/
Other
3 stars 4 forks source link

render page fails with latest version of mkdocs mkdocs_material-9.5.3 #28

Closed abotzki closed 8 months ago

abotzki commented 10 months ago

@GeertvanGeest When creating a new repo based on this template, a new version 9.5.3 of mkdoc material framework is installed.

Unfortunately, the current mkdocs.yml configuration triggers an error with the bibtex plugin. https://github.com/elixir-europe-training/ELIXIR-TrP-FAIR-Material-By-Design/actions/runs/7358376042/job/20031539341

I could work around it temporarily by commenting 2 lines in the mkdocs.yml file - see e927b07

As far as I saw in the older version 9.4.14, there was a warning that an API call will be deprecated: https://github.com/elixir-europe-training/ELIXIR-TrP-TeSS/actions/runs/7117131929/job/19377166113 - see line 226ff In versions before (so 9.4.9 or so from other successful rendering tasks of other repos, I did not see this info).

abotzki commented 10 months ago

I just found this thread: https://bitbucket.org/pybtex-devs/pybtex/issues/169/replace-pkg_resources-with the suggested solution is to install setuptools - I'll try this.

abotzki commented 10 months ago

Seems to be fixed: see https://github.com/elixir-europe-training/ELIXIR-TrP-FAIR-Material-By-Design/actions/runs/7359230979

GeertvanGeest commented 10 months ago

I tried to integrate the .github folder into the template sync, but it requires setting up a PAT, and I think that is a bit too much to ask for most users for now. Therefore, you can take over https://github.com/elixir-europe-training/ELIXIR-TrP-LessonTemplate-MkDocs/blob/main/.github/workflows/render_page.yml (I also updated the action versions). I'll send PRs in the coming days to other repositories.

abotzki commented 10 months ago

Hi, @GeertvanGeest

thanks a lot.

I've already copied the new version of render_page.yml for three repos: https://github.com/elixir-europe-training/ELIXIR-TrP-ContainersPython-CodeRep https://github.com/elixir-europe-training/ELIXIR-TrP-TeSS https://github.com/elixir-europe-training/ELIXIR-TrP-FAIR-Material-By-Design

GeertvanGeest commented 10 months ago

Thanks Alex. To prevent similar issues in the future, I amended the page build workflow to use a requirements.txt file. In that way the dependencies are part of the template sync. I've sent an issue to all of the repositories that use the template. It describes the required steps.