Wikifuncties:Introductie

Functies voeren berekeningen uit op de gegevens die u aanlevert.

Wikifuncties is een open source-project dat het mogelijk maakt voor iedereen om functies te creëren en met anderen te delen zodat ze die kunnen gebruiken, remixen, testen en ervan kunnen leren.

Bekijk de onderstaande doe-het-zelfgids om de basiskenmerken van Wikifuncties te zien. Wij kijken uit naar uw feedback en bijdragen!

Een functie evalueren

U kunt zelf al functies proberen die door de gemeenschap zijn gemaakt! U kan er een uit onze catalogus van functies kiezen en parameters invoeren om resultaten te krijgen.

Stappen:

1. Vind een functie op de hoofdpagina.

   

2. Ga naar een functiepagina.

   

3. Voer uw invoerwaarden in.

   

4. Voer de functie uit.

   

Resultaten:

1. Was het resultaat wat u had verwacht?
2. Heeft u correcties of feedback te melden?

Een Functie-aanroep delen

Na het uitvoeren van een functie, gebruik de knop 'Copy result link' onder het resultaatpaneel om een gedeelde URL te kopiëren. Als iemand die link opent, laadt Wikifunctions dezelfde functie en voert het automatisch uit, zodat ze de input zien en het resultaat precies zoals u dat deed. Dit is een snelle manier om reproduceerbare voorbeelden te laten zien of om anderen te vragen om hulp met een specifieke functie-input/output.

Stappen (vervolg van "Een functie evalueren"):

1. Klik na het laden van het resultaat op 'Copy result link' onder het resultaatpaneel.

   

2. Deel de URL met anderen!

Opmerking: de gedeelde link laadt uw exacte invoer vooraf en voert ze opnieuw uit, zodat ontvangers hetzelfde resultaat zien tenzij de onderliggende implementatie is veranderd sinds u de link heeft aangemaakt.

Een functie creëren

U kunt uw eigen functies aan Wikifuncties toevoegen! Creëer een nieuwe functie zodat u deze in uw eigen implementaties met anderen kunt gebruiken. Nieuwe functies kunt u in uw voorkeurstaal schrijven.

Stappen:

1. Ga naar de pagina voor het maken van functies.

   

2. Geef de functie een naam.

   

3. Bepaal de parameters van de functie:
   1. Voeg toe/verwijder invoervelden.
   2. Bepaal elk parametertype.
   3. Geef elke parameter een naam.

   

4. Bepaal het uitvoertype van de functie.

   

5. Optioneel, geeft meertalige keuzes voor deze velden:
   • Functienaam, functie-aliassen, parameterlabels.

   

6. Publiceer de functie.

   

Resultaten:

1. Is de functie gepubliceerd?
2. Heeft u correcties of feedback te melden?

Een functie bewerken

U kunt aan Wikifuncties bijdragen door het bewerken van zijn catalogus van functies. Voeg meertalige informatie toe of bewerk de functies en verander hun omschrijvingen.

Stappen:

1. Vind een functie op de hoofdpagina.

   

2. Ga naar de functiepagina.

   

3. Klik op "Brontekst bewerken" om de bewerkingsopties voor deze functie te zien.

   

4. Optioneel kunt u de waarden wijzigen van:
   1. Functienaam,
   2. Functie-aliassen,
   3. Invoerlijst
      1. Invoervelden toevoegen/verwijderen
      2. Parametertype bewerken
      3. Parameterlabels bewerken
   4. Uitvoertype.
5. Optioneel, geeft meertalige waarden voor deze velden:
   1. Functienaam
   2. functie-aliassen,
   3. parameterlabels.
6. Publiceer uw bewerkingen.

Resultaten:

1. Zijn uw bewerkingen succesvol gepubliceerd?
2. Heeft u correcties of feedback te melden?

Testen aanmaken

U mag testen aanmaken voor uw functie-implementaties in Wikifuncties om te verzekeren dat ze op de juiste manier werken.

Stappen:

1. Kies een functie op de hoofdpagina of de functie die u in de vorige workflow heeft aangemaakt.

   

2. Ga naar de functiepagina.

   

