# Fonctionnalités de Aktivisda

Aktivisda permet principalement de faire quatre choses différentes :
1. **Éditer des visuels**, à partir d'exemples déjà remplis
2. **Accéder à la charte graphique de l'organisation** sans devoir chercher des documents au fin fond du cloud de l'organisation
3. **Générer des codes QR** facilement sans offrir toutes ses données à des entreprises privées
4. **Respecter la vie privée des personnes** en réalisant toutes les modifications directement sur le navigateur et en permettant de flouter des visages ou n'importe quel élément personnel d'une photo

Les différentes fonctionnalités ou familles de fonctionnalités ne sont pas définitives et évoluent au fil du temps en fonction des besoins des organisations.

👉 Pour formuler ou suivre des demandes d'évolutions, utiliser les tickets du projet sur [Framagit](https://framagit.org/aktivisda/aktivisda/-/issues).

## 1️⃣ Éditer des visuels

Le cœur historique de Aktivisda est l'édition des visuels.

Pour chaque type de composants, il est possible de les déplacer, de les redimensionner et de changer l'indice de profondeur pour distinguer ce qui est au premier plan de ce qui est au dernier plan. Chaque élément peut être dupliqué. Toutes les modifications peuvent être annulées.

L'édition des visuels peut être partiellement faite au clavier, grâce aux raccourcis claviers : suppr, ctrl + D pour dupliquer, ctrl + z pour annuler une modification (ctrl + y pour la rétablir), pageup et pagedown pour mettre un élément plus en avant ou plus en arrière.


### Manipuler des images vectorielles

Aktivisda permet de manipuler des images vectorielles (format `svg`). Le format binaire (`.svgz`) est également supporté.

L'utilisation d'un tel format permet :
* de limiter le poids de l'image (souvent) ;
* d'agrandir autant que souhaité les images ;
* de changer les couleurs d'une image.

Pour chacune de ces images, il est possible de spécifier automatiquement la _zone cliquable_.

Il n'est pas possible de charger des images svg depuis son ordinateur.

### Manipuler des photos

On peut manipuler des photos déjà présentes dans la galerie d'images ou bien depuis son ordinateur.

