<div dir="ltr"><div>and you wonder why so few writers get involved.</div><div><br></div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On 15 January 2015 at 17:53, Dalai Felinto <span dir="ltr"><<a href="mailto:dfelinto@gmail.com" target="_blank">dfelinto@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi JET,<br>
<br>
"> Checked out revision 53."<br>
<br>
rev. 53 was actually my go at OSX installing docs. I should have<br>
announced here I guess.<br>
<br>
Your guide has a different approach (mine was mostly a copy/adapt of<br>
the linux guide). It may be better since it's more verbose (mine<br>
relies entirely on the terminal).<br>
<br>
That said, you don't need:<br>
"sphinx-build -b html ./manual ./build/html"<br>
<br>
Instead you simply do:<br>
"make"<br>
<br>
> The main difficulty I’m having is not knowing how to preview the RST as HTML, so I can see how the built HTML would turn out.<br>
<br>
I'm using vim and instantRst for that. But its not very useful unless<br>
you're familiar with vi.<br>
<br>
Cheers,<br>
Dalai<br>
--<br>
<a href="http://blendernetwork.org/dalai-felinto" target="_blank">blendernetwork.org/dalai-felinto</a><br>
<a href="http://www.dalaifelinto.com" target="_blank">www.dalaifelinto.com</a><br>
<br>
<br>
2015-01-15 14:47 GMT-02:00 JET koten <<a href="mailto:jetkoten@gmail.com">jetkoten@gmail.com</a>>:<br>
> Here's a draft of the OS X install docs. I'm also new to SVN and<br>
> RST/Sphinx,along with some of the people who have been posting lately... so<br>
> this does seem much more complicated than a wiki to me too. Nonetheless, I<br>
> was able to work out how to successfully do the install on OS X, translating<br>
> from the Windows link that Greg posted a day or two ago.<br>
><br>
> I guess someone might have to sub-edit this to get it properly formatted in<br>
> RST and uploaded online to the docs page, if you want to use it, as I don't<br>
> know how to do that myself. I tried to format it in RST, using the View page<br>
> source link from the Windows page as a template but am not sure how it<br>
> turned out. Probably needs some fine tuning, but should be quick for someone<br>
> accustomed to RST workflow. The main difficulty I’m having is not knowing<br>
> how to preview the RST as HTML, so I can see how the built HTML would turn<br>
> out.<br>
><br>
> I did notice that when trying to download the Blender documentation repo<br>
> that the HTTPS certificate had a validation error and that stopped the<br>
> download with an alert. I had to press t to temporarily authorize it to<br>
> continue.<br>
><br>
> Should the URL be switched to http:// versus https:// in the docs if that<br>
> would avoid the error (that might scare new people)?<br>
><br>
> I also wondered whether or not the pip command will work on a stock OS X<br>
> machine without Command Line Tools installed? I can't answer that because I<br>
> have already installed them on mine.<br>
><br>
> Also, I had 355 warnings (some of them marked SEVERE) while building the<br>
> HTML... not sure if that is normal or not either, maybe adding a similar<br>
> note as the earlier section about warnings being OK (even SEVERE ones) would<br>
> help. The built HTML docs did seem to work in my browser despite the<br>
> warnings, but I only looked at the contents.html page.<br>
><br>
> Here's what I wrote, hope it is useful (attached as RST/txt).<br>
><br>
> On Thu Jan 15 2015 at 8:07:03 AM marco ardito <<a href="mailto:ardito@apiform.to.it">ardito@apiform.to.it</a>> wrote:<br>
>><br>
>> Il 15/01/2015 13:56, Greg Zaal ha scritto:<br>
>><br>
>> The manual at <a href="http://blender.org/manual" target="_blank">blender.org/manual</a> is now the official one to use - all the<br>
>> Help/manual links inside blender itself point to it.<br>
>><br>
>> <a href="http://blender.org/documentation" target="_blank">blender.org/documentation</a> (which is now out-dated) needs to redirect to<br>
>> <a href="http://blender.org/manual/about" target="_blank">blender.org/manual/about</a><br>
>><br>
>><br>
>> this page also needs to link the new one, perhaps.<br>
>> <a href="http://www.blender.org/support/" target="_blank">http://www.blender.org/support/</a> => online manual<br>
>> and maybe <a href="http://www.blender.org/get-involved/" target="_blank">http://www.blender.org/get-involved/</a> => documentation<br>
>><br>
>> Marco<br>
>><br>
>> ------------------- [Ai sensi e per gli effetti della Legge sulla tutela<br>
>> della privacy (L. 196/2003), questa mail è destinata unicamente alle persone<br>
>> sopra indicate e le informazioni in essa contenute sono da considerarsi<br>
>> strettamente riservate. E' proibito leggere, copiare, usare o diffondere il<br>
>> contenuto della presente mail senza autorizzazione. Se avete ricevuto questo<br>
>> messaggio per errore, siete pregati di rispedire la stessa al mittente.<br>
>> Grazie]<br>
>><br>
>> _______________________________________________<br>
>> Bf-docboard mailing list<br>
>> <a href="mailto:Bf-docboard@blender.org">Bf-docboard@blender.org</a><br>
>> <a href="http://lists.blender.org/mailman/listinfo/bf-docboard" target="_blank">http://lists.blender.org/mailman/listinfo/bf-docboard</a><br>
><br>
><br>
> _______________________________________________<br>
> Bf-docboard mailing list<br>
> <a href="mailto:Bf-docboard@blender.org">Bf-docboard@blender.org</a><br>
> <a href="http://lists.blender.org/mailman/listinfo/bf-docboard" target="_blank">http://lists.blender.org/mailman/listinfo/bf-docboard</a><br>
><br>
_______________________________________________<br>
Bf-docboard mailing list<br>
<a href="mailto:Bf-docboard@blender.org">Bf-docboard@blender.org</a><br>
<a href="http://lists.blender.org/mailman/listinfo/bf-docboard" target="_blank">http://lists.blender.org/mailman/listinfo/bf-docboard</a><br>
</blockquote></div><br></div>