3. Klik op de link "+" in de testtabel.

   

4. De sectie "Call" zou automatisch uitgebreid moeten worden.
   1. In het veld onder "Functie" kunt u de naam van de functie intypen en de functie selecteren wanneer ze verschijnt.
   2. U kunt waarden voor de parameters in de respectieve velden toevoegen.

   

5. Het gedeelte "Result Validation" moet automatisch worden uitgebreid.
   1. In het veld onder "Function" typ de naam van de functie in die u wilt gebruiken om het resultaat te controleren.
   2. Voor een functie waarvan de uitvoertype Tekenreeks is, is deze "Tekenreeksgelijkheid", voor een functie waarvan de uitvoertype Boolean is, is deze "booleaanse gelijkheid".
   3. U kunt de verwachte waarde in het gegeven veld toevoegen ("Tweede tekenreeks" of "Tweede boolean").

   

6. Publiceer de bewerkingen.

Resultaten:

1. Is de test succesvol gepubliceerd?
2. Heeft u correcties of feedback te melden?

Een implementatie creëren

Functies zijn tot leven gebracht met implementaties om aan uw behoeften te voldoen. U kunt functies uitvoeren, remixen, en combineren via implementaties bij Wikifuncties. Zie de onderstaande sectie om te leren hoe je je implementaties aan functies kunt koppelen. Wij adviseren om een test te creëren en te koppelen voordat u een implementatie aanmaakt. Een uitgebreidere gids om implementaties te creëren is op Wikifunctions:How to create implementations beschikbaar.

Stappen:

1. Kies een functie op de hoofdpagina.

   

2. Ga naar de functiepagina.

   

3. Klik op de link "+" in de tabel met implementaties.
4. U kunt een nieuwe implementatie op twee manieren aanmaken:
   1. Code
      • Selecteer de vereiste programmeertaal om de functiecode te schrijven.
      • Voer uw code in.
   2. Compositie:
      • U kunt een compositie creëren met bestaande functies.

   

5. Publiceer uw bewerkingen (na het uitvoeren van een test door te klikken op de ronde pijl rechts in het vak "Testen").

Resultaten:

1. Is de implementatie succesvol gepubliceerd?
2. Heeft u correcties of feedback te melden?

Een implementatie of test aan een functie koppelen

Let op: Deze functie is alleen voor Functioneers beschikbaar.

Koppel testen en implementaties aan uw functie om het tot leven te laten komen.

Stappen:

1. Kies een functie op de hoofdpagina.

   

2. Ga naar de functiepagina.

   

3. Selecteer een of meer testen of een of meer implementaties.

   

4. Klik op de knop “Verbinden”.

Resultaten:

1. Is de status Verbonden/Losgekoppeld succesvol gewijzigd?
2. Heeft u correcties of feedback te melden?

Een functie gebruiken in een Wikipedia-artikel

Nu is het tijd om een functie in een Wikipedia-artikel te plaatsen en te zien hoe de magie zich ontvouwt.

Stappen:

1. Open het artikel waar u een functie aan wilt toevoegen.

   

2. Ga naar het tabblad bewerken en open de VisualEditor.

   

3. Klik op het menu "Instellen" bovenaan. Scroll naar beneden en klik op "Functie". Een dialoogbox wordt geopend.

   

4. Zoek naar de functie die u wilt gebruiken en klik erop. Of probeer een van de voorgestelde functies onder de zoekbalk.

   

5. Voer de benodigde invoer in en klik op de knop "Invoegen" rechtsboven om de functie in het artikel in te voegen.

   

6. U kunt nu het resultaat van de functie zien in het artikel. U kunt doorgaan met het publiceren van de wijzigingen.

   

7. Als u de functie wilt bewerken, klik er dan op. Er verschijnt een tip met de functienaam en beschrijving. Klik op de knop "Bewerken".

   

8. Vervolgens kunt u wijzigingen aanbrengen in de invoer en klikt u op "Wijzigingen toepassen" wanneer u klaar bent met het bewerken.

   

Resultaten:

1. Was het resultaat wat u had verwacht?
2. Heeft u correcties of feedback die u wilt doorgeven?