This project generates API documentation for Ignite UI for Blazor components by:
- restoring IgniteUI.Blazor packages in the
app
folder - installing npm packages
- building Blazor API project
This section will guide you to setup a blazor application in the app
folder:
-
in notepad, open
/app/blazor-app.csproj
file -
update version of IgniteUI packages to latest version
-
open VS Code terminal window
-
run
cd app
command -
run
dotnet restore --force
command -
run
dotnet build --force
command
This section will guide you to setup docs project in the root for this repo:
- run
cd ..
command - run
npm install
command
This section builds a website for Blazor API:
- run
gulp build
to generate output files in_site
folder - copy content of the
_site
folder to hosting server
This section explains how to update API Landing Page
-
open
index-links.json
file -
add entries for new API members (if any), where
api
is name of API component, andurl
is routing path for a topic that provides documentation and examples of the API component
{ "api": "IgbTreeGrid", "links": [ { "url": "/grids/tree-grid/overview" }] },
-
run
gulp updateIndex
to generate a table with API mapping to topics inindex.md
files -
commit your changes and create a new Pull Request