<div dir="ltr">Static files rendering: <div><br></div><div>If you change a single page, it will render that, and will render any related pages, such as home, tags, etc. Changes to the stylesheet make each page render again, which tremendously slows down development.</div>

<div><br></div><div><br></div><div>Using Drupal @Olssy:</div><div><br></div><div>It's already been established that we *need* something that doesn't need a database so it can be easily mirrored (on over 70 mirrors) and can be downloaded and stored by our users (in a pen drive, CD, etc). Also, I don't believe we need user roles?</div>

</div><div class="gmail_extra"><br><br><div class="gmail_quote">On Sat, Jan 11, 2014 at 12:31 AM, Rey Dhuny <span dir="ltr"><<a href="mailto:rey@spcshp.com" target="_blank">rey@spcshp.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div dir="auto"><div class="im"><div><span>> </span><span style="background-color:rgba(255,255,255,0)">How often will the static files need to be rendered?</span></div><div><span><br></span></div></div><div><span>Off the top of my head (not in front of a computer), When a page is changed or added, the entire site is regenerated.</span></div>

<div><span><br></span></div><div><span>I could be mistaken. </span></div><div><br><span>Sent from my silly iPhone</span></div><div><div class="h5"><div><br>On 10 Jan 2014, at 18:58, "Clark Venable" <<a href="mailto:jclarkv@gmail.com" target="_blank">jclarkv@gmail.com</a>> wrote:<br>

<br></div><blockquote type="cite"><div>
<span>How often will the static files need to be rendered? The greater the time interval between static file generation the less speed of engine matters. Or an I thinking about this wrong?<div><br></div>
<div>Clark Venable</div></span><div>-- <br>Clark</div>
<br><br><div class="gmail_quote"><p>On Fri, Jan 10, 2014 at 1:55 PM, Rey Dhuny <span dir="ltr"><<a href="mailto:rey@spcshp.com" target="_blank">rey@spcshp.com</a>></span> wrote:<br></p><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


<div><div>Namanyay Goel:</div></div>
<div><span><br></span></div>
<div><span>Thank you for those stats!</span></div>
<div><span><br></span></div>
<div><span>Maybe they should be put on the wiki where we can compare performance under the proposed generators section?</span></div>
<div><span><br></span></div>
<div>
<span>> </span><span style="background-color:rgba(255,255,255,0)">Hmm, Middleman might be overkill, but still I suggest we look into other static site generators, especially that can handle larger sites.</span>
</div>
<div><span><br></span></div>
<div>
<span>I very much agree, much more so since seeing looking at those stats. <br></span><br><span>Rey</span>
</div>
<div>
<br>On 10 Jan 2014, at 18:49, Namanyay Goel <<a href="mailto:mail@namanyayg.com" target="_blank">mail@namanyayg.com</a>> wrote:<br><br></div>
<blockquote type="cite"><div>
<div dir="ltr">I couldn't find much - Except the multiple StackOverflow questions you find when searching 'Jekyll generation slow', and this Github issue: <a href="https://github.com/jekyll/jekyll/issues/1140" target="_blank">https://github.com/jekyll/jekyll/issues/1140</a>, and my personal experience with using it (Use it on a blog with ~40 posts, generation time is from 8-12 seconds).<br>

<br>Hmm, Middleman might be overkill, but still I suggest we look into other static site generators, especially that can handle larger sites.<div><br></div>
<div>(Points of interest in the Github issue:</div>
<div>
<br>* Testing with jekyll build:</div>

<div>
<div>150 files - 20sec</div>
<div>300 files - 40sec</div>
<div>600 files - 130sec<br><br>* Testing jekyll build, 100 files, and using Jekyll-Bootstrap:<br><div>#1</div>
<div>real    0m18.725s</div>
<div>user    0m18.256s</div>

<div>sys 0m0.407s</div>
<div><br></div>
<div>#2</div>
<div>real    0m18.578s</div>
<div>user    0m18.124s</div>
<div>sys 0m0.423s</div>
<div><br></div>
<div>#3</div>
<div>real    0m18.467s</div>
<div>user    0m17.986s</div>
<div>sys 0m0.434s<br><br>* jekyll new performance:<br><br><div>posts</div>
<div>1<span style="white-space:pre-wrap">     </span>0.824<span style="white-space:pre-wrap">s</span>
</div>
<div>100<span style="white-space:pre-wrap">           </span>2.644<span style="white-space:pre-wrap">s</span>
</div>

<div>1000<span style="white-space:pre-wrap">          </span>25.071<span style="white-space:pre-wrap">s</span>
</div>
<div>5000<span style="white-space:pre-wrap">          </span>186.715s</div>
<div>10000<span style="white-space:pre-wrap">   </span>536.904s)</div>

