[Bf-docboard] Current Status and Next Steps

[Abuelo S. B. Chdancer]

and you wonder why so few writers get involved.



On 15 January 2015 at 17:53, Dalai Felinto <dfelinto at gmail.com> wrote:

> 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
> >
> _______________________________________________
> Bf-docboard mailing list
> Bf-docboard at blender.org
> http://lists.blender.org/mailman/listinfo/bf-docboard
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.blender.org/pipermail/bf-docboard/attachments/20150115/11070635/attachment.htm