Extension:Page Forms/Quick start guide/cs

Takže, nainstalovali jste na svůj web veškerý potřebný software. Co teď? Teď je ta správná chvíle vytvořit sadu stránek, přes kterou budete moct spravovat, zobrazovat, přidávat a upravovat svoje data; a jejím prostřednictví bude možné velice jednoduše generovat nejrůznější wiki stránky.

Nejprve si musíte ujasnit jak jsou strukturovaná vaše data, to je prvním krok, co musíte udělat. Jaké typy stránek budou zapotřebí? Jaká data budou obsahovat? To vše lze dodatečně změnit, ale už od počátku byste měli mít nějaký výchozí plán. Jakmile je budete takový plán mít (v ideálním případě je dobré si ho někam napsat), můžete přejít k vytvoření potřebných stránek wiki. Bude potřeba založit, nebo upravit stávající stránky pro šablony a formuláře, vymyslet pro ně vhodnou kategorii a (pokud používáte sémantickou MediaWiki) i jaké budou mít vlastnosti.

Klidně si je můžete vytvořit postupně sami, ale proč byste to dělali, když máte k dispozici pomocné formuláře, které vám s vytvořením těchto stránek pomohou? Jak na to jít, záleží také na tom, jaká další rozšíření používáte:



Používáte-li rozšíření Cargo


Special:CreateClass - nejjednodušší cesta
The page Special:CreateClass, defined by Page Forms, provides a single helper form to define everything about a data "class" in one place. If you fill out the fields and hit "submit", the page will create the necessary template, form and category pages automatically. Then you can go to the form page that was created, and start entering data.

If not all the pages seem to be getting created, it could be that your job queue lacks enough memory. See the job-queue-related item here for how to add more memory.

The more comprehensive way
You should take the following steps: Just go to the form page(s), and start creating pages.
 * Create templates. Šablona zajišťuje zobrazení dat na stránce, obsahuje značky pro uložení dat v Cargo tabulkách a (obvykle) také kategorizuje stránku do určité kategorie, a určuje také jakého bude typu. Pro každý typ stránky obvykle existuje pouze jedna šablona, ale některé typy stránek mohou současně používat i několik šablon. Šablonu lze také použít k agregaci, kdy se zobrazí seznam všech ostatních stránek, které mají k této stránce určitý vztah. Pro vytvoření šablony (či šablon) použijte stránku Special:CreateTemplate.
 * Create forms. Teď můžete vytvářet formuláře, které uživatelům umožní snadno přidávat a upravovat obsah stránek nejrůznějšího typu. Pro každý typ stránky by měl existovat pouze jeden formulář; ten vloží data jako paramtery šablony (nebo šablon), které tento typ stránky bude obsahovat. Podobně jako v předchozím případě, i pro zakládání formulářů je k dispozici speciální stránka: Special:CreateForm.
 * Create categories. Alespoň jedna šablona v každém formuláři by měla zajišťovat kategorizaci každého nového článku, který se přes tento formulář vytvoří. Pro každou takovou kategorii byste měli vytvořit stránku a nastavit pro ni výchozí formulář, aby bylo možné každou stránku z této kategorie možné dodatečně editovat přes formulář, který ji vytvořil. Nejjednodušší způsob, jak to udělat, je použít stránku Special:CreateCategory.
 * Enable links to forms. Kromě vytvoření kategorie s výchozím formulářem byste měli podniknout i další kroky, abyste uživatelům umožnili přístup k vámi vytvořeným formulářům. Patří mezi ně i přidání odkazů pro přidání dat do postranního panelu a jinam, a také použití funkcionality #formredlink, aby červené odkazy na neexistující stránky volaly odpovídající formulář pro jejich vytvoření. To vše je vysvětleno v části Propojení formulářů.
 * Add links on sidebar and elsewhere. Obsah postranního panelu (je dán obsahem stránky "MediaWiki:Sidebar") můžete upravit tak, aby obsahoval odkazy pro přidání jednotlivých typů dat. Můžete přidat také odkaz na stránku Special:Drilldown, což je stránka kterou poskytuje Cargo, která umožňuje snadné zobrazení všech údajů wiki najednou. Tyto odkazy ale můžete umístit i na hlavní stránku a jinam.
 * Add data. Now you can start entering data!
 * Customize. Once the structure is in place, you can customize all you want - changing the look-and-feel of the entire wiki, of the various templates, and of the forms, adding and changing fields and adding and changing queries.



Používáte-li rozšíření Semantic MediaWiki


Special:CreateClass - nejjednodušší cesta
The page Special:CreateClass, defined by Page Forms, provides a single helper form to define everything about a data "class" in one place. If you fill out the fields and hit "submit", the page will create all the necessary property, template, form and category pages automatically. Then you can go to the form page that was created, and start entering data.

If not all the pages seem to be getting created, it could be that your job queue lacks enough memory. See the job-queue-related item here for how to add more memory.

The more comprehensive way
You should take the following steps:

A property is used to specify a single piece of information about the topic of this page. Every property should be defined on your wiki, with a page in the "Property:" namespace. Create each property by going to the Special:CreateProperty page. There will generally be one template per page type, although sometimes a single page type will contain more than one template. A template can also be used for aggregation, by displaying a list of all other pages that have a certain relationship to this page (see the inline queries documentation for much more information on this). Create the template(s) by going to the Special:CreateTemplate page. There should be one form per page type; the form will populate the template or templates that this page type contains. As before, there's a special page to create new forms: Special:CreateForm. You should create a page for each such category, and specify a default form for it so that every article is automatically editable with the same form that created it. The easiest way to do that is by using the Special:CreateCategory page. These include adding links to add data in the sidebar and elsewhere, and using #formredlink in order to have red-links to nonexistent pages point to a form for creating them. These actions are all explained in the section "Linking to forms". You can also include such links on the main page and elsewhere. Just go to the form page(s), and start creating pages.
 * Create properties. The basic building blocks of any semantic site are the connections between data, which in Semantic MediaWiki are known as properties.
 * Create templates. A template sets the display of the data on a page, holds the markup to turn the data into actual semantic information, and (often) defines the page as being of a certain category, and thus of a certain page type.
 * Create forms. Now you can create forms to allow users to easily add and edit pages of various types.
 * Create categories. One template in each form should tag each article that the form creates as being part of a certain category.
 * Enable links to forms. Besides creating categories that have a default form, there are other steps you should take to enable users to access the forms that you have created.
 * Add links on sidebar and elsewhere. The sidebar (which, for English-language wikis, can be edited at the page "MediaWiki:Sidebar") should hold links to add each of the data types, and to the categories for each of these data types as well.
 * Add data. Now you can start entering data!
 * Customize. Once the structure is in place, you can customize all you want - changing the look-and-feel of the entire wiki, of the various templates, and of the forms, adding and changing fields and adding and changing inline queries.

Example
Let's go through a specific example of setting up a Page Forms-based wiki from scratch, in the "more comprehensive way". Let's say that you want to create a wiki that shows all the books you have at home. We'll then go through the previous steps specified, with some parts different for Cargo vs. SMW.

1. Figure out the data structure. You want two kinds of pages on your wiki: one for books, and one for authors. Each book page should hold a title, an author name (or names), a genre (or genres), a year of publication, and a number of pages. Each author page should hold the author name, their country of origin, and a list of all the books they have written that you own.

2. Create properties.

3. Create templates. You need to create two templates, one for books and one for authors, both at the "Create a template" page at.

First, books:

Next, create the template for Authors - using the "Create a template" page, you create a template called "Author", and set it to define the category "Authors".

4. Create forms. You need to create two forms, one for books and one for authors:


 * Books - using the "Create a form" page (at ), you make a form called "Book", select the template "Book" and click the Add button. You could also optionally add a section for the plot of the book - to do that, add a section (not a template) called "Plot". You do not do any further customizations on this form, but just save the form once you have created it.
 * Authors - using the "Create a form" page, you make a form called "Author", and add to it the template "Author". As before, you do not do any further customizations - you just save the page.

5. Create categories. You need to create two categories, one for books and one for authors; you have already specified these categories' names before:


 * Books - using the "Create a category" page (at ), you make a category called "Books", and give it the default form "Book".
 * Authors - using the "Create a category" page, you make a category called "Authors", and give it the default form "Author".

6. Enable links to forms.

This will make links to author pages that don't exist yet point to the form for creating those pages.

7. Add data. Using the new "Book" form (at ), you create pages for some books; you check to make sure that both the form and the resulting pages look alright. Each book page will now have a red link to its author, that should point to the "Author" form for adding that author (you may need to refresh the page for the right link to show up). You can then add a few authors, either through these links or from the form page directly, to make sure that this setup works correctly too. Each created author's page should show a list of the books you've saved that have that person as the author.

8. Add links on sidebar and elsewhere. Your structures are now all set up, and you can add links to the sidebar for easy adding and viewing, by modifying the page  (or its equivalent if you're using a language other than English). You can add links to the "Book" and "Author" forms to make it easy to add new ones. You could also link to Special:Drilldown (if you have Cargo installed), or Special:BrowseData (if you have the Semantic Drilldown extension installed), to let users view all the data at a glance.

Using Page Schemas
The Page Schemas extension is specifically intended for the automated creation of data structures, including forms. Its big advantage over the standard PF helper forms is that it can be used to create and modify these data structure pages many times, not just create them one time. It can be used with either Cargo or Semantic MediaWiki installed, or with neither one installed. If Cargo and/or SMW are installed, the Page Schemas form will include many additional form fields in order to create the additional tags needed. To create a page schema, you need to go to the category page (whether or not it has been created yet), go to the tab action for creating that page's schema, fill out the form, then go the tab action for generating pages based on that schema. See the Page Schemas documentation for more information.

Quick reference guides
There are two quick reference guides, or "cheat sheets", suitable for printing, that contain helpful information about Page Forms (though in both cases they still refer to it as "Semantic Forms"), among other extensions:
 * The Cargo quick reference guide - in PNG and PDF formats
 * The Semantic MediaWiki quick reference guide - can be found here, in PNG (image), PDF and SVG formats