</div>
</div>
</div>
</div>
<div class="gmail_extra">
<br><br><div class="gmail_quote">On Sat, Jan 11, 2014 at 12:07 AM, Rey Dhuny <span dir="ltr"><<a href="mailto:rey@spcshp.com" target="_blank">rey@spcshp.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


<div dir="auto">
<div>
<div><span style="background-color:rgba(255,255,255,0)">> While Jekyll is indeed a choice, for larger sites, it's generation time is simply too long.</span></div>

<div><span style="background-color:rgba(255,255,255,0)"><br></span></div>
</div>
<div><span style="background-color:rgba(255,255,255,0)">Are there any benchmarks or examples to validate this statement?</span></div>
<div><span style="background-color:rgba(255,255,255,0)"><br></span></div>
<div><span style="background-color:rgba(255,255,255,0)">I would be very interested to see generation times comparing the proposed static site generators, especially for larger sites. </span></div>
<div><span style="background-color:rgba(255,255,255,0)"><br></span></div>
<div><span style="background-color:rgba(255,255,255,0)">I personally have never encountered such problems in my usage of Jekyll though they haven't been large, content heavy applications like will be the case for <a href="http://torproject.org" target="_blank">torproject.org</a>. </span></div>



<div>
<div><span style="background-color:rgba(255,255,255,0)"><br></span></div>
<div><span>> (Someone suggested Middleman? It also has internationalization!)</span></div>
<div><span><br></span></div>
</div>
<div>

<span>I was somebody who suggested Middleman and indeed, it does have internationalisation baked in, though a concern I personally have is that it could potentially be _overkill_ for the application in this case. </span>
</div>

<div><br></div>
<div><span>Thoughts?</span></div>
<span><font color="#888888"><div><span><br></span></div>
<div><span>Rey</span></div></font></span><div><div>
<div>
<br>On 10 Jan 2014, at 18:21, Namanyay Goel <<a href="mailto:mail@namanyayg.com" target="_blank">mail@namanyayg.com</a>> wrote:<br><br></div>
<blockquote type="cite"><div>
<div dir="ltr">While Jekyll is indeed a choice, for larger sites, it's generation time is simply too long. Development takes time on Jekyll, simply because of it's generation time. If we can offset that problem in some way, that would be great, otherwise I feel we should be looking at some other static site generator (Someone suggested Middleman? It also has internationalization!)<div>





<br></div>
<div>As for the debate about author's writing 'code', Markdown is easy to learn and use, and outputs semantic data. We really don't need a rich text editor of some sort, Markdown (Or similar languages) are good enough. </div>





</div>
<div class="gmail_extra">
<br><br><div class="gmail_quote">On Fri, Jan 10, 2014 at 11:45 PM, Gvido Glazers <span dir="ltr"><<a href="mailto:gvido.glazers@gmail.com" target="_blank">gvido.glazers@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


<div dir="ltr"><div>
<div>
<div>Hello, Everyone!<br>Missed the introduction thread, so I'll just start with that:<br></div>I'm Gvido, and I'm currently based in Amsterdam.<br>My official job title is front-end developer, but in reality I do full-stack development with ruby or python.<br>

<br><br></div>Now, back on topic. <br>I'm also going to agree with the general sentiment that Jekyll is the way to go. It's stable, simple, widely used, easy to extend, and powerful.<br>Markdown is really easy to learn, I don't think content creators writing about Tor would have a problem grasping it.<br>

