mirror of
https://github.com/Jermolene/TiddlyWiki5
synced 2024-11-25 11:07:19 +00:00
1e221ddbdb
* Styles and templates for visual changes to Saving methods listing * Color coding saver methods according to delivery * Changes to tags and few tiddlers - The tag InternetExplorer has been changed to [[Internet Explorer]] - A tag for Edge is added - Reclassified TiddlyServer as DIY instead of App The existing criteriion for classification is unclear. Here is my reasoning for the change. An app is something user can simply install and run. Like TiddlyDesktop or Tiddloid. A DIY is something user has to install additional runtimes for. Thus Nodejs is a DIY. In the same vein, TiddlyServer is a DIY * Adding Twexe * Reversing accidental changes to StoryList * Restyling Download button and Card Size * Removing "Read more" links Entire card is now clickable To give visual clues regarding the clickability of card, title will change color to blue on card hover * Removing margins from elements under link and adding padding instead. Why this change? Margins are not "clickable". Having margins under <a> tag means there are minute dead areas where the mouse pointer will change shape, is not clickable and degrade user experience. Paddings are "clickable"
70 lines
3.5 KiB
Plaintext
70 lines
3.5 KiB
Plaintext
caption: Internet Information Services
|
|
color: #F06292
|
|
created: 20180328120356008
|
|
delivery: DIY
|
|
description: Windows' built-in web server
|
|
method: sync
|
|
modified: 20200507105855400
|
|
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">>
|
|
#* (See [[the documentation|https://docs.microsoft.com/en-us/iis/extensions/httpplatformhandler/httpplatformhandler-configuration-reference]] for details of the configuration fields for ~HttpPlatformHandler
|
|
# Execute the command `npm install` within the `C:/MyStuff` directory
|
|
|
|
! 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 `--listen` command in `web.config`. For example:
|
|
** `arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki-server --listen username=joe "password=bloggs" port=PORT path-prefix=/MyApp">`
|
|
** Take note of the need to use double quotes around non-alphanumeric passwords, and to HTML encode them 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
|
|
|