wiki, modèle, comment participer

Modèle : page application

Cette page présente un modèle de base servant à la rédaction d'un article sur une application dans cette documentation. Pour récupérer le code Dokuwiki de cette page, servez vous du modèle à copier/coller ou télécharger, en bas de cette page. Cette présentation est suggérée, mais n'est pas statique ; n'hésitez pas à personnaliser vos pages. Par contre, ne modifiez pas cette page modèle !

Quelques conventions à respecter au maximum :

Le nom de la page (URL) doit être le nom du paquet principal de l'application ou le nom de l'application si elle n'est pas présente dans les dépôts.
La page doit se situer à la racine du wiki.
Par exemple, la page sur le navigateur web Mozilla Firefox sera à l'adresse : http://doc.ubuntu-fr.org/firefox.
Évitez les fautes d'orthographe (si vous pensez avoir laissé des fautes, ajoutez le tag orthographe_a_corriger à la page).

Le modèle annoté commence ICI.

Resolute, Noble, BROUILLON

Les tags d'une page "application" sont à introduire dans l'ordre suivant :
Versions¹⁾ autres_tags²⁾ BROUILLON
Pour en savoir plus sur l'usage des tags : voir ici.

Nom de l'application

Il est important de mettre un et un seul titre de niveau 1 (H1) à toutes vos pages. Ainsi, si une page liste toutes les pages contenant un des tags de cette page, alors cette page pourra être inclue à la liste. Dans le cas contraire, elle ne le pourra pas (et dans ce cas-là, les tags ne servent à rien).

Rédigez ici une courte introduction sur l'application.
De manière brève, concise et claire, indiquez par exemple ce à quoi est destinée l'application, dans quel cas elle peut être utile, la licence sous laquelle elle est diffusée, toute autre information que vous jugerez utile de savoir avant de commencer la lecture de la page… Par exemple :

Le logiciel Bidule est un gestionnaire d'archives sous licence libre (GPL v3), ayant la particularité de pouvoir …

Optionnel: [Capture d'écran du logiciel fonctionnant sous Ubuntu (voir ce tutoriel)]

Chaque section aura un titre de niveau 2 (H2) puis ses sous-sections, un titre de niveau 3 (H3) et ainsi de suite… Remarque : il n'y a que 5 niveaux de titre, ce qui devrait être amplement suffisant.

Installation

Il existe plusieurs méthodes au choix pour installer Bidule :

Il est disponible dans les dépôts officiels APT d'Ubuntu.
Il est distribué par ses développeurs en Flatpak.
Il existe un paquet snap non-officiel.
Bidule est aussi disponible en AppImage sur son site officiel.
Bidule est aussi disponible depuis un PPA, mais cette méthode est désormais déconseillée.

Vous trouverez aussi des informations en anglais concernant le téléchargement et l'installation de Bidule sur son site officiel.

Dépôts officiels APT

Pour avoir accès à ce paquet, il faut que le dépôt Universe soit activé dans les sources de logiciels.

Pour installer ce logiciel depuis les dépôts officiels, il suffit d'installer le paquet bidule.

Flatpak

Bidule est aussi distribué par ses développeurs en Flatpak sur le dépôt Flathub.

On peut donc l'obtenir en installant Flatpak avec le dépôt Flathub si ce n'est pas déjà fait, puis en installant Bidule depuis GNOME Logiciels, ou en installant le paquet com.example.bidule en ligne de commande :

flatpak install com.example.bidule

Snap

Bidule est aussi disponible en snap depuis Snapcraft. Cette version n'est cependant pas officielle.

On peut simplement installer l'application Bidule depuis le centre d'applications (Snap Store), ou installer le paquet bidule en ligne de commande :

snap install bidule

AppImage

Cette méthode ne permet pas de mise à jour automatique.

L'intégration au système (dont la création d'un lanceur) doit aussi être faite manuellement.

Pour installer une AppImage référez-vous avant tout au chapitre dédié au sujet.

En résumé téléchargez le fichier XXXX.AppImage sur le site officiel ou GitHub, puis rendez-le exécutable (clic droit sur le fichier → Propriétés → Permissions → Autoriser l’exécution). Finalement lancez-le en double-cliquant dessus.

Vous pouvez utiliser un service tel que appimaged pour créer automatiquement un lanceur.

PPA

L'ajout d'un PPA est plus dangereux que l'utilisation de Flatpak ou snap (voir cet avertissement).

Cette méthode peut aussi poser des problèmes lors d'une mise à niveau.

Vous pouvez aussi installer Bidule depuis le PPA nom_du_ppa :

ajouter le PPA ppa:<nom_du_dépôt>³⁾ aux sources de logiciels
recharger la liste de vos paquets
puis installer le paquet bidule

Configuration

Tout d'abord, ouvrez le fichier /truc/machin/bidule en modification puis…

