Today I fought around with python's setuptools and assorted other
things to wrangle what might be an installable tarball of TiddlyWeb. I
need some volunteers to try it out to make sure it is working. Anyone
is welcome to give it a try, but it would probably be best if you've
had some experience installing software (especially python modules) on
your computer. Theoretically TiddlyWeb should work on Windows, Linux,
OS X and various Unix flavors. It's been tested on OS X and Linux.

If you are willing to give it a try, please follow the instructions
below and report back success or failure.

If you get an error about a problem with zlib, try running the
previous command again. I've been getting that one sometimes with no
pattern.

Apologies to those of you using Windows, these instructions are biased
to unix-like systems.

1. Download the gzipped tarball from 
http://peermore.com/tiddlyweb/dist/tiddlyweb-0.2.tar.gz
to a convenient location.
2. Use your favorite tar tool to unpack it (it will expand into a
directory called tiddlyweb-0.2):

    tar zxvf tiddlyweb-0.2.tar.gz

3. Change directory to the newly created directory.
4. Install the software. To do this you may need administrator
privileges (use sudo), or if you know how, install things to your own
preferred location:

    sudo python setup.py install

5. There will be a bunch of stuff on the screen, including some
information about following dependencies. This latter part is the part
that is most likely to fail. If it does trying a second time may help.
6. Once the code installed change to some other directory. In this
directory we will create a TiddlyWeb store and run the server.
7. In that directory make the store directory:

    mkdir -p store/{recipes,bags,users}

8. Make a bag with the name 'foo':

    twanager bag foo </dev/null

9. Create a file, let's call it 'input' with the following content:

--snip--
modifier: WikiMan

Welcome to TiddlyWeb WikiMan!
--snip--

10. Turn that file into a stored tiddler:

    twanager tiddler TestTiddler foo < input

11. Start up the server and put it in the background:

    twanager server 0.0.0.0 8080

12. In your browser visit http://0.0.0.0:8080/bags/foo/tiddlers.wiki
This should result in a TiddlyWiki containing TestTiddler

13. In your browser visit http://0.0.0.0:8080/
This should give you a screen that lists 'recipes' and 'bags' from
which you can browse around a bit.

14. Back in the terminal window hit ctrl-c to stop the server (this
make take a bit to respond, there are threads to reap).

Once we've established this system is working, I'll start making
regular releases of TiddlyWeb and start building tools to make the
rest of the installation process more smooth (for example it should be
easier to establish a basic server with a bit of content, without all
that whoo ha above).

Thanks!
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"TiddlyWikiDev" group.
To post to this group, send email to [email protected]
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at 
http://groups.google.com/group/TiddlyWikiDev?hl=en
-~----------~----~----~----~------~----~------~--~---

Reply via email to