Merge pull request #52 from ticketfrei/master

Last few layout improvements: Let's release!
This commit is contained in:
b3yond 2018-10-13 19:03:30 +02:00 committed by GitHub
commit 740a78ec6e
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 37 additions and 27 deletions

View file

@ -1,7 +1,5 @@
# Ticketfrei social bot # Ticketfrei social bot
Version: 2.0beta
Ticketfrei is a mastodon/twitter/mail bot to dodge ticket controllers in public Ticketfrei is a mastodon/twitter/mail bot to dodge ticket controllers in public
transport systems. transport systems.
@ -13,19 +11,19 @@ your tweet and others can read the info and think twice whether they want to
buy a ticket or not. If enough people, a critical mass, participate for the bot buy a ticket or not. If enough people, a critical mass, participate for the bot
to become reliable, you have positive self-reinforcing dynamics. to become reliable, you have positive self-reinforcing dynamics.
Today, you can use a Twitter, a Mastodon, and Mail with the account. They will Today, you can use a Twitter, Mastodon, Telegram, and Mail with the account.
communicate with each other; if someone warns others via Mail, Twitter and They will communicate with each other; if someone warns others via Mail,
Mastodon users will also see the message. And vice versa. Telegram, Twitter and Mastodon users will also see the message. And vice versa.
In version 2, this bot has received a frontend website. On this website, people In version 2, this repository contains a web application. On this website,
can register an own bot for their city - the website manages multiple bots for people can register an own bot for their city - the website manages multiple
multiple citys. This way, you do not have to host it yourself. bots for multiple citys. This way, you do not have to host it yourself.
In the promotion folder, you'll find some promotion material you can use to In the promotion folder, you'll find some promotion material you can use to
build up such a community in your city. Unfortunately it is in german - but build up such a community in your city. Unfortunately it is in german - but
it's editable, feel free to translate it! it's editable, feel free to translate it!
Website: https://ticketfrei.links-tech.org Website (our flagship instance): https://ticketfrei.links-tech.org
More information: https://wiki.links-tech.org/IT/Ticketfrei More information: https://wiki.links-tech.org/IT/Ticketfrei
@ -34,9 +32,11 @@ More information: https://wiki.links-tech.org/IT/Ticketfrei
Just go to https://ticketfrei.links-tech.org or another website where this software is Just go to https://ticketfrei.links-tech.org or another website where this software is
running. running.
* Register a twitter account
* Register a Mastodon account
* Register on the ticketfrei site * Register on the ticketfrei site
* Optionally: register bots:
* Register a Twitter account
* Register a Mastodon account
* Register a Telegram bot
* Configure account * Configure account
* The hard part: do the promotion! You need a community. * The hard part: do the promotion! You need a community.
@ -50,7 +50,7 @@ to check if something was retweeted in the last hour or something.
To this date, we have never heard of this happening though. To this date, we have never heard of this happening though.
### blockisting ### Blocklisting
You also need to edit the goodlist and the blocklist. You can do this on the You also need to edit the goodlist and the blocklist. You can do this on the
website, in the settings of your bot. website, in the settings of your bot.
@ -70,9 +70,9 @@ a GitHub issue or write to tech@lists.links-tech.org, we are happy to help and s
We wrote these installation notes, so you can set up the website easily: We wrote these installation notes, so you can set up the website easily:
### Install ### Install from the git repository
To Do: This guide assumes you are on a Debian 9 Server:
```shell ```shell
sudo apt install python3 virtualenv uwsgi uwsgi-plugin-python3 nginx git exim4 sudo apt install python3 virtualenv uwsgi uwsgi-plugin-python3 nginx git exim4
@ -101,10 +101,11 @@ cp config.toml.example config.toml
vim config.toml vim config.toml
``` ```
This configuration is only for the admin. Users can log into This configuration is only for the admin. Moderators can log into
twitter/mastodon/mail and configure their personal bot on the settings page. twitter/mastodon/mail and configure their personal bot on the settings page.
Set up LetsEncrypt: Set up LetsEncrypt:
```shell ```shell
sudo apt-get install python-certbot-nginx -t stretch-backports sudo apt-get install python-certbot-nginx -t stretch-backports
sudo certbot --authenticator webroot --installer nginx --agree-tos --redirect --hsts sudo certbot --authenticator webroot --installer nginx --agree-tos --redirect --hsts
@ -176,11 +177,15 @@ less /var/log/syslog
# for the nginx web server: # for the nginx web server:
less /var/log/nginx/example.org_error.log less /var/log/nginx/example.org_error.log
# for the mail server
less /var/log/exim4/mainlog
``` ```
### Development Install ### Development Install
If you want to install it locally to develop on it: If you want to install it locally to develop on it, note that twitter and mail
will probably not work. You should test them on a server instead.
```shell ```shell
sudo apt install python3 virtualenv uwsgi uwsgi-plugin-python3 nginx git sudo apt install python3 virtualenv uwsgi uwsgi-plugin-python3 nginx git

View file

@ -15,13 +15,14 @@
your city into a paradise for fare dodgers. your city into a paradise for fare dodgers.
</p> </p>
<p> <p>
Ticketfrei is a Twitter, Mastodon, and E-Mail bot. Users Ticketfrei is a Twitter, Mastodon, Telegram, and E-Mail
can help each other by tweeting, tooting, or mailing, bot. Users can help each other by tweeting, tooting,
when and where they spot a ticket controller. messaging, or mailing, when and where they spot a ticket
controller.
</p> </p>
<p> <p>
Ticketfrei automatically retweets, boosts, and remails Ticketfrei automatically spreads those controller reports
those controller reports, so others can see them. If there in the other networks, so others can see them. If there
are ticket controllers around, they can still buy a ticket are ticket controllers around, they can still buy a ticket
- but if the coast is clear, they can save the money. - but if the coast is clear, they can save the money.
</p> </p>
@ -31,22 +32,26 @@
to other citys. There are four basic steps: to other citys. There are four basic steps:
</p> </p>
<ul> <ul>
<li>Create a Twitter and/or a Mastodon account.</li>
<li>Register on this website to create a bot for your city.</li> <li>Register on this website to create a bot for your city.</li>
<li>Create a Twitter, a Telegram, and/or a Mastodon account.</li>
<li>Log in with the social media accounts you want to <li>Log in with the social media accounts you want to
use for Ticketfrei.</li> use for Ticketfrei.</li>
<li>Promote the service! Ticketfrei only works if there is <li>Promote the service! Ticketfrei only works if there is
a community for it. Fortunately, we prepared some material a community for it. Fortunately, we prepared some material
you can use: you can edit, remix, use, and republish:
<a href="https://github.com/ticketfrei/promotion" target="_blank">https://github.com/ticketfrei/promotion</a></li> <a href="https://github.com/ticketfrei/promotion" target="_blank">https://github.com/ticketfrei/promotion</a>
<ul>
<li>If you build cool promotion material yourself, please
share it with us, so others can use it, too!</li>
</ul></li>
</ul> </ul>
% include('template/register-plain.tpl') % include('template/register-plain.tpl')
<h2>Our Mission</h2> <h2>Our Mission</h2>
<p> <p>
Public transportation is meant to provide an easy and Public transportation is meant to provide an easy and
time-saving way to move within a region while being time-saving way to move within a region while being
affordable for everybody. Unfortunately, this is not the affordable for everybody. Unfortunately, this is not yet
case. Ticketfrei's approach is to enable people to the case. Ticketfrei's approach is to enable people to
reclaim public transportation. reclaim public transportation.
</p> </p>
<p> <p>
@ -58,7 +63,7 @@
<p> <p>
Because with Ticketfrei you're able to use trains and Because with Ticketfrei you're able to use trains and
subways for free anyway. Take part and create a new subways for free anyway. Take part and create a new
understanding of what public transportation should look understanding of what public transportation could look
like! like!
</p> </p>