-
Notifications
You must be signed in to change notification settings - Fork 294
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:
-
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.
-
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. -
Add the Jekyll site to IIS:
-
Note down the base url configured in Jekyll. By default, it is set to /devtools/aspnet-ajax;
-
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.
-
When created, IIS should automatically find the web application named aspnet-ajax;
-
Browse the aspnet-ajax applicaiton in the browser.
-
- Home
- Getting Started
- Deploying Documentation on IIS
- Git and GitHub Workflow
- Handling Redirects (link to the docs-seed wiki)
- Markdown Syntax (link to the docs-seed wiki)
- Markdown Nesting (link to the docs-seed wiki)
- Using Templates (link to the docs-seed wiki)
- Using Git and Git Bash
- Faster Jekyll Build via generate_exclude.rb Script
- Using Helper Tools
- Troubleshooting
- Use VS Diff tool with Git and SourceTree