<table cellspacing="0" cellpadding="0" border="0" ><tr><td valign="top" style="font: inherit;">Sean,<br><br>I add the empty file .nojekyll to <a href="https://github.com/Jonathan2251/lbd/tree/gh-pages">https://github.com/Jonathan2251/lbd/tree/gh-pages</a> and do "make gh-pages" again. It's the same. I check the uvbook has the gh-pages as mine as follows,<br><br><a href="https://github.com/nikhilm/uvbook/tree/gh-pages">https://github.com/nikhilm/uvbook/tree/gh-pages</a><br><a href="https://github.com/Jonathan2251/lbd/tree/gh-pages">https://github.com/Jonathan2251/lbd/tree/gh-pages</a><br><br>In addition to gh-pages, uvbook has the the other web site on<br><a href="http://nikhilm.github.com/uvbook/">http://nikhilm.github.com/uvbook/</a><br><br><br>I think, maybe the extra web site is created manually and copy the gh-pages to it. Or the extra http site (not https) is created automatically. Because I cannot see it put html to the extra web from gh-pages of
 Makefile.<br><br><br>Jonathan<br>  <br><br><br><br>--- <b>12/12/4 (二)，Sean Silva <i><silvas@purdue.edu></i></b> 寫道：<br><blockquote style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; padding-left: 5px;"><br>寄件者: Sean Silva <silvas@purdue.edu><br>主旨: Re: LLVM documentation work help<br>收件者: "gamma_chen" <gamma_chen@yahoo.com.tw><br>副本: "llvmdev@cs.uiuc.edu" <llvmdev@cs.uiuc.edu>, "Anoushe Jamshidi" <ajamshidi@gmail.com><br>日期: 2012年12月4日,二,上午10:47<br><br><div id="yiv108003032">You may need a ".nojekyll" file. uvbook has one <<a rel="nofollow" target="_blank" href="https://github.com/nikhilm/uvbook/blob/gh-pages/.nojekyll">https://github.com/nikhilm/uvbook/blob/gh-pages/.nojekyll</a>>. Also see <<a rel="nofollow" target="_blank"
 href="https://help.github.com/articles/files-that-start-with-an-underscore-are-missing">https://help.github.com/articles/files-that-start-with-an-underscore-are-missing</a>>.<div>
<br></div><div>Let me know if that doesn't work.<br><div><br></div><div>-- Sean Silva</div></div><div class="yiv108003032gmail_extra"><br><br><div class="yiv108003032gmail_quote">On Mon, Dec 3, 2012 at 9:15 PM, gamma_chen <span dir="ltr"><<a rel="nofollow" ymailto="mailto:gamma_chen@yahoo.com.tw" target="_blank" href="/mc/compose?to=gamma_chen@yahoo.com.tw">gamma_chen@yahoo.com.tw</a>></span> wrote:<br>
<blockquote class="yiv108003032gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex;"><table border="0" cellpadding="0" cellspacing="0"><tbody><tr><td style="font:inherit;" valign="top">Sean,<br><br>I can create html, pdf and epub, then put them on <br>
<<a rel="nofollow" target="_blank" href="https://github.com/Jonathan2251/lbd/tree/gh-pages">https://github.com/Jonathan2251/lbd/tree/gh-pages</a>>.<br>The uvbook example as below can click the pdf link and pop up a download window while I cannot. The uvbook link is put on <a rel="nofollow" target="_blank" href="http://username.github.com/.">http://username.github.com/.</a>.. while the "make gh-pages" put them on <a rel="nofollow" target="_blank" href="https://github.com/username/.">https://github.com/username/.</a>..  How can I have the download link like uvbook example?<br>
<br>A really good example of a book written with Sphinx is <<a rel="nofollow" target="_blank" href="https://github.com/nikhilm/uvbook">https://github.com/nikhilm/uvbook</a>>. Sphinx can then generate HTML <<a rel="nofollow" target="_blank" href="http://nikhilm.github.com/uvbook/index.html">http://nikhilm.github.com/uvbook/index.html</a>> or PDF <<a rel="nofollow" target="_blank" href="http://nikhilm.github.com/uvbook/An%20Introduction%20to%20libuv.pdf">http://nikhilm.github.com/uvbook/An%20Introduction%20to%20libuv.pdf</a>> <br>
<br><br><br>My steps as follows,<br>1. I follow your one time procedure as follows,<br><<a rel="nofollow" target="_blank" href="https://help.github.com/articles/creating-project-pages-manually">https://help.github.com/articles/creating-project-pages-manually</a>>.<br>
2. make gh-pages (I modify file Makefile for my document name before do this)<br><br>Jonathan<br><br><br>--- <b>12/12/3 (一)，Sean Silva <i><<a rel="nofollow" ymailto="mailto:silvas@purdue.edu" target="_blank" href="/mc/compose?to=silvas@purdue.edu">silvas@purdue.edu</a>></i></b> 寫道：<br>
<blockquote style="border-left:2px solid rgb(16,16,255);margin-left:5px;padding-left:5px;"><br>寄件者: Sean Silva <<a rel="nofollow" ymailto="mailto:silvas@purdue.edu" target="_blank" href="/mc/compose?to=silvas@purdue.edu">silvas@purdue.edu</a>><br>主旨: Re: LLVM documentation work help<br>
收件者: "Jonathan" <<a rel="nofollow" ymailto="mailto:gamma_chen@yahoo.com.tw" target="_blank" href="/mc/compose?to=gamma_chen@yahoo.com.tw">gamma_chen@yahoo.com.tw</a>><br>副本: "<a rel="nofollow" ymailto="mailto:llvmdev@cs.uiuc.edu" target="_blank" href="/mc/compose?to=llvmdev@cs.uiuc.edu">llvmdev@cs.uiuc.edu</a>" <<a rel="nofollow" ymailto="mailto:llvmdev@cs.uiuc.edu" target="_blank" href="/mc/compose?to=llvmdev@cs.uiuc.edu">llvmdev@cs.uiuc.edu</a>>, "Anoushe Jamshidi"
 <<a rel="nofollow" ymailto="mailto:ajamshidi@gmail.com" target="_blank" href="/mc/compose?to=ajamshidi@gmail.com">ajamshidi@gmail.com</a>><br>日期: 2012年12月3日,一,下午2:48<div><div class="yiv108003032h5"><br><br><div>Let me explain how uvbook does it. They use a feature of github called<br>
