2019-01-21 00:30:39 +01:00
|
|
|
**Whyblocked** allows you to store the reason why you blocked someone, along
|
2019-06-12 01:21:57 +02:00
|
|
|
with “receipts”, URLs to the posts that led you to block them.
|
2018-08-30 14:03:25 +02:00
|
|
|
|
2019-01-15 01:46:11 +01:00
|
|
|
It has a Qt-interface and uses an SQLite-database.
|
2018-10-14 05:16:16 +02:00
|
|
|
|
2019-06-12 01:21:57 +02:00
|
|
|
![Screenshot](https://doc.schlomp.space/whyblocked/whyblocked_screenshot.png)
|
2018-08-30 14:30:55 +02:00
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
2019-01-21 00:30:39 +01:00
|
|
|
Run `whyblocked`. You can also start it from the menu of your desktop
|
2018-10-17 21:20:38 +02:00
|
|
|
environment.
|
2018-08-30 14:30:55 +02:00
|
|
|
|
|
|
|
## Install
|
|
|
|
|
2018-08-30 23:53:58 +02:00
|
|
|
### Packages
|
|
|
|
|
|
|
|
Every [release](https://schlomp.space/tastytea/whyblocked/releases) includes
|
2018-11-02 12:31:56 +01:00
|
|
|
a .deb-package, an .rpm-package and a .tar.gz-package with precompiled binaries
|
2019-06-12 01:21:57 +02:00
|
|
|
for x86_64(amd64)
|
|
|
|
([more info](https://schlomp.space/tastytea/whyblocked/wiki/Binary-Packages)).
|
|
|
|
These are automatically built and not tested. You can install them with
|
|
|
|
`apt install ./whyblocked*.deb` or `yum install ./whyblocked*.rpm`,
|
2019-06-12 00:22:03 +02:00
|
|
|
respectively. The packages are signed with the PGP key
|
|
|
|
[242E5AC4DA587BF9](https://tastytea.de/tastytea_autosign.asc)
|
2018-11-02 12:31:56 +01:00
|
|
|
(Fingerprint: `F730 1ADF C9ED 2624 48C4 2B64 242E 5AC4 DA58 7BF9`).
|
2018-08-30 23:53:58 +02:00
|
|
|
|
|
|
|
Gentoo ebuilds are available via my
|
|
|
|
[repository](https://schlomp.space/tastytea/overlay).
|
|
|
|
|
|
|
|
### From source
|
|
|
|
|
|
|
|
#### Dependencies
|
2018-08-30 14:30:55 +02:00
|
|
|
|
2019-06-11 23:46:40 +02:00
|
|
|
* C++ compiler (tested: [gcc](https://gcc.gnu.org/) 6/8/9,
|
|
|
|
[clang](https://llvm.org/) 3/6)
|
2018-11-05 20:27:47 +01:00
|
|
|
* [cmake](https://cmake.org/) (at least 3.2)
|
|
|
|
* [vsqlite++](http://vsqlite.virtuosic-bytes.com/) (tested: 0.3)
|
2018-08-30 14:30:55 +02:00
|
|
|
* [libxdg-basedir](http://repo.or.cz/w/libxdg-basedir.git) (tested: 1.2)
|
2019-06-12 00:22:03 +02:00
|
|
|
* [qtcore](https://www.qt.io/) (tested: 5.12/5.5)
|
|
|
|
* [qtwidgets](https://www.qt.io/) (tested: 5.12/5.5)
|
2019-01-12 21:28:29 +01:00
|
|
|
* [libconfig++](https://github.com/hyperrealm/libconfig) (tested: 1.5)
|
2018-10-20 05:42:42 +02:00
|
|
|
* Optional
|
2019-06-12 01:21:57 +02:00
|
|
|
* Translations: [lupdate & lrelease](http://doc.qt.io/qt-5/linguist-manager.html) (tested: 5.12/5.5)
|
2019-01-20 23:31:58 +01:00
|
|
|
* Manpage: [asciidoc](http://asciidoc.org/) (tested: 8.6)
|
2018-08-30 14:30:55 +02:00
|
|
|
|
2018-08-30 23:53:58 +02:00
|
|
|
#### Get sourcecode
|
|
|
|
|
|
|
|
Download the current
|
2021-12-24 16:10:15 +01:00
|
|
|
[release](https://schlomp.space/tastytea/whyblocked/releases).
|
2018-11-03 13:06:21 +01:00
|
|
|
|
2018-08-30 23:53:58 +02:00
|
|
|
#### Compile
|
2018-08-30 14:30:55 +02:00
|
|
|
|
2019-06-12 00:22:03 +02:00
|
|
|
``` zsh
|
2018-08-30 14:30:55 +02:00
|
|
|
mkdir build
|
|
|
|
cd build
|
|
|
|
cmake ..
|
|
|
|
make
|
|
|
|
make install
|
|
|
|
```
|
2018-08-30 18:10:59 +02:00
|
|
|
|
2018-10-20 07:20:08 +02:00
|
|
|
cmake options:
|
|
|
|
* `-DCMAKE_BUILD_TYPE=Debug` for a debug build
|
2019-01-20 23:31:58 +01:00
|
|
|
* `-DWITH_TRANSLATIONS=NO` to not compile translations
|
|
|
|
* `-DWITH_MAN=NO` to not compile the manpage
|
2018-10-20 07:20:08 +02:00
|
|
|
* One of:
|
|
|
|
* `-DWITH_DEB=YES` if you want to be able to generate a deb-package
|
|
|
|
* `-DWITH_RPM=YES` if you want to be able to generate an rpm-package
|
|
|
|
|
2018-10-18 01:13:31 +02:00
|
|
|
## Contributing
|
|
|
|
|
|
|
|
Contributions are always welcome. You can submit them as pull requests or via
|
|
|
|
email to `tastytea`@`tastytea.de`.
|
|
|
|
|
|
|
|
### Translations
|
|
|
|
|
|
|
|
To start a new translation, go to `translations/` and copy `whyblocked_en.ts` to
|
|
|
|
a file [appropriate](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements)
|
|
|
|
for the new language. If you want to translate to french for example, that file
|
|
|
|
name would be `whyblocked_fr.ts`.
|
|
|
|
|
|
|
|
Use [Linguist](http://doc.qt.io/qt-5/qtlinguist-index.html) to edit the
|
|
|
|
`.ts`-files.
|
|
|
|
|
2018-08-31 16:09:02 +02:00
|
|
|
## Bugs
|
|
|
|
|
|
|
|
Please report them on the
|
|
|
|
[issue tracker](https://schlomp.space/tastytea/whyblocked/issues) or to
|
|
|
|
`tastytea`@`tastytea.de`.
|
|
|
|
|
2018-10-20 00:34:00 +02:00
|
|
|
## Licence & Copyright
|
2018-08-30 18:10:59 +02:00
|
|
|
|
2019-06-12 00:22:03 +02:00
|
|
|
``` plain
|
2018-08-30 18:10:59 +02:00
|
|
|
Copyright © 2018 tastytea <tastytea@tastytea.de>.
|
|
|
|
License GPLv3: GNU GPL version 3 <https://www.gnu.org/licenses/gpl-3.0.html>.
|
|
|
|
This program comes with ABSOLUTELY NO WARRANTY. This is free software,
|
|
|
|
and you are welcome to redistribute it under certain conditions.
|
|
|
|
```
|
2018-10-20 00:34:00 +02:00
|
|
|
|
2019-06-12 01:21:57 +02:00
|
|
|
The icon is derived from the icons *“messagebox critical”* and *“help”* of the
|
2018-10-20 00:34:00 +02:00
|
|
|
[Gartoon icon theme](https://commons.wikimedia.org/wiki/Gartoon_icons). The
|
|
|
|
original authors were Zeus, Patrick Yavitz and La Mula Francis, who released
|
|
|
|
them under the terms of the
|
|
|
|
[GPL2+](https://www.gnu.org/licenses/old-licenses/gpl-2.0.html) and
|
|
|
|
[DSL](http://www.fsf.org/licensing/licenses/dsl.html). The new icon is released
|
|
|
|
under the same terms.
|