An open API service indexing awesome lists of open source software.

https://github.com/ietf-tools/author-tools

Author Tools
https://github.com/ietf-tools/author-tools

hacktoberfest ietf internet-draft rfc xml xml2rfc

Last synced: about 1 month ago
JSON representation

Author Tools

Awesome Lists containing this project

README

        



IETF Author Tools

[![Release](https://img.shields.io/github/release/ietf-tools/author-tools.svg?style=flat&maxAge=300)](https://github.com/ietf-tools/author-tools/releases)
[![License](https://img.shields.io/github/license/ietf-tools/author-tools?20240110)](https://github.com/ietf-tools/author-tools/blob/main/LICENSE)

##### IETF Author Tools

- [**Production Website**](https://datatracker.ietf.org)
- [Changelog](https://github.com/ietf-tools/author-tools/releases)
- [Contributing](https://github.com/ietf-tools/author-tools/blob/main/CONTRIBUTING.md)
- [License](https://github.com/ietf-tools/author-tools/blob/main/LICENSE)
- [Documentation](#documentation)
- [Running Author Tools service](#running-author-tools-service)
- [Testing Web UI](#testing-web-ui)
- [Testing API](#testing-api)

---

## Documentation

* [API documenation](https://author-tools.ietf.org/doc/)
* [OpenAPI specification](https://author-tools.ietf.org/api.yml)

## Running Author Tools service

```
docker compose up --build -d
```

## Testing Web UI

* Visit http://localhost:8888

## Testing API

* Test XML RFC generation
```
curl localhost:8888/api/render/xml -X POST -F "file=@"
```

* Test HTML RFC generation
```
curl localhost:8888/api/render/html -X POST -F "file=@"
```

* Test text RFC generation
```
curl localhost:8888/api/render/text -X POST -F "file=@"
```

* Test PDF RFC generation
```
curl localhost:8888/api/render/pdf -X POST -F "file=@" -o draft-output.pdf
```

* Test validation
```
curl localhost:8888/api/validate -X POST -F "file=@"
```

## Contributing

See [contributing guide](CONTRIBUTING.md).

## License

* [IETF Author Tools License](LICENSE)