[Bf-docboard] Building the html pages

[Dan McGrath]

Hey,

Do yourself a favor, and install Linux in a VM and work on the docs that
way. Virtual box works great on windows and is free to use. I'd probably
recommend Ubuntu or Debian, as they tend to just work and many people know
them enough to help.

Trying to get Unix like tools and work environment setup in windows is
never going to be a fun experience.

Dan
On Jan 18, 2015 6:19 PM, "Wim Teuling" <wfteuling at yahoo.com> wrote:

> Stupid mistake on my part: I tried to use Python 3.4. It must be 2.7.
>
> I installed 2.7, and still no go: venv is not recognized as a command,
> make is not available, exceptions everywhere.
>
> ...very tiresome.
>
>
>   On Sunday, January 18, 2015 2:53 PM, Wim Teuling <wfteuling at yahoo.com>
> wrote:
>
>
>
> Last week I decided to check the Blender docs, and I'd like to start
> helping out with the documentation. A year or two ago I fixed a number of
> mistakes and errors in the documentation in the old system.
>
> I like the look and feel of the new approach. I also like how Sphinx can
> export to multiple formats.
>
> Unfortunately, the steps for building the pages do not work for me: I set
> up a local repository, downloaded all the files, installed Python 3.4, and
> tried to run the requirements.txt as explained. (I am on Windows)
>
> That is where my trouble began: scripts not found, etc. I added a path to
> the Windows system vars, still no go. At some point I got it to install
> some components, but I was lost after that. I cannot get it to work
> properly. And I am a web developer, so I do know how to work with svn,
> github, programming, etc.
>
> After an hour of trial and error, and checking the Sphinx manual for
> clues, I gave up. I just do not have time for this. The setup documentation
> is severely lacking, which is ironic.
>
> Really, I just want to write and edit, and help out with, the
> documentation, but this is taking too much time, and the barrier is set
> fairly high to be able to start writing! If I can't get it up and running
> within 20 minutes, how on earth are less experienced potential writers
> going to deal with this?
>
> I will uninstall everything, and try again next week, when I have time.
> Too bad, I could have been editing and writing today.
>
>
>
>
> _______________________________________________
> 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/20150118/a2ae1d4e/attachment.htm