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 an URL Rewrite Module installed;

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

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

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

    jekyll build
   

   If you need to run the build with a watch, use this command:

    jekyll build --watch
   

   This will lead you to a generated site in the _site folder, located in the root.

3. Add the Jekyll site to IIS

   1. Note down the base url configured in Jekyll. By default, it is set to /devtools/aspnet-ajax. It is mandatory to use devtools as name of the web application.

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

   2. Open IIS and add a web application with Alias set to devtools and Physical path navigating to the _site folder.