Install for python 27
 Installation stable version python2
 Configuration
 How to start
 Log of changes
 Problems with installation
 problems with NatLink
 Speech Model
 Ini file strategy
 Configure administrator rights
 Setting HOME
 Technical details
  Natlinkstatus
  Natlinkconfigfunctions
  Natlinkcorefunctions
  configure GUI
  Batch mode for configuration
  Installer
  Natlinkmain_vocola_main
  Natlinkmain
  Natlinkutils
  Nsformat
  Testing natlink
  Working with subversion
   Checkout example
   Relocate example
Installation experimental version python3
log of changes Python 3

Working with subversion (SVN)

Migration to new repositories

Summary

The new repositories for the projects NatLink, Unimacro and Voicecode are:

  • NatLink: https://svn.code.sf.net/p/natlink/code
  • Unimacro: https://svn.code.sf.net/p/unimacro/code
  • Voicecode: https://svn.code.sf.net/p/voicecode/code

and in all three repositories the trunk is used.

In all three cases you will be prompted for username (sourceforge id) and password. I am not aware of an anonymous login possibility.

Unimacro

Unimacro has on February 12, 2013 been moved to a new location. See new address above and more details below. For those who were on subversion for Unimacro before can do a "relocate" to https://svn.code.sf.net/p/unimacro/code and then click on the three dots and choose trunk. See example.

NatLink

NatLink has been moved to a new location (10 March 2013). Subversion update seems to work as normal, but when you commit things you will get the following message (assuming you use TortoiseSVN):

subversionerrormessagenatlink

You can do a subversion relocate to:

subversionnatlinkrelocate

Then enter the new location (please type in, no paste): https://svn.code.sf.net/p/natlink/code and then click on the three dots and choose trunk. See example.

VoiceCode

The same for voicecode (10 March 2013). Do a subversion relocate, and choose: https://svn.code.sf.net/p/voicecode/code and then click on the three dots and choose trunk. See example.

When all is succesfull, after having been prompted for your sourceforge password, you will get the following message:

voicecoderelocationsuccesfull

Why and how to work with subversion

If you want more recent versions of files than the latest release, or if you want to contribute to NatLink, possibly Vocola, or Unimacro, you should get your files from SourceForge with subversion.

  • First you need a sourceforge id (USERNAME and password), as far as I know no anonymous checkout is possible. Goto sourceforge and click on join top right.
  • Then get Tortoise SVN from tigris tortoisesvn.
  • Now remove the subdirectories of Unimacro and NatLink (in case of getting both with SVN) or either one of them. Leaving you in C:\NatLink. (Another starting point, like D:\NatLink is also possible and even recommended.)

These were the preliminaries. Now proceed (and study the example):

  • So now assume the root of NatLink is in C:\NatLink. And you have removed one or both subdirectories NatLink and Unimacro.

NatLink

  • For NatLink: right click on C:\NatLink and choose SVN checkout.
  • Fill in for URL of repository (please type in, no paste): https://svn.code.sf.net/p/natlink/code
  • click on the three dots and choose trunk*-choose for checkout directory *C:\NatLink\NatLink
  • you are probably prompted twice for loging (sourceforge id) and password

checking out NatLink with SVN (subversion)

Unimacro

  • For Unimacro: also right click on C:\NatLink and choose SVN checkout:
  • Fill in as repository (please type in, no paste): https://svn.code.sf.net/p/unimacro/code,
  • click on the three dots and choose trunk*-choose for checkout directory *C:\NatLink\NatLink
  • choose as checkout directory C:\NatLink\Unimacro,
  • you are probably prompted twice for loging (sourceforge id) and password

checking out Unimacro with SVN (subversion)

Voicecode

  • Similar actions are needed to get Voicecode: right click on C:\NatLink and choose SVN checkout:
  • Fill in as repository (please type in, no paste): https://svn.code.sf.net/p/voicecode/code,
  • click on the three dots and choose trunk*-choose for checkout directory *C:\NatLink\NatLink
  • choose as checkout directory C:\NatLink\Voicecode,
  • you are probably prompted twice for loging (sourceforge id) and password

checking out Voicecode with SVN (subversion)

Note: checking out Voicecode takes quite some time, you will be seeing the following for some time:

checking out Voicecode takes some time

Directory layout

After checking out NatLink (which includes Vocola), Unimacro and Voicecode (only for voice coders), you will see the following directory layout:

directory layout after subversion checkout

Vocola:

Note the Vocola files are in the NatLink repository.

Update

For updating you can right click on one of the folders and choose SVN update. You should do a separate Update for each of the three folders (if you checked them out).

Contribute: Commit

If you want to commit changes (contribute to one of the projects):

  • You probably are by now registered at SourceForge.net by now,
  • You need to get permission from one of the repository administrators to do so. Mail to Quintijn, see email link at the bottom of this page.

If that has been done, you can also commit changes by right clicking on the correct folder and choose commit. Your password for SourceForge will be asked once.

How to find configurenatlink.py or natlinkconfigfunctions.py

In case you checked out things in different folders, or didn't install the .exe installer before you took above steps, you will have to find the configure GUI or the configure command line interface in the Windows explorer.

Go to C:\NatLink\NatLink\confignatlinkvocolaunimacro.

  • With the python file start_configurenatlink.py you can start the config program, in "elevated" mode. Just run this python file by double clicking on it in an explorer window.
  • With the file start_natlinkconfigfunctions.py you start the command line interface, also in elevated mode. (See link(/installation/technicaldetails/natlinkconfigfunctions.html, "instructions on natlinkconfigfunctions").