Fenchurch (000016)

Fenchurch is an iteration of Sputnik development in Fall 2008 and Winter 2009. It offers a simpler administration interface, built-in search and better responsiveness.

This version is stable, but is a "pre-release" in the sense that there are a few small bugs that we want to fix before the release. Some of the plugins have not yet been ported.

New Features

9.03.16

  • better forums
  • fixed collections

9.03.03

  • non-existent pages offer links to create nodes of specific types
  • the tool bar is configurable (and can be with or without icons)
  • "configure" command is separated from the "edit" command
  • the default edit UI is simplified
  • much better infrastructure for adding javascript editors
  • a script to create CGI files and launch xavante, plus a general CLI framework
  • a @Discussion node type allows creation of forum nodes
  • Collections can be created from a blank page
  • login and logout use sputnik/login and sputnik/logout nodes
  • system node names are configurable
  • bug fixes

9.02.16

  • installation without compilation (see below)
  • better error handling
  • built-in search (simple and slow)
  • simpler admin interface
  • better reponsiveness
  • a listing of config nodes (see sputnik)
  • menu can now be on the side
  • support for jquery-driven accordion menus
  • permissions are now more extensible and support groups
  • debian-friendly icons
  • interwiki links
  • per-node markup configuration
  • lbase64 no longer needed
  • support for Collections

Installing Fenchurch

To get the absolutely latest version of Sputnik Fenchurch, get the Source (use "mainline"). Meanwhile, here is how you can install the last pre-release:

Step 1. Install Lua and Binary Dependencies

You will need Lua, luafilesystem, lpeg, md5, luasocket, rings. Those are binary libraries. You'll need to either compile them or get the binaries for your operating system. You have several options:

Option A: LuaRocks

mkdir /tmp/sputnik
cd /tmp/sputnik/
wget http://luaforge.net/frs/download.php/3985/kepler-install-1.1.1-1
yes | bash kepler-install-1.1.1-1 --prefix=${PWD} --without-readline --without-kepler
./bin/luarocks --only-from=http://spu.tnik.org/rocks/fenchurch install sputnik-binary-dependencies

(To use this method on Windows, see Windows installation instructions for LuaRocks.)

Option B: LuaForWindows

LuaForWindows provides a nice way of installing Lua on Windows and comes with the five libraries that you will need. (That's what I heard.)

Option C: Apt-Get

On Debian / Ubuntu systems, you can install Lua and all the libraries using apt-get. For instance, on Ubuntu 8.10:

sudo apt-get install lua5.1 liblua5.1-filesystem0 liblua5.1-lpeg1 \
     liblua5.1-md5-0 liblua5.1-socket2 liblua5.1-rings0

Step 2: Install Sputnik and It's Pure-Lua Dependencies

Option A: Use LuaRocks

If you installed LuaRocks in the step above, then you can use it to install Sputnik and Xavante.

./bin/luarocks --only-from=http://spu.tnik.org/rocks/fenchurch install sputnik
./bin/luarocks --only-from=http://spu.tnik.org/rocks/fenchurch install sputnik-markitup
./bin/luarocks --only-from=http://spu.tnik.org/rocks/fenchurch install xavante

(Remove ./bin if have luarocks in your path.)

Option B: Just Unpack the Lua Code

Alternatively, you can just get the Lua source for Sputnik and all of it's pure-Lua dependencies from sputnik-9.03.16-all-in-one.zip. Copy the the files and directories in the "lua" folder to some place where your Lua installation will find them, and those in "bin" to somewhere from where you can run them.

Step 3: Setup

Use Lua to generate configuration files:

./bin/sputnik.lua make-cgi

(If not using luarocks, skip -lluarocks.require and make sure your Lua paths include Sputnik.)

Then create a directory to store the data:

mkdir wiki-data && chmod -R a+rw wiki-data

(Or just do this by hand.)

Step 4: Run Sputnik Using Xavante

You are now ready to start an instance of Xavante configured to just run Sputnik:

./bin/sputnik.lua start-xavante

(There is no bin/xavante_start.sh anymore, but you can put the line above into a shell script.)

Optional Step 5: Deploy as CGI, etc.

If you don't want to deploy Sputnik using Xavante, you have many other options. See Installations on how to use CGI or FastCGI.

Powered by Sputnik | XHTML 1.1