Skip to content

Commit

Permalink
Create README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
evilfactory committed Sep 26, 2024
1 parent 95f4e25 commit 2265be2
Showing 1 changed file with 33 additions and 0 deletions.
33 changes: 33 additions & 0 deletions README.md
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/`.

0 comments on commit 2265be2

Please sign in to comment.