tlienart / FranklinTemplates.jl

Simple website templates for Franklin.jl
https://tlienart.github.io/FranklinTemplates.jl/
MIT License
77 stars 24 forks source link

Documenter.jl theme #165

Open KronosTheLate opened 1 year ago

KronosTheLate commented 1 year ago

I think that Documenter.jl looks great. I really like the icons on the top right (github, page theme, info). I also really like the sliding menu on mobile, and static menu on PC. I think recreating/coping that layout would and adding it as a template here would be nice.

The main reason now to use Documenter directly is how the pages are generated, where documenter focuses on stuff like docstrings, and franklin has a more general focus with more flexibility.

tlienart commented 1 year ago

Hello @KronosTheLate yeah I think that could be nice and might even be reasonably straightforward to do given the Documenter.jl repo is pretty clean. I don't think I can afford to do that soon but if someone wants to give it a shot, I'll definitely give a hand on the PR

Note: it's probably a good idea to start with Xranklin.jl directly (the beta for the next Franklin release).

KronosTheLate commented 1 year ago

Great! I am not capable enough to make it happen, but at some point in the future someone will hopefully get round to this. So this issue will just represent my wish-list ^_^

Perhaps @mortenpi be able to, or know someone who is able to, help make this happen.

mortenpi commented 1 year ago

I almost certainly won't have the bandwidth for it. But if someone does want to embark on this, then I'd just say that the Documenter SCSS files should refactored anyway, and so maybe there would be some way to combine those efforts, and make the whole thing a bit more reusable.

KronosTheLate commented 1 year ago

That sounds very interesting. If you see someone making efforts on the refactoring, feel free to point them to this thread.