When you are ready to publish a new version of your dictionary, you can upload the new version to SooSL Web from inside SooSL Desktop. This will replace the old version with your new one. 

This upload only works if you have already published the dictionary on SooSL Web. If you want to publish your dictionary for the first time, see this topic.

Important: We will not keep a copy of the old version on SooSL Web. Once you upload the new version, the old version is gone permanently from our website. If you need a copy of the old version, you should keep a copy of it yourself on your own computer.

How to upload a new version of your dictionary

The first thing you need is a user account on SooSL Web. Normally people get a user account in order to see private dictionaries. You also need a user account to upload a new version of a dictionary. Read about how to get a user account here.

After you have the user account, write to [email protected] and tell us your username and which dictionary you want to upload. We will only let you upload a dictionary if you own it or if the owner has given you permission to upload it. We will tell you when SooSL Web is ready for you to start uploading.

Here is how to upload a new version of a dictionary:

• Open SooSL Desktop.
• Open the dictionary that you want to upload.
• Check Tools > About Dictionary. Make sure the information is correct. Especially, check the version number; it should be different from previous versions. You can include either a version number (such as "1.0") or a date or both.
• Click Tools > Upload dictionary. You will see a dialog like this:
  
• If this is the first time you have tried to upload a dictionary, you need to enter your SooSL Web username and password. Click on the gear icon in the lower left. The dialog will change, with new information at the bottom that you can change.
  
  "Upload to:" should normally be "https://api-web.soosl.net/". Fill in the username and password that you use with SooSL Web. Click the closed eye icon to see your password. If you want SooSL to remember your username and password, check the box in front of "Remember username and password". Then, you won't have to enter it again. (SooSL stores your password securely.) Later, if you ever want to upload a dictionary with a different username, you can change it here.
• Click .
• If you have permission to upload both a public and a private version of the same dictionary on SooSL Web, SooSL will ask you which one you want to replace. 
• While you are developing a new version of the dictionary, you can upload it frequently to the private version. That way, people working with you can see the most recent changes. Other people will see only the public version.
• When you are ready to publish the new version for everyone, you can upload it to the public version.
• If someone else is uploading the same dictionary at the same time, SooSL will tell you the dictionary is locked and who locked it. It can take up to twelve hours for a lock to expire. You must first wait for the lock to expire or for someone else to cancel the upload. Before you try again, talk to the other person to make sure you don't over-write their work. 
• If everything works correctly, the upload will start and you will see a listing showing its progress, something like this:
  
• When it says "All files have now been uploaded", click to close the dialog box.
• SooSL Web will install your new version. When it is done installing and ready for people to see, SooSL Web will send you an email. Usually this takes just a few minutes.
• You should export a copy of this version of the dictionary to a ZooZL file. That way, you can keep a copy of what you just uploaded. Maybe the copy on the website will get damaged sometime. If so, you may need to upload it again. That's why it is good to save the database in a ZooZL file each time you upload it. 
• Finally, change the version number of the dictionary in SooSL Desktop. Then you can start making changes for the next version.
• If the upload doesn't work correctly, the dialog box will tell you what is wrong. If you don't understand the problem, take a screenshot of the dialog box and send it to us at [email protected]. We will help you.
• Sometimes the upload gets interrupted. Maybe the power goes off. Maybe you lose internet. Just try again later. If you do so within 12 hours, SooSL will save your work and will only upload the signs that didn't get uploaded the first time. After 12 hours, it will start uploading all files again, from the beginning.

Created with the Personal Edition of HelpNDoc: Full-featured EPub generator