Wikifunkcje:Najczęściej zadawane pytania

From Wikifunctions
This page is a translated version of the page Wikifunctions:FAQ and the translation is 60% complete.
Outdated translations are marked like this.
Skrót:
WF:FAQ

To jest strona poświęcona często zadawanym pytaniom na temat Wikifunkcji. Możesz zadać własne pytanie na stronie dyskusji, jeśli twojego pytania nie ma na liście!

Also, please consider our FAQ on Meta regarding more general questions about Wikifunctions and/or Abstract Wikipedia.

Wprowadzenie

O co chodzi w tym projekcie?

Wikifunctions is a new Wikimedia project that provides a catalog of all kinds of functions that anyone can call, write, maintain, and use. It also provides the underlying technology that will eventually enable the translation of language-independent articles from Abstract Wikipedia into the language of any Wikipedia. This will allow everyone to contribute and read articles in their preferred languages.

Co to jest funkcja?

Funkcje to forma wiedzy, która może odpowiedzieć na pytania, takie jak ile dni minęło między dwiema datami lub odległość między dwiema miastami. Bardziej złożone funkcje mogą odpowiedzieć na bardziej skomplikowane pytania, takie jak objętość trójwymiarowego kształtu, odległość między Marsem a Wenus w określonym dniu lub czy dwa gatunki żyły w tym samym czasie.

We already use functions in many types of knowledge inquiries, such as asking a question to a search engine. The templates, such as Template:Convert and Template:Age on English Wikipedia, are also examples of functionalities that are already used in many Wikipedias, written in wikitext and Lua and manually copied to each wiki where it's wanted.

Co to jest implementacja?

Implementacja to szczególny sposób wykonania funkcji. Implementacja to przepis zawierający listę kroków niezbędnych do uruchomienia funkcji. Może to być fragment kodu w języku programowania lub kombinacja wywołań innych funkcji. Funkcja może mieć wiele implementacji i wszystkie powinny być równoważne.

Czym jest test?

A test is a way to determine if a given function is doing the right thing. A function will typically have multiple testers, each specifying some input to the function and the conditions the output for the given input must fulfill.

For example, testers for a “title case” function might include: “abc” should become “Abc”; “war and peace” should become “War and Peace”; “война и мир” should become “Война и мир”; and “123” should remain “123”.

Jaka funkcjonalność jest już dostępna, jaka będzie wkrótce, a jaka później?

  • At launch:
    • We have the ability to have functions that work with Strings and Booleans.
    • Wikifunkcje będą od początku w pełni umiędzynarodowione. Można ich używać w dowolnym języku.
  • Ongoing development:
    • generic types and generic functions are not fully supported.
    • Dodawanie typów będzie na razie czymś ograniczonym dla zespołu programistów. W przyszłości społeczność będzie mogła samodzielnie dodawać więcej typów. Czeka nas dużo pracy, aby typy zachowywały się bardziej gładko.
      • Szczególnie interesującym typem będą dane binarne, a zwłaszcza pliki.
    • Obecnie obsługujemy dwa języki programowania dla implementacji, JavaScript i Python. W przyszłości chcemy obsługiwać ich znacznie więcej.
    • Obecnie nie jest możliwe wywoływanie innych funkcji z implementacji napisanych w innym języku programowania.
  • W przyszłości:
    • Będzie możliwe wywoływanie funkcji Wikifunkcji z innych projektów Wikimedia i integrowanie ich wyników z wynikami strony.
    • W funkcjach będzie można używać danych z Wikidanych.
    • It will be possible to call data sets from Commons Data namespace.

W jaki sposób Wikifunkcje są wielojęzyczne?

Wikifunctions and Abstract Wikipedia are multilingual in a number of different ways which do not impact each other:

  • Wikifunctions is multilingual in terms of its content and user interface. Users can read and call functions on Wikifunctions in any natural language. Here is the “join string” function in English, Polish, and Hebrew, and it is available in many more languages.
  • Contributors can edit and improve Wikifunctions using their language. Even implementations can be edited in the natural language of the contributor. For example, the composition of the “and” function can be edited in German, English, or any other of about 300 languages.
  • Wikifunctions functions can be used to create results for any natural language. The community is creating a growing number of functions to support the generation of text in many natural languages. We have functions for Breton, Rohingya, English, and many other languages.
  • Funkcje w Wikifunkcjach mogą być implementowane w różnych językach programowania. Na przykład funkcja łączenia tekstu jest zaimplementowana zarówno w JavaScripcie, jak i Pythonie.

