Problem with documentation

[Tomaaz]

I've tried to edit EGSL documentation and, unfortunately, I'm not able to do it. Chromium crashes. IE and Firefox let me edit, but I can't save any changes. I thought that the problem was only on Linux, but on Windows 7 is exactly the same. I've got Java installed (the script uses it, right?). Any ideas? Of course I was trying with a copy saved on my disc.

[Cybermonkey]

Hm, it works with Firefox on Windows 7 and Linux here. Maybe there is a WoaS hint about that issue?

[Tomaaz]

After reinstalling Java, Chromium doesn't crash any more, but I still can't save anything. During opening the document I get a message WoaS unhandled error. Save failure during integrity test., but the page is displayed correctly. Then when I want to edit and save changes to the document I get a message that my browser (in all cases - IE, Chromium or Firefox) might be not supported. In WoaS documentation I've found something like this: "The first time you save a change to Wiki on a Stick, your browser will ask for permission to save data to the disk. This is normal and necessary for the wiki to make changes to itself. You can give permission each time or make the setting permanent." My browsers don't ask me anything. They just display messages about an error. I've tried to change security settings in each browser, but nothing works. Any ideas? I'd like to make it work on Windows. I don't want to even think about fixing it on Linux...

[Cybermonkey]

Hm, it doesn't need Java but Javascript. Is this enabled? My browser asks my every time for permission.

[Tomaaz]

It uses Java. I even got a message that I had an old version installed. JavaScript doesn't have an access to a hard drive. That's why it needs Java. To save changes to the the disk. And it looks like this is something that doesn't want to work on my systems. Markus, could you disable Java and try to edit the document without it?

[Cybermonkey]

Oh funny. If I load the html site it says now

WoaS Unhandled error
----
Save failure during integrity test
/home/markus/Dokumente/EGSL-Documentation

Now I enable Java agin.

[Cybermonkey]

And I got the same error message. Seems to be rather a problem with the file here. I'll try it at home again this evening.

[Cybermonkey]

Okay, I tried it and turned Java off (on Linux Mageia 2 64 Bit): everything works fine; I can change and save the documentation.

[Tomaaz]

This is really strange. I don't have Java on one of my Linux laptops and while loading that page (I tried Firefox, Chromium and Seamonkey) I get a message about a missing plug-in. And the missing plug-in is Java Runtime Environment (see screenshot). Are you sure you disabled Java? How is it possible that JavaScript has access to your hard drive? From Wikipedia:

JavaScript and the DOM provide the potential for malicious authors to deliver scripts to run on a client computer via the web. Browser authors contain this risk using two restrictions. First, scripts run in a sandbox in which they can only perform web-related actions, not general-purpose programming tasks like creating files.

EDIT: I checked WoaS forum and documentation and found out that it uses a TiddlySaver.jar applet, but the documentation is very outdated.

[Cybermonkey]

Yes I disabled Java IcedTea plugin in Firefox. Maybe it needs a java runtime anyway?

[Tomaaz]

I think I know what the problem is. To edit this file you need to have all WoaS files already on your machine, not only the one html file that you get when save EGSL documentation to the hard drive. I downloaded WoaS, placed EGSL documentation in its folder and then finally got several security messages about running Java file (TiddlySaver.jar is included in WoaS folder). Markus... what about using something else for EGSL documentation?

[Cybermonkey]

The funny thing is I don't have this TiddlySaver.jar in my folder and it works anyway. Did you place the images into that folder? I have attached now my working copy from my harddisk.

[Tomaaz]

It doesn't work without TiddlySaver on my machines. I'm able to edit documentation with TiddlySaver, but do you really want to keep using this format?

[Cybermonkey]

I got no time to learn another software. The only other program I would use is LibreOffice but that would result in an offline documentation.

[Tomaaz]

I tried to use a simple CMS for EGSL documentation. Here is an example: http://egsl.ct8.pl/screen/. It's based on GetSimple CMS. The main advantage is that it can be fast and easily edited online. It's also much lighter than WoaS and probably will work better with mobile devices. What do you think?