Change CSS/theme to wider view or ReadTheDocs style about ro-crate

[alaninmcr]

At the moment, it makes poor use of "real estate". I'd recommend starting with the simpler Bootstrap and then add in any necessary links.

[marcolarosa]

+1

[stain]

@ljgarcia suggested using a ReadTheDocs style theme, see for instance https://isa-specs.readthedocs.io/en/latest/isajson.html

That would look very nice! And we could do a similar page split of the main sections, e.g. Contextual Entities, each of the appendices, etc.

I am not sure how we can activate that in GitHub pages as a theme, at least I hope we don't need to rewrite the Markdown to RST! Do @ljgarcia have any suggestions?

I also think if we change the markdown theme it would change the look on the old https://researchobject.github.io/ro-crate/1.0/ - however if this breaks we could save/archive 1.0 and older as the existing HTML rather than MarkDown.

[ljgarcia]

You can include a remote theme. In the config.yml you need to add

remote_theme: pmarsceill/just-the-docs #rather than #theme: jekyll-theme-minimal

Other configurations possible for just-the-docs

logo:  #I put it on the root, not sure it can be inside a folder
search_enabled: true/false 
aux_links: #the ones that go on the top
footer_content: 

All the "docs" I wanted listed on the left, I added them to a folder named docs. I think by default they will appear on alphabetical order. You can also add a header to the ./docs/*.md

---
layout: default
title: Title
nav_order: 2
---

And yes, the annoying bit is that if you want a new page on position 2, you will have to update the 3, 4, and so (if you want to keep all tidy up, if not, you will have two pages in position 2 and they will be displayed following alphabetical order, the rest will follow the specified positions)