SocialCalc
hideSee also: Socialcalc & wikiCalc history and SocialCalc Translations
For developers:
The core of SocialCalc is basically the Perl and JavaScript source
code for editing and rendering sheets. Remember, this code is
licensed under the Artistic License 2.0[1] which means you can freely
use, modify, and distribute it. You can also send us patches and get
involved by joining the Google Group.
The code in the core lives under the following directories in
socialcalc:
lib/SocialCalc - The Perl Code
jslib/SocialCalc - The JavaScript Code
share/socialcalc - Data files and such
What isn't in the SocialCalc Core?
Another great question! That would be anything not directly involved
in running the editing screen or rendering the HTML view of a
spreadsheet. This includes publishing sheets; site, host, and user
administration; interfaces for formatting, tools, and logging out;
scripts; distributed html and page templates; and build systems.
1 http://socialcalc.org/licenses/al-20
Developer Documentation
In addition to the comments in the code, there is some overview documentation of the main data structures and routines in the SocialCalc Core (also known as the SocialCalc Engine). This documentation assumes basic knowledge of Perl and Javascript as well as of operation of SocialCalc and spreadsheets in general. The documentation includes sample code so you can experiment with simple testbeds to learn how to embed the Engine into other products or to test modifications to the code.
The first public drafts of this documentation are attached to this page as "EngineDoc - 8.txt", "Engine JS Documentation - 6.txt", and "Engine_Example_Doc-2.txt". HTML versions may be found at:
- http://www.softwaregarden.com/products/wikicalc/socialcalc/EngineDoc-8.html
- http://www.softwaregarden.com/products/wikicalc/socialcalc/Engine_JS_Documentation-6.html
- http://www.softwaregarden.com/products/wikicalc/socialcalc/Engine_Example_Doc-2.html
Installing Socialcalc 1.1.0
On MacOSX
Download and unpack the files
- Download socialcalc
- You may need to also download Xcode
- untar xvf Socialcalc*
Install some extra stuff from CPAN. (I had to configure CPAN to use sudo ./Build instead of ./Build. )
- Perl -MCPAN -e shell
- look ExtUtils::MakeMaker
- perl Makefile.PL && make install; control-D to return to cpan shell
- look CPAN
- perl Makefile.PL && make install; quit
- Perl -MCPAN -e shell (restart the cpan shell)
- sudo cpan YAML
- install HTTP::Daemon
- install HTML::Tagset
- quit
If any other Perl modules are missing you would need to install them.
Installing Socialcalc 1.1.0 on Ubuntu
(Details should go here as I test on ec2)
Starting up Socialcalc
perl bin/socialcalc.pl will start Socialcalc, or under Windows, bin/socialcalcwin.pl. By default, the UI will be running locally and can be accessed by
http://127.0.0.1:6556/ .
You can also use bin/socialcalccgi.pl to run the server based version (or bin/socialcalcmodperl.pl under mod_perl).
To enable Socialcalc for network use, you can edit bin/socialcalc.pl. Future releases will make this easy to enable.
Once Socialcalc running, you can choose to do a demonstration setup, or configure Socialcalc in the UI for network use with information about your host, ftp, and network information.
License
SocialCalc 1.1 is released under the Socialtext Public License (STPL) and the next release will be under the Common Public Attribution License (CPAL). See Licensing for further information.
I am getting a 403 error while trying to download the 1.1.0 or the snapshot. Could you please fix it?
contributed by on Dec 12 6:05am
Sorry, Jan; the snapshots are currently inaccessible. Anonymous svn access should work to pull in the code, though. Web design
contributed by on Mar 9 8:20am
Cheap websites Good to see your wiki is still going strong! always knew you would do great!
contributed by on Jan 19 3:56pm
sweet irena I got a error when i clicked on the download link. any help?
contributed by on Jan 21 5:46pm