Wikifunctions:Introduction

Les fonctions réalisent des calculs sur les données que vous fournissez.

Wikifunctions est un projet open source qui permet à quiconque de créer des fonctions et de les partager pour que d’autres puissent les utiliser, les remixer, les tester et apprendre d’elles.

Utilisez les guides suivants pour essayer les fonctionnalités basiques de Wikifunctions. Nous attendons avec impatience vos commentaires et vos contributions !

Évaluer une fonction

Vous pouvez essayer directement les fonctions fournies par la communauté sur Wikifunctions ! Choisissez-en une dans notre bibliothèque de fonctions, et donnez-lui des valeurs d’entrée pour découvrir la sortie.

Étapes :

1. Trouvez une fonction sur la Page d’accueil.

   

2. Allez sur la page d’une fonction.

   

3. Saisir les valeurs d’entrée.

   

4. Exécutez la fonction.

   

Résultats :

1. Est-ce la valeur de sortie attendue ?
2. Avez-vous des corrections ou des commentaires à apporter ?

Partager l'appel d'une fonction

Après avoir exécuté une fonction, utilisez le bouton Copy result link sous le panneau de résultats pour copier une URL partageable. Quand quelqu'un ouvre ce lien, Wikifunctions précharge le même appel de fonction et l'exécute automatiquement, de sorte qu'il voit les entrées et le résultat exactement comme vous l'avez fait. C'est un moyen rapide de démontrer des exemples reproductibles ou de demander de l'aide à d'autres personnes pour une entrée/sortie de fonction spécifique.

Etapes (suite de Evaluer une fonction) :

1. Une fois les résultats chargés, cliquer sur Copy result link sous le panneau des résultats.

   

