On Wed, 18 Aug 2021 at 10:46, Grégoire JUGE <[email protected]> wrote: > > Hello, > > 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 > > Pros: > - 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 > > Cons: > - 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 _______________________________________________ Twisted mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3/lists/twisted.python.org/ Message archived at https://mail.python.org/archives/list/[email protected]/message/52A7FAYRPADSOU5UC3Y3XGCWOWO2HKXD/ Code of Conduct: https://twisted.org/conduct