</div></div>
<div><div>
<div class="gmail_extra">
<br><br><div class="gmail_quote">On Fri, Jan 10, 2014 at 6:52 PM, William Papper <span dir="ltr"><<a href="mailto:william@papper.me" target="_blank">william@papper.me</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


<div dir="ltr">
<span style="font-family:arial,sans-serif;font-size:13px">Definitely a +1 for Jekyll. There's no need to reinvent the wheel. While a custom solution or plain HTML may seem appealing at first (and would be great for a personal project), Jekyll lets us move much quicker and keeps everything relatively standardized. It also makes it easier for people to collaborate, since Jekyll is widely used.</span><br>

</div>
<div><div>
<div class="gmail_extra">
<br><br><div class="gmail_quote">On Fri, Jan 10, 2014 at 11:57 AM, Moritz Süß <span dir="ltr"><<a href="mailto:moritz@moritzsuess.de" target="_blank">moritz@moritzsuess.de</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">


<div style="word-wrap:break-word">Markdown is _very_ simple.<div>Please check out <a href="http://daringfireball.net/projects/markdown/basics" target="_blank">http://daringfireball.net/projects/markdown/basics</a> and try out markdown at <a href="http://www.markdownviewer.com/" target="_blank">http://www.markdownviewer.com/</a>.</div>







<div><br></div>
<div>Let’s try to use these as long as possible for getting people familiarized with Markdown. We do not want to duplicate existing documentation efforts, and keep up-front investment for tools as low as possible in this project.</div>







<div><br></div>
<div>I hope I am correct in my understanding that we agree on a static website generator now, and kind-off agree on Jekyll.</div>
<div><br></div>
<div>Best</div>
<div>
<div>Moritz
</div>
<br><div>
<div>Am 10.01.2014 um 17:35 schrieb Earl G <<a href="mailto:globallogins@gmail.com" target="_blank">globallogins@gmail.com</a>>:</div>
<div><div>
<br><blockquote type="cite">
<div dir="ltr">Ok So Jeklly<div>
a user guide for people that need to learn markdown to be able to contribute to the blog.</div>
<div><br></div>
<div>and the front of the site user friendly for anybody that wants to get started.</div>
<div><br></div>
<div>back of the site and deeper for the linux nerds and specialists that want to dig deeper.</div>
<div><br></div>
<div>job done</div>
<div><br></div>
</div>
<div class="gmail_extra">
<br><br><div class="gmail_quote">






On 10 January 2014 17:32, Sam E. Lawrence <span dir="ltr"><<a href="mailto:selbrit@gmail.com" target="_blank">selbrit@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">








<div dir="ltr">
<div class="gmail_extra">
<div>
<br><div class="gmail_quote">
<font color="#674ea7">On Fri, Jan 10, 2014 at 10:10 AM, Sean Rafferty <span dir="ltr"><<a href="mailto:seanmrafferty@me.com" target="_blank">seanmrafferty@me.com</a>></span> wrote:<br></font><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<font color="#674ea7">But there are a lot of content writers in the world that just don’t know it well enough. </font></blockquote>








</div>
<br></div>Then they can learn. If someone wants to contribute to a solution to a problem as complex as privacy and security, then learning markdown / HTML should be a minor investment of their time. Basic HTML takes little time to learn, and will instantly boost the self-respect of anyone who wants to help Tor and other software projects. Setting a bar is worth it, IMO.</div>










</div>
<br>________________________________________________________________________<br>
Tor Website Team coordination mailing-list<br><br>
To unsubscribe or change other options, please visit:<br><a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a><br><br>

</blockquote>
</div>
<br></div>
________________________________________________________________________<br>Tor Website Team coordination mailing-list<br><br>To unsubscribe or change other options, please visit:<br><a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a><br>

</blockquote>
</div></div>
</div>
<br></div>
</div>
<br>________________________________________________________________________<br>
Tor Website Team coordination mailing-list<br><br>
To unsubscribe or change other options, please visit:<br><a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a><br><br>

</blockquote>
</div>
<br></div>
</div></div>
<br>________________________________________________________________________<br>
Tor Website Team coordination mailing-list<br><br>
To unsubscribe or change other options, please visit:<br><a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a><br><br>

