Difference between revisions of "Inkscape-dev"

From X-Moto
Jump to: navigation, search
(TODO)
 
(75 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
[[Ca:Inkscape-dev|Català]] - [[Es:Inkscape-dev|Español]]
 +
 
----
 
----
=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.
 +
 
 +
=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
  
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.
+
==Using the svn==
  
By the way, the developpement version has only be tested under Linux. So, it may not work at all under other operating systems.
+
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.
 +
 
 +
*Mac OS X 10.4 Tiger: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.4-Tiger.dmg
 +
 
 +
*Mac OS X 10.5 Leopard: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.5-Leopard.dmg
 +
 
 +
*Mac OS X 10.6 Snow Leopard: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.6-SnowLeopard.pkg
 +
 
 +
*Mac OS X 10.7 Lion: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.7-Lion.pkg
 +
 
 +
*Mac OS X 10.8 Mountain Lion: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.8-MountainLion.pkg
 +
 
 +
==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:
  
* [http://www.inkscape.org/ Inkscape] (svn version)
+
svn
* [http://www.python.org/ Python] (>= 2.4)
 
* Svg2lvl converter and inkscape extension from cvs
 
$ cvs -z3 -d:pserver:anonymous@xmoto.cvs.sourceforge.net:/cvsroot/xmoto co -P xmoto/tools/svg2lvl/
 
  
= Pre-requesites =
+
Your terminal window should look like this, if it works properly:
  
You have to install the svg2lvl inkscape extension.
+
DarkSeph22:~ WeatherGameMan97$ svn
 +
Type 'svn help' for usage.
  
== GNU/Linux ==
+
==Getting the svn of Inksmoto==
  
We suppose that you have do the checkout into ~/xmoto-cvs/
+
Type in the URL repository, then the full path of where you want the files to go, like this:
  
  $ cd ~/xmoto-cvs/xmoto/tools/svg2lvl/
+
  svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions /Users/your username/Applications/Inkscape.app/Contents/Resources/extensions
$ mkdir -p ~/.inkscape/extensions/textures/
 
$ cp *.inx *.py ~/.inkscape/extensions/
 
$ cp textures/*.jpg ~/.inkscape/extensions/textures/
 
$ ln -s /usr/share/inkscape/extensions/bezmisc.py ~/.inkscape/extensions/bezmisc.py
 
$ ln -s /usr/share/inkscape/extensions/inkex.py ~/.inkscape/extensions/inkex.py
 
$ ln -s /usr/share/inkscape/extensions/embedimage.py ~/.inkscape/extensions/embedimage.py
 
  
Then, you can launch inkscape.
+
Once its all done, open up Inkscape and begin testing.
  
== TODO ==
+
=Inksmoto-dev Bug Tracker=
  
* change the way xmoto properties are handled in inkscape objects label. DONE
+
You can see the progress of the developement in the bug tracker:
* fix the xmoto level size. DONE
+
[http://todo.xmoto.tuxfamily.org/index.php?project=2 Inksmoto-dev Bug Tracker]
* show xmoto textures in Inkscape. DONE
 
* show xmoto sprites in Inkscape. IN PROGRESS
 
* use list of value in extensions windows. DONE
 
* allow xmoto to update texture informations when new textures are downloaded by xmoto. IN PROGRESS
 
* change the way inkscape object style is handled by svg2lvl extensions. IN PROGESS
 
* create an automatic installation for Unix and Windows. TODO
 

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