I don't want to generate documentation for maya and pymel.  Just our own
custom python modules.  I can do that with sphinx but obviously all our
python module inport pymel.  imports using pymel or openmaya crash the
builder.  I'll give this ago,

Cheers Chad

-Dave

On Fri, Jan 8, 2010 at 4:17 PM, Chad Dombrova <[email protected]> wrote:

> here's a little trick i learned.  go to where you unzipped pymel, where the
> setup.py file resides. then try:
>
> mayapy setup.py easy_install sphinx
>
> btw, generating documentation for pymel and maya is not a simple test case.
>  you should pick something a bit simpler.  we actually use a modified
> version of their latest development version from bitbucket along with a lot
> of custom templates to get it to work properly.  sphinx still has a ways to
> come before it's a robust API-style documentation generator.
>
> -chad
>
>
>
> On Jan 8, 2010, at 6:35 AM, David Moulder wrote:
>
> Got a little further with this.
>
> Sphinx works if I don't import anything importing OpenMaya (Pymel being on
> of these)
>
> I think I need to install Sphinx with Mayapy.   Only thing I can't seem to
> work that out.  I can only install setupTools against my default Python
> install with the SetupTools.exe  I tried using eay_install to -d flag to put
> sphinx into Maya's site packages.   But that errors becase of C:\Program
> Files (x86) has a space....
>
> Anyone?
>
>
> Cheers
> -Dave
>
>
> On Fri, Jan 8, 2010 at 10:21 AM, thirstydevil <[email protected]>wrote:
>
>> Hi Guys and Gals,
>>
>> I'm trying to get Sphinx to auto document our modules here at work.
>> However I'm running into problems with the build.
>>
>> While I'm testing I've just created a simple py file that imports
>> pymel, cmds, os, sys.  A basic class with some dummy functions and
>> test doc strings.
>>
>> in the config,py file I've added pymel, maya(from maya's site-
>> packages) and the path the my py file.
>> I've created .rst file for my module
>>
>> Paths added in the config file are :-
>>
>> # Paths to my modules
>> sys.path.append(os.path.abspath("E:\\CODE\\SVN_Branch\\Maya\
>> \Maya_Modules\\Modules\\CoreLibs\\PyLib"))
>> sys.path.append(os.path.abspath("E:\\CODE\\SVN_Branch\\Maya\
>> \Maya_Modules\\Modules\\CoreLibs\\PyLib\\eCore"))
>> # Pymel path
>> sys.path.append(os.path.abspath("C:\\ArtPipelines\\App\\Maya2010-
>> x86"))
>> # Maya Path
>> sys.path.append(os.path.abspath("C:\\Program Files (x86)\\Autodesk\
>> \Maya2010\\Python\\lib\\site-packages"))
>>
>> index.rst :-
>>
>> :mod:`eGeneral`
>> ==========================================
>>
>> .. module:: eGeneral
>>   :synopsis: Test synopsis
>>
>> .. automodule:: eCore.eGeneral
>>
>>
>>  and linked it into the toctree in index.rst
>>
>> Contents:
>>
>> .. toctree::
>>   :maxdepth: 1
>>
>>   modules/eFile.rst
>>
>>
>> Then I run >>>$sphinx-build . html
>> and get the followinh error.  Can't import/find module
>> "eCore.eGeneral", DLL load failed: The specified proceedure could not
>> be found. check the sys.path
>>
>> I used easy_install and installed sphinx to my system python 2.6.  I
>> wonder if I need to install this to Maya's mayapy.
>>
>> Anyone got any tips or ideas would be much appreciated.
>>
>> Thanks people
>>
>> -Dave
>>
>> --
>> http://groups.google.com/group/python_inside_maya
>>
>
> --
> http://groups.google.com/group/python_inside_maya
>
>
>
> --
> http://groups.google.com/group/python_inside_maya
>
-- 
http://groups.google.com/group/python_inside_maya

Reply via email to