"github pages", which provides small static website hosting. The way<br>that github pages works is that you make a git branch `gh-pages` which<br>contains the generated HTML. They explain it better here<br><<a rel="nofollow" target="_blank" href="https://help.github.com/articles/creating-project-pages-manually">https://help.github.com/articles/creating-project-pages-manually</a>>.<br>
You can see how uvbook does it by looking at their makefile<br><<a rel="nofollow" target="_blank" href="https://github.com/nikhilm/uvbook/blob/master/Makefile#L160">https://github.com/nikhilm/uvbook/blob/master/Makefile#L160</a>>. It<br>
should be easy to reuse.<br><br>I think that you should do this so that it is easy for anyone to read<br>the book without leaving their browser. That will mean that more<br>people read
 it and contribute.<br><br>-- Sean Silva<br><br>On Sun, Dec 2, 2012 at 11:03 PM, Jonathan <<a rel="nofollow" target="_blank" href="http://mc/compose?to=gamma_chen@yahoo.com.tw">gamma_chen@yahoo.com.tw</a>> wrote:<br>> Sean,<br>
><br>> The `.. code-block:: bash` is work. Thank your information.<br>><br>> Currently, I can put reStructuredText files on github. But, your example uvbook seems put the html and pdf on different github directory. Do you put html and pdf on github with version control?<br>
><br>> Jonathan<br>><br>><br>> On 2012/12/3, at 上午7:43, Sean Silva <<a rel="nofollow" target="_blank" href="http://mc/compose?to=silvas@purdue.edu">silvas@purdue.edu</a>> wrote:<br>><br>>> It looks like things are going well.<br>
>><br>>> One suggestion. Instead of using `.. literalinclude::` for displaying<br>>> the terminal sessions, you can use `.. code-block:: bash` instead.
 The<br>>> reason that uvbook uses `.. literalinclude` is that they are showing<br>>> parts of real compilable programs. If you just want to show a snippet<br>>> of code or terminal snippet, you can use `.. code-block::` and avoid<br>
>> having lots of little files.<br>>><br>>> -- Sean Silva<br>>><br>>> On Thu, Nov 29, 2012 at 10:43 AM, Jonathan <<a rel="nofollow" target="_blank" href="http://mc/compose?to=gamma_chen@yahoo.com.tw">gamma_chen@yahoo.com.tw</a>> wrote:<br>
>>> Sean,<br>>>><br>>>> By try, I seems realize the <a rel="nofollow" target="_blank" href="http://github.com">github.com</a> is free for register. So, just ignore my last mail.<br>>>><br>>>> Anoushe,<br>
>>><br>>>> You can register with email and get an account on<br>>>> <a rel="nofollow" target="_blank" href="https://github.com/">https://github.com/</a><br>>>><br>>>> I have put the our document reStructuredText on
 <a rel="nofollow" target="_blank" href="http://git.hub.com">git.hub.com</a>. You can clone it without register.<br>>>> After you get an account and I add it to collaborators, then you can do check in with our project as follows,<br>
>>><br>>>> <a rel="nofollow" target="_blank" href="https://github.com/Jonathan2251/lbd.git">https://github.com/Jonathan2251/lbd.git</a><br>>>><br>>>> Jonathan<br>>>><br>>>> On 2012/11/29, at 下午7:13, Sean Silva <<a rel="nofollow" target="_blank" href="http://mc/compose?to=silvas@purdue.edu">silvas@purdue.edu</a>> wrote:<br>
>>><br>>>>>> I am happy to introduce Anoushe, my llvm backend documentation work helper for English and edit.<br>>>>><br>>>>> Awesome! Great to see people helping out. Thank you both for working on this.<br>
>>>><br>>>>>> Is it possible, me and Anoushe can get a git free space and access right for the reStructuredText files (include .png
 pictures) of me and Anoushe create in future? If not allowed. Can we hand over the reStructuredText files, and put to git server through you?<br>>>>><br>>>>> I would suggest that you create a git repository on github. LLVM<br>
>>>> itself does not have any git servers except for hosting the SVN<br>>>>> mirror.<br>>>>><br>>>>> If you want, I can setup a git repository and give you access if you<br>
>>>> think it would be easier that way. Just tell me what seems easiest for<br>>>>> you.<br>>>>><br>>>>> -- Sean Silva<br>>>><br>><br></div></div></div></blockquote>
</td></tr></tbody></table></blockquote></div><br></div>
</div></blockquote></td></tr></table>