Module:Infobox/Fonctions/Logiciel/Documentation

Ceci est la page de documentation de Module:Infobox/Fonctions/Logiciel [modifier] [purger].

Cette sous-page contient les instructions et les catégories de son module d'origine et elle n'est pas destinée à être visualisée directement.

Cette page est en cours de réécriture ou de restructuration importante (24 novembre 2022).

Un utilisateur prévoit de modifier cet article pendant plusieurs jours. Vous êtes invité(e) à en discuter en page de discussion et à participer à son amélioration de préférence en concertation pour des modifications de fond.
Bandeau apposé par Metamorforme42 (d · c) le 24 novembre 2022.

Cette page réunit des fonctions qui peuvent être réutilisées pour construire des modules d'infobox visant à décrire un logiciel. Sauf mention contraire, les fonctions utilisent des données fournies en paramètre dans l'article, ou alors, lorsque celles-ci sont absentes, des données issues de Wikidata.

Fonctions exportables

`p.programmingLanguage(disableCat)`

`p.programmingLanguagesSupported()`

`p.internationalisation(nbmax)`

`p.developmentStart()`

`p.versionsNavbox()`

`p.firstVersion()`

`p.lastStableVersion()`

`p.advancedVersion()`

`p.softwareType()`

`p.creator()`

`p.developer()`

`p.license()`

`p.repository()`

`p.qualityAssurance()`

`p.graphicalInterface()`

`p.operatingSystem()`

`p.environment()`

`p.dataSize()`

`p.readFormats()`

`p.writtenFormats()`

`p.documentation()`

`p.mainimage(cat, defaultimage)`

Affiche une illustration du logiciel. Généralement, il s’agit d’une capture d’écran.

Paramètres de la fonction
Argument	Type	Description
Première syntaxe
`cat`	chaîne	Catégorie à laquelle sera ajoutée la page contenant l'infobox si cette denière n'a pas d'image.
`defaultimage`	chaîne	Image à afficher en l'absence d'image fournie. Par exemple .
Deuxième syntaxe
`args`	tableau	tableau d'arguments qui peut contenir : `defaultimage`, `upright`, `size`, `cat`, `altparameter`, `alt`, `defaultimagealt`, `wikidata`,
`defaultimage`	chaîne?	???

Paramètres de l'infobox
Paramètre	Wikidata	Description
`image` `photo` `Photo`	`P18 (« image »)`	Fichier de l'image ou de la photographie à afficher dans l'infobox. Pour les « bâtiments récents » prennez en compte les règles exceptions au droit d'auteur. Exemples :
`légende image` `légende` `Légende`	Qualificatif de l'image affichée : P2096 (« légende de média »)^[1]	Légende de l'image. Si l'image provient de Wikidata, la légende doit être précisée dans le qualificateur P2096 (« légende de média ») de l'image, sinon il y a un risque d'incohérence. La légende ne s'affiche que si l'image s'affiche. Exemples : Pour l'Académie des Jeux floraux l'infobox est paramétrée avec : `légende image = L’hôtel d'Assézat, où siège l’académie.`
`upright`		Facteur de redimensionnement de l'image. Utile en particulier lorsque l'image est en mode portrait^[2]. Voir l'aide sur la mise en forme des images Exemples : `upright = 0.5`
`taille image`		Largeur de l'image, en pixels. L'utilisation de ce paramètre est déconseillée dans l'aide sur la mise en forme des images. Le paramètre `upright` est préférable. Valeur par défaut : 300 Valeur maximum : 315 Exemples : Pour AARP l'infobox est paramétrée avec : `taille image = 150.`
`alternative image`	Voir la proposition de propriété alt text	Texte à afficher quand l'image ne peut l'être. Si l'image provient de Wikidata, le texte alternatif devrait être précisé dans un qualificateur de l'image, afin d'éviter un risque d'incohérence. Exemples :

↑ Légende en français de l'image si elle existe.
↑ Image dont la hauteur est supérieur à la largeur.

`p.logo(upright)`

Affiche le logo du logiciel.

Paramètre de la fonction
Argument	Type	Description
`upright`	nombre	Valeur par défaut du facteur de redimensionnement du logo.

