Deploying Documentation on IIS

If you do not want to deal with Jekyll configurations and mess up the _plugins/slug.rb file you can deploy the built site under IIS.

To achieve that you can follow these steps:

1. Make sure you have a URL Rewrite Module installed;

   To install it, just download the installation—http://www.iis.net/downloads/microsoft/url-rewrite—from Microsoft and follow the installation steps.

   If you are not sure if the module is installed, check if there is such an option in any of the already deployed sites:

2. Build the Jekyll site, without modifying the Jekyll configuration (_config.yml) or any of the plugins (_plugins\slug.rb):

   bundle exec jekyll build

3. Add the Jekyll site to IIS:

   1. Note down the base URL configured in Jekyll. By default, it is set to /devtools/winforms;

   2. Add a Virtual Directory named devtools, and configure its Physical path to navigate to the parent folder of the repository;

      Important: If the name of the application is different, the requests to the CSS and JavaScript files will fail.

      

   3. When created, IIS should automatically find the web application named winforms.

      If, however, the winforms web application does not appear, just add it manually:

      1. Right click -> Add Application;
      2. Name: winforms;
      3. Physical path: [winforms]/_site.

      

   4. Browse the winforms application in the browser.