search

NNPDF / pineappl

PineAPPL is not an extension of APPLgrid
https://nnpdf.github.io/pineappl/
GNU General Public License v3.0
13 stars 3 forks source link

Fix badge links on the website #170

Open cschwan opened 2 years ago

cschwan commented 2 years ago

Commits 491cf2613cb48d3adfcc4831fea81260d351679d, 571c46367ffeaae055be5619d8ffff7d80e83868 and a36ce334a4bb62b3bc7b77a5c4e318f6d8cd8913 tried to make the link point to installation docs to markdown file if viewed on github and to the rendered markdown file if viewed on the website. Unfortunately, the latter doesn't work due to https://github.com/benbalter/jekyll-relative-links/issues/74.

alecandido commented 2 years ago

I wonder at this point if it's time to drop Ruby and just make a workflow with something else.

Jekyll is nice in GitHub Pages because it's there by default, and you have to do little to nothing to make it working. But it's not the most common choice for static site generators (SSG), and it's harder to find Ruby developers than JS or Python ones (so smaller community, and fewer ready-made solutions).

cschwan commented 2 years ago

For me this bug isn't really a problem. What would you suggest to use instead of Jekyll?

alecandido commented 2 years ago

The most popular and reliable I believe to be Next.js, another sensible choice in JS is Docusaurus. And just pick a reasonable ready-made theme (with the advantage that we can customize it, if needed).

But we can even avoid JS: being a Rust project in the first place why not mdBook directly? The PineAPPL book :) (Also Sphinx is suitable, since it's already there for Python, but I'd keep it for Python projects, rather than generic websites)