Tig Kindel
3a7efd0cdf
Fixes #1889. Docs broken after org move.
|
3 лет назад | |
|---|---|---|
| .. | ||
| _exported_templates | 3 лет назад | |
| articles | 3 лет назад | |
| images | 3 лет назад | |
| templates | 3 лет назад | |
| README.md | 4 лет назад | |
| aboutbox.png | 4 лет назад | |
| build.ps1 | 3 лет назад | |
| docfx.json | 3 лет назад | |
| index.md | 3 лет назад | |
| runbuild.cmd | 3 лет назад | |
| toc.yml | 3 лет назад | |
README.md
This folder generates the API docs for Terminal.Gui.
The API documentation is generated using the DocFX tool. The output of docfx gets put into the ./docs folder which is then checked in. The ./docs folder is then picked up by Github Pages and published to Miguel's Github Pages (https://migueldeicaza.github.io/gui.cs/).
To Generate the Docs
- 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.