On Friday, September 22, 2017 at 6:05:54 AM UTC-4, RichardWilliamSmith
Post by RichardWilliamSmith
Picking up where my trouble starts...
What You Need
You need to install Node.js, which you can do just like any other app, from
here: https://nodejs.org (the LTS, "Long Term Support" version will be best
for most people)
Then you need to download and install Tiddlyserver itself. The best way to
do so is to go here:https://github.com/Arlen22/TiddlyServer/releases and
download the most recent zip file, then unzip it.
On my mac, it unzips into my download directory. I figure I should move it
someplace, so I sent the whole directory to my Documents folder.
If you would prefer to use git and have it installed, you can do git clone
https://github.com/Arlen22/TiddlyServer from the command line, or use
Github Desktop for an easier alternative. If use git, you'll also need to
run npm install from the main directory to install the dependencies. Note
also that the git repo contains a lot of unused files and the stable
release (zip file) contains other optimisations that also make it run
Now we need to create a settings file, in the directory we just created,
which will be called settings.json. You can either follow the steps and
reasoning outlined below, or just create a file with that name, skip to the
next section (settings.json), and give it the content listed there.
In the folder you just created, you can find the file example-settings.json
and open it in an editor.
If you don't normally use an editor, you probably nevertheless have one
installed and 'double-clicking' the file may well open it in a suitable app
that shouldn't be too hard to use.
We need to change a lot of things in this file. To begin with, it looks
// all comments need to be removed from this file
"twig1": "C:/Some Folder",
"twig2": "C:/Some Other Folder"
//this is the default value if types is not specified
//this only applies to the directory listing
//specifies file extensions for each icon in the files folder
"htmlfile": ["htm", "html"]
//127.0.0.1 (the default) serves on localhost, 0.0.0.0 serves on all network connections.
//remove or set to an empty string to disable backups when saving single-file wikis
As it says, we need to remove all the comments.
We also need to change the entries in the 'tree' at the top to match the
places on our filing system we want to serve files from.
If we want to serve files to the whole network, we should change 127.0.0.1
to 0.0.0.0 (we've done this below but you can leave it as 127.0.0.1 if you
want to restrict access to just your own machine.
If we want to, we can change the port number to something else (if you
don't know what this means, there's very little chance you would need to
To avoid a current quirk, which prevents saving, we also need to either
create a directory called 'backup', to save backups in, or delete the value
'backup' from the last line.
I'm not sure where the "backup" directory should go, I initially placed it
inside Documents - but it failed to work (probably because I allowed this
folder to be placed on the iCloud drive and my paths aren't working), since
moved to a newly created Docs folder: /Users/jwh/Docs
Once we've made the changes we need to save this file with a different name
(usually 'save as' or similar'). It needs to be called settings.json.
The result should look like this looks like this: settings.json
"htmlfile": ["htm", "html"]
Note that the only difference between Windows and Unix/Mac is the style of
the paths. I've included an example of each here, you should delete the one
that doesn't apply.
You can add as many entries as you like and they can be nested too, as
shown in example-settings.json, but they don't need to be. The simplest
configuration is a single entry.
Now we can run Tiddlyserver.
I think that if you're using Windows(tm), you should be able to
double-click start.cmd and the process should run. (is that right?)
If you're using a Mac, a similar mechanism is also possible, but the file
you need isn't included yet (I sent a pull request: Hi Arlen!)
To run the app from the command line, in the top directory of the
repository (where you will already be, if you did npm install above) just
I don't know what is meant by the top directory of the repository. I did
not use Git - I unzipped from the Arlen link and created a directory for
it. In terminal, I CD (Change Directory) and get to /Users/jwh/Docs
directory, run "node server" and get a parsing error at location 75
(wherever that is). I recreate settings.json and copy it into every
possible location throughout the directory tree and try again
module.js:471 throw err; ^ Error: Cannot find module
'/Users/jwh/Docs/server' at Function.Module._resolveFilename
(module.js:469:15) at Function.Module._load (module.js:417:25) at
Module.runMain (module.js:604:10) at run (bootstrap_node.js:389:7) at
startup (bootstrap_node.js:149:9) at bootstrap_node.js:502:3 So I copy
server.js to /Users/jwh/Docs and rerun node server - and now it wants /lib
files... I realize that I should be in directory
/Users/jwh/Docs/TiddlyServer-2.0.6 And I get my original parse error at
You should see a message in your terminal, telling you that Tiddlyserver
has started. It will give you the ip address and port that it's running on,
which you can enter in the address bar of your browser to see the main
You received this message because you are subscribed to the Google Groups "TiddlyWiki" group.
To unsubscribe from this group and stop receiving emails from it, send an email to email@example.com.
To post to this group, send email to ***@googlegroups.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/0f9b6d58-5740-4913-8919-a59475a9b22b%40googlegroups.com.
For more options, visit https://groups.google.com/d/optout.