Jakie języki programowania obsługują obecnie Wikifunkcje? Jakie języki programowania będą obsługiwane w przyszłości?

Obecnie Wikifunkcje obsługują implementacje napisane w języku JavaScript i Python. W przyszłości planujemy dodać wsparcie dla większej liczby języków programowania. Mamy nadzieję, że w 2024 roku dołączy się przynajmniej jeden język programowania (ale jeszcze nie zdecydowaliśmy który).

W jaki sposób Wikifunkcje zostaną zintegrowane z innymi projektami?

Wikifunctions is the first step towards building Abstract Wikipedia. Our near-term focus will be on supporting the community and making improvements based on feedback. Concurrently we will begin the process of integrating it with Wikipedia and Wikidata, which will enable broader real-life applications and get us closer to the vision of Abstract Wikipedia.

Contributors will be able to call functions from Wikifunctions from within their wikis. For readers of the wiki, the result of the function call will be displayed. This can be used, for example, to calculate the age of a person, the population density based on population and area data from Wikidata, or to draw a graph and integrate it into a given article.

Inną opcją na integrację WikiFunkcji będzie umożliwienie bezpośrednio w wiki interaktywnego wywoływania funkcji. Dzięki temu będzie można na przykład w artykule w Wikipedii dynamicznie obliczać wyniki równań fizycznych na podstawie parametrów wprowadzonych przez czytelnika; rysować i wchodzić w interakcję z funkcjami matematycznymi; itp.

Czym Wikifunkcje nie są?

Więcej informacji na ten temat znajdziesz w artykule Wikifunkcje:Czym Wikifunkcje nie są.

Jakiej licencji będą podlegać funkcje i treści pochodne?

Per the discussion happened on Meta between November and December 2021, all contributions to Wikifunctions and the wider Abstract Wikipedia projects will be published under free licenses. In particular:

There are still some points that will need to be addressed in the future, such as the license of the generated content from the abstract content. We plan on drafting a more comprehensive document with the Legal department about how people can re-use code from Wikifunctions as painlessly as possible, while adhering to the license.

Wkład

Jestem tu nowy. Co mogę zrobić i jak mogę pomóc?

Welcome! We're very happy to have you here! There are many opportunities for contributing to Wikifunctions, from creating new functions to improving and translating documentation. If you are looking for ways to get involved, we recommend that maybe, depending on your level of comfort, you suggest a new function on a topic you are interested in. Or even create such a function. Provide some tests. Try your hand at an implementation. Help with translations. Read and improve our documentation. Help with organizing the community.

Jak utworzyć nową funkcję, implementację lub test?

Aby zobaczyć, jak utworzyć nową funkcję, implementację lub test, zobacz Wikifunkcje:Wprowadzenie.

Aby zobaczyć bardziej szczegółowo, jak utworzyć implementację, zobacz Wikifunkcje:Jak tworzyć implementacje.

Co powinienem edytować na początku?

Jeśli znasz kilka języków, znajdź funkcje, które nie mają jeszcze etykiet i opisów w tych językach i pomóż je dodać.

If you have some interest in a domain that could feature functions in Wikifunctions, but yet doesn't, or if you have more ideas for functions, go to the page for suggesting new functions, and present your ideas.

Jeśli jesteś programistą w JavaScripcie lub Pythonie, być może chcesz sprawdzić funkcje, które nie mają jeszcze implementacji w JavaScript lub Pythonie i spróbować je napisać.

Gdzie mogę zwrócić się po pomoc?

Twoje pierwsze kroki powinny prowadzić do Portalu pomocy, gdzie znajdziesz całą dokumentację związaną z korzystaniem i edycją WikiFunkcji. Jeśli nadal będziesz mieć problemy, umieść wiadomość na Czacie projektu, gdzie ktoś odpowie na twoje pytanie.

Jak sortujemy i kategoryzujemy funkcje?

Tracked in Phabricator:
Task T285424

For now, the best way to sort or categorize functions is doing it by hand through pages in the Wikifunctions namespace. Another option would be through the talk page of the given function. We will monitor these efforts, and discuss with the community which changes to the system would be helpful for this task.