Docs for running on MS Internet Information Server
This commit is contained in:
Jermolene
parent
1280984e78
commit
274bea1258
|
|
@ -0,0 +1,2 @@
|
|||
title: $:/config/tiddlyweb/host
|
||||
text: $protocol$//$host$/MyApp/
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
title: Example config-tiddlyweb-host for IIS
|
||||
created: 20180328145039530
|
||||
modified: 20180328145234871
|
||||
tags:
|
||||
type: text/plain
|
||||
|
|
@ -0,0 +1,8 @@
|
|||
{
|
||||
"name": "MyStuff",
|
||||
"description": "A description of this wiki",
|
||||
"dependencies": {
|
||||
"sax": "1.2.4",
|
||||
"tiddlywiki": "*"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
created: 20180328145039530
|
||||
modified: 20180328145234871
|
||||
tags:
|
||||
title: Example package.json for IIS
|
||||
type: text/plain
|
||||
|
|
@ -0,0 +1,11 @@
|
|||
{
|
||||
"description": "My wiki",
|
||||
"plugins": [
|
||||
"tiddlywiki/tiddlyweb",
|
||||
"tiddlywiki/filesystem"
|
||||
],
|
||||
"themes": [
|
||||
"tiddlywiki/vanilla",
|
||||
"tiddlywiki/snowwhite"
|
||||
]
|
||||
}
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
created: 20180328151124878
|
||||
modified: 20180328151214616
|
||||
tags:
|
||||
title: Example tiddlywiki.info for IIS
|
||||
type: text/plain
|
||||
|
|
@ -0,0 +1,25 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<configuration>
|
||||
<system.webServer>
|
||||
<handlers>
|
||||
<add
|
||||
name="httpplatformhandler"
|
||||
path="*"
|
||||
verb="*"
|
||||
modules="httpPlatformHandler"
|
||||
resourceType="Unspecified"
|
||||
requireAccess="Script" />
|
||||
</handlers>
|
||||
<httpPlatform
|
||||
stdoutLogEnabled="true"
|
||||
stdoutLogFile=".\node.log"
|
||||
startupTimeLimit="20"
|
||||
processPath="C:\Program Files\nodejs\node.exe"
|
||||
arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./MyStuff --server PORT $:/core/save/all text/plain text/html "" "" 127.0.0.1 /MyApp">
|
||||
<environmentVariables>
|
||||
<environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%" />
|
||||
<environmentVariable name="NODE_ENV" value="Production" />
|
||||
</environmentVariables>
|
||||
</httpPlatform>
|
||||
</system.webServer>
|
||||
</configuration>
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
created: 20180328145259455
|
||||
modified: 20180328151038658
|
||||
tags:
|
||||
title: Example web.config for IIS
|
||||
type: text/plain
|
||||
|
|
@ -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:
|
||||
#> <<example-file "Example package.json for IIS">>
|
||||
# Also create a file called `C:\MyStuff\web.config` with the content:
|
||||
#> <<example-file "Example web.config for IIS">>
|
||||
# Create a subdirectory called "wiki" (i.e. `C:\MyStuff\wiki`)
|
||||
# Create a file called `C:\MyStuff\wiki\tiddlywiki.info` with the content:
|
||||
#> <<example-file "Example tiddlywiki.info for IIS">>
|
||||
# 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:
|
||||
#> <<example-file "Example config-tiddlyweb-host for IIS">>
|
||||
|
||||
! 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
|
||||
|
||||
Loading…
Reference in New Issue