Difference between revisions of "Inkscape-dev"

From X-Moto
Jump to: navigation, search
(Code documentation)
(TODO)
 
(25 intermediate revisions by 5 users not shown)
Line 8: Line 8:
  
 
This version of Inksmoto Level Editor is not stable and not fully tested, but you can test it anyway.
 
This version of Inksmoto Level Editor is not stable and not fully tested, but you can test it anyway.
 
Svg made with the 0.2.0 version of Inksmoto Level Editor are not compatible with this developement version of Inksmoto Level Editor.
 
  
 
=Required softwares =
 
=Required softwares =
  
The next version of Inksmoto will require Inkscape 0.46. This version of Inkscape no longer uses python-xml, but lxml instead. Tk is still needed. And python too (don't know the minimum required version required, but Inkscape 0.46 is packaged with python 2.5).
+
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 (=0.46)
+
*inkscape
*python (=2.5)
+
*python
 
*python-lxml
 
*python-lxml
*python-tk
+
*python-gtk2
*python-imaging-tk
+
*libglade2-0
  
 
=Installation on Linux =
 
=Installation on Linux =
Line 25: Line 23:
  
 
For example on a debian/ubuntu:
 
For example on a debian/ubuntu:
  sudo apt-get install inkscape python python-lxml python-tk python-imaging-tk
+
  sudo apt-get install inkscape python python-lxml python-gtk2 libglade2-0
 
 
==Using the .deb file==
 
 
 
Under debian/ubuntu, you can use this .deb file to install Inksmoto with the command line or graphically:
 
 
 
*Command line:
 
wget http://download.tuxfamily.org/xmoto/svg2lvl/dev/inksmoto-0.5.0~svn-1.deb
 
sudo dpkg -i inksmoto-0.5.0~svn-1.deb
 
 
 
*Graphically:
 
** download the .deb file http://download.tuxfamily.org/xmoto/svg2lvl/dev/inksmoto-0.5.0~svn-1.deb
 
** double click on it from the file explorer to install it (with GDebi)
 
 
 
Warning:
 
'''If you have previously installed the svn version in your home dir, you should better delete it''':
 
rm -rf ~/.inkscape/extensions
 
  
 
==Using the svn==
 
==Using the svn==
Line 51: Line 33:
 
  svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions
 
  svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions
  
= Installation on Windows =
+
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
  
==Using the generated setup==
+
=Installation on Windows=
  
Just download and execute this executable: http://download.tuxfamily.org/xmoto/svg2lvl/dev/Inkscape-0.46_inksmoto-0.5.0~svn_win32.exe
+
== 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.
  
==Manual installation==
+
== 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
  
===Download===
+
== Step 1. Get Tortoise SVN ==
 +
Download the installer here: [http://tortoisesvn.net/downloads Tortoise SVN] Install it.
  
*Python 2.5: http://python.org/ftp/python/2.5.2/python-2.5.2.msi
+
== Step 2. Checkout ==
*PIL 1.1.6: http://effbot.org/downloads/PIL-1.1.6.win32-py2.5.exe
+
Make sure that you remove the old inksmoto files from the extensions folder before proceeding.
*Inkscape 0.46: http://downloads.sourceforge.net/inkscape/Inkscape-0.46.win32.exe
+
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.
  
===Install them===
+
== Step 3. Testing ==
 +
Open Inkscape and begin testing and developing. voila!
  
Install them by double clicking on the .exe/.msi files.
+
=Installation on Mac OS X=
 
 
===Copy===
 
  
Copy those files/directories from your Python 2.5 installation into your Inkscape 0.46 installation:
+
There is a way to get the svn of Inksmoto for Mac OS X.
C:\Python25\Lib\lib-tk in C:\Program Files\Inkscape\python\Lib\
 
C:\Python25\DLLs\_tkinter.pyd in C:\Program Files\Inkscape\python\DLLs\
 
C:\Python25\DLLs\tk84.dll in C:\Program Files\Inkscape\python\DLLs\
 
C:\Python25\DLLs\tcl84.dll in C:\Program Files\Inkscape\python\DLLs\
 
C:\Python25\tcl in C:\Program Files\Inkscape\python\
 
C:\Python25\site-packages\PIL in C:\Program Files\Inkscape\python\Lib\site-packages\
 
C:\Python25\site-packages\PIL.pth in C:\Program Files\Inkscape\python\Lib\site-packages\
 
  
===Download===
+
==Required software==
  
Svn Inksmoto: http://svn.tuxfamily.org/viewvc.cgi/xmoto_svg2lvl/trunk/extensions.tar.gz?view=tar
+
*Apple's Mac OS X
 +
*MacPorts
 +
*Inkscape
 +
*Subversion(MacPort's Port)
  
===Install===
+
==Downloading and installing MacPorts==
  
Extract extensions.tar.gz with ''7z'' or ''WinRar''.
+
Download the right version of MacPorts for your Mac OS X version.
Then copy the content of the extracted ''extensions'' directory into:
 
  C:\Program Files\Inkscape\share\extensions\
 
(It will ask you if you want to replace existed ''inkex.py'' and ''bezmisc.py'', you can do it, as they are the same as the one from Inksmoto)
 
  
===Remove old version of Inksmoto===
+
*Mac OS X 10.4 Tiger: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.4-Tiger.dmg
  
If you have installed previous svn versions of Inksmoto, to avoid potentials conflicts, you should better delete this directory:
+
*Mac OS X 10.5 Leopard: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.5-Leopard.dmg
C:\Documents And Settings\<Your Name>\Application Data\Inkscape\extensions\
 
  
==Updating the svn version==
+
*Mac OS X 10.6 Snow Leopard: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.6-SnowLeopard.pkg
  
===Download===
+
*Mac OS X 10.7 Lion: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.7-Lion.pkg
  
Latest svn Inksmoto: http://svn.tuxfamily.org/viewvc.cgi/xmoto_svg2lvl/trunk/extensions.tar.gz?view=tar
+
*Mac OS X 10.8 Mountain Lion: https://distfiles.macports.org/MacPorts/MacPorts-2.1.3-10.8-MountainLion.pkg
  
===Install===
+
==Installing Subversion==
  
Extract extensions.tar.gz with ''7z'' or ''WinRar''.
+
After installing MacPorts, open up Terminal.app, and type in:
Then copy the content of the extracted ''extensions'' directory into:
 
  C:\Program Files\Inkscape\share\extensions\
 
(It will ask you if you want to replace existed ''inkex.py'' and ''bezmisc.py'', you can do it, as they are the same as the one from Inksmoto)
 
 
 
=Installation on Mac OS X=
 
  
==Download==
+
sudo port install subversion
*Python 2.5: http://pythonmac.org/packages/py25-fat/dmg/python-2.5-macosx.dmg
 
*PIL 1.1.6: http://pythonmac.org/packages/py25-fat/dmg/PIL-1.1.6-py2.5-macosx10.4-2007-05-18.dmg
 
*Inkscape 0.46:
 
** Leopard: http://downloads.sourceforge.net/inkscape/Inkscape-0.46-2.LEOPARD.UNIVERSAL.dmg
 
** Tiger: http://downloads.sourceforge.net/inkscape/Inkscape-0.46-3.TIGER.UNIVERSAL.dmg
 
  
==Install==
+
After its done, to make sure subversion is working, type in:
  
Install them.
+
svn
  
==Download Inksmoto==
+
Your terminal window should look like this, if it works properly:
  
Svn Inksmoto: http://svn.tuxfamily.org/viewvc.cgi/xmoto_svg2lvl/trunk/extensions.tar.gz?view=tar
+
DarkSeph22:~ WeatherGameMan97$ svn
[edit]
+
Type 'svn help' for usage.
  
==Install Inksmoto==
+
==Getting the svn of Inksmoto==
  
Extract extensions.tar.gz with the appropriate Mac OS X tool. Then copy the content of the extracted extensions directory into:
+
Type in the URL repository, then the full path of where you want the files to go, like this:
  
  /<look on a macosx to know the inkscape installation directory>/extensions/
+
  svn co svn://svn.tuxfamily.org/svnroot/xmoto/svg2lvl/trunk/extensions /Users/your username/Applications/Inkscape.app/Contents/Resources/extensions
  
(It will ask you if you want to replace existed inkex.py and bezmisc.py, you can do it, as they are the same as the one from Inksmoto)
+
Once its all done, open up Inkscape and begin testing.
  
= TODO =
+
=Inksmoto-dev Bug Tracker=
  
You can see the progress of the developpement in the bug tracker:
+
You can see the progress of the developement in the bug tracker:
http://todo.xmoto.tuxfamily.org/index.php?project=2&do=index
+
[http://todo.xmoto.tuxfamily.org/index.php?project=2 Inksmoto-dev Bug Tracker]

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