On Wed, 18 Aug 2021 at 10:46, Grégoire JUGE email@example.com wrote:
I tried to replicate the current https://twistedmatrix.com/documents/current/index.html theme with pelican: https://judgegregg.github.io/pelitwi/ (I reused Moshe Z.'s example to make comparison easier :) ) Sources: https://github.com/JudgeGregg/pelitwi
- Creating a theme from scratch seems easy at least for the basics
- Pelican handles rst natively, so porting current pages should be doable without too much hassle
- The theme feels a bit dated maybe (but switching/upgrading theme looks simple)?
- Pelican can be used to host any static content (not only blogs) but it requires a little more work AFAIK
- I have no idea how to replicate navbar and menus on pelican (probably related to n.2)
Please let me know what you think. If in the end we switch to Sphinx, I'd be happy to lend a hand too :) (Although I'm currently logged in the Twisted Libera Chat, I won't be able to use it for another week or so.)
-- Grégoire Juge
Thanks for your work.
I like Pelican... I see it as a simplified Sphinx alternative and at the same time a flexible alternative.
With Pelican you can have different templates for different pages.
I am using it for my company to create the main "business page" and it works ok. You can create side-menus in pelican for sub-pages... I am doing that using a jinja filter that takes as input all the pages and outputs list items. I can share the filters. I have various such filters...for example a similar one to generate the footer mini-sitemap
For my site, the main (top) navbar is fixed and sourced from the pelican conf file.
I am familiar with Jinja and RST and copy/pasting an already existing HTML/CSS markup. I am not good at creating new HTML and CSS. I am lucky with Boostrap CSS :)
I guess that we can go with Pelican + GitHub pages for the main site. -- Adi Roiban