-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
1 parent
95f4e25
commit 2265be2
Showing
1 changed file
with
33 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,33 @@ | ||
# Luatrauma.Docs | ||
|
||
This is the documentation source hosted at https://luatrauma.github.io/Luatrauma.Docs/ | ||
|
||
## How to build | ||
|
||
This documentation has three components: | ||
|
||
The manual, which uses mkdocs. | ||
The CSharp API documentation, which uses doxygen. | ||
The Lua API documentation, which uses ldoc. | ||
|
||
Note all of the build scripts are written for Linux (windows is a fucking pain), so if you are on Windows, you can use WSL to run the scripts. | ||
|
||
### Manual | ||
|
||
To build the manual, you need to have material for mkdocs installed. You can install it with pip: | ||
|
||
```bash | ||
pip install mkdocs-material | ||
``` | ||
|
||
Now you can just run `./serve_manual.sh` to build and serve the manual. | ||
|
||
### CSharp API | ||
|
||
Run `install_doxygen.sh` first and then run `build_api_cs.sh`, the documentation files will be generated at `build/api/cs/client` and `build/api/cs/server`. | ||
|
||
### Lua API | ||
|
||
First make sure you have Lua 5.2, Lua headers and Luarocks installed in your system. | ||
|
||
Run `build_api_lua.sh`, the documentation files will be generated at `build/api/lua/`. |