With some help from Hashar and Marktraceur I added some new CI build jobs for some fundraising stuff -- I noticed we had a job that indicates it'll build sphinx documentation so I figured I might as well add that and see where I get.
... Which is not very far -- the build fails with
*19:11:58* + python setup.py build_sphinx*19:11:58* python: can't open file 'setup.py': [Errno 2] No such file or directory
This makes sense; I don't have a setup.py file. But I cannot create it because I also don't know what's expected to be in that file and there doesn't seem to be anything on wikitech about this...
I've used sphinx before via makefile and sphinx-build but clearly we are doing something different. Guidance please! :D
~Matt Walker Wikimedia Foundation Fundraising Technology Team
I actually answered my own question mostly.
Sartoris seems to be the only project with that job enabled; and it's using python's setuptools to run sphinx.
Given that my stuff is predominantly PHP and I was just going to use sphinx for nice looking documentation that's not wiki based; I'm not sure I want to introduce a setuptools dependency.
Any thoughts about using some sort of documentation makefile? /me has to go read up on how we automatically build the doxygen stuff.
~Matt Walker Wikimedia Foundation Fundraising Technology Team
On Tue, Feb 4, 2014 at 2:31 PM, Matthew Walker mwalker@wikimedia.orgwrote:
With some help from Hashar and Marktraceur I added some new CI build jobs for some fundraising stuff -- I noticed we had a job that indicates it'll build sphinx documentation so I figured I might as well add that and see where I get.
... Which is not very far -- the build fails with
*19:11:58* + python setup.py build_sphinx*19:11:58* python: can't open file 'setup.py': [Errno 2] No such file or directory
This makes sense; I don't have a setup.py file. But I cannot create it because I also don't know what's expected to be in that file and there doesn't seem to be anything on wikitech about this...
I've used sphinx before via makefile and sphinx-build but clearly we are doing something different. Guidance please! :D
~Matt Walker Wikimedia Foundation Fundraising Technology Team
wikitech-l@lists.wikimedia.org