-
Notifications
You must be signed in to change notification settings - Fork 71
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Transition to Sphinx for rendering #42
base: master
Are you sure you want to change the base?
Conversation
Looks nice and I like the default theme! It looks like all links are currently broken, we'd need to switch those from .html to .md, which would break links in github. |
IIRC @thefinn93 was saying something about just doing nginx rewriting. It might not be him but either way it would be good solution. |
|
…Other small css fixes.
…stays viewable in github.
Added a custom sphinx theme based on default. Added menu to sidebar. …
Like these messed up section headers: https://docs2.meshwith.me/config/shorewall-and-vpn-gateway-howto.html |
This particular file isn't valid as .md because there is a lack of spaces between "#" and the words. Well actually github and browser apparently support this very well but sphinx doesn't by default, and I don't really see a way to change it, because that would involve changing the text of the files before sphinx process it and I have still have no idea how to do that. Most of the change I was able to do where after the process by sphinx. Should we simply fix the files that forgot the spaces between "#" and the title? |
Yes, we should fix the files. Most Markdown processors require them. |
So I made some modifications. I'm not really satisfied with the result, but I'm not too sure what to change, so feedback is very welcome! http://ns346455.ip-91-121-136.eu/hyperboria-docs/_build/html/ Modifications: Also I know Danielo was working on some new design ideas he had and it looked very promising, does anyone know if he is still around? |
Looks pretty good. Thanks. I'll review more thoroughly in a few days and see about pulling things in. |
Is this still being worked on? |
not by me |
Not currently but I have some spare time coming soon, so if you have any suggestion I'm all ears |
Don't merge this yet, I just want a unified discussion thread. I added the stuff to do Sphinx rendering, and setup a demo at docs2.meshwith.me and h.docs2.meshwith.me. Lemme know what you think. I assume we'll want to theme it eventually, but at this point I suspect there's a lot of stuff that doesn't render properly that i'd like to track down.