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

Deploy failure in GH Action #24

Closed mfernandes61 closed 7 months ago

mfernandes61 commented 1 year ago

@GeertvanGeest - could you help please?

Repo is ELIXIR-TrP-LiterateProgrammingR-CodeRep

Editted chapter01.md and in GitHub actions I get the following output from the deploy part of GH actions (Note I have not altered references.md) INFO - Building documentation to directory: /home/runner/work/ELIXIR-TrP-LiterateProgrammingR-CodeRep/ELIXIR-TrP-LiterateProgrammingR-CodeRep/site 154 INFO - The following pages exist in the docs directory, but are not included in the "nav" configuration: 155

GeertvanGeest commented 1 year ago

Hi Mark!

The error says chapters/references.md is empty.. The site renderer doesn't like that. To fix it, add some markdown to the file (find it at docs/chapters/references.md) and commit+push again.

I suppose you followed all instructions, so this would be a 'bug' of the template that we should address.

@ac812: you didn't run into this when testing?

mfernandes61 commented 1 year ago

Hi I added a line of markdown at top of file '## references go here' and did pull & merge and it worked!

Note that previously I have done this on this and other repos (containers one) and they built fine with the empty references.md so this appears to be new 'bug'

Thanks for quick response, Mark

GeertvanGeest commented 1 year ago

Awesome, thanks for the feedback. I think the new version of mkdocs checks for actual markdown and doesn't allow 'any text' anymore. Keeping this open until fixed.

GeertvanGeest commented 7 months ago

Closing because of inactivity.