SocialCalc

hide

See 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:


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 Jan Galinski 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 Rick Scott on Mar 9 8:20am


Cheap websites Good to see your wiki is still going strong! always knew you would do great!

contributed by Guest User on Jan 19 3:56pm


sweet irena I got a error when i clicked on the download link. any help?

contributed by Guest User on Jan 21 5:46pm


Click this button to save this page to your computer for offline use. Created by Liz Henry on Mar 20 10:31am. Updated by Guest User on Jan 21 5:46pm. (39 revisions, 15,919 views)