Create API documentation in reStructuredText from Godot GDScript files
Project description
GDScript reStructuredText Docs Maker
gdscript2rest is a tool to document your Godot gdscript files into reStructuredText (.rst) files and to create an index of the generated files if required.
The code is based on the gdscript-docs-maker code from GDQuest and, in as far as the initial stages of the conversion are concerned, it is a direct copy of their code with a few notable exceptions:
- This version only provides reStructuredText (.rst) output - if you require markdown or Hugo output then please follow the above link and use the original version.
- As there is no facility to create markdown or Hugo files the
-f/--format
and-a/--author
options in the original are no longer available. - Multi-line comments in the code are concatenated to single line comments unless there are multiple line breaks, in which case the line breaks are preserved. This is to give, hopefully, a better flow of the description text.
Usage
A JSON file of the Godot projects docstrings has to be created first using either the generate-reference
script on homepage or the original at gdscript-docs-maker code. Both locations have instructions on how to do this.
Once the JSON file has been created then the reStructuredText documents can be created by running
python -m gdscript2rest [options] $JSON-dump.json
where $JSON-dump.json is the file created by generate-reference
.
The above command will generate the files required and place them in a folder called export that is a sub folder of the Current Working Directory.
Running
python3 -m gdscript2rest -h
will give full program usage with detailing options for tailoring the output location and generating an index file.
My Homepage has full instructions, a mini tutorial wiki's as well as a wiki on creating a Sphinx based webpage of your Games API.
Don't hesitate to raise issues or ask questions and if you like this tool then please spread the word!
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for gdscript2rest-0.5.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 45872f34e20d2c0e9584e9066b3ebeeaedf2bde071dcc3abb5cb8529b0fc33f7 |
|
MD5 | ac5a7e379e3db4634e3b95d591a214ad |
|
BLAKE2b-256 | 774f91247afe12ec22973e63033ca5fe564a6360184e41f68e5acd03e5bbb097 |