test

________________________________
 From: Tawez <[email protected]>
To: [email protected] 
Cc: [email protected] 
Sent: Friday, November 30, 2012 1:10 PM
Subject: [sphinx-users] Re: OS independent make script
 

Please find attached an example of make.py script.

This is extracted universal building script based on make.bat, Makefile and our 
internal experiences.
It may looks a bit complicated at the first time, but this solution is flexible 
enough to cover most of the needs if you want to customize building process.


Target is a function, so if you want to disable a target just delete it or 
comment out it.
If you want to add new target, just add new function.
Help is generated dynamicaly, so no additional actions are required, just add 
your target function and document it.

Some use cases:
        * html - simple example

        * latex - target witt command line options

        * latexpdf - target that calls another target

        * clean

I've tested it on Win7(64bit), Py2.7.3(32bit), Sphinx1.1.3

I will test it on MacOSX but more tests are needed.
If someone can help, please get the script and test it on your Sphinx projects.
Some configuration will be needed.

It depends on the particular project, but BUILDDIR and SOURCEDIR (lines 6-7) 
should be enough.
If you want to test qthelp target, change .qhcp and .qhc file names to propper 
(lines 58,60).


I think that it could be merged with Sphinx (quickstart.py) right now,
but I'm looking forward for your feedback before i will make pull request.

--
Regards
Tawez


On Thursday, August 23, 2012 11:32:02 PM UTC+2, Tawez wrote:
I am working with the team on quite a big project that utilizes Sphinx.
>We have a heterogeneous environment (Win, Linux, Mac OS X).
>
>
>We had to change a bit the make script to fit it to our requirements.
>Doing it twice (make.bat and Makefile) is not so user friendly and it is hard 
>to maintain.
>Moreover, it is not possible to do everything in Windows shell.
>
>
>So, why not to use Python to write make script?
>IMHO it sounds more natural.
>
>
>This is what we have done actually.
>We've got make.py that runs on every team machine.
>It is specific to our project, but I think it will be easy to extract 
>universal core similar to the current make scripts.
>
>
>Sounds interesting?
>I'm waiting for Your opinions.
>
>
>--
>Tawez
-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
Visit this group at http://groups.google.com/group/sphinx-users?hl=en.

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-users" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
Visit this group at http://groups.google.com/group/sphinx-users?hl=en.


Reply via email to