[Sputnik-list] Re: Sputnik Earth Beta

[Yuri Takhteyev]

I forgot to mention that a new version of versium-git is also out,
which means that you can now use Git to store Sputnik's history.

To do this, first install Sputnik the normal way.  If you already
created some nodes using the default storage module, delete everything
in the wiki-data directory, then initialize it as a git repository:

    cd wiki-data
    rm -rf wiki-data
    git init

Then install 'versium-git':

    ./bin/luarocks install
--from=http://sputnik.freewisdom.org/rocks/earth/ versium-git

Then add this to the parameters:

   VERSIUM_STORAGE_MODULE = 'versium.git',

In other words, you sputnik.ws should look like this:

    require('sputnik')
    return sputnik.new_wsapi_run_fn{
       VERSIUM_PARAMS = { '/yuri/sputnik/wiki-data/' },
       BASE_URL       = '/sputnik.ws',
       VERSIUM_STORAGE_MODULE = 'versium.git',
    }

Then run Sputnik the normal way.

Running sputnik over git gives you a few benefits:

1. Your data directory is now very clean.  Each node is a file (e.g.,
"Home_Page.lua"), sub-nodes are files in directories.  (This also
means you can just trivially dofile any of your data files if you want
to use the data in them bypassing Sputnik entirely.)
2. You can access your wiki history without the browser by just using
"git log" (e.g. "git log Home_Page.lua")
3. You can edit files by hand, then commit changes through git, and
those changes will then show up in Sputnik's history.
4. You can pull files from the server that runs Sputnik onto your
laptop, edit them locally in your favorite editor, commit, push, and
the changes will appear (with history!) in the Sputnik running on the
server.  (Or, you can sync data between two Sputniks - e.g., one
running on the server and one running locally.)
5. If you are doing 4 and meanwhile someone edits the data on the
server, you can actually merge them.

In other words, all the reasons why you already love git are now also
reasons to love Sputnik.

Sputnik over MySQL, SQLite and Subversion should hopefully be coming
shortly.  (The first two of those are ready, just need to be tested a
bit more.)

 - yuri

On Mon, Jun 23, 2008 at 2:21 AM, Yuri Takhteyev <yuri at sims.berkeley.edu> wrote:
> A more complete release of Sputnik "Earth" is here:
>
> On UNIX:
>
> cd into some directory (e.g., "cd ~/sputnik"), then run
>
>    wget http://sputnik.freewisdom.org/files/sputnik_install_2008_06_22.sh
>    sh sputnik_install_2008_06_22.sh
>    ./bin/xavante_start
>
> On Windows (not tested):
>
> 1. install Kepler 1.1
> 2. make a directory where you want to store the data (e.g., "wiki-data")
> 3. create a file called sputnik.ws in Kepler's "htdocs" directory that
> looks like this:
>
>    require('sputnik')
>    return sputnik.new_wsapi_run_fn{
>       VERSIUM_PARAMS = { 'c:/sputnik/wiki-data/' },
>       BASE_URL       = '/sputnik.ws',
>    }
>
> (Replace "c:/sputnik/wiki-data/" with the path to your directory
> wiki-data directory).
>
> This beta should be better than the previous (March 2008) release of
> Sputnik (last in "Dish of the Day" series), so I updated
> "Installation" page with those instructions and consider this "beta"
> to be the recommended version now.  I am calling it "beta" for now,
> since there are a few more changes I want to make to "earth" before I
> close it.
>
>  - yuri
>
> --
> http://sputnik.freewisdom.org/
>



-- 
http://sputnik.freewisdom.org/