Skip to content

Commit

Permalink
fixes #7: Add README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Alexandre Leblanc committed Jan 28, 2024
1 parent e81f838 commit d56d458
Showing 1 changed file with 29 additions and 0 deletions.
29 changes: 29 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# qt-ts-tools
This repository contains suite of tools for manipulating [Qt Framework](https://www.qt.io/product)'s [translation files](https://wiki.qt.io/QtInternationalization), contained in a single executable.

## Implemented functions
See `qt-ts-tools --help` for a list of operations in your version.

### Sort
```shell
./qt-ts-tools sort my_file.ts -o my_file_sorted.ts
```
## Limitations
* Sorting might not be 100% identical to Qt's.
* Some tags may become self-closing (e.g. `<translation/>` instead of `<translation></translation>`)

## Planned work
In no particular order:

- [x] `sort`: outputs a sorted version of the provided file.
- [ ] `diff`: outputs the differences between 2 translation files.
- [ ] `merge`: merge 2 translation files into a single output.
- [ ] `extract`: copy some specific elements via a filter (i.e. `unfinished` translations) to a new translation file.
- [ ] `strip`: remove some specific elements via a filter (i.e. `oldcomment` nodes) from the provided file.

## Philosophy
This tool aims to be simple to use and conservative in its decision. Therefore, no command shall modify the input file.
If an input file is modified without being explicitly asked, it is an undesirable behavior.

## License
See [LICENSE](LICENSE).

0 comments on commit d56d458

Please sign in to comment.