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. Vous pouvez modifier la barre latérale (qui pour les wikis en langue anglaise est modifiable à la page « MediaWiki:Sidebar » ) afin qu'elle garde les liens pour ajouter chacuns des types de données. Vous pouvez également ajouter un lien vers la page Special:Drilldown qui est une page définie par Cargo et qui fournit un moyen facile de voir toutes les données du wiki d'un simple coup d'oeil. Vous pouvez aussi inclure de tels liens sur la page d'accueil ou ailleurs.
 * Add data. Maintenant vous pouvez commencer à saisir les données ! Allez simplement sur les pages des formulaires et commencez à créer les pages.
 * Customize. Une fois que la structure est en place, vous pouvez personnaliser tout ce que vous voulez - modifier l'aspect et le comportement du wiki dans sa totalité, celui des différents modèles ou des formulaires, ajouter ou modifier des champs, ou encore ajouter ou modifier des requêtes.

La manière facile - Special:CreateClass
La page Special:CreateClass définie par Page Forms, fournit un formulaire unique d'assistant pour déclarer à un seul endroit tout ce qui concerne une donnée de type « classe ». Si vous remplissez les champs et cliquez sur « Envoyer », la page va créer automatiquement toutes les propriétés nécessaires, le modèle, le formulaire et les pages de catégories. Ensuite vous pouvez aller sur la page du formulaire qui a été créé et commencer à saisir les données.

Si toutes les pages semblent ne pas avoir été créées, c'est peut être parce que la file d'attente des tâches manque de mémoire. Voyez ici l'élément associé de la file d'attente des tâches pour savoir comment ajouter davantage de mémoire.

Manière la plus raisonnable
Vous devez réaliser les étapes suivantes :
 * Create properties. Les blocs de construction de base de tout site sémantique sont les connexions entre les données, qui dans Semantic MediaWiki s'appellent les propriétés. Une propriété est utilisée pour spécifier un élément unique d'information à propos du sujet de cette page. Chaque propriété doit être définie sur votre wiki, par une page de l'espace de noms « Property: » . 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. Un modèle dans chaque formulaire doit marquer chaque article créé par ce formulaire, comme faisant partie d'une catégorie donnée. 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. En plus de créer des catégories qui possèdent un formulaire par défaut, il existe d'autres étapes à suivre pour permettre aux utilisateurs de pouvoir accéder aux formulaires que vous avez créés. 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. Vous pouvez aussi inclure de tels liens sur la page d'accueil et ailleurs.
 * Add data. Maintenant vous pouvez commencer à saisir les données ! Allez simplement sur les pages des formulaires et commencez à créer les 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. Nous passerons ensuite par les étapes précédentes spécifiées, avec certaines parties différentes pour Cargo avec Semantic MediaWiki.

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. Vous devez créer deux formulaires, un pour les livres et un pour les auteurs :
 * 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