<p dir="ltr">Hi, I just wanted to mail community first and get the discussion started, but I should have written details first.</p>
<p dir="ltr">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.</p>
<p dir="ltr">Coming to existing site generators, we looked at Jekyll, Hugo and Mkdocs.</p>
<p dir="ltr">Hugo - very flexible, great tool but complicated. User needs hugo installed to contribute. Docker uses this, switching from mkdocs.</p>
<p dir="ltr">Mkdocs - Not very flexible, but very friendly. User needs to create doc in mardown, add the link in another file and done! </p>
<p dir="ltr">Jekyll -- very blog specific, which we don't require.</p>
<p dir="ltr">What do you think about it?</p>
<div class="gmail_quote">On 28-Jul-2015 8:52 AM, "Sankarshan Mukhopadhyay" <<a href="mailto:sankarshan.mukhopadhyay@gmail.com">sankarshan.mukhopadhyay@gmail.com</a>> wrote:<br type="attribution"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Tue, Jul 28, 2015 at 8:47 AM, kunaal jain <<a href="mailto:kunaalus@gmail.com">kunaalus@gmail.com</a>> wrote:<br>
> Lei and I have been working on the project, based on community input. We<br>
> have implemented two way sync between github and pagure as suggest by many.<br>
><br>
> Now we want build the site and display it to user. There are number of<br>
> options mkdocs, hugo(docker uses it now) etc.<br>
><br>
> There are pros and cons to each site generator. To use hugo, we need the<br>
> user to have hugo installed too, and than he needs to run hugo command to<br>
> create a new file, which is big con.<br>
><br>
> Mkdocs is great too, but little inflexible we found.<br>
<br>
You would probably have to do better than just list one reason a piece.<br>
<br>
> Any suggestions on which tool to use?<br>
<br>
A good part of this decision is hinged on what are the design<br>
considerations you have in place. More importantly, since you'll be<br>
developing this, what are your thoughts?<br>
<br>
<br>
<br>
--<br>
sankarshan mukhopadhyay<br>
<<a href="https://about.me/sankarshan.mukhopadhyay" rel="noreferrer" target="_blank">https://about.me/sankarshan.mukhopadhyay</a>><br>
_______________________________________________<br>
CentOS-docs mailing list<br>
<a href="mailto:CentOS-docs@centos.org">CentOS-docs@centos.org</a><br>
<a href="http://lists.centos.org/mailman/listinfo/centos-docs" rel="noreferrer" target="_blank">http://lists.centos.org/mailman/listinfo/centos-docs</a><br>
</blockquote></div>