Paramètres de l'infobox
Paramètre	Wikidata	Description
`logo` `association_logo`	`P154 (« image du logotype »)`	Fichier du logo à afficher dans l'infobox. Exemples :
`légende logo`	P2096 (« légende de média ») de P154 (« image du logotype »)^[1]	Légende du logo. Si le logo provient de Wikidata, la légende doit être précisée dans le qualificateur P2096 (« légende de média ») du logo, sinon il y a un risque d'incohérence. La légende ne s'affiche que si le logo s'affiche. Exemples :
`upright logo`		Facteur de redimensionnement du logo. Utile en particulier lorsque le logo est en mode portrait^[2]. Voir l'aide sur la mise en forme des images Exemples : `upright logo = 0.5`
`taille logo`		Largeur du logo, en pixels. L'utilisation de ce paramètre est déconseillée dans l'aide sur la mise en forme des images. Le paramètre `upright logo` est préférable. Valeur par défaut : 300 Valeur maximum : 315 Exemples :
`alternative logo`	Voir la proposition de propriété alt text	Texte à afficher quand l'image ne peut l'être. Si l'image provient de Wikidata, le texte alternatif devrait être précisé dans un qualificateur de l'image, afin d'éviter un risque d'incohérence. Exemples : Alternative textuelle à un logo

↑ Légende en français de l'image si elle existe.
↑ Image dont la hauteur est supérieur à la largeur.

`p.title()`

Retourne le titre de l’infobox.

Paramètres de l'infobox
Libellé	Paramètre	Wikidata	Description
	`nom` `association_nom` `nom_think` `acronymelaboratoire` `titre`		Texte à afficher dans la barre de titre de l'infobox. Par défaut c'est le libellé en français de l'élément wikidata lié à la page. En son absence, c'est le nom de la page Wikipédia. Exemples :

`p.website(localparam)`

Retourne le site web du logiciel.

Paramètre de la fonction
Argument	Type	Description
`localparam`	chaîne	Nom du paramètre dans l'infobox

Paramètre de l'infobox
Libellé	Paramètre	Wikidata	Description
`Site web`	`site web` `site_web` `site officiel` `site internet` `web`	P856 (« site officiel ») Qualificateur obligatoire : P407 (« langue de l'œuvre, du nom ou du terme ») Autres qualificateurs : P1001 (« ressort territorial »)	URL du site internet. L'adresse doit être complète en commençant par http:// ou https://. Lorsque l'un des paramètres est utilisé il ne peut y avoir qu'un seul site. Lorsque des propriétés de Wikidata sont utilisées le ou les sites internet s'affichent en respectant les règles suivantes, dans l'ordre, jusqu'à ce qu'il soit possible de renvoyer quelque chose à afficher : les sites ayant un rang égal à `deprecated` ne sont jamais pris en compte. pour une catégorie de sites, ceux ayant un rang `normal` ne sont pris en considération que s'il n'y en a aucun ayant un rang `preferred`. S'il y a au moins un site dont le qualificateur P407 (« langue de l'œuvre, du nom ou du terme ») est le français, seuls les sites en français sont renvoyés pour affichage. Sinon les sites dans les autres langues sont précédés du code de langue, par exemple (en) pour l'anglais et sont renvoyés pour affichage. Remarques : Normalement tous les P856 (« site officiel ») doivent avoir une P407 (« langue de l'œuvre, du nom ou du terme »). Lorsqu'un site s'affiche en plusieurs langues pour une même URL, P407 (« langue de l'œuvre, du nom ou du terme ») doit avoir la valeur Q20923490 (« multilingue »). Ni la P580 (« date de début »), ni la P582 (« date de fin ») ne sont prises en compte pour sélectionner les sites à afficher. Exemples : Pour la règle 3 voir Conseil international de la danse. Pour la règle 4 voir Académie nationale des sciences d'Azerbaïdjan.
	`nom site`		Texte affiché pour le lien du site. Ce paramètre ne fonctionne que lorsque l'adresse est spécifiée par un paramètre. Exemples : `nom site = site officiel`

Projet Scribunto

[Module:Infobox/Fonctions/Documentation_en_français-1] Légende en français de l'image si elle existe.

[Module:Infobox/Fonctions/Documentation_portrait-2] Image dont la hauteur est supérieur à la largeur.

[Module:Infobox/Fonctions/Documentation_en_français-3] Légende en français de l'image si elle existe.

[Module:Infobox/Fonctions/Documentation_portrait-4] Image dont la hauteur est supérieur à la largeur.

[1]

[2]

[1]

[2]