Tig
b3a5b78d64
Merge pull request #2111 from tznind/simple-example
|
%!s(int64=2) %!d(string=hai) anos | |
|---|---|---|
| .. | ||
| _exported_templates | %!s(int64=3) %!d(string=hai) anos | |
| articles | %!s(int64=3) %!d(string=hai) anos | |
| images | %!s(int64=2) %!d(string=hai) anos | |
| overrides | %!s(int64=2) %!d(string=hai) anos | |
| templates | %!s(int64=3) %!d(string=hai) anos | |
| README.md | %!s(int64=3) %!d(string=hai) anos | |
| aboutbox.png | %!s(int64=4) %!d(string=hai) anos | |
| build.ps1 | %!s(int64=3) %!d(string=hai) anos | |
| docfx.json | %!s(int64=3) %!d(string=hai) anos | |
| index.md | %!s(int64=3) %!d(string=hai) anos | |
| runbuild.cmd | %!s(int64=3) %!d(string=hai) anos | |
| toc.yml | %!s(int64=3) %!d(string=hai) anos | |
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
- Install DotFX https://dotnet.github.io/docfx/tutorial/docfx_getting_started.html
- Change to the
./docfxfolder and run./build.ps1 - Browse to http://localhost:8080 and verify everything looks good.
- 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.