Extension:Page Forms/pl

Page Forms, do listopada 2016 znane jako Semantic Forms, to rozszerzenie umożliwiające dodawanie, edytowanie i przeszukiwanie danych (wykonywanie kwerend) z użyciem formularzy. Rozszerzenie to powstało w ramach i pierwotnym jego przeznaczeniem było umożliwienie łatwego edytowania szablonów semantycznych (tj. przechowujących dane semantyczne) - stąd jego pierwotna nazwa Semantic Forms. Obecnie jednak może być używane także w skojarzeniu z, jak i samodzielnie.

Ujmując sprawę w skrócie - rozszerzenie Page Forms daje użytkownikom wiki możliwość edytowania oraz tworzenia wikistron za pomocą formularzy, a jeśli jest używane w skojarzeniu z Cargo lub Semantic MediaWiki także wykonywania kwerend. Co najważniejsze - użytkownicy nie muszą posiadać żadnej wiedzy na temat wikikodu, czy tworzenia kwerend. Można powiedzieć, że formularz to rodzaj szablonu, z tą jednak różnicą, że służącego nie do prezentacji, a do wprowadzania danych. Formularze mogą być tworzone nie tylko przez administratorów, ale też przez zwykłych użytkowników.

Centralną częścią rozszerzenia Page Forms są definicje formularzy. Definicje te są niczym innym, jak wikistronami znajdującymi się w odrębnej, przeznaczonej tylko dla nich przestrzeni nazw Form. Formularze definiuje się za pomocą specjalnego języka znaczników. Kod definicji jest parsowany "w locie" za każdym razem gdy użytkownik korzysta z formularza. Całość kodu niezbędnego do zdefiniowana danego formularza znajduje się na jego stronie. (np. kod formularza o nazwie Recencja znajduje się na stronie Form:Recenzja). Dzięki temu użytkownicy mogą w (stosunkowo) łatwy sposób samodzielnie tworzyć i modyfikować formularze bez konieczności programowania w ścisłym tego wyrażenia znaczeniu. Konieczne jest tylko zapoznanie się ze składnią znaczników służących do definiowania formularzy, co jest stosunkowo proste (niewiele bardziej skomplikowane niż standardowy wikikod używany do tworzenia szablonów).

The Page Forms extension is mostly used to add and edit calls to infobox-style templates within pages. A form allows a user to populate a pre-defined set of templates, as well as page sections, for any page; if Cargo or Semantic MediaWiki are used, the data within the templates can then be stored and queried.

Forms can also be used to edit the data in an existing page, and you can enable an "" tab to show up on any page.

Page Forms also supports autocompletion of fields, so users can easily see what the previously-entered values were for a given field. This greatly helps to avoid issues of naming ambiguity, spelling, etc.

Data in a page that doesn't fit into the form, like a free-form text description of the page's subject, isn't ignored when the page is edited with a form; rather, it is placed into a separate input box called "free text".

Page Forms also includes a wide variety of other functionality related to forms.

Below are links to the entire documentation.


 *  Download and installation 


 * How to download Page Forms via either Git, a standard download, or a software package; and how to install it.


 *  Quick start guide 


 * How to get started with Page Forms right away.


 *  Hosting 


 * Wiki hosting sites that support Page Forms, plus public wikis that can be used for trying out the software.


 *  Special pages 


 * ''All the "special pages" that Page Forms defines: the ones that provide helper forms (Special:CreateProperty, Special:CreateTemplate, Special:CreateForm, Special:CreateCategory, Special:CreateClass), the ones that display lists (Special:Templates, Special:Forms) and the ones used to display actual forms (Special:FormEdit, Special:FormStart, Special:RunQuery, Special:UploadWindow).


 *  Page Forms and templates 


 * The template-based philosophy of Page Forms - plus information on the two parser functions that PF defines for templates: #arraymap and #arraymaptemplate.


 *  Defining forms 


 * This is the first of the two major sections. How to define a form via a page within the "Form:" namespace. Covers the entire form-definition syntax, including the,  ,  ,  ,  and  tags. Also covers how to add tabs and tooltips.


 *  Input types 


 * The second major section. A listing of all allowed input types, as well as parameters for each, and the set of SMW and Cargo data types that each can be used with. Also includes complete information on autocompletion options.


 *  The "" tab 


 * How to get the "" tab to appear on pages, using the #default_form parser function. Plus, how to rename the tab to simply "edit", and how to remove the standard "edit" tab (if you want to).


 *  Linking to forms 


 * How to bring users to forms, via the #forminput, #formlink, #formredlink and #queryformlink functions. Also, how to use #formredlink to have red-linked pages created automatically. Also, how to create links that directly modify a page, via the #autoedit function.


 *  Creating query forms 


 * Creating forms to query data, instead of to modify data, via the Special:RunQuery page.


 *  Common problems 


 * Common issues people have run into, and their solutions, relating to forms, data structure design, and the use of Page Forms with other extensions.


 *  Known bugs and planned features 


 * ''Known bugs in the software, and potential workarounds for them; plus features that are planned in the current "development roadmap".


 *  Getting support 


 * Where to ask questions, submit bug reports, submit feature requests, submit fixes, and add new translations.


 *  Developers' documentation 


 * Information for developers who want to modify Page Forms, or create an extension that works in tandem with it.


 *  Authors and credits 


 * The main authors, others who have contributed to the code, and credits to other organizations and software projects.


 *  Version history 


 * A version history of Page Forms, from May 2007 to the present.


 *  Sites that use Page Forms 


 * A small sampling of the wikis that use Page Forms, plus links to more comprehensive lists.


 *  Related extensions 


 * Extensions that require the presence of Page Forms, extensions that can be used together with Page Forms, and extensions that have a similar purpose to Page Forms.