[CentOS-docs] Regarding Static website generator [GSOC Docs-toolchain]
Pierre-Yves Chibon
pingou at pingoured.fr
Tue Jul 28 06:57:56 UTC 2015
On Tue, Jul 28, 2015 at 11:30:01AM +0530, kunaal jain wrote:
> Hi, I just wanted to mail community first and get the discussion started,
> but I should have written details first.
>
> The main aim behind this project is to facilitate contributors, so the
> site generator should be such that, it doesn't complicate the workflow.
> Another constraint is that the site generator should require minimal human
> effort, as we plan to build the site continuously through CI, so the new
> content should automatically be indexed, added to navigation panels,
> content directory etc.
>
> Coming to existing site generators, we looked at Jekyll, Hugo and Mkdocs.
>
> Hugo - very flexible, great tool but complicated. User needs hugo
> installed to contribute. Docker uses this, switching from mkdocs.
>
> Mkdocs - Not very flexible, but very friendly. User needs to create doc in
> mardown, add the link in another file and done!
>
> Jekyll -- very blog specific, which we don't require.
>
> What do you think about it?
There is also Nikola for static content generator, relies on the rest syntax and
can be themed.
Pierre
More information about the CentOS-docs
mailing list