Charlie Kindel d06dd3f599 fixes doc script преди 3 години
..
_exported_templates 0dcbdb847c Tweaked API docs format and content. Fixed build warnings. преди 3 години
articles 7e2e7b9d2d Updates v1.7 docs (#1919) преди 3 години
images 0dcbdb847c Tweaked API docs format and content. Fixed build warnings. преди 3 години
templates 7e2e7b9d2d Updates v1.7 docs (#1919) преди 3 години
README.md 70ca1a854e Adds new workflow for generating API docs via Github action преди 3 години
aboutbox.png 7f27d78cc7 Release Candiate 2 (#1248) преди 4 години
build.ps1 d06dd3f599 fixes doc script преди 3 години
docfx.json 68ddc4295a Puts API doc overrides in ./docfx/overrides folder преди 3 години
index.md 7e2e7b9d2d Updates v1.7 docs (#1919) преди 3 години
runbuild.cmd 239191cde0 Fixes #1434. Regenerating the docs. (#1528) преди 3 години
toc.yml 3a7efd0cdf Fixes #1889. Docs broken after org move. преди 3 години

README.md

This folder generates the API docs for Terminal.Gui.

The API documentation is generated via a GitHub Action (.github/workflows/api-docs.yml) using DocFX. The Action publishes the docs to the gh-pages branch, which gets published to https://gui-cs.github.io/Terminal.Gui/.

To Generate the Docs Locally

  1. Install DotFX https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
  2. Change to the ./docfx folder and run ./build.ps1
  3. Browse to http://localhost:8080 and verify everything looks good.
  4. Hit ctrl-c to stop the script.

If docfx fails with a Stackoverflow error. Just run it again. And again. Sometimes it takes a few times. If that doesn't work, create a fresh clone or delete the docfx/api, docfx/obj, and docs/ folders and run the steps above again.

Note the ./docfx/build.ps1 script will create a ./docs folder. This folder is ignored by .gitignore.