duckinator / parts.horse

A website documenting electrical components.
https://parts.horse
MIT License
3 stars 1 forks source link

Refine existing custom static site generator OR switch to a pre-existing one #127

Closed duckinator closed 11 months ago

duckinator commented 1 year ago

Either refine the existing custom static site generator, or switch to a preexisting one while sticking with Python + Jinja2.

From https://github.com/duckinator/parts.horse/issues/112#issuecomment-1082568600:

https://github.com/duckinator/parts.horse/pull/114 and https://github.com/duckinator/parts.horse/pull/116 mean Parts Horse is fully static, but lacking search functionality. I do want to switch to a more standard site generator instead of a haphazard mess.

If you go to https://jamstack.org/generators/ and set the language to "Python" and the template system to "Jinja2", those will likely require the least effort for migration. (Since that's the setup the fully-custom system is using.)

From #112 (different comment):

potentially-promising static site generators i have no experience with:

https://jamstack.org/generators/nikola/ https://jamstack.org/generators/lektor/ https://jamstack.org/generators/grow/

Netlify CMS ( https://www.netlifycms.org/ ) may also be worth looking into, but i don't have a good feel for how it works.

duckinator commented 1 year ago

If MkDocs works, then we'd get search functionality by default.

duckinator commented 11 months ago

Switched to Sphinx in #144.