Configuration particulière ? Expliquez les détails utiles de configuration (il n'est pas nécessaire de faire un copier-coller de la page de manuel ; les grandes lignes suffisent avec éventuellement un lien dans les références).

Utilisation

Lancez l'application comme indiqué ici ou via le terminal (toutes versions ou variantes d'Ubuntu) avec la commande suivante :

machin-chose

Raccourcis intéressants ? Fonctions cachées ? Expliquez le fonctionnement général de ce que vous présentez (là non plus, il n'est pas nécessaire de copier-coller la page de manuel).

Désinstallation

Pour désinstaller cette application, il suffit de supprimer son paquet :

Pour la version des dépôts Ubuntu APT, vous pouvez passer par le centre d'applications, ou en ligne de commande :
```
sudo apt remove bidule
```
Les préférences de l'utilisateur stockées dans son répertoire personnel sont conservées.
Pour la version Flatpak, vous pouvez passer par GNOME Logiciels (si vous avez le plugin Flatpak), ou en ligne de commande :
```
flatpak uninstall com.example.bidule
```
Pour la version snap, vous pouvez passer par le centre d'applications, ou en ligne de commande :
```
snap remove bidule
```
Pour la version Appimage, supprimez simplement le fichier bidule.AppImage.

Voir aussi

Site officiel
(en) Documentation officielle
Discussion J'ai un soucis avec le logiciel Bidule sur le forum

Si vous considérez que votre contribution à la page de documentation est significative et/ou que vous souhaitez pouvoir être contacté par les lecteurs, vous avez la possibilité de la signer en ajoutant votre identifiant dans la ligne ci-dessous. Vous pouvez aussi vous abonner aux modifications de la page en cliquant sur "S'abonner à la page" (menu en haut à gauche).

Contributeurs : votre nom ou pseudonyme si différent de l'identifiant, autre_identifiant.

Si vous vous êtes basé sur un document existant pour écrire votre article, citez la source originale ! Ceci est indispensable afin de respecter les droits d'auteur.

Basé sur Titre original de l'article par Auteur Original.
Discussion au sujet de cette page sur le forum.

Le modèle annoté se termine ICI.

Modèle à copier-coller

modèle_application

{{tag>Resolute Noble BROUILLON}}
 
====== Nom de l'application ======
 
Le logiciel **Bidule** est un [[:archivage|gestionnaire d'archives]] sous licence libre ([[http://fr.wikipedia.org/wiki/Licence_publique_g%C3%A9n%C3%A9rale_GNU|GPL v3]]), ayant la particularité de pouvoir ...
 
Optionnel: [Capture d'écran du logiciel fonctionnant sous Ubuntu (voir [[:wiki:ajout_image|ce tutoriel]])]
 
<note important>Chaque section aura **un titre de niveau 2** (H2) puis ses sous-sections, **un titre de niveau 3** (H3) et ainsi de suite… Remarque : il n'y a que 5 niveaux de titre, ce qui devrait être amplement suffisant.</note>
 
===== Installation =====
 
Il existe plusieurs méthodes //au choix// pour installer **Bidule** :
  * Il est disponible dans les [[#dépôts officiels APT]] d'Ubuntu.
  * Il est distribué par ses développeurs en [[#Flatpak]].
  * Il existe un paquet [[#snap]] non-officiel.
  * **Bidule** est aussi disponible en [[#AppImage]] sur son [[https://www.example.com/download/|site officiel]].
  * **Bidule** est aussi disponible depuis un [[#PPA]], mais cette méthode est désormais déconseillée.
 
<note tip>
Vous trouverez aussi des informations en anglais concernant le téléchargement et l'installation de **Bidule** sur son [[https://example.com/installation|site officiel]].
</note>
 
==== Dépôts officiels APT ====
 
<note>
Pour avoir accès à [[pu>bidule|ce paquet]], il faut que le [[:depots#sections_universe_et_multiverse_maintenues_par_les_motu|dépôt Universe]] soit activé dans les [[:tutoriel:comment_modifier_sources_maj|sources de logiciels]].
</note>
 
Pour installer ce logiciel depuis les [[:depots#dépôts officiels]], il suffit d'[[:deb#installer_un_paquet_deb|installer le paquet]] ''[[apt>bidule]]''.
 
==== Flatpak ====
 
**Bidule** est aussi distribué par ses développeurs en [[:Flatpak]] sur le dépôt [[https://flathub.org/fr/apps/com.example.bidule|Flathub]].
 
On peut donc l'obtenir en [[:flatpak#installation|installant Flatpak]] avec le [[:flatpak#ajout_du_depot_flathub|dépôt Flathub]] si ce n'est pas déjà fait, puis en installant ''Bidule'' depuis [[:gnome-software|GNOME Logiciels]], ou en [[:gerer_flatpak#installation_d_applications|installant le paquet]] ''[[https://flathub.org/fr/apps/com.example.bidule|com.example.bidule]]'' en ligne de commande :
<code>flatpak install com.example.bidule</code>
 
==== Snap ====
 
**Bidule** est aussi disponible en [[:snap]] depuis [[https://snapcraft.io/bidule|Snapcraft]]. Cette version n'est cependant pas officielle.
 
On peut simplement installer l'application ''Bidule'' depuis le [[:snap store|centre d'applications (Snap Store)]], ou installer le paquet ''[[https://snapcraft.io/bidule|bidule]]'' en ligne de commande :
<code>snap install bidule</code>
 
==== AppImage ====
 
<note important>
Cette méthode ne permet pas de mise à jour automatique.
 
L'intégration au système (dont la création d'un [[:raccourci-lanceur|lanceur]]) doit aussi être faite manuellement.
</note>
 
Pour installer une **[[:AppImage]]** référez-vous avant tout au [[:appimage#installer_un_appimage|chapitre dédié]] au sujet.
 
En résumé téléchargez le fichier ''XXXX.AppImage'' sur [[https://bidule.com/download/|le site officiel]] ou [[https://github.com/bidule/bidule/releases/latest|GitHub]], puis [[:permissions#modifier_les_permissions|rendez-le exécutable]] (clic droit sur le fichier -> //Propriétés// -> //Permissions// -> //Autoriser l’exécution//). Finalement lancez-le en double-cliquant dessus.
 
Vous pouvez utiliser un service tel que **[[:appimage#go_appimageappimaged|appimaged]]** pour créer automatiquement un [[:raccourci-lanceur|lanceur]].
 
==== PPA ====
 
<note important>
L'ajout d'un [[:PPA]] est plus dangereux que l'utilisation de [[#Flatpak]] ou [[#snap]] (voir cet [[:ppa#presentation_des_depots_logiciels|avertissement]]).
 
Cette méthode peut aussi poser des problèmes lors d'une [[:upgrade|mise à niveau]].
</note>
 
Vous pouvez aussi installer **Bidule** depuis le [[:PPA]] ''nom_du_ppa'' :
  - [[:ppa#ajout_d_un_ppa_a_vos_sources_logicielles|ajouter le PPA]] ''ppa:<nom_du_dépôt>''((https://launchpad.net/~nom_du_depot/+archive/ppa)) aux sources de logiciels
  - [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|recharger la liste de vos paquets]]
  - puis [[:tutoriel:comment_installer_un_paquet|installer le paquet]] ''[[apt>bidule]]''
 
===== Configuration =====
 
Tout d'abord, [[:tutoriel:comment_modifier_un_fichier|ouvrez le fichier]] ''/truc/machin/bidule'' en modification puis...
 
===== Utilisation=====
 
Lancez l'application comme indiqué [[:tutoriel:comment_lancer_application|ici]] ou via le [[:terminal]] (toutes [[:versions]] ou [[:variantes]] d'Ubuntu) avec la [[:commande_shell|commande]] suivante : <code>machin-chose</code>
 
===== Désinstallation =====
 
Pour désinstaller cette application, il suffit de [[:desinstaller_une_application#methodes_standardspour_deb_snap_et_flatpak|supprimer son paquet]] :
  * Pour la version des [[#dépôts Ubuntu APT]], vous pouvez passer par le [[:snap store|centre d'applications]], ou en ligne de commande :<code>sudo apt remove bidule</code>Les préférences de l'utilisateur stockées dans son [[:arborescence#répertoire personnel]] sont conservées.
  * Pour la version **[[:gerer_flatpak#desinstaller_une_application|Flatpak]]**, vous pouvez passer par [[:gnome-software|GNOME Logiciels]] (si vous avez le //plugin// [[:gnome-software#installer_les_greffons_snap_et_flatpak|Flatpak]]), ou en ligne de commande :<code>flatpak uninstall com.example.bidule</code>
  * Pour la version **[[:snap#suppression|snap]]**, vous pouvez passer par le [[:snap store|centre d'applications]], ou en ligne de commande :<code>snap remove bidule</code>
  * Pour la version **[[:appimage#desinstaller_un_appimage|Appimage]]**, supprimez simplement le fichier ''bidule.AppImage''.
 
===== Voir aussi =====
 
  * [[http://bidule.org/projects/bidule/|Site officiel]]
  * **(//en//)** [[http://www.bidule.org|Documentation officielle]]
  * Discussion //[[https://forum.ubuntu-fr.org/viewtopic.php?id=64840|J'ai un soucis avec le logiciel Bidule]]// sur le forum
 
----
//[[:Contributeurs]] : [[:utilisateurs:votre_identifiant|votre nom ou pseudonyme si différent de l'identifiant]], [[:utilisateurs:autre_identifiant]].//
  * Basé sur //[[http://www.document_source.com|Titre original de l'article]]// par Auteur Original.
  * [[https://forum.ubuntu-fr.org/viewtopic.php?id=2094334|Discussion]] au sujet de cette page sur le forum.

¹⁾

versions d'Ubuntu LTS pour lesquelles la page est valide

²⁾

au moins un, à choisir parmi les tags existants

³⁾

https://launchpad.net/~nom_du_depot/+archive/ppa