From 274bea12589a7c0bab5515060e8b0b9d2f9c73b5 Mon Sep 17 00:00:00 2001 From: Jermolene Date: Thu, 29 Mar 2018 12:51:31 +0100 Subject: [PATCH] Docs for running on MS Internet Information Server --- .../Example config-tiddlyweb-host for IIS.txt | 2 + ...ple config-tiddlyweb-host for IIS.txt.meta | 5 ++ .../saving/Example package.json for IIS.txt | 8 +++ .../Example package.json for IIS.txt.meta | 5 ++ .../Example tiddlywiki.info for IIS.txt | 11 ++++ .../Example tiddlywiki.info for IIS.txt.meta | 5 ++ .../saving/Example web.config for IIS.txt | 25 +++++++ .../Example web.config for IIS.txt.meta | 5 ++ ... Microsoft Internet Information Server.tid | 66 +++++++++++++++++++ 9 files changed, 132 insertions(+) create mode 100644 editions/tw5.com/tiddlers/saving/Example config-tiddlyweb-host for IIS.txt create mode 100644 editions/tw5.com/tiddlers/saving/Example config-tiddlyweb-host for IIS.txt.meta create mode 100644 editions/tw5.com/tiddlers/saving/Example package.json for IIS.txt create mode 100644 editions/tw5.com/tiddlers/saving/Example package.json for IIS.txt.meta create mode 100644 editions/tw5.com/tiddlers/saving/Example tiddlywiki.info for IIS.txt create mode 100644 editions/tw5.com/tiddlers/saving/Example tiddlywiki.info for IIS.txt.meta create mode 100644 editions/tw5.com/tiddlers/saving/Example web.config for IIS.txt create mode 100644 editions/tw5.com/tiddlers/saving/Example web.config for IIS.txt.meta create mode 100644 editions/tw5.com/tiddlers/saving/Installing TiddlyWiki on Microsoft Internet Information Server.tid diff --git a/editions/tw5.com/tiddlers/saving/Example config-tiddlyweb-host for IIS.txt b/editions/tw5.com/tiddlers/saving/Example config-tiddlyweb-host for IIS.txt new file mode 100644 index 000000000..e30d38eb6 --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Example config-tiddlyweb-host for IIS.txt @@ -0,0 +1,2 @@ +title: $:/config/tiddlyweb/host +text: $protocol$//$host$/MyApp/ diff --git a/editions/tw5.com/tiddlers/saving/Example config-tiddlyweb-host for IIS.txt.meta b/editions/tw5.com/tiddlers/saving/Example config-tiddlyweb-host for IIS.txt.meta new file mode 100644 index 000000000..e57cb2484 --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Example config-tiddlyweb-host for IIS.txt.meta @@ -0,0 +1,5 @@ +title: Example config-tiddlyweb-host for IIS +created: 20180328145039530 +modified: 20180328145234871 +tags: +type: text/plain diff --git a/editions/tw5.com/tiddlers/saving/Example package.json for IIS.txt b/editions/tw5.com/tiddlers/saving/Example package.json for IIS.txt new file mode 100644 index 000000000..bfe3b8c1a --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Example package.json for IIS.txt @@ -0,0 +1,8 @@ +{ + "name": "MyStuff", + "description": "A description of this wiki", + "dependencies": { + "sax": "1.2.4", + "tiddlywiki": "*" + } +} \ No newline at end of file diff --git a/editions/tw5.com/tiddlers/saving/Example package.json for IIS.txt.meta b/editions/tw5.com/tiddlers/saving/Example package.json for IIS.txt.meta new file mode 100644 index 000000000..2aba3f4bc --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Example package.json for IIS.txt.meta @@ -0,0 +1,5 @@ +created: 20180328145039530 +modified: 20180328145234871 +tags: +title: Example package.json for IIS +type: text/plain diff --git a/editions/tw5.com/tiddlers/saving/Example tiddlywiki.info for IIS.txt b/editions/tw5.com/tiddlers/saving/Example tiddlywiki.info for IIS.txt new file mode 100644 index 000000000..1ba78a6c9 --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Example tiddlywiki.info for IIS.txt @@ -0,0 +1,11 @@ +{ + "description": "My wiki", + "plugins": [ + "tiddlywiki/tiddlyweb", + "tiddlywiki/filesystem" + ], + "themes": [ + "tiddlywiki/vanilla", + "tiddlywiki/snowwhite" + ] +} diff --git a/editions/tw5.com/tiddlers/saving/Example tiddlywiki.info for IIS.txt.meta b/editions/tw5.com/tiddlers/saving/Example tiddlywiki.info for IIS.txt.meta new file mode 100644 index 000000000..e1728156e --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Example tiddlywiki.info for IIS.txt.meta @@ -0,0 +1,5 @@ +created: 20180328151124878 +modified: 20180328151214616 +tags: +title: Example tiddlywiki.info for IIS +type: text/plain diff --git a/editions/tw5.com/tiddlers/saving/Example web.config for IIS.txt b/editions/tw5.com/tiddlers/saving/Example web.config for IIS.txt new file mode 100644 index 000000000..78db39293 --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Example web.config for IIS.txt @@ -0,0 +1,25 @@ + + + + + + + + + + + + + + diff --git a/editions/tw5.com/tiddlers/saving/Example web.config for IIS.txt.meta b/editions/tw5.com/tiddlers/saving/Example web.config for IIS.txt.meta new file mode 100644 index 000000000..757d70318 --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Example web.config for IIS.txt.meta @@ -0,0 +1,5 @@ +created: 20180328145259455 +modified: 20180328151038658 +tags: +title: Example web.config for IIS +type: text/plain diff --git a/editions/tw5.com/tiddlers/saving/Installing TiddlyWiki on Microsoft Internet Information Server.tid b/editions/tw5.com/tiddlers/saving/Installing TiddlyWiki on Microsoft Internet Information Server.tid new file mode 100644 index 000000000..5d497d871 --- /dev/null +++ b/editions/tw5.com/tiddlers/saving/Installing TiddlyWiki on Microsoft Internet Information Server.tid @@ -0,0 +1,66 @@ +caption: Internet Information Services +created: 20180328120356008 +delivery: DIY +description: Windows' built-in web server +method: sync +modified: 20180328151441294 +tags: Saving [[TiddlyWiki on Node.js]] Windows +title: Installing TiddlyWiki on Microsoft Internet Information Server +type: text/vnd.tiddlywiki + +\define example-file(title) +<$transclude tiddler="$title$" mode="block"/> <$macrocall $name="copy-to-clipboard" src={{$title$}}/> +\end + +Microsoft's [[Internet Information Server|https://en.wikipedia.org/wiki/Internet_Information_Services]] (IIS) is the built-in web server for Windows. It can be useful to host TiddlyWiki within IIS in order to take advantage of IIS features like URL rewriting, static file hosting and automatic restarts after a crash. + +! 1. Enable IIS + +# In Windows, access the Control Panel and click ''Add or Remove Programs'' +# In the Add or Remove Programs window, click ''Add/Remove Windows Components''. +# Select the ''Internet Information Services (IIS)'' check box +# Click ''Next'', then click ''Finish'' + +! 2. Install the required tools + +# Install the IIS module ~HttpPlatformHandler from https://www.iis.net/downloads/microsoft/httpplatformhandler +# Install [[Node.js]] from https://nodejs.org/ +# Install Git from https://git-scm.com/ +#* //optional; only required when using the latest TiddlyWiki release pulled directly from ~GitHub -- see below// + +! 3. Install TiddlyWiki and setup a new wiki + +# Create a convenient directory for the wiki (e.g. `C:\MyStuff`) +# Within it, create a file called `C:\MyStuff\package.json` with the content: +#> <> +# Also create a file called `C:\MyStuff\web.config` with the content: +#> <> +# Create a subdirectory called "wiki" (i.e. `C:\MyStuff\wiki`) +# Create a file called `C:\MyStuff\wiki\tiddlywiki.info` with the content: +#> <> +# Create a subdirectory called "tiddlers" (i.e. `C:\MyStuff\wiki\tiddlers`) +# Within it, create a file called `C:\MyStuff\wiki\tiddlers\config-tiddlyweb-host.tid` with the content: +#> <> + +! 4. Setup the application in IIS + +* In Windows, run the IIS Manager application (use the start menu to run `inetmgr.exe`) +* Locate the server in the ''Connections'' column on the left, and click the disclosure triangle to show its content +* Open the ''Sites'' folder +* Right click on the ''Default Web Site'' entry, and select ''Add application..'' from the menu +* Enter the following information in the dialogue box: +*# ''Alias'': `MyApp` +*# ''Physical path'': `C:\MyStuff` +* Click ''OK'' + +! 5. Test the application + +Test the app by visiting http://localhost/MyApp/ in a browser. + +! Notes + +* If you require authentication, specify a username and password in the `--server` command in `web.config`. For example: +** `arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki-server --server PORT $:/core/save/all text/plain text/html "username" "password" 127.0.0.1 /MyApp">` +** Take note of the need to HTML encode the double quotes around the username and password into `"` +* If you change the settings in the `web.config` file, or modify the app code, then you'll need to restart the server using the IIS manager application +