whyblocked/README.md

109 lines
3.8 KiB
Markdown
Raw Normal View History

2018-10-23 03:35:49 -04:00
**Whyblocked** allows you to store the reason why you blocked someone, along with
"receipts", URLs to the posts that led you to block them.
2018-08-30 08:03:25 -04:00
It has a Qt-interface and uses an SQLite-database.
2018-10-13 23:16:16 -04:00
![Screenshot Qt interface](https://doc.schlomp.space/whyblocked/whyblocked_screenshot.png)
2018-08-30 08:30:55 -04:00
## Usage
Start `whyblocked-gui`. You can also start it from the menu of your desktop
2018-10-17 15:20:38 -04:00
environment.
2018-08-30 08:30:55 -04:00
## Install
2018-08-30 17:53:58 -04:00
### Packages
Every [release](https://schlomp.space/tastytea/whyblocked/releases) includes
a .deb-package, an .rpm-package and a .tar.gz-package with precompiled binaries
2018-11-11 20:05:59 -05: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 `dpkg -i` or `rpm -i`, respectively. The packages are signed with the
PGP key [242E5AC4DA587BF9](https://tastytea.de/tastytea_autosign.asc)
(Fingerprint: `F730 1ADF C9ED 2624 48C4 2B64 242E 5AC4 DA58 7BF9`).
2018-08-30 17:53:58 -04:00
Gentoo ebuilds are available via my
[repository](https://schlomp.space/tastytea/overlay).
### From source
#### Dependencies
2018-08-30 08:30:55 -04:00
2018-10-13 17:33:13 -04:00
* C++ compiler (tested: [gcc](https://gcc.gnu.org/) 6/7/8,
2018-10-14 18:57:01 -04:00
[clang](https://llvm.org/) 3/5/6)
2018-11-05 14:27:47 -05:00
* [cmake](https://cmake.org/) (at least 3.2)
* [vsqlite++](http://vsqlite.virtuosic-bytes.com/) (tested: 0.3)
2018-08-30 08:30:55 -04:00
* [libxdg-basedir](http://repo.or.cz/w/libxdg-basedir.git) (tested: 1.2)
2018-11-05 17:29:13 -05:00
* [qtcore](https://www.qt.io/) (tested: 5.11/5.5)
2019-01-12 15:28:29 -05:00
* [qtwidgets](https://www.qt.io/) (tested: 5.11/5.5)
* [libconfig++](https://github.com/hyperrealm/libconfig) (tested: 1.5)
2018-10-19 23:42:42 -04:00
* Optional
2018-11-05 17:29:13 -05:00
* Translations: [lupdate & lrelease](http://doc.qt.io/qt-5/linguist-manager.html) (tested: 5.11/5.5)
2019-01-20 17:31:58 -05:00
* Manpage: [asciidoc](http://asciidoc.org/) (tested: 8.6)
2018-08-30 08:30:55 -04:00
2018-08-30 17:53:58 -04:00
#### Get sourcecode
Download the current
2018-11-03 08:44:10 -04:00
[release](https://schlomp.space/tastytea/whyblocked/releases) and copy
[xdgcfg](https://schlomp.space/tastytea/xdgcfg) into `xdgcfg/`.
2018-08-30 17:53:58 -04:00
2018-11-03 08:06:21 -04:00
If you clone from git, be sure to `git submodule init` and
`git submodule update` afterwards. See the [submodules article in the git book]
(https://git-scm.com/book/en/v2/Git-Tools-Submodules#_cloning_submodules) for
further info.
2018-08-30 17:53:58 -04:00
#### Compile
2018-08-30 08:30:55 -04:00
```SH
mkdir build
cd build
cmake ..
make
make install
```
2018-08-30 12:10:59 -04:00
2018-10-20 01:20:08 -04:00
cmake options:
* `-DCMAKE_BUILD_TYPE=Debug` for a debug build
2019-01-20 17:31:58 -05:00
* `-DWITH_TRANSLATIONS=NO` to not compile translations
* `-DWITH_MAN=NO` to not compile the manpage
2018-10-20 01:20:08 -04: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
## 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 10:09:02 -04:00
## Bugs
Please report them on the
[issue tracker](https://schlomp.space/tastytea/whyblocked/issues) or to
`tastytea`@`tastytea.de`.
2018-10-19 18:34:00 -04:00
## Licence & Copyright
2018-08-30 12:10:59 -04:00
```PLAIN
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-19 18:34:00 -04:00
The icon is derived from the icons `messagebox critical` and `help` of the
[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.