Difference between revisions of "Inkscape-dev"

From X-Moto
Jump to: navigation, search
(TODO)
 
(68 intermediate revisions by 6 users not shown)
Line 2: Line 2:
  
 
----
 
----
=Documentation for the developpement version of svg2lvl=
+
=Documentation for the developpement version of Inksmoto Level Editor=
 
----
 
----
  
 
=Disclaimer=
 
=Disclaimer=
  
This version of svg2lvl is not stable and not fully tested, but you can test it anyway. It requires Inkscape functionnalities that will be available in the next version of Inkscape, so to test this svg2lvl version, you have to compile Inkscape from source.
+
This version of Inksmoto Level Editor is not stable and not fully tested, but you can test it anyway.
  
See [http://wiki.inkscape.org/wiki/index.php/WorkingWithSVN Inkscape svn] to get Inkscape source code and [http://wiki.inkscape.org/wiki/index.php/Category:Developer_Documentation Inkscape developper documentation] to compile it.
+
=Required softwares =
 +
 
 +
The next version of Inksmoto will require Inkscape 0.46 or 0.47 This version of Inkscape no longer uses python-xml, but lxml instead. PyGtk is now needed instead of Tk. And python too (don't know the minimum required version required, but Inkscape 0.46 is packaged with python 2.5).
 +
*inkscape
 +
*python
 +
*python-lxml
 +
*python-gtk2
 +
*libglade2-0
 +
 
 +
=Installation on Linux =
 +
 
 +
==Installation of the prerequisites==
 +
 
 +
For example on a debian/ubuntu:
 +
sudo apt-get install inkscape python python-lxml python-gtk2 libglade2-0
 +
 
 +
==Using the svn==
  
Svg made with the 0.2.0 version of svg2lvl are not compatible with this developement version of svg2lvl.
+
run:
 +
sudo apt-get install subversion
 +
mkdir ~/.inkscape
 +
cd ~/.inkscape
 +
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions
  
=Required softwares =
+
for newer versions of inkscape using xdg basedirs (e.g. Inkscape 0.47):
 +
sudo apt-get install subversion
 +
mkdir ~/.config/inkscape
 +
cd ~/.config/inkscape
 +
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions
 +
 
 +
=Installation on Windows=
 +
 
 +
== General ==
 +
There is another way to get it too, this one illustartes the way to get it with Tortoise SVN so that you can easily update to the newest version.
 +
 
 +
== Things needed ==
 +
You need:
 +
* Microsoft Windows
 +
* Tortoise SVN (or another svn program, I like tortoise best)
 +
* patience... (not really)
 +
* Latest official Inksmoto and Inkscape installed
 +
 
 +
== Step 1. Get Tortoise SVN ==
 +
Download the installer here: [http://tortoisesvn.net/downloads Tortoise SVN] Install it.
 +
 
 +
== Step 2. Checkout ==
 +
Make sure that you remove the old inksmoto files from the extensions folder before proceeding.
 +
Go to your Inkscape installation directory and there to the share folder, for example:
 +
*"C:\Program Files\Inkscape\share\"
 +
Then Right-Click the extensions folder to see the context menu of windows, you should see the tortoise svn and a button which says: "SVN Check out...".
 +
* URL of repository: svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions/
 +
* Checkout directory: [install dir]\share\extensions
 +
Click Ok. Wait... It will download all the files needed and then you are done. Just open inkscape and voila.
 +
 
 +
== Step 3. Testing ==
 +
Open Inkscape and begin testing and developing. voila!
 +
 
 +
=Installation on Mac OS X=
 +
 
 +
There is a way to get the svn of Inksmoto for Mac OS X.
 +
 
 +
==Required software==
 +
 
 +
*Apple's Mac OS X
 +
*MacPorts
 +
*Inkscape
 +
*Subversion(MacPort's Port)
 +
 
 +
==Downloading and installing MacPorts==
 +
 
 +
Download the right version of MacPorts for your Mac OS X version.
  
* [http://www.inkscape.org/ Inkscape] (0.45 or later or svn version)
+
*Mac OS X 10.4 Tiger: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.4-Tiger.dmg
* [http://www.python.org/ Python] (>= 2.3)
 
* Svg2lvl converter and inkscape extension from cvs
 
$ cvs -z3 -d:pserver:anonymous@xmoto.cvs.sourceforge.net:/cvsroot/xmoto co -P svg2lvl/
 
  
= Pre-requesites =
+
*Mac OS X 10.5 Leopard: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.5-Leopard.dmg
  
You have to install the svg2lvl inkscape extension.
+
*Mac OS X 10.6 Snow Leopard: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.6-SnowLeopard.pkg
  
== GNU/Linux ==
+
*Mac OS X 10.7 Lion: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.7-Lion.pkg
  
We suppose that you have do the checkout into ~/xmoto-cvs/
+
*Mac OS X 10.8 Mountain Lion: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.8-MountainLion.pkg
  
$ cd ~/xmoto-cvs/svg2lvl/
+
==Installing Subversion==
$ mkdir -p ~/.inkscape/extensions/
 
$ cp -rf * ~/.inkscape/extensions/
 
  
Then, you can launch inkscape.
+
After installing MacPorts, open up Terminal.app, and type in:
  
== MacosX ==
+
sudo port install subversion
  
You have to install PyXML. See http://wiki.inkscape.org/wiki/index.php/CompilingMacOsX#Enabling_python_effects for an howto.
+
After its done, to make sure subversion is working, type in:  
  
Then, install svg2lvl the same way as under GNU/Linux.
+
svn
  
== Windows 95 & 98 ==
+
Your terminal window should look like this, if it works properly:
  
Copy all the file from the cvs into the share/extensions/ directory of the inkscape installation.
+
DarkSeph22:~ WeatherGameMan97$ svn
(It will ask if you want to override the inkex.py and bezmisc.py files, answer no)
+
Type 'svn help' for usage.
  
Then, you can launch inkscape.
+
==Getting the svn of Inksmoto==
  
== Windows 2000 & XP ==
+
Type in the URL repository, then the full path of where you want the files to go, like this:
  
Copy all the files from cvs into the C:\Documents And Settings\<USER>\Applications Data\Inkscape\extensions\ directory.
+
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions /Users/your username/Applications/Inkscape.app/Contents/Resources/extensions
  
Then, you can launch inkscape.
+
Once its all done, open up Inkscape and begin testing.
  
= TODO =
+
=Inksmoto-dev Bug Tracker=
  
* show xmoto textures in Inkscape. DONE
+
You can see the progress of the developement in the bug tracker:
* show xmoto sprites in Inkscape. IN PROGRESS
+
[http://todo.xmoto.tuxfamily.org/index.php?project=2 Inksmoto-dev Bug Tracker]
* allow xmoto to update texture informations when new textures are downloaded by xmoto. IN PROGRESS
 
* create an automatic installation for Unix and Windows. TODO
 
* allow inkscape to open .lvl files. IN PROGRESS
 

Latest revision as of 17:03, 11 June 2013

Català - Español


Documentation for the developpement version of Inksmoto Level Editor


Disclaimer

This version of Inksmoto Level Editor is not stable and not fully tested, but you can test it anyway.

Required softwares

The next version of Inksmoto will require Inkscape 0.46 or 0.47 This version of Inkscape no longer uses python-xml, but lxml instead. PyGtk is now needed instead of Tk. And python too (don't know the minimum required version required, but Inkscape 0.46 is packaged with python 2.5).

  • inkscape
  • python
  • python-lxml
  • python-gtk2
  • libglade2-0

Installation on Linux

Installation of the prerequisites

For example on a debian/ubuntu:

sudo apt-get install inkscape python python-lxml python-gtk2 libglade2-0

Using the svn

run:

sudo apt-get install subversion
mkdir ~/.inkscape
cd ~/.inkscape
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions

for newer versions of inkscape using xdg basedirs (e.g. Inkscape 0.47):

sudo apt-get install subversion
mkdir ~/.config/inkscape
cd ~/.config/inkscape
svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions

Installation on Windows

General

There is another way to get it too, this one illustartes the way to get it with Tortoise SVN so that you can easily update to the newest version.

Things needed

You need:

  • Microsoft Windows
  • Tortoise SVN (or another svn program, I like tortoise best)
  • patience... (not really)
  • Latest official Inksmoto and Inkscape installed

Step 1. Get Tortoise SVN

Download the installer here: Tortoise SVN Install it.

Step 2. Checkout

Make sure that you remove the old inksmoto files from the extensions folder before proceeding. Go to your Inkscape installation directory and there to the share folder, for example:

  • "C:\Program Files\Inkscape\share\"

Then Right-Click the extensions folder to see the context menu of windows, you should see the tortoise svn and a button which says: "SVN Check out...".

Click Ok. Wait... It will download all the files needed and then you are done. Just open inkscape and voila.

Step 3. Testing

Open Inkscape and begin testing and developing. voila!

Installation on Mac OS X

There is a way to get the svn of Inksmoto for Mac OS X.

Required software

  • Apple's Mac OS X
  • MacPorts
  • Inkscape
  • Subversion(MacPort's Port)

Downloading and installing MacPorts

Download the right version of MacPorts for your Mac OS X version.

Installing Subversion

After installing MacPorts, open up Terminal.app, and type in:

sudo port install subversion

After its done, to make sure subversion is working, type in:

svn

Your terminal window should look like this, if it works properly:

DarkSeph22:~ WeatherGameMan97$ svn
Type 'svn help' for usage.

Getting the svn of Inksmoto

Type in the URL repository, then the full path of where you want the files to go, like this:

svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions /Users/your username/Applications/Inkscape.app/Contents/Resources/extensions

Once its all done, open up Inkscape and begin testing.

Inksmoto-dev Bug Tracker

You can see the progress of the developement in the bug tracker: Inksmoto-dev Bug Tracker