igniteui-docfx's Introduction

Ignite UI DocFX Site Builder

This project uses Node.js and Gulp as a build tool to accelerate the development of the Ignite UI DocFX samples site for Ignite UI for Angular.

Prerequisites

Getting Started

Installing DocFX

In macOS You can use brew to install the latest version of DocFX:

brew install docfx

For Windows based platforms use chocolatey:

choco install docfx

Installing the Node.js dependencies:

If you are using npm, run:

npm install

If you are using yarn, run:

yarn install

Starting the Development Server

The build process depends on the environment variable NODE_ENV to be able to set the correct URL for the Angular Samples. Assign either development, staging, or production to NODE_ENV.

You can create a .env file under the root of the project and set NODE_ENV, for instance, by assigning environment.

NODE_ENV=development

Additionally, you can configure the URLs for all three environments development, staging, and production by editing the 'post_processors/PostProcessors/EnvironmentVariables/preconfig.json' file and setting the respective URLs in the variables object.

To start the server, run:

for English:

npm start -- --lang en

for Japansese:

npm start -- --lang jp

The command takes an adittional argument --lang [ en | jp ] to serve either the English or Japanese version.

Building the Static Site

For instance, for English:

npm run build -- --lang en

For the Japanese version:

npm run build -- --lang jp

The build script produces a folder called _site at the root of the respective project. For instance, for English, the static site lives under en/_site;