Extension:Page Forms/Quick start guide/fr

Ainsi, vous avez installé tous les logiciels sur votre site. Et maintenant ? Il est temps de créer les structures qui contiendront, afficheront et permettront d'ajouter et de modifier vos données ; heureusement tout ceci peut être fait simplement en créant différentes page wiki.

La première étape va être de définir la structure de vos données. Quels types de pages figureront sur votre site ? Quelles données contiendra chaque type ? Vous pourrez changer tout cela plus tard mais vous devez avoir un plan pour commencer. Une fois que vous avez cela (idéalement écrit sur un papier) vous pouvez passer à la création des pages wiki nécessaires. Vous devrez créer ou modifier les pages des modèles et des formulaires, probablement celles des catégories aussi, ainsi que les propriétés (si vous utilisez Semantic MediaWiki).

Vous pouvez créer tout ceci en partant de rien, bien que des formulaires d'assistance existent par ailleurs afin de vous aider dans vos créations. L'approche convenable dépend des autres extensions que vous utilisez :

Manière la plus directe - Special:CreateClass
La page Special:CreateClass définie par Page Forms, fournit en un même lieu, un unique formulaire d'aide pour définir tout ce qu'il faut concernant une « classe » de données. Si vous remplissez les champs et cliquez sur « Soumettre », la page créera automatiquement le modèle, le formulaire et les pages de catégorie nécessaires. Vous pouvez ensuite aller sur la page du formulaire créée, et commencer à saisir les données.

Si toutes les pages ne semblent pas être créées, il se peut que votre file d'attente de travaux manque de mémoire. Voir l'élément relatif à la file des tâches ici pour la manière d'ajouter davantage de mémoire.

Manière la plus raisonnable
Exécutez les étapes suivantes :
 * Create templates. Un modèle définit l'affichage des données sur une page, contient le balisage pour stocker les données dans les tables Cargo et définit (souvent) la page comme appartenant à une certaine catégorie, et donc à un certain type de page. Il y aura généralement un modèle par type de page, bien que parfois un seul type de page contienne plus d'un modèle. Un modèle peut également être utilisé pour l'agrégation, en affichant une liste de toutes les autres pages qui ont une certaine relation avec cette page. Créer les modèles en allant sur la page Special:CreateTemplate.
 * Create forms. Vous pouvez maintenant créer des formulaires pour permettre aux utilisateurs d'ajouter et de modifier facilement des pages de différents types. Il devrait y avoir un formulaire par type de page; le formulaire remplira le ou les modèles contenus dans ce type de page. Comme auparavent, il existe une page spéciale pour créer les nouveaux formulaires : Special:CreateForm.
 * Create categories. Un modèle dans chaque formulaire doit baliser chaque article que le formulaire crée comme faisant partie d'une certaine catégorie. Vous devez créer une page pour chacune de ces catégories et lui spécifier un formulaire par défaut, pour que chaque article soit automatiquement modifiable avec le même formulaire qui l'a créé. La manière la plus facile de faire cela est d'utiliser la page Special:CreateCategory.
 * Enable links to forms. Outre la création de catégories qui ont un formulaire par défaut, vous devez suivre d'autres étapes pour permettre aux utilisateurs d'accéder aux formulaires que vous avez créés. Celles-ci comprennent notamment l'ajout de liens pour ajouter des données dans la barre latérale et ailleurs, et d'utiliser  pour avoir des liens rouges vers des pages inexistantes pointant vers un formulaire pour les créer. Ces actions sont toutes expliquées dans la section « Lier les formulaires ».
 * Add links on sidebar and elsewhere. You can edit the sidebar (which, for English-language wikis, can be edited at the page "MediaWiki:Sidebar") to hold links to add each of the data types. You could also add a link to the page Special:Drilldown, a Cargo-defined page that provides an easy way to view all the wiki's data at a glance. You can also include such links on the main page and elsewhere.
 * Add data. Now you can start entering data! Just go to the form page(s), and start creating pages.
 * 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.

La manière facile - Special:CreateClass
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.

Manière la plus raisonnable
Vous devez réaliser les étapes suivantes :
 * Create properties. The basic building blocks of any semantic site are the connections between data, which in Semantic MediaWiki are known as properties. 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. Créer chaque propriété en allant sur la page Special:CreateProperty.
 * 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. Il y aura généralement un modèle par type de page, bien que parfois un seul type de page contienne plus d'un modèle. 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). Créer les modèles en allant sur la page Special:CreateTemplate.
 * Create forms. Maintenant vous pouvez créer des formulaires pour permettre aux utilisateurs d'ajouter ou de modifier facilement les pages de différents types. Il faut avoir un formulaire par type de page; le formulaire va populer le ou les modèles que cette page contient. Comme précédemment, il existe une page spéciale pour créer les nouveaux formulaires : Special:CreateForm.
 * Create categories. One template in each form should tag each article that the form creates as being part of a certain category. Vous devez créer une page pour chacune de ces catégories et spécifier un formulaire par défaut pour que chaque article soit automatiquement modifiable avec le même formulaire qui l'a créé. La manière la plus facile de faire cela est d'utiliser la page Special:CreateCategory.
 * 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. 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. Ces actions sont toutes expliquées dans la section « Pointer vers les formulaires ».
 * 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. You can also include such links on the main page and elsewhere.
 * Add data. Now you can start entering data! Just go to the form page(s), and start creating pages.
 * 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.

Exemple
Let's go through a specific example of setting up a Page Forms-based wiki from scratch, in the "more comprehensive way". Disons que vous voulez créer un wiki qui affiche tous les livres que vous avez chez vous. We'll then go through the previous steps specified, with some parts different for Cargo vs. SMW.

1. Définier la structure de données. Vous voulez deux types de pages sur votre wiki: une pour les livres et une autre pour les auteurs. Chaque page de livre doit contenir un titre, un nom d'auteur (ou des noms), un genre (ou des genres), une année de publication et un certain nombre de pages. Chaque page d'auteur doit contenir le nom de l'auteur, son pays d'origine et une liste de tous les livres qu'ils ont écrits et que vous possédez.

2. Créer les propriétés. 3. Créer les modèles. You need to create two templates, one for books and one for authors, both at the "Create a template" page at.

D'abord commencer par les livres : 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. Créer les formulaires. 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". Vous ne faites aucun personnalisation supplémentaire sur ce formulaire, mais vous l'enregistrez simplement une fois que vous l'avez créé.
 * Authors - using the "Create a form" page, you make a form called "Author", and add to it the template "Author". Comme précédemment, ne faites aucune personnalisation supplémentaire - enregistrez simplement la page.

5. Créer les catégories. 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. Activer les liens vers les formulaires. This will make links to author pages that don't exist yet point to the form for creating those pages.

7. Ajouter des données. 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. Ajouter des liens dans la barre latérale et ailleurs. 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.

Utiliser 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. Pour créer un schéma de page, vous devez aller à la page de catégorie (si elle a déjà été créée ou pas), aller sur l'onglet action pour créer le schéma de cette page, remplir le formulaire, puis aller sur l'onglet action pour générer des pages en se basant sur ce schéma. Pour plus d'information, voir la documentation Page Schemas.

Guides de référence rapides
Il existe deux guides de référence rapide, ou « aide-mémoire », formatés pour l'impression, contenant des informations utiles sur Page Forms (bien que dans les deux cas, ils se réfèrent toujours à cette extension sous le nom « Semantic Forms »), entre autres extensions :
 * Guide de référence rapide Cargo - dans les formats PNG et PDF
 * Guide de référence rapide de Semantic - est disponible ici, au format PNG (image), PDF ou SVG