create repo
This commit is contained in:
commit
17fcd16fd6
|
|
@ -0,0 +1,113 @@
|
||||||
|
<div align="center">
|
||||||
|
<img alt="Timewarrior logo" src="https://avatars.githubusercontent.com/u/36100920?s=200&u=24da05914c20c4ccfe8485310f7b83049407fa9a&v=4">
|
||||||
|
<br>
|
||||||
|
|
||||||
|
[](https://github.com/GothenburgBitFactory/timewarrior/actions/workflows/tests.yaml)
|
||||||
|
[](https://github.com/GothenburgBitFactory/timewarrior/releases/latest)
|
||||||
|
[](https://github.com/GothenburgBitFactory/timewarrior/releases/latest)
|
||||||
|
|
||||||
|
<br>
|
||||||
|
[](https://twitter.com/timewarrior_net)
|
||||||
|
</div>
|
||||||
|
|
||||||
|
# this fork
|
||||||
|
|
||||||
|
is functionally the same as timew 1.7.1 except that it supports weeks and months as variants of the week and month commands.
|
||||||
|
|
||||||
|
## Semantics
|
||||||
|
|
||||||
|
In unforked commands, the tag list is always a conjunction that filters each interval which must have all of them.
|
||||||
|
For weeks and months, each tag only needs to occur once for the interval to pass the filter.
|
||||||
|
|
||||||
|
|
||||||
|
# Timewarrior
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Thank you for taking a look at Timewarrior!
|
||||||
|
|
||||||
|
Timewarrior is a time tracking utility that offers simple stopwatch features as well as sophisticated calendar-based backfill, along with flexible reporting.
|
||||||
|
It is a portable, well-supported and very active Open Source project.
|
||||||
|
|
||||||
|
Please visit [timewarrior.net](https://timewarrior.net/docs/) for extensive documentation, downloads, news and more.
|
||||||
|
|
||||||
|
## Installing
|
||||||
|
[](https://archlinux.org/packages/extra/x86_64/timew/)
|
||||||
|
[](https://packages.debian.org/search?keywords=timewarrior&searchon=names&suite=all§ion=all)
|
||||||
|
[](https://bodhi.fedoraproject.org/updates/?packages=timew)
|
||||||
|
[](https://formulae.brew.sh/formula/timewarrior#default)
|
||||||
|
[](https://packages.ubuntu.com/search?keywords=timewarrior&searchon=names&suite=hirsute§ion=all)
|
||||||
|
|
||||||
|
### From Package
|
||||||
|
|
||||||
|
Thanks to the community, there are binary packages available [here](https://timewarrior.net/docs/install.html#distributions).
|
||||||
|
|
||||||
|
### Building Timewarrior
|
||||||
|
|
||||||
|
Building Timewarrior yourself requires
|
||||||
|
|
||||||
|
* Git
|
||||||
|
* CMake (>= 3.8)
|
||||||
|
* Make
|
||||||
|
* C++ compiler with full C++17 support, currently GCC 8+ or Clang 5+
|
||||||
|
* Python 3 (for running the testsuite)
|
||||||
|
* Asciidoctor (for creating documentation)
|
||||||
|
|
||||||
|
There are two ways to retrieve the Timewarrior sources:
|
||||||
|
|
||||||
|
* Clone the repository from GitHub and update required submodules,
|
||||||
|
```
|
||||||
|
git clone --recurse-submodules https://github.com/GothenburgBitFactory/timewarrior
|
||||||
|
cd timewarrior
|
||||||
|
```
|
||||||
|
* Or download the tarball with curl,
|
||||||
|
```
|
||||||
|
curl -O https://github.com/GothenburgBitFactory/timewarrior/releases/download/v1.7.1/timew-1.7.1.tar.gz
|
||||||
|
```
|
||||||
|
and expand the tarball
|
||||||
|
```
|
||||||
|
tar xzf timew-1.7.1.tar.gz
|
||||||
|
cd timew-1.7.1
|
||||||
|
```
|
||||||
|
Build Timewarrior, optionally run the test suite, and install it.
|
||||||
|
```
|
||||||
|
cmake -DCMAKE_BUILD_TYPE=release .
|
||||||
|
make
|
||||||
|
[make test]
|
||||||
|
sudo make install
|
||||||
|
```
|
||||||
|
This copies files into the right place (default under `/usr/local`), and installs man pages.
|
||||||
|
|
||||||
|
Add the optional parameter `-DCMAKE_INSTALL_PREFIX=/path/to/your/install/location` to the `cmake` command if you want to install Timewarrior at a location other than `/usr/local`.
|
||||||
|
The `make install` command may not require `sudo` depending on your choice of install location.
|
||||||
|
|
||||||
|
## Community
|
||||||
|
[](https://twitter.com/timewarrior_net)
|
||||||
|
[](https://reddit.com/r/taskwarrior/)
|
||||||
|
[](https://web.libera.chat/#taskwarrior)
|
||||||
|
[](https://discord.gg/HYpSAeVH)
|
||||||
|
[](https://github.com/GothenburgBitFactory/timewarrior/discussions)
|
||||||
|
|
||||||
|
Timewarrior has a lively community on many places on the internet.
|
||||||
|
The project has its own Twitter account, and shares community spaces on IRC and Discord with [Taskwarrior](https://github.com/GothenburgBitFactory/taskwarrior).
|
||||||
|
|
||||||
|
Best place to ask questions is our [discussions forum on GitHub](https://github.com/GothenburgBitFactory/timewarrior/discussions).
|
||||||
|
For other support options, take a look at [timewarrior.net/support](https://timewarrior.net/support)
|
||||||
|
|
||||||
|
## Contributing
|
||||||
|
[](https://github.com/GothenburgBitFactory/timewarrior/graphs/contributors)
|
||||||
|
[](https://github.com/GothenburgBitFactory/timewarrior/milestone/11)
|
||||||
|
[](https://github.com/GothenburgBitFactory/timewarrior/issues?q=is%3Aissue+is%3Aopen+label%3A%22good+first+issue%22)
|
||||||
|
|
||||||
|
Contributions are greatly appreciated.
|
||||||
|
Whether in the form of code patches, ideas, discussion, bug reports, encouragement or criticism, we need you!
|
||||||
|
|
||||||
|
For support options, take a look at [CONTRIBUTING.md](CONTRIBUTING.md) or visit [timewarior.net](https://timewarrior.net/support).
|
||||||
|
|
||||||
|
Visit [GitHub](https://github.com/GothenburgBitFactory/timewarrior) and participate in the future of Timewarrior.
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
Timewarrior is released under the MIT license.
|
||||||
|
For details check the [LICENSE](LICENSE) file.
|
||||||
Loading…
Reference in New Issue