A modern wiki with minimal external dependencies.
Tome is an attempt to create a wiki that is slim, trivial to deploy, looks clean, and is written as a modern web application. It's core features are:
Right now I'm closing in on my first preview release.
The following items are left:
To get going with tome, you will need to either make a new node project, or at the very least, make a new directory. Tome is installed as an npm package, and requires a couple of lines of code from you to get running. (This is so that we can allow you to easily customize it, without needing to edit any of the core files.)
Assuming you've made a directory called
example-wiki, you should do the following:
$ cd example-wiki$ npm install tome
This will install the latest version of Tome into the
Now, the bare minimum you need is a file to launch the Tome wiki:
var tome = require'tome';tomelisten;
That's it! Now, you should have a tome instance running on http://localhost:4000.
In order to customize Tome, you will want to add a configuration file. I recommend copying the
from the main repository, and modifying that. It has some nice explanations about what the configuration options do,
and how to use them. (Still, some of the information is replicated here, to make it easier to find.)
Tome uses connect as it's middleware. This means that it should be trivial for you to use connect to serve static files. ( Note: Tome uses connect 0.2.X at the moment. ) If you want to do so, you can do the following:
var connect = require'connect';var tome = require'tome';// Serve our local static directorytomeappuseconnectstatic'static';// Start the servertomelisten;
This will serve the contents of the
static directory at the root of your website.
You can customize the logo used for Tome. Simple set the
logo config option to any valid url, and it will load that
logo in the navbar, as well as use it for the favicon. ( Note: The logo will be forced to 50px high. If you want this
to look good on high dpi screens, I recommend using a logo that is 100px high. Width is less important, but if you make
it too wide, it could cause issues with flow in the navbar. )
While Tome doesn't support custom CSS directly, it does support an 'extra template' that is included at the bottom of
<body> tag in the index page. This means that in you config file, you can do:
Then, you will have to serve some static directory, and inside of it place a
partials folder with a
file inside of it. Here is an example of such a template: