markup changes
This commit is contained in:
parent
b9906e847c
commit
6a1abe8691
82
README.md
82
README.md
@ -22,7 +22,6 @@ A few examples:
|
||||
* [CluebotNG](https://en.wikipedia.org/wiki/User:ClueBot_NG)
|
||||
* [How to do anything](https://mastodon.social/@wikihow)
|
||||
|
||||
|
||||
**Bots as Tools to Intervene in Conversations**
|
||||
|
||||
What would it mean to become more entangled with bots, redistribute the labour of making and maintaining a collective, but without falling into the metaphorical understanding of bot as a servant?
|
||||
@ -37,62 +36,51 @@ Currently, we use:
|
||||
|
||||
* [Streambot](https://git.vvvvvvaria.org/varia/xmpp.streambot): a bot that saves the images sent to the main Varia group chat and creates an [html page](https://vvvvvvaria.org/stream/) for them.
|
||||
* [Logbot](https://git.vvvvvvaria.org/varia/logbot): a bot that [logs](https://vvvvvvaria.org/logs/) the quotes that are sent to it.
|
||||
* You can find a genealogy of the bots around Varia in this footnote[^2]
|
||||
* You can find a genealogy of the bots around Varia in this footnote[^genealogy]
|
||||
|
||||
<br>
|
||||
|
||||
Let's look into the bots [examples](https://git.vvvvvvaria.org/ccl/bots-of-conduct):
|
||||
|
||||
|
||||
### Transit
|
||||
|
||||
**_name:_** transit.py;
|
||||
**_name:_** transit.py
|
||||
|
||||
**_action mode:_** announces when someone enters or leaves the room;
|
||||
**_action mode:_** announces when someone enters or leaves the room
|
||||
|
||||
**_situation:_** finding non-verbal ways of communicating through presence and absence; making presence felt otherwise;
|
||||
|
||||
<br>
|
||||
**_situation:_** finding non-verbal ways of communicating through presence and absence, making presence felt otherwise
|
||||
|
||||
### Gather
|
||||
|
||||
**_name:_** gather.py;
|
||||
**_name:_** gather.py
|
||||
|
||||
**_action mode:_** generates a shared language; it creates a collective document;
|
||||
**_action mode:_** generates a shared language; it creates a collective document
|
||||
|
||||
**_situation:_** a collective discursive setting that generates its own vocabulary;
|
||||
|
||||
<br>
|
||||
**_situation:_** a collective discursive setting that generates its own vocabulary
|
||||
|
||||
### Greet
|
||||
|
||||
**_name:_** greet.py;
|
||||
**_name:_** greet.py
|
||||
|
||||
**_action mode:_** sends a message when it enters the room;
|
||||
**_action mode:_** sends a message when it enters the room
|
||||
|
||||
**_situation:_** when there is a theme, for example: "send a reference to an existing or imaginary code of conduct, complaint, guideline, bug report, open letter, license or other social-technical protocol and explain why it is of interest to you."; how one wants to be introduced;
|
||||
|
||||
<br>
|
||||
**_situation:_** when there is a theme, for example: "send a reference to an existing or imaginary code of conduct, complaint, guideline, bug report, open letter, license or other social-technical protocol and explain why it is of interest to you."; how one wants to be introduced
|
||||
|
||||
### Spark
|
||||
|
||||
**_name:_** spark.py;
|
||||
**_name:_** spark.py
|
||||
|
||||
**_action mode:_** replies to a specific word; brings alternatives into the situation; tries to create new habits and terminologies;
|
||||
**_action mode:_** replies to a specific word; brings alternatives into the situation; tries to create new habits and terminologies
|
||||
|
||||
**_situation:_** potentially in moments when a situation seems difficult and there is a need for more joyful interactions;
|
||||
|
||||
<br>
|
||||
**_situation:_** potentially in moments when a situation seems difficult and there is a need for more joyful interactions
|
||||
|
||||
### Whisper
|
||||
|
||||
**_name:_** whisper.py
|
||||
|
||||
**_action mode:_** takes what someone says to it in confidentiality and echoes it to a group chat, thus anonymising it;
|
||||
**_action mode:_** takes what someone says to it in confidentiality and echoes it to a group chat, thus anonymising it
|
||||
|
||||
**_situation:_** there are remarks or complaints in the room, but the person does not feel comfortable to bring up the issue themselves;
|
||||
|
||||
<br>
|
||||
**_situation:_** there are remarks or complaints in the room, but the person does not feel comfortable to bring up the issue themselves
|
||||
|
||||
## Installing and Running the Bots
|
||||
|
||||
@ -107,7 +95,7 @@ Some installation guides can be found under the following links.
|
||||
|
||||
**python3 + pip3**:
|
||||
|
||||
*For computers running **Windows OS** or **Mac OS***:
|
||||
For computers running **Windows OS** or **Mac OS**:
|
||||
|
||||
1. check what version of Python you have on your computer with `$ python --version`
|
||||
2. if you have python 2.x, try also the following, to be sure that you don't have python3 already: `$ python3 --version`
|
||||
@ -119,9 +107,9 @@ Some installation guides can be found under the following links.
|
||||
pip3 comes installed with python3.
|
||||
You can check if it installed correctly by running: `$ pip3 --version`
|
||||
|
||||
<br>
|
||||
-----
|
||||
|
||||
*For computers running **Linux OS***
|
||||
For computers running **Linux OS**:
|
||||
|
||||
* open the terminal
|
||||
* check which version of python you have:
|
||||
@ -135,33 +123,31 @@ You can check if it installed correctly by running: `$ pip3 --version`
|
||||
|
||||
This is the Python library we use to make the bots. You can install it by running: $ pip3 install slixmpp
|
||||
|
||||
**run the bots!**:
|
||||
|
||||
* download the bots from this page
|
||||
* go to the folder where you have installed them
|
||||
* run the following commands in the terminal:
|
||||
> pip3 install slixmpp requests
|
||||
* to run a bot, you can copy paste the commands which are already mentioned in the bot file, but a general command looks like this:
|
||||
> python3 bot.py -d -j administratorbot@conversejs.org -r botsofconduct@muc.vvvvvvaria.org -n bot -p testing
|
||||
* where:
|
||||
- j stands for JID (jabber id)
|
||||
- r means room
|
||||
- n stands for bot nickname
|
||||
- o stands for for output
|
||||
- . means here
|
||||
|
||||
**code editor**:
|
||||
|
||||
* if you dont have a code editor, we can suggest (among others) [Sublime Text](https://www.sublimetext.com/)
|
||||
* to install the conversations app on your phone, you could use either Conversations or [Quicksy](https://quicksy.im/) for Android phones (among others)
|
||||
|
||||
## Run the bots!
|
||||
|
||||
* download the bots from this page
|
||||
* go to the folder where you have downloaded them
|
||||
* run the following commands in the terminal:
|
||||
`$ pip3 install slixmpp requests`
|
||||
* to run a bot, you can copy paste the commands which are already mentioned in the bot file, but a general command looks like this:
|
||||
`$ python3 bot.py -d -j administratorbot@conversejs.org -r botsofconduct@muc.vvvvvvaria.org -n bot -p testing`
|
||||
* where:
|
||||
`-j` stands for JID (jabber id) \
|
||||
`-r` means room \
|
||||
`-n` stands for bot nickname \
|
||||
`-o` stands for for output \
|
||||
`. ` means here \
|
||||
|
||||
## Footnotes
|
||||
|
||||
**Link to references [pad](https://pad.vvvvvvaria.org/Bots_of_Conduct_References) — further references and materials assembled by Joana and Cristina - feel free to add your own!**
|
||||
|
||||
[^1]: Varia is not merely a collective, nor merely a space. Varia is an interdependent concatenation of both
|
||||
|
||||
[^2]: genealogy of bots
|
||||
[^genealogy]: genealogy of bots
|
||||
|
||||
* https://gitlab.com/relearn/relearn2017/blob/master/xmpp-bots/timekeeper-bot/timekeeper.py (Relearn 2017)
|
||||
* https://gitlab.com/relearn/relearn2017/blob/master/xmpp-bots/collection-bot/collection-bot.py (Relearn 2017)
|
||||
|
||||
Loading…
Reference in New Issue
Block a user