[Bf-docboard] Update on Wiki to RestructuredText conversion
Campbell Barton
ideasman42 at gmail.com
Mon Sep 1 01:15:18 CEST 2014
Hi Nils, its fine to post installation issues here - maybe someone on
this list knows a solution. (looks like this is Py2 running in Py3).
But it may be good to ask sphinx project directly, lots of projects
use sphinx, so any issues installing it aren't specific to us.
Even so, its good to know if this is an easy process for users on
different platforms.
On Mon, Sep 1, 2014 at 8:11 AM, Gaia <gaia.clary at machinimatrix.org> wrote:
> Hi, Nils;
>
> I already had python 2.7 on my windows 7 before i installed sphinx.
> Maybe your python is too new ? maybe looking closer to this page
> can help you more:
>
> https://pypi.python.org/pypi/wsgiref
>
> Not much but maybe at least a hint ;-/
>
> btw: creating a noobie document for installing Sphinx would be very
> appreciated ;-)
> cheers,
> Gaia
>
>
> On 31.08.2014 23:38, nils.kelleter at googlemail.com wrote:
>
> Hi,
>
> I have tried it under Windows 8.1 and use the instructions on your project
> site.
> I got an error during pip installation of wsgiref. Below you can find the
> debug output.
>
> For information, I have no experience with git or python, I have installed
> both today the first time.
> I have downloaded the latest version of the git and python installation
> package for Windows and installed it.
>
> I hope someone can help me.
> If the setup is running on my computer, I will write an installation guide
> for Windows users and can provide it here.
>
> Regards,
>
> Nils
>
>
> Here the Output of the debug log file:
>>>>
> Downloading/unpacking wsgiref==0.1.2 (from -r requirements.txt (line 7))
> Getting page https://pypi.python.org/simple/wsgiref/
> URLs to search for versions for wsgiref==0.1.2 (from -r requirements.txt
> (line 7)):
> * https://pypi.python.org/simple/wsgiref/0.1.2
> * https://pypi.python.org/simple/wsgiref/
> Getting page https://pypi.python.org/simple/wsgiref/0.1.2
> Could not fetch URL https://pypi.python.org/simple/wsgiref/0.1.2: 404
> Client Error: Not Found
> Will skip URL https://pypi.python.org/simple/wsgiref/0.1.2 when looking
> for download links for wsgiref==0.1.2 (from -r requirements.txt (line 7))
> Analyzing links from page https://pypi.python.org/simple/wsgiref/
> Skipping link
> https://pypi.python.org/packages/2.3/w/wsgiref/wsgiref-0.1-py2.3.egg#md5=102c28c347907758ef83006e7fd4bc60
> (from https://pypi.python.org/simple/wsgiref/); unknown archive format: .egg
> Skipping link
> https://pypi.python.org/packages/2.3/w/wsgiref/wsgiref-0.1.1-py2.3.egg#md5=d87f9e63c6a83d798730c2c74dc5c455
> (from https://pypi.python.org/simple/wsgiref/); unknown archive format: .egg
> Skipping link
> https://pypi.python.org/packages/2.3/w/wsgiref/wsgiref-0.1.2-py2.3.egg#md5=6afff05ff3bd529123b1b987677d08a1
> (from https://pypi.python.org/simple/wsgiref/); unknown archive format: .egg
> Skipping link
> https://pypi.python.org/packages/2.4/w/wsgiref/wsgiref-0.1-py2.4.egg#md5=8e46b55129b21a5dfdedd120ad13b8e3
> (from https://pypi.python.org/simple/wsgiref/); unknown archive format: .egg
> Skipping link
> https://pypi.python.org/packages/2.4/w/wsgiref/wsgiref-0.1.1-py2.4.egg#md5=e63f109ff92ec1bc4c3d9755f3c4ff73
> (from https://pypi.python.org/simple/wsgiref/); unknown archive format: .egg
> Skipping link
> https://pypi.python.org/packages/2.4/w/wsgiref/wsgiref-0.1.2-py2.4.egg#md5=8376d1cde46a101877687c041f46f02d
> (from https://pypi.python.org/simple/wsgiref/); unknown archive format: .egg
> Found link
> https://pypi.python.org/packages/source/w/wsgiref/wsgiref-0.1.1.zip#md5=95b91a109b7e4bebe5bcf5ae3fdaf853
> (from https://pypi.python.org/simple/wsgiref/), version: 0.1.1
> Found link
> https://pypi.python.org/packages/source/w/wsgiref/wsgiref-0.1.2.zip#md5=29b146e6ebd0f9fb119fe321f7bcf6cb
> (from https://pypi.python.org/simple/wsgiref/), version: 0.1.2
> Found link
> https://pypi.python.org/packages/source/w/wsgiref/wsgiref-0.1.zip#md5=156193401dc7b068ec1dd1f8bac99555
> (from https://pypi.python.org/simple/wsgiref/), version: 0.1
> Skipping link http://peak.telecommunity.com/wsgiref.pdf (from
> https://pypi.python.org/simple/wsgiref/); unknown archive format: .pdf
> Skipping link http://peak.telecommunity.com/wsgiref_docs/ (from
> https://pypi.python.org/simple/wsgiref/); not a file
> Skipping svn://svn.eby-sarna.com/svnroot/wsgiref#egg=wsgiref-dev (from
> https://pypi.python.org/simple/wsgiref/) because it is externally hosted.
> Ignoring link
> https://pypi.python.org/packages/source/w/wsgiref/wsgiref-0.1.1.zip#md5=95b91a109b7e4bebe5bcf5ae3fdaf853
> (from https://pypi.python.org/simple/wsgiref/), version 0.1.1 doesn't match
> ==0.1.2
> Ignoring link
> https://pypi.python.org/packages/source/w/wsgiref/wsgiref-0.1.zip#md5=156193401dc7b068ec1dd1f8bac99555
> (from https://pypi.python.org/simple/wsgiref/), version 0.1 doesn't match
> ==0.1.2
> Downloading wsgiref-0.1.2.zip
> Downloading from URL
> https://pypi.python.org/packages/source/w/wsgiref/wsgiref-0.1.2.zip#md5=29b146e6ebd0f9fb119fe321f7bcf6cb
> (from https://pypi.python.org/simple/wsgiref/)
> Running setup.py
> (path:C:\Users\Nils\AppData\Local\Temp\pip_build_Nils\wsgiref\setup.py)
> egg_info for package wsgiref
> Traceback (most recent call last):
> File "<string>", line 17, in <module>
> File
> "C:\Users\Nils\AppData\Local\Temp\pip_build_Nils\wsgiref\setup.py", line 5,
> in <module>
> import ez_setup
> File
> "C:\Users\Nils\AppData\Local\Temp\pip_build_Nils\wsgiref\ez_setup\__init__.py",
> line 170
> print "Setuptools version",version,"or greater has been installed."
> ^
> SyntaxError: invalid syntax
> Complete output from command python setup.py egg_info:
> Traceback (most recent call last):
>
> File "<string>", line 17, in <module>
>
> File "C:\Users\Nils\AppData\Local\Temp\pip_build_Nils\wsgiref\setup.py",
> line 5, in <module>
>
> import ez_setup
>
> File
> "C:\Users\Nils\AppData\Local\Temp\pip_build_Nils\wsgiref\ez_setup\__init__.py",
> line 170
>
> print "Setuptools version",version,"or greater has been installed."
>
> ^
>
> SyntaxError: invalid syntax
> <<<
>
>
>
> Von: Campbell Barton
> Gesendet: Samstag, 30. August 2014 16:59
> An: Blender Documentation Project
>
> Did anyone try get the docs and build them? so far this has been me
> and Francesco, but if the project is to be a success, we will need
> others to become involved.
> For the migration and for ongoing improvements.
>
> We realize the barrier of entry is high (using git for technical
> writers), and may eventually have a way to avoid writings having to
> use git or sphinx (directly) at all. (We're keeping an eye on possible
> solutions).
>
> But for now its important that we can see if the system is usable.
> That the team who writes docs even is able to use it effectively, or
> finds it better then the wiki.
>
>
>
> On Fri, Aug 29, 2014 at 8:31 PM, Francesco Siddi
> <francesco.siddi at gmail.com> wrote:
>> Hello everyone,
>> an important update on the documentation migration:
>>
>> - we created a project on https://developer.blender.org/project/view/53/
>> - the new sphinx-based documentation is available here
>> https://developer.blender.org/diffusion/BM/
>>
>> The project is now open for contribution, so we welcome any volunteer
>> willing to check out the documentation and do content edits and structure
>> refactoring for basically any section. General instructions on how to do
>> this are available in the project description. At the moment, in order to
>> contribute, there are a few requirements:
>>
>> - basic knowledge of GIT (checkout, commit, diff)
>> - basic knowledge of Sphinx and reST (the documentation system)
>> - an account on developer.blender.org (so you can write comments in the
>> project tasks or raise issues there)
>>
>> About translations and versioning:
>>
>> - currently we are trying to set up this documentation in English (many
>> sections are unmaintained and some are outdated back to 2.4x)
>> - if this migration succeeds, we will support other languages in parallel
>> repos
>> - currently we are working for the 2.7x series, and the idea is to use
>> git-tags for greater versions
>> - older documentation will stay on wiki.blender.org until this
>> documentation
>> fully functional
>>
>> We are happy to hear feedback and comments! Also, we are working on trying
>> to make this infrastructure simpler, to easily allow casual contribution.
>>
>> Reminder: this project is about the User Manual. Everything else
>> (developers
>> docs, proposals, release logs, module owners list, etc) will stay on the
>> wiki.
>>
>> Thanks,
>> Francesco
>>
>>
>> On 3 Jul 2014 at 10:35:13, Campbell Barton (ideasman42 at gmail.com) wrote:
>>
>> On Thu, Jul 3, 2014 at 5:47 PM, marco ardito <ardito at apiform.to.it> wrote:
>>> Hi, campbell,
>>>
>>> nice clean look! but... a TOC should be, well, a TOC, not a full index!
>>> :)
>>> look at the TOC page source. Something like that, with links... :) but
>>> that will be tuned later, I'm sure.
>>
>> Yep, this needs cleaning up, basic structure is there but need to
>> change how top-level categories show.
>>
>> Attempting to do this automatic isnt that valuable IMHO, once we do
>> final conversion re-arranging TOC isn't so hard.
>>
>>> about the look, it's clean but it needs some tweaking. Great job, anyway
>>> for an automatic conversion!
>>>
>>> I'm doing a wiki > pdf conversion since a while, updated each month. atm
>>> I stopped to see how the sphinx-doc trial went on, hoping that soon the
>>> old pdf could be no more needed!! great! converting the wiki in pdf is
>>> fun but also a pain :)
>>
>> With sphinx we can provide the HTML as a downloadable archive, IMHO
>> this is more usable then the PDF,
>> I generated a PDF for our sphinx python reference for a while but it
>> wasnt that great, I removed and dont think anyone noticed.
>>
>>> Do you have any pdf conversion test?
>>
>> I did do one, but cant recall if I uploaded- It does an OK job, but
>> image layout sometimes doesn't look right.
>>
>> Heres sphinx generated PDF, though there aren't any images.
>>
>> http://www.blender.org/documentation/blender_python_api_2_59_0/blender_python_reference_2_59_0.pdf
>>
>> To summarize we can have PDF book if we want, but I always found the
>> output inferior to the HTML docs.
>>
>>> Thanks, Marco
>>>
>>> Il 02/07/2014 23:29, Campbell Barton ha scritto:
>>>> Hi, quick update on the progress migrating the wiki,
>>>
>>>
>>>
>>>
>>> -------------------
>>> [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
>>
>>
>>
>> --
>> - Campbell
>> _______________________________________________
>> 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
>>
>
>
>
> --
> - Campbell
>
>
>
> _______________________________________________
> 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
>
--
- Campbell
More information about the Bf-docboard
mailing list