2. Partagez l'URL avec d'autres personnes (lien redirige sur l'opération avec les mêmes paramètres)

Note : le lien partagé charge au préalable vos données exactes et les exécute à nouveau, par conséquent le destinataire voit les mêmes résultats que vous à moins que l'implémentation sous-jascente n'ait été modifiée depuis la dernière fois que vous avez généré le lien.

Créer une fonction

Vous pouvez ajouter vos propres fonctions à Wikifunctions ! Créez une nouvelle fonction à utiliser dans vos propres implémentations et permettez à d’autres personnes de l’utiliser également. Les nouvelles fonctions peuvent être écrites dans votre langage préféré.

Étapes :

1. Allez sur la Page de création de fonction.

   

2. Donnez un nom à votre fonction.

   

3. Définissez les entrées de votre fonction :
   1. Ajoutez/retirez des champs d'entrée.
   2. Définissez le type de chaque entrée parmi la liste des types autorisés en entrée.
   3. Nommez chaque entrée.

   

4. Définissez le type de la sortie de votre fonction parmi la liste des types autorisés en sortie.

   

5. Vous pouvez éventuellement fournir des valeurs multilingues pour chacun de ces champs :
   • Nom de la fonction, son alias, libellés d’entrée.

   

6. Publiez votre fonction.

   

Résultats :

1. La fonction a-t-elle été publiée avec succès ?
2. Avez-vous des corrections ou des commentaires à apporter ?

Modifier une fonction

Vous pouvez contribuer à Wikifunctions en éditant sa bibliothèque de fonctions. Ajoutez ou éditez des informations multilingues aux fonctions, développez ou modifiez les définitions des fonctions.

Étapes :

1. Trouvez une fonction sur la Page d’accueil.

   

2. Allez sur la page de la fonction choisie.

   

3. Cliquez sur le lien "Modifier le wikicode" en haut de la page pour voir les options d'édition pour cette fonction.

   

4. Optionnellement, vous pouvez modifier les valeurs suivantes :
   1. Nom de fonction,
   2. Alias de fonction,
   3. Liste des entrées
      1. Ajouter/supprimer des entrées
      2. Modifier le type d'entrée
      3. Modifier les étiquettes des entrées
   4. Type de sortie.
5. Vous pouvez éventuellement fournir des valeurs multilingues pour chacun de ces champs :
   1. Nom de la fonction
   2. Alias de la fonction
   3. Etiquettes des entrées.
6. Publiez vos modifications.

Résultats :

1. Vos modifications ont-elles été publiées avec succès ?
2. Avez-vous des corrections ou des commentaires à apporter ?

Créer des tests

Vous pouvez créer des tests pour les implémentations de votre fonction dans Wikifunctions, pour vous assurer de leur bon fonctionnement.

Étapes :

1. Trouvez une fonction sur la Page d'accueil ou la fonction que vous avez créée à l'étape précédente.

   

2. Naviguez jusqu'à la page de la fonction.

   

3. Cliquez sur le lien « + » dans la Table des tests.

   

4. La section Call doit automatiquement être développée.
   1. Dans le champ au dessous de « Fonction », tapez le nom de la fonction que vous testez et sélectionnez la fonction lorsqu'elle apparaît.
   2. Ajoutez les valeurs des entrées dans les champs respectifs.

   

5. La section Result Validation doit automatiquement être développée.
   1. Dans le champ sous Function, entrez le nom de la fonction que vous voulez utiliser pour vérifier le résultat.
   2. Pour une fonction dont le rendu est une chaîne de caractères, ce sera l'« égalité des chaînes ». Au contraire, pour une fonction dont la sortie est un booléen, ce sera l'« égalité booléenne ».
   3. Ajoutez la valeur attendue dans le champ donné (soit « « Seconde chaîne » ou « Second booléen »).

   

6. Publiez vos modifications.

Résultats :

1. Le test a-t-il été publié avec succès ?
2. Avez-vous des corrections ou remarques dont vous voudriez nous faire part ?

Créer une implémentation

Les fonctions prennent vie dans des implémentations créées afin de subvenir à vos besoins. Exécutez, remixez et combinez des fonctions via des implémentations dans Wikifunctions. Consultez la section ci-dessous pour savoir comment connecter votre implémentation aux fonctions. Nous recommandons de créer et connecter un test avant de créer une implémentation. Un guide plus complet pour créer des implémentations est disponible sur Wikifunctions:How to create implementations.

Étapes :

1. Trouvez une fonction sur la Page d’accueil.

   

2. Naviguez jusqu'à la page de la fonction.

   

3. Cliquez sur le lien « + » dans la Table des implémentations.
4. Vous pouvez créer une nouvelle implémentation de deux façons :
   1. Code
      • Sélectionnez le langage de programmation que vous utiliserez parmi les langages proposés pour écrire le code de la fonction.
      • Entrez votre code.
   2. Composition :
      • Créez une composition en utilisant les fonctions existantes.

   

5. Publiez vos modifications (après avoir lancé un test en cliquant sur la flèche ronde sur la droite de l'encadré intitulé « Tests »).

Résultats :

1. L'implémentation a-t-elle été publiée avec succès ?
2. Avez-vous des corrections ou des commentaires à apporter ?

Connecter une implémentation ou un test à une fonction

Remarque : Cette fonctionnalité n'est disponible que pour les Fonctionnaires.

Connectez des tests et des implémentations à votre fonction pour la voir prendre vie.

Étapes :

1. Trouvez une fonction sur la Page d’accueil.

   

2. Naviguez jusqu'à la page de la fonction.

   

3. Sélectionnez un ou plusieurs tests ou une ou plusieurs implémentations.

   

4. Cliquez sur le bouton “Connecter”.

Résultats :

1. L'état Connecté/Déconnecté a-t-il été modifié avec succès ?
2. Avez-vous des corrections ou des commentaires à apporter ?

Insérer une fonction dans un article Wikipédia

Il est maintenant temps d’insérer une fonction dans un article Wikipédia et voir la magie opérer.

Étapes :

1. Ouvrez l’article auquel vous souhaitez ajouter une fonction.

   

2. Allez dans l’onglet Modifier et ouvrez l’éditeur visuel.

   

3. Cliquez sur le menu « Insérer » en haut de l’éditeur visuel. Faites défiler vers le bas et cliquez sur « Fonction ». Une boîte de dialogue s’ouvre.

   

4. Cherchez la fonction que vous souhaitez insérer et cliquez dessus. Vous pouvez également essayer l’une des fonctions suggérées sous la barre de recherche.

   

5. Saisissez les entrées nécessaires et cliquez sur le bouton « Insérer » en haut à droite pour insérer la fonction dans l’article.

   

6. Vous pouvez maintenant voir la sortie de votre fonction dans l’article. Vous pouvez procéder à la publication des modifications.

   

7. Si vous souhaitez modifier la fonction, cliquez dessus. Une infobulle apparaîtra avec le nom et la description de la fonction. Cliquez sur le bouton « Modifier ».

   

8. Ensuite, vous pouvez apporter des modifications aux entrées et cliquer sur « Appliquer les modifications » lorsque vous avez terminé l’édition.

   

Résultats :

1. Le résultat était-il celui que vous attendiez ?
2. Avez-vous des corrections ou des commentaires à apporter ?