:::tips 适用范围：
系统

  • Windows
    :::

    Microsoft 的 Internet Information Server (IIS) 是 Windows 的内置网页服务器。为了利用 IIS 功能 (如 URL 重写、静态档托管和崩溃后的自动重新开机)，有助于在 IIS 中托管 TiddlyWiki。

1. 激活 IIS

  1. 在 Windows 中，请访问控制台，然后点击 添加或移除程序
  2. 在 添加或移除程序 窗口中，点击 添加/移除 Windows 组件.
  3. 勾选 Internet Information Services (IIS) 核取方块
  4. 点击 下一步，然后点击 完成

:::info

2. 安装所需的工具

  1. 从 https://www.iis.net/downloads/microsoft/httpplatformhandler 安装 IIS 模块 HttpPlatformHandler
  2. 从 https://nodejs.org/ 安装 Node.js
  3. 从 https://git-scm.com/ 安装 Git
    • 可选的；只有使用最新版的 _TiddlyWiki 时，才需直接从 GitHub 拉取 - 见下文_ ::: :::danger

      3. 安装 TiddlyWiki 并设置一个新维基

  1. 为维基创建一个合适的目录 (例如，C:\MyStuff)

  2. 在其中创建一个名为 C:\MyStuff\package.json 的文件，内容如下: :::

    1. {   
    2. "name": "MyStuff", 
    3. "description": "A description of this wiki",
    4. "dependencies": { 
    5.  "sax": "1.2.4",
    6.  "tiddlywiki": "*"     
    7. } 
    8. }

    :::danger

  3. 同时创建一个名为 C:\MyStuff\web.config 的文件，内容如下: :::

    1. <?xml version="1.0" encoding="UTF-8"?>
    2. <configuration>
    3. <system.webServer>         
    4.  <handlers>             
    5.    <add                  
    6.         name="httpplatformhandler"                 
    7.         path="*"                 
    8.         verb="*"                 
    9.         modules="httpPlatformHandler"                 
    10.         resourceType="Unspecified"                 
    11.         requireAccess="Script" />         
    12.  </handlers>         
    13.  <httpPlatform             
    14.                stdoutLogEnabled="true"            
    15.                stdoutLogFile=".\node.log"            
    16.                startupTimeLimit="20"            
    17.                processPath="C:\Program Files\nodejs\node.exe"            
    18.                arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki --listen port=PORT path-prefix=/MyApp">             
    19.    <environmentVariables>                 
    20.      <environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%" />                 
    21.      <environmentVariable name="NODE_ENV" value="Production" />             
    22.    </environmentVariables>                     
    23.  </httpPlatform>     
    24. </system.webServer> 
    25. </configuration>

    :::danger

  4. 创建一个名为 “wiki” 的子目录 (即 C:\MyStuff\wiki)

  5. 创建一个名为 C:\MyStuff\wiki\tiddlywiki.info 的文件，内容如下: :::

    1. {     
    2.  "description": "My wiki",
    3.  "plugins": [         
    4.     "tiddlywiki/tiddlyweb",
    5.     "tiddlywiki/filesystem"     
    6.   ],
    7.   "themes": [         
    8.     "tiddlywiki/vanilla",
    9.     "tiddlywiki/snowwhite"     
    10.   ] 
    11. }

    :::danger

  6. 创建一个，名为 “tiddlers” 的子目录 (即 C:\MyStuff\wiki\tiddlers)

  7. 在其中创建一个名为 C:\MyStuff\wiki\tiddlers\config-tiddlyweb-host.tid 的文件，内容如下: :::

    1. title: $:/config/tiddlyweb/host 
    2. text: $protocol$//$host$/MyApp/

    :::danger

    • (有关 HttpPlatformHandler 配置字段的详细信息，请参考微软的文档
  8. 在 C:/MyStuff 目录下运行 npm install 命令 ::: :::success

    4. 在 IIS 中设置应用程序

  • 在 Windows 中，运行 IIS 管理程序 (使用 “开始” 功能表运行 inetmgr.exe)
  • 在左侧的 连接 栏中找到该服务器，然后按一下 “显示三角形” 显示其内容 *
  • 打开 “网站” 文件夹
  • 在默认网站项目点击右键，然后从功能表中选择添加应用程序。
  • 在对话框中输入以下信息:
    1. Alias: MyApp
    2. Physical path: C:\MyStuff

  • 点击 确定 ::: :::info

    5. 测试应用程序

    在浏览器中访问 http://localhost/MyApp/ 来测试应用程序。 ::: :::tips

    注意事项

  • 如果需要身份验证，请在 web.config 中的 —listen 命令中指定用户名和密码。例如:

    • 复制到剪贴板
    • 注意在非字母、数字的密码前后，需使用双引号, 并将其 HTML 编码为 "
  • 如果更改了 web.config 档中的设置，或者修改了应用程序代码，则需要使用 IIS 管理程序，重新启动服务器 :::