[Bf-docboard] Current Status and Next Steps

[Dalai Felinto]

Hi JET,

"> Checked out revision 53."

rev. 53 was actually my go at OSX installing docs. I should have
announced here I guess.

Your guide has a different approach (mine was mostly a copy/adapt of
the linux guide). It may be better since it's more verbose (mine
relies entirely on the terminal).

That said, you don't need:
"sphinx-build -b html ./manual ./build/html"

Instead you simply do:
"make"

> 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.

I'm using vim and instantRst for that. But its not very useful unless
you're familiar with vi.

Cheers,
Dalai
--
blendernetwork.org/dalai-felinto
www.dalaifelinto.com


2015-01-15 14:47 GMT-02:00 JET koten <jetkoten at gmail.com>:
> Here's a draft of the OS X install docs. I'm also new to SVN and
> RST/Sphinx,along with some of the people who have been posting lately... so
> this does seem much more complicated than a wiki to me too. Nonetheless, I
> was able to work out how to successfully do the install on OS X, translating
> from the Windows link that Greg posted a day or two ago.
>
> I guess someone might have to sub-edit this to get it properly formatted in
> RST and uploaded online to the docs page, if you want to use it, as I don't
> know how to do that myself. I tried to format it in RST, using the View page
> source link from the Windows page as a template but am not sure how it
> turned out. Probably needs some fine tuning, but should be quick for someone
> accustomed to RST workflow. 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.
>
> I did notice that when trying to download the Blender documentation repo
> that the HTTPS certificate had a validation error and that stopped the
> download with an alert. I had to press t to temporarily authorize it to
> continue.
>
> Should the URL be switched to http:// versus https:// in the docs if that
> would avoid the error (that might scare new people)?
>
> I also wondered whether or not the pip command will work on a stock OS X
> machine without Command Line Tools installed? I can't answer that because I
> have already installed them on mine.
>
> Also, I had 355 warnings (some of them marked SEVERE) while building the
> HTML... not sure if that is normal or not either, maybe adding a similar
> note as the earlier section about warnings being OK (even SEVERE ones) would
> help. The built HTML docs did seem to work in my browser despite the
> warnings, but I only looked at the contents.html page.
>
> Here's what I wrote, hope it is useful (attached as RST/txt).
>
> On Thu Jan 15 2015 at 8:07:03 AM marco ardito <ardito at apiform.to.it> wrote:
>>
>> Il 15/01/2015 13:56, Greg Zaal ha scritto:
>>
>> The manual at blender.org/manual is now the official one to use - all the
>> Help/manual links inside blender itself point to it.
>>
>> blender.org/documentation (which is now out-dated) needs to redirect to
>> blender.org/manual/about
>>
>>
>> this page also needs to link the new one, perhaps.
>> http://www.blender.org/support/ => online manual
>> and maybe http://www.blender.org/get-involved/ => documentation
>>
>> Marco
>>
>> ------------------- [Ai sensi e per gli effetti della Legge sulla tutela
>> della privacy (L. 196/2003), questa mail è destinata unicamente alle persone
>> sopra indicate e le informazioni in essa contenute sono da considerarsi
>> strettamente riservate. E' proibito leggere, copiare, usare o diffondere il
>> contenuto della presente mail senza autorizzazione. Se avete ricevuto questo
>> messaggio per errore, siete pregati di rispedire la stessa al mittente.
>> Grazie]
>>
>> _______________________________________________
>> Bf-docboard mailing list
>> Bf-docboard at blender.org
>> http://lists.blender.org/mailman/listinfo/bf-docboard
>
>
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>