<div class="gmail_quote">On Mon, Jan 24, 2011 at 09:20, Brian Granger <span dir="ltr"><<a href="mailto:ellisonbg@gmail.com">ellisonbg@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><div></div><div class="h5">On Mon, Jan 24, 2011 at 5:54 AM, Darren Dale <<a href="mailto:dsdale24@gmail.com">dsdale24@gmail.com</a>> wrote:<br>
> On Sun, Jan 23, 2011 at 11:56 PM, Fernando Perez <<a href="http://fperez.net" target="_blank">fperez.net</a>@<a href="http://gmail.com" target="_blank">gmail.com</a>> wrote:<br>
>> Hey folks,<br>
>><br>
>> I'm really sorry that (due to 'real life' getting in the way) I missed<br>
>> several important discussions, in particular this one:<br>
>><br>
>> <a href="https://github.com/ipython/ipython/issues/closed/#issue/239" target="_blank">https://github.com/ipython/ipython/issues/closed/#issue/239</a><br>
>><br>
>> As I just mentioned to Brian during a chat we had, there's a problem<br>
>> with the default approach Github took to pages hosting: they put the<br>
>> pages in a separate DAG inside the repo (the gh-pages branch), but<br>
>> this means polluting the repo forever with all builds of the docs.<br>
>> Furthermore, if we want to host multiple versions of the docs (as we<br>
>> do today for each release and should continue doing), the storage<br>
>> requirements are going to balloon.<br>
>><br>
>> Fortunately, there's a different approach that's easy to implement,<br>
>> adds only minimal work, and is completely clean.  And I'd already<br>
>> written the tools for it :)  For datarray, here's the gh-pages-hosted<br>
>> docs:<br>
>><br>
>> <a href="http://fperez.github.com/datarray-doc/" target="_blank">http://fperez.github.com/datarray-doc/</a><br>
>><br>
>> The basic idea is just to have a *separate* git repo that *only* hosts<br>
>> the gh-pages docs, in this case this one:<br>
>><br>
>> <a href="https://github.com/fperez/datarray-doc" target="_blank">https://github.com/fperez/datarray-doc</a><br>
><br>
> Just FYI, github also allows you to host a repository like:<br>
><br>
> <a href="https://github.com/ipython/ipython.github.com" target="_blank">https://github.com/ipython/ipython.github.com</a><br>
><br>
> which would render docs at <a href="http://ipython.github.com" target="_blank">http://ipython.github.com</a>. I've started<br>
> doing so with a project of my own:<br>
><br>
> <a href="http://praxes.github.com" target="_blank">http://praxes.github.com</a><br>
><br>
<br>
</div></div>I like this approach!<br></blockquote><div><br></div><div>Yes, I think this is a good plan for the IPython site in general, but that's a much bigger migration than just the sphinx docs.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">


<div class="im"><br>
> Also, if you add a .nojekyll in the master branch of that repo (or the<br>
> gh-pages repo), github can serve the content as provided by sphinx,<br>
> without additional processing.<br>
<br>
</div>Especially this.  While we have a makefile that does the extra<br>
processing, it is just one more thing to maintain.  What do others<br>
think?<br></blockquote><div><br></div><div>The sphinx-github extension resolves the conflict easily, but .nojekyll is definitely nicer.  Does .nojekyll work with regular repo gh-pages, or just '<a href="http://ipython.github.com">ipython.github.com</a>' ones?</div>

<div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;">
<br>
Cheers,<br>
<br>
Brian<br>
<div class="im"><br>
> _______________________________________________<br>
> IPython-dev mailing list<br>
> <a href="mailto:IPython-dev@scipy.org">IPython-dev@scipy.org</a><br>
> <a href="http://mail.scipy.org/mailman/listinfo/ipython-dev" target="_blank">http://mail.scipy.org/mailman/listinfo/ipython-dev</a><br>
><br>
<br>
<br>
<br>
</div><font color="#888888">--<br>
Brian E. Granger, Ph.D.<br>
Assistant Professor of Physics<br>
Cal Poly State University, San Luis Obispo<br>
<a href="mailto:bgranger@calpoly.edu">bgranger@calpoly.edu</a><br>
<a href="mailto:ellisonbg@gmail.com">ellisonbg@gmail.com</a><br>
</font><div><div></div><div class="h5">_______________________________________________<br>
IPython-dev mailing list<br>
<a href="mailto:IPython-dev@scipy.org">IPython-dev@scipy.org</a><br>
<a href="http://mail.scipy.org/mailman/listinfo/ipython-dev" target="_blank">http://mail.scipy.org/mailman/listinfo/ipython-dev</a><br>
</div></div></blockquote></div><br>