Différences

Ci-dessous, les différences entre deux révisions de la page.

--- wiki:modeles:application [Le 03/06/2016, 00:09] – [Installation] temps
+++ wiki:modeles:application [Le 19/03/2026, 10:46] (Version actuelle) – +warning PPA | GitHub : latest | détails krodelabestiole
@@ Ligne 1: / Ligne 1: @@
 {{tag>wiki wiki:modèle comment_participer}}
-----
 ====== Modèle : page application ======
-<note help>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 !**</note>
+<note>
+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 !**
+</note>
-<note important>**Quelques conventions à respecter au maximum :**
+<note important>
+**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 : [[:firefox|http://doc.ubuntu-fr.org/firefox]].
@@ Ligne 14: / Ligne 15: @@
----[ le modèle commence ICI ]---
-{{tag>Precise Trusty BROUILLON}}
+^  <box 100% #e95420>Le modèle annoté commence ICI.</box>  ^
-----
+{{tag>Resolute Noble BROUILLON}}
 <note tip>Les [[:wiki:tags|tags]] d'une page "application" sont à introduire dans l'ordre suivant :\\ ''Versions(([[:lts|versions d'Ubuntu LTS]] pour lesquelles la page est valide)) autres_tags((au moins un, à choisir parmi les [[:thesaurus|tags existants]])) BROUILLON''\\
@@ Ligne 25: / Ligne 28: @@
 </note>
+====== Nom de l'application ======
+<note important>
+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). :-(
+</note>
+<note tip>
+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 :
+</note>
+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://bidule.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...
+<note tip>
+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).
+</note>
+===== 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>
+<note tip>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).
+</note>
+===== 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
 ----
+<note help>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).
+</note>
-======En attente de correction ======
+//[[:Contributeurs]] : [[:utilisateurs:votre_identifiant|votre nom ou pseudonyme si différent de l'identifiant]], [[:utilisateurs:autre_identifiant]].//
-<note tip>la page</note>
+<note>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.</note>
+  * 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.
+|  <box 100% #e95420>Le modèle annoté se termine ICI.</box>  |
+====== Modèle à copier-coller ======
+<file text 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]])]
@@ Ligne 38: / Ligne 168: @@
 <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>
-===== Pré-requis =====
+===== Installation =====
-<note tip>Connaitre le langage c ou cpp n'est pas une obligation, mais peut apporter beaucoup en modifiant l'application pour sa propre utilisation. </note>
+Il existe plusieurs méthodes //au choix// pour installer **Bidule** :
-  * Disposer des [[:sudo|droits d'administration]].
+  * Il est disponible dans les [[#dépôts officiels APT]] d'Ubuntu.
-  * Savoir utiliser un terminal.
+  * Il est distribué par ses développeurs en [[#Flatpak]].
-  * Pour plus tard quand le .deb sera créé savoir installer un ppa
+  * 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>
-===== Installation =====
+==== 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 …
+Tout d'abord, [[:tutoriel:comment_modifier_un_fichier|ouvrez le fichier]] ''/truc/machin/bidule'' en modification puis...
-===== Utilisation =====
+===== Utilisation=====
-Lancez l'application via le [[:unity#tableau_de_bord_dash|tableau de bord]] (Unity) ou via le [[:terminal]] (toutes versions d'Ubuntu) avec la [[:commande_shell|commande]] suivante :
+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>
-<code>machin-chose</code>
 ===== Désinstallation =====
-Pour supprimer cette application, il suffit de [[:tutoriel:comment_supprimer_un_paquet|supprimer son paquet]]. Selon la méthode choisie, la configuration globale de l'application est conservée ou supprimée. Les journaux du système, et les fichiers de préférence des utilisateurs dans leurs dossiers personnels sont toujours conservés.
+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 =====
-  * **(en)** [[Site officiel du logiciel]]
+  * [[http://bidule.org/projects/bidule/|Site officiel]]
-  * **(fr)** [[Site de la communauté francophone du logiciel Bidule]]
+  * **(//en//)** [[http://www.bidule.org|Documentation officielle]]
-  * [[http://forum.ubuntu-fr.org/viewtopic.php?id=64840|Discussion « J'ai un soucis avec le logiciel Bidule »]] sur le forum Ubuntu-fr
+  * Discussion //[[https://forum.ubuntu-fr.org/viewtopic.php?id=64840|J'ai un soucis avec le logiciel Bidule]]// sur le forum
 ----
-//Contributeurs principaux : [[utilisateurs:votre_identifiant|votre nom ou pseudonyme]], [[utilisateurs:autre_identifiant|nom ou pseudo autre]].//
+//[[: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.
-//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.
 </file>

Différences

Outils pour utilisateurs

Outils du site

Outils de la page

Divers