Wiki

Dans un wiki de projet, vous pouvez créer et documenter des informations avec votre équipe, comme la documentation du projet, les spécifications, les lignes directrices ou toute autre information importante sur le projet.

Sujet	Contenu
Informations générales sur le wiki	Comment formater une page wiki.
Gestion des images	Comment insérer des images dans le wiki.
Macros	Comment ajouter plus d’informations à une page wiki, par exemple le bouton créer des lots de travaux ou la liste des lots de travaux.
Liens vers les ressources OpenProject	Comment lier des ressources OpenProject, par exemple des lots de travaux, des membres ou des projets.

Informations générales sur le wiki

Le wiki d’OpenProject et tous les autres champs de saisie de texte incluent un éditeur WYSIWYG, développé par CKSource CKEditor5. Le format sous-jacent est GitHub-flavored CommonMark (GFM).

Tous les contenus Textile précédents seront migrés lors de la mise à niveau vers OpenProject 8.0.

Mise en forme de base

L’éditeur de texte d’OpenProject prend en charge les styles de texte de base, tels que la mise en forme en gras et en italique, les en-têtes, caractères barrés, le code en ligne, les guillemets ainsi que la gestion des images en ligne. Le collage de contenu comme des images ou du texte riche est également pris en charge, tandis que les styles non pris en charge seront supprimés par l’éditeur.

Saisissez simplement votre texte dans le champ de saisie, mettez un texte en surbrillance et sélectionnez le formatage via la barre d’outils en haut.

Sauts de ligne

Au lieu de créer un nouveau paragraphe avec Entrée, vous pouvez appuyer sur MAJ + Entrée pour créer un saut de ligne sans créer de nouveau paragraphe.

Liens

Créer des hyperliens en appuyant sur l’icône de lien dans la barre d’outils (éventuellement avec du texte sélectionné), ou en appuyant sur CTRL+k pour ouvrir une fenêtre contextuelle et saisir le href du lien.

Widgets et sauts de lignes

CKEditor utilise des widgets pour afficher des éléments de bloc tels que les images, les tableaux et d’autres éléments qui ne sont pas affichés en ligne. Vous pouvez sélectionner la plupart des widgets en appuyant dessus. La seule exception à cela est le widget de tableau qui comprend un petit bouton de sélection en haut à gauche pour sélectionner le tableau entier.

Lorsque vous avez sélectionné un widget, vous pouvez le supprimer ou le couper. Vous pouvez créer une nouvelle ligne ci-dessous en sélectionnant le widget et en appuyant sur ENTRÉE ou ↓ (FLÈCHE VERS LE BAS), ou une nouvelle ligne au-dessus de celle-ci en appuyant sur SHIFT+Entrée ou ↑ (FLÈCHE VERS LE HAUT). Ceci est particulièrement nécessaire lorsque le widget est le premier ou le dernier élément de la page pour insérer une ligne au-dessous ou en dessus.

Blocs de code

Comme CKEditor5 ne fournit pas actuellement de prise en charge pour les blocs de code, OpenProject peut s’afficher, mais pas éditer les blocs de code dans l’instance de CKEditor. Un bloc de code peut être édité via une fenêtre modale dans une instance de l’éditeur CodeMirror. Cela a l’avantage de fournir la coloration syntaxique et la détection de code (pour les langages supportés).

Tableaux

L’extension GFM des spécifications CommonMark ajoute une définition pour la syntaxe des tableaux pris en charge par CKEditor d’OpenProject. Cette définition requiert que tous les tableaux aient une ligne d’en-tête. Pour les tableaux créés avec CKEditor sans ligne d’en-tête, un tableau HTML est affiché. Cela correspond au comportement de GitHub.

Mise en forme automatique

CKEditor5 permet certaines frappes de clavier ressemblant à CommonMark :

Créez des styles en gras ou en italique en saisissant **will become bold**, will become italic_,
Créez des titres d'indentation différente avec #, ##, ###, …
Créez une liste à puces en démarrant la ligne par * ou - et un espace
Créez une liste numérotée en commençant la ligne par 1. ou 1) et un espace

Gestion des images

Dans les ressources prises en charge par OpenProject où les pièces jointes sont autorisées, vous pouvez ajouter des images à la page

• en utilisant le bouton de la barre d’outils,
• collant une image depuis votre presse-papiers,
• ou en glissant-déposant une image dans l’éditeur.

La pièce jointe sera automatiquement téléchargée et stockée en tant que pièce jointe.

Macros

OpenProject prend en charge les macros sur les pages formatées en Textile et continue de le faire avec l’éditeur WYSIWYG. Notez que les macros ne sont pas développées lors de l’édition de la page, à la place un espace réservé est affiché.

Table des matières

Le cas échéant, la macro de table des matières (TOC) affichera une liste de tous les en-têtes de la page actuelle.

Bouton du lot de travaux

Configurez un bouton ou un lien pour cibler l’écran de création de lots de travaux dans le projet actuel. Vous pouvez présélectionner le type de lot de travaux qui doit être sélectionné. Cela facilite l’orientation des utilisateurs vers le formulaire de création de lots de travaux.

Inclure la page wiki

Ajoutez le contenu d’une page wiki donnée dans le projet actuel ou dans un autre projet visible.

Tableau des lots de travaux et graphique de Gantt intégrés

Il s’agit de la macro la plus flexible qui fournit des fonctionnalités étendues concernant l’inclusion de tableaux dynamiques de lots de travaux avec tout le potentiel du tableau normal.

En ajoutant un tableau intégré de lots de travaux à travers la barre d’outils, vous pouvez configurer la vue du tableau (comme les colonnes, le regroupement, les filtres et autres propriétés) dans une fenêtre contextuelle.

La page rendue récupérera ensuite les résultats du tableau des lots de travaux de façon dynamique, en respectant la visibilité de chaque utilisateur.

Utilisez-le pour intégrer des vues dans d’autres pages, créer des rapports de résultats multiples ou intégrer une vue en diagramme de Gantt.

Éditeur plein vs. contraint

Dans certaines ressources telles que les lots de travaux ou les commentaires, l’éditeur n’expose pas toutes les fonctionnalités telles que les macros ou le téléchargement d’image.

Liens vers les ressources OpenProject

Comme avec la syntaxe de formatage Textile, vous pouvez faire le lien avec d’autres ressources dans OpenProject en utilisant les mêmes raccourcis que précédemment. Create links to:

a wiki page: [[Wiki page]]
a wiki page with separate link name: [[Wiki page|The text of the link]]
a wiki page in the Sandbox project: [[Sandbox:Wiki page]]

a work package with ID12: #12
a work package with ID234: view#12
the default work package view: view:default

a version by ID or name: version#3, version:"Release 1.0.0"
a project by ID/name: project#12 , project:"My project name"
an attachment by filename: attachment:filename.zip
a user by id or login: user#4 , user:"johndoe"
a forum message by ID: message#1218
a repository revision 43: r43
a commit by hash: commit:f30e13e4
a source file in the repository: source:"some/file"

You can always prefix these links with a project identifier followed by a colon in order to reference resources from projects other than the one of the current wiki page:

my-project:view:default

To avoid processing these items, precede them with a bang ! character such as !#12 will prevent linking to a work package with ID 12:

Wiki systems contain all the answers !#42

Saisie semi-automatique pour les lots de travaux

For work packages, typing # will open an autocompleter for visible work packages. This means when you type e.g. #3 or #Market, a list of work packages matching the description will be shown. Then you can either continue typing or choose a work package from the list.