Pour le moment, il n'est pas possible de rogner les photos (ticket [#103](https://framagit.org/aktivisda/aktivisda/-/issues/103) ou bien d'ajouter des filtres (flous, filtres colorés) (ticket [#102](https://framagit.org/aktivisda/aktivisda/-/issues/102)) ou encore de changer l'opacité (ticket [#18](https://framagit.org/aktivisda/aktivisda/-/issues/18)).

Il est envisagé de permettre de brancher une galerie de photos (dossier partagé) Nextcloud à Aktivisda (voir ticket [#154](https://framagit.org/aktivisda/aktivisda/-/issues/154)).

### Manipuler l'image de fond et les dimensions du document

On peut changer la taille du visuel exporté parmi une liste de format pré-définie ou bien en indiquant directement le format souhaité (hauteur x largeur).

L'image de fond du modèle peut également être choisie parmi une liste de photos ou d'images vectorielles mises à disposition sur l'instance.
Les photos et images vectorielles disposent des mêmes fonctionnalités que lorsqu'elles sont utilisées en tant que symboles.

On peut, en un clic, redimensionner le visuel à la dimension de l'image de fond.

### Manipuler des textes

Sur Aktivisda, on peut ajouter des zones de texte, les redimensionner, les déplacer, changer l'alignement (à gauche, centré, à droite), changer la couleur (couleur personnalisée ou bien une couleur de la charte graphique), changer la police (choix parmi les polices de la charte graphique).

Les textes peuvent être directement modifiés dans l'éditeur en double-cliquant dessus.

Il n'est par contre pas possible d'enrichir le texte en mettant certains mots en couleur ou bien certains mots en italique. Pour en savoir plus sur les essais réalisés, voir le ticket [#131](https://framagit.org/aktivisda/aktivisda/-/issues/131). Cela freine grandement l'usage de Aktivisda pour créer des flyers ou tracts avec beaucoup de texte.

Si des émojis sont ajoutés, ces derniers n'apparaîtront pas dans l'export pdf (voir ticket [#90](https://framagit.org/aktivisda/aktivisda/-/issues/90)).

On peut ajouter un _fond coloré_ derrière le texte. Ce dernier peut-être rectangulaire, un quadrilataire quelconque, plus ou moins différent d’un rectangle suivant un paramètre sélectionné, ou un rectangle avec _angles arrondis_ (voir ticket [#207](ttps://framagit.org/aktivisda/aktivisda/-/issues/207)
Il est envisageable de créer automatiquement d'autres formes géométriques derrière les textes pour s'adapter aux usages graphiques de chaque organisation.

### Exporter le visuel

Il est possible d'exporter un visuel en `png` ou `jpg`. La sortie jpeg est recommandée dès que des photos sont présentes ou bien qu'il y a beaucoup de couleurs. Autrement, utiliser la sortie png.
Les fichiers sont compressés directement dans le navigateur avec [oxipng](https://github.com/shssoichiro/oxipng) et [mozjpeg](https://github.com/mozilla/mozjpeg).

On peut aussi exporter en `pdf`. Et ce sont **vraiment** des pdf, c'est-à-dire que les textes et images (si vectorielles) ne sont pas pixellisés, et ce quelque soit le niveau de zoom appliqué. C'est ce qui est recommandé pour l'impression.

Les sorties « images » (png, jpg) et « pdf » sont réalisés différemment dans Aktivisda. Cela explique qu'il puisse y avoir des différences entre les deux. Les différences peuvent être remontées à l’équipe de développement via [Framagit](https://framagit.org/aktivisda/aktivisda/-/issues) pour qu'elles soient corrigées.
D'une manière générale, certaines fonctionnalités sont absentes de l'export pdf ou sont ajoutées bien plus tard.

### Sauvegarder et recharger un visuel

Les visuels peuvent être téléchargés sur son ordinateur pour être modifiés plus tard ou pour être diffusé à d’autres personnes. Cet export prend la forme d'un fichier `json` qui peut être chargé sur Aktivisda.

Le format du fichier est le format interne à Aktivisda (**Todo** : ajouter lien vers la documentation). Ce format ne peut pas être ouvert dans d'autres logiciels de manipulation d'image mais est néanmoins documenté et peut être modifié _à la main_.

Pour les images présentes dans la galerie de Aktivisda, seuls leurs identifiants sont stockés dans le fichier. Par contre, les images chargées depuis son ordinateur sont stockées dans le fichier. Cela signifie qu'en rechargeant le fichier, les différentes photos et images seront chargées automatiquement.

!> ⚠️ **Pour les administrateur·ices** : attention à ne pas supprimer des images car cela invaliderait les fichiers des utilisateur·ices qui référençaient une image qui n'est plus présente dans Aktivisda.

Plutôt que de créer un fichier, on peut décider de _créer une url_ qui contient le contenu de modèle. Il s'agit d'une url à rallonge. Aucune information n'est stockée dans Aktivisda. Cette fonctionnalité ne marche pas dès que le modèle est un peu complexe ou contient des photos chargées localement (voir ticket [#149](https://framagit.org/aktivisda/aktivisda/-/issues/149)).

Il est également possible (fonctionnalité jamais utilisée en production) de pré-remplir Aktivisda en ajoutant des paramètres dans l'url.

## 2️⃣ Accéder à la charte graphique

Aktivisda a vocation à rassembler en son sein l'intégralité des éléments graphiques d'une organisation (couleurs, photos, polices de caractères, etc.) afin de permettre aux militant·es de créer leurs visuels.

Mais les graphistes qui créent des visuels plus élaborés ou d'autres supports de communication, type tracts ou vidéos ont également besoin de trouver la charte graphique et les visuels types. Étant donné que ces informations sont déjà présentes dans Aktivisda, il était naturel de les rendre accessibles facilement et ce, sans passer par l'éditeur graphique.

Chaque type d'élément graphique dispose de son propre onglet (modèles, symboles, images de fond, couleurs, polices de caractères). Chaque onglet est similaire avec une galerie exhaustive.

Les images peuvent être téléchargées dans leur format original. Dans le cas d'une image vectorielle, on peut préalablement changer la couleur et choisir de la télécharger en png haute résolution.

Les polices de caractères peuvent être téléchargées dans différents formats.

Toutes les galeries sauf les polices de caractères (voir ticket [#189](https://framagit.org/aktivisda/aktivisda/-/issues/189)) peuvent être filtrées avec un système de tags/catégories. Chaque élément peut appartenir à plusieurs catégories.

## 3️⃣ Générer des codes QR

Souvent, les sites web permettant de générer des codes QR sont couplés à des raccourcisseurs d'URL et donc, lorsqu'on crée un code QR avec ces sites, on redirige l'intégralité du flux par l'entreprise qui met à disposition le code QR.

Cela n'est pas très résilient (dépendance à cette entreprise) et pas top au niveau des données des utilisateur·ices de votre service.

Aktivisda propose tout simplement de générer des codes QR qui redirigent vers n'importe quelle URL. Lorsque les personnes scannent un code QR généré par Aktivisda, elles ne voient que l'URL renseignée et absolument pas Aktivisda.

Parce que cela serait dommage de s'arrêter là, Aktivisda propose d’intégrer au centre du code QR n'importe quelle image (par exemple un logo). Cela fonctionne parce qu'un code QR contient beaucoup d'informations en double ou en triple afin de pouvoir être scanné même s'il est un peu abîmé ou s'il y a des reflets. Cette redondance de l'information permet de faire en sorte, qu'en insérant un logo au milieu, le code QR soit toujours valide.

!> Attention à toujours vérifier que le code QR généré soit valide avant de le diffuser largement ou de lancer une impression.

## 4️⃣ Respecter la vie privée


### Support du floutage

Lorsqu'on manipule des photos, pour des raisons de respect de la vie privée il peut être souhaitable de dissimuler certaines portions (informations de localisation, adresse) ou des visages. Cela peut être réalisé dans l'éditeur d'Aktivisda avec un système de "flou" (plusieurs paramétrages possibles) ou d'ajout d'émojis.

### Gestion des méta-données

Par ailleurs, les images réalisées par Aktivisda ne contiennent pas de méta-données personnelles. Charger une photo dans Aktivisda puis télécharger le visuel permet ainsi d'obtenir une image sans méta-données.

### Opérations 100% en local

À la différence d'autres logiciels, toutes les modifications effectuées dans Aktivisda se passent entièrement dans votre navigateur : les images que vous chargez ou les textes que vous écrivez restent chez vous et ne sont aucunement communiqués au gestionnaire de votre instance. Même la compression des images est réalisée dans le navigateur (grâce à la technologie de _web assembly_).