</blockquote>
</div>
<br></div>
</div></div>
<br>________________________________________________________________________<br>
Tor Website Team coordination mailing-list<br><br>
To unsubscribe or change other options, please visit:<br><a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a><br><br>

</blockquote>
</div>
<br><br clear="all"><div><br></div>-- <br><div dir="ltr">
<div>
<a href="http://namanyayg.com/" style="font-size:large;font-family:tahoma,sans-serif" target="_blank">Namanyay Goel</a><br></div>
<font face="tahoma, sans-serif" color="#666666"><br><font>:: Freelance Web Designer and Developer.</font></font><div><font face="tahoma, sans-serif" color="#666666">:: UI Designer at <a href="http://makeuseof.com/" target="_blank">MakeUseOf</a>.<br>

<font>:: A</font><font>uthor at <a href="http://symmetrycode.com/" target="_blank">Symmetrycode</a>.</font></font></div>
<div>
<font face="tahoma, sans-serif" color="#666666">:: <a href="http://twitter.com/namanyayg" target="_blank">@namanyayg</a><br></font><br></div>
</div>
</div>
</div></blockquote>
<blockquote type="cite"><div>
<span>________________________________________________________________________</span><br><span>Tor Website Team coordination mailing-list</span><br><span></span><br><span>To unsubscribe or change other options, please visit:</span><br>

<span><a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a></span><br></div></blockquote>
</div></div>
</div>
<br>________________________________________________________________________<br>


Tor Website Team coordination mailing-list<br><br>
To unsubscribe or change other options, please visit:<br><a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a><br><br>

</blockquote>
</div>
<br><br clear="all"><div><br></div>-- <br><div dir="ltr">
<div>
<a href="http://namanyayg.com/" style="font-size:large;font-family:tahoma,sans-serif" target="_blank">Namanyay Goel</a><br></div>
<font face="tahoma, sans-serif" color="#666666"><br><font style>:: Freelance Web Designer and Developer.</font></font><div><font face="tahoma, sans-serif" color="#666666">:: UI Designer at <a href="http://makeuseof.com/" target="_blank">MakeUseOf</a>.<br>

<font style>:: A</font><font style>uthor at <a href="http://symmetrycode.com/" target="_blank">Symmetrycode</a>.</font></font></div>
<div>
<font face="tahoma, sans-serif" color="#666666">:: <a href="http://twitter.com/namanyayg" target="_blank">@namanyayg</a><br></font><br></div>
</div>
</div>
</div></blockquote>
<blockquote type="cite"><div>
<span>________________________________________________________________________</span><br><span>Tor Website Team coordination mailing-list</span><br><span></span><br><span>To unsubscribe or change other options, please visit:</span><br>

<span><a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a></span><br></div></blockquote>
</blockquote></div><br></div></blockquote><blockquote type="cite"><div><span>________________________________________________________________________</span><br><span>Tor Website Team coordination mailing-list</span><br><span></span><br>

<span>To unsubscribe or change other options, please visit:</span><br><span><a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a></span><br>

</div></blockquote></div></div></div><br>________________________________________________________________________<br>
Tor Website Team coordination mailing-list<br>
<br>
To unsubscribe or change other options, please visit:<br>
<a href="https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team" target="_blank">https://lists.torproject.org/cgi-bin/mailman/listinfo/www-team</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div dir="ltr"><div><a href="http://namanyayg.com/" style="font-size:large;font-family:tahoma,sans-serif" target="_blank">Namanyay Goel</a><br></div><font face="tahoma, sans-serif" color="#666666"><br>

<font style="background-color:rgb(255,255,255)">:: Freelance Web Designer and Developer.</font></font><div><font face="tahoma, sans-serif" color="#666666">:: UI Designer at <a href="http://makeuseof.com/" target="_blank">MakeUseOf</a>.<br>

<font style="background-color:rgb(255,255,255)">:: A</font><font style="background-color:rgb(255,255,255)">uthor at <a href="http://symmetrycode.com/" target="_blank">Symmetrycode</a>.</font></font></div><div><font face="tahoma, sans-serif" color="#666666">:: <a href="http://twitter.com/namanyayg" target="_blank">@namanyayg</a><br>

</font><br></div></div>
</div>