Agenda du libre
===============

L'Agenda du libre est un calendrier d'évènements (qui sont proposés
par tout un chacun mais nécessitant une modération avant d'être
affichés).

C'est une application web qui est disponible sous la licence GNU AGPL
version 3 ou supérieure et son code source est hébergé ici:
https://git.framasoft.org/agenda-libre/agenda-libre-ruby et utilisable
notamment ici: https://www.agendadulibre.org

Le logiciel adl-submit est un client qui peut interagir avec une
instance de L'Agenda du libre, pour pouvoir proposer un évènement soit
à partir des argument de adl-submit en ligne de commande, soit en
envoyant les données provenant d'un fichier XML.

Code source et utilisation
==========================

Pour pourvoir utiliser adl-submit sous Debian 12 (bookworm), il faut
installer le paquet `python3-pycurl`.

On peut ensuite télécharger adl-submit avec la commande suivante:

` ~ $ git clone https://framagit.org/agenda-libre/adl-submit.git`

On doit ensuite aller dans le répertoire téléchargé:

`~ $ cd adl-submit`

Une fois téléchargé, on peut simplement lancer adl-submit dans un
terminal avec la commandes suivante (ici on va afficher l'aide):

`~ $ python3 adl-submit --help`

On peut aussi le télécharger depuis une instance de l'Agenda du libre
comme par exemple https://www.agendadulibre.org/adl-submit.py.

Et voici la commande pour le lancer:

`~ $ python3 adl-submit.py --help`

Pip
===

On peut aussi installer adl-submit dans un répertoire local avec
pip. Pour faire ça on peut exécuter les commandes suivantes:

```
~ $ python3 -m venv adl-submit
~ $ adl-submit/bin/pip install \
    git+https://framagit.org/agenda-libre/adl-submit.git
```

Une fois que c'est fait, adl-submit peut ensuite être exécuté
localement:

```
~ $ adl-submit/bin/adl-submit --help
Soumettre un évènement dans l'Agenda du Libre

Options:
    --file        event.xml   Fichier XML décrivant l'évènement.
[...]
```

Licence
=======

adl-submit est un logiciel libre ; vous pouvez le redistribuer et/ou
le modifier au titre des clauses de la version 2 de la Licence
Publique Générale GNU, telle que publiée par la Free Software
Foundation.

adl-submit est distribué dans l'espoir qu'il sera utile, mais SANS
AUCUNE GARANTIE ; sans même une garantie implicite de COMMERCIABILITE ou
DE CONFORMITE A UNE UTILISATION PARTICULIERE. Voir la Licence Publique
Générale GNU pour plus de détails.

Vous devriez avoir reçu un exemplaire de la Licence Publique Générale GNU
avec ce programme ; si ce n'est pas le cas, écrivez à la Free Software
Foundation Inc., 51 Franklin Street, Fifth Floor, Boston,
MA 02110-1301, USA.

Contributions
=============

Vu que adl-submit n'est pas encore packagé dans les distributions
comme Debian, quand on contribue à adl-submit, on doit faire en sorte
que adl-submit continue à fonctionner si on ne télécharge que le
fichier adl-submit.py.

Discussions
===========

Il existe un canal de communication IRC (#agendadulibre) dans le
réseau Libera Chat.
