FAQ

Je suis novice sur PmWiki, où puis-je trouver de l'aide de base pour débuter ?

La page Basic Editing est un bon point de départ. À partir de là, vous pouvez simplement suivre les liens de navigation en haut ou en bas de la page (appelés Wiki Trails) pour accéder aux pages suivantes, ou à la page Documentation Index, qui propose un index structuré des pages de documentation essentielles, classées du niveau débutant au niveau avancé.

Comment insérer des caractères spéciaux comme Copyright (©) et Marque déposée (® ou ™) sur mes pages wiki ?

Consultez la section special characters pour savoir comment insérer des caractères spéciaux qui ne figurent pas sur votre clavier.

Comment conserver les sauts de ligne du texte source ?

PmWiki considère généralement les lignes de texte consécutives comme un paragraphe et les fusionne et les ajuste à la ligne lors de l'affichage. Ce comportement est conforme à celui de la plupart des autres packages wiki. Un auteur peut utiliser la directive `(:linebreaks:)` pour que les lignes de texte balisées suivantes soient conservées comme des lignes distinctes dans le rendu. Un administrateur wiki peut également définir dans le fichier config.php la ligne `$EnablePreserveLineBreaks = 1;` pour activer les sauts de ligne par défaut.

Puis-je saisir directement du code HTML ?

Par défaut (et intentionnellement), PmWiki ne prend pas en charge l’utilisation d’éléments HTML dans le balisage modifiable des pages wiki. Plusieurs raisons expliquent ce choix, décrites dans la section PmWiki Philosophy et Audiences. Activer le balisage HTML dans les pages wiki au sein d’un environnement collaboratif peut empêcher certains auteurs potentiels de modifier les pages et poser des problèmes d’affichage et de sécurité. Toutefois, un administrateur du site peut utiliser la recette Cookbook:Enable HTML pour activer l’utilisation du balisage HTML directement dans les pages.

Comment masquer la barre latérale pendant l’édition ?

Modifiez Site.EditForm et ajoutez la directive (:noleft:), voir page directives. Certains thèmes peuvent utiliser une directive différente (:noright:) ou une page de formulaire d’édition différente ; consultez leur documentation.

Où puis-je trouver plus de documentation ?

Consultez les pages Index de la documentation et markup master index.

Comment créer une nouvelle page ?

Saisir [[ma nouvelle page]] créera un lien vers la nouvelle page. Il existe beaucoup de possibilités avec les liens à double crochet.

Pourquoi certaines nouvelles pages ont-elles un titre avec des espaces comme "Création de nouvelles pages" et d'autres un titre de type WikiWord comme "CreationDeNouvellesPages" ?

Le titre par défaut d'une page est simplement son nom, généralement "CreationDeNouvellesPages". Vous pouvez toutefois le modifier à l'aide de la directive (:title Création de nouvelles pages:). Ceci est particulièrement utile lorsque le titre contient des caractères spéciaux ou des majuscules qui ne peuvent pas figurer dans le nom de la page.

Pourquoi certaines images externes sont-elles correctement intégrées et d’autres non ?

Si la page actuelle se trouve sur une URL sécurisée avec le protocole "https://", certains navigateurs refusent de charger les images provenant d’URL non sécurisées (l’inverse est autorisé). De plus, certains webmasters configurent leurs serveurs pour interdire le hotlinking.

Est-il possible d’insérer un lien vers une image sur PmWiki sans utiliser d’URL complète ?

Oui. Pour les images jointes, le format général est Attach:Groupname./image.gif. Pour insérer un lien vers une image hébergée sur le même serveur, utilisez Path:/chemin/vers/image.gif où "Path:" remplace le nom du serveur, par exemple "https://www.example.com".

Puis-je joindre un fichier image client sur PmWiki ?

Oui, voir Uploads.

Comment inclure une image dont le nom contient des espaces ?

Échappez le nom de l'image avec le balisage [=nom_de_l'image=].jpg.

Comment inclure une page d'un autre groupe contenant une image jointe ?

Incluez la page normalement, c'est-à-dire : (:include GroupName.Pagename:). Dans la page à inclure (celle qui contient l'image), remplacez Attach:filename.ext par Attach:{$Group}./filename.ext.

Pourquoi, lorsque j'insère une image avec rframe ou rfloat et que j'ouvre immédiatement après une nouvelle section de page avec !, le titre de la section s'affiche-t-il sous l'image au lieu d'être à gauche ?

Parce que le CSS des headings, comme !, contient l'élément clear:both qui impose ce comportement. Redéfinissez le CSS localement si vous souhaitez éviter cela, mais je pense que la bordure inférieure (qui souligne le titre) devra également être redéfinie. J'utilise simplement le gras pour le titre et 4 tirets en dessous de ---- pour séparer une nouvelle section, ce qui évite d'avoir à modifier les définitions principales.

Contrairement aux directives lframe et rframe, cframe ne tient pas entièrement compte de la largeur définie. Bien que le cadre lui-même s'adapte à la requête, l'image qu'il contient conserve sa largeur d'origine. Le comportement est identique sous Internet Explorer et Firefox. J'ai ajouté un exemple sous l'exemple standard ci-dessus.

Est-il possible de désactiver toutes les images ? J’ai déjà désactivé les chargements, mais je souhaite également empêcher l’affichage d’images externes sur mes pages wiki.

Oui, ajoutez à config.php :

DisableMarkup('img');
$ImgExtPattern = "$^";

Comment faire pour que, lorsque j'insère une image dans une page, le bloc de texte qui la contient soit un paragraphe (<p>) plutôt qu'une division (<div>) ?

Si vous souhaitez que cela ne s'applique qu'à une seule image (et non à toutes), essayez d'ajouter [==] au début de la ligne, comme ceci :

L'ajout de [==] au début d'une ligne force le texte qui suit à faire partie d'un paragraphe.

Est-il possible d’utiliser des chemins relatifs pour les images ?

Consultez le guide : Cookbook:RelativeLinks et $EnableLinkPageRelative.

Est-il possible de joindre une image BMP et de l'afficher plutôt que de créer un lien ?

Ajoutez la ligne suivante à config.php :
$ImgExtPattern = "(?:$ImgExtPattern|\\.bmp|\\.BMP)";
Notez que les images BMP ne sont pas compressées et sont assez volumineuses. Vous pouvez les convertir au format PNG (sans perte) ou JPG (avec perte) afin de réduire leur taille de 5 à 20 fois.

Comment ajouter un type d’image à $ImgExtPattern tout en incluant les futurs types d’images par défaut ajoutés dans PmWiki ?

Vous pouvez ajouter les extensions à la variable $ImgExtPattern comme ceci :
$ImgExtPattern = "(?:$ImgExtPattern|\\.webp|\\.WEBP)";

Est-il possible d’afficher un tableau à gauche ou à droite d’une image ?

Oui, voir TableAndImage.

Comment inclure un fichier externe (depuis le même système de fichiers)?

Il y a deux options.

Dans la page wiki elle-même, si vous ne voulez pas donner un accès aux auteurs à n'importe quel fichier du système, créez votre propre balise. En supposant que les fichiers à inclure sont dans un seul répertoire (ou dans un répertoire remplis de liens) pour être un peu plus en sécurité, adaptez ce qui suit:

Markup('includefile', 'directives', '/\\(:includefile\\s+([-\\w.]+)\\s*:\\)/e', "Keep(implode('', file('/home/chemin/$1')))");

Avec ceci, la balise (:includefile something.html:)incluera le contenu de /home/chemin/something.html dans la sortie.

Dans un fichier de modèle .tmpl vous pouvez utiliser <!--file:path/to/template.html-->.

Voir aussi : Cookbook:IncludeUrl

Qu'est PmWiki?

PmWiki est un système wiki pour la création et la maintenance de sites internet. Pour plus d'information, cf. PmWikiFr.

Que puis-je faire avec PmWiki?

Les pages de PmWiki ressemblent à des pages web ordinaires, mais elles ont un lien "Éditer" qui facilite la modification de pages existantes et l'ajout de nouvelles pages dans le site internet, avec des règles simples d'édition. Vous n'avez pas besoin de connaitre ou d'utiliser HTML, CSS ou PHP. L'édition peut être ouverte à tous les visiteurs, ou réservée à de petits groupes d'auteurs. Essayez les Règles de mise en forme dans le "Bac à sable". Ce site que vous êtes en train de parcourir est construit et maintenu avec PmWiki.

Quels sont les besoins système?

Référez-vous à la page Besoins système.

Où je peux trouver la documentation?

Voyez la page Index de la documentation en français et Documentation Index en anglais.

Comment je peux télécharger PmWiki?

Voyez la page Téléchargement.

Comment installer PmWiki?

Voyez la page Installation.

Comment trouver de l'aide avec PmWiki?

Voyez les pages Listes de diffusion et HowToGetAssistance.

Comment créer un lien qui s’ouvre dans une nouvelle fenêtre ?

Utilisez le style wiki %newwin%, comme ceci :

%newwin% https://example.com/ %%

Comment créer un lien qui ouvre une nouvelle fenêtre et configurer cette nouvelle fenêtre ?

Cela nécessite JavaScript. Voir Cookbook:PopupWindow.

Comment insérer une adresse postale dans une page ?

Utilisez la balise mailto:, comme dans l'un des exemples suivants :

* mailto:myaddress@example.com
* [[mailto:myaddress@example.com]]
* [[mailto:myaddress@example.com | m'envoyer un e-mail]]
* [[mailto:myaddress@example.com?subject=Sujet | m'envoyer un e-mail]]

La balise @@[[mailto:me@example.com?cc=someoneelse@example.com&bcc=else@example.com&subject=Sujet prédéfini&body=Corps prédéfini | L'option `display text` vous permet de spécifier davantage de paramètres, comme le corps du message et d'autres destinataires (cette fonctionnalité peut ne pas être compatible avec tous les navigateurs et clients de messagerie).

Consultez également le Cookbook:DeObMail pour obtenir des informations sur la protection des adresses e-mail contre les spams.

Comment activer les liens vers d'autres protocoles, tels que nntp, ssh, xmpp, etc. ?

Consultez Cookbook:Add Url schemes How to get PmWiki to recognize additional URL schemes such as irc:, nntp:, etc.

Comment créer un lien WikiWord vers une page externe plutôt que vers une WikiPage ?

Utilisez le balisage de lien. Il existe deux formats :

[[https://example.com/ | WikiWord]]
[[WikiWord -> https://example.com/]]

Comment trouver toutes les pages qui contiennent un lien vers une autre page (c.-à-d. les backlinks) ?

Dans le formulaire de recherche du wiki, utilisez link=Group.Page pour trouver toutes les pages contenant un lien vers Group.Page.

Utilisez l'option link= de la directive (:pagelist:), comme dans :

(:pagelist link=SomePage list=all:) -- afficher tous les liens vers SomePage
(:pagelist link={$FullName} list=all:) -- afficher tous les liens vers la page actuelle

Notez que (à quelques exceptions près) les inclusions, les conditions, les listes de pages, les résultats de recherche, les wikitrails et les redirections ne sont pas évalués pour les wikilinks ; par conséquent, les liens qu'ils placent sur la page ne seront pas considérés comme des backlinks. Toutes les autres directives et balises, par exemple les liens introduits par (:pmform:), seront détectées.

Quels schémas de liens PmWiki prend-il en charge ?

Voir PmWiki:Link schemes Link schemes supported by PmWiki

Comment ouvrir les liens externes dans une nouvelle fenêtre ou les marquer d'une icône ?

Voir Cookbook:External links Configure external links to open in a new window, have a "tooltip title", or use other CSS classes

Comment utiliser une image comme lien ?

Utilisez [[Page| Attach:image.jpg ]] ou [[ https://site | https://site/image.jpg ]]. Voir Images#links.

Pourquoi mon navigateur ne suit-il pas les liens locaux file:// ?

Pour des raisons de sécurité, la plupart des navigateurs n'autorisent les liens file:// que si la page contenant le lien se trouve sur le disque local. Autrement dit, la plupart des navigateurs n'autorisent pas les liens file:// depuis des pages récupérées via https://, comme sur un site PmWiki. Voir également Cookbook:DirList pour une solution de contournement.

Comment créer un lien vers la première page existante ? Par exemple : [[Group1.Page Group2.Page|Page]]

Voir ConditionalMarkup

(:if exists Group1.Page:)
[[Group1.Page|Page]]
(:elseif exists Group2.Page:)
[[Group2.Page|Page]]
(:ifend:)

Comment faire apparaître les liens Reference en bas de page, comme sur Wikipédia ? Ou comment lister tous les liens d’une page ?

Voir Cookbook:Footnotes.

Comment créer un lien qui invite l’utilisateur à télécharger un fichier au lieu de l’ouvrir dans le navigateur ?

Sur une page, utilisez %download%[[Attach:file.txt]]%% ou %download="differentfilename.txt"%[[Attach:file.txt]]%% pour suggérer un autre nom de fichier dans la boîte de dialogue d'enregistrement.

Avant PmWiki 2.5.9, vous devez ajouter le code suivant à config.php :

$WikiStyle['download']['download'] = '';
$WikiStyleAttr['download'] = 'a';

Est-ce le bon endroit où poser une question?

Peut-être. Vérifiez que votre question n'apparait pas déjà dans la FAQ

Recherche accentuée / non accentuée

Je voudrais que lorsque le moteur de recherche cherche un mot avec accent, il donne indifféremment les mots avec accents et les mots sans accents exemple je cherche chateau je veux avoir comme resultat toutes les pages avec chateau ou château. Comment peut on arriver a ce resultat? Merci. Jean.

Je n'arrive pas à installer la version française.

Je ne comprend pas où il faut écrire "XLPage('fr','PmWikiFr.XLPage');" Ecris le dans le fichier local/config .dans le fichier pmwiki.php et où ce fichier doit-il être placé (racine du wiki ou dossier /local ?). Merci d'avance, Louise.

Ecris la ligne dans le fichier local/config.php . FidelioEspoir

Dans wikilib.d, toutes les pages PmWiki.xxx ont leur traduction dans PmWikiFr.xxx. Qu'en est-il avec les pages wikilib.d/Site.xxx et wikilib.d/SiteAdmin.xxx ? Ont-elles été traduites? Je ne les vois pas non plus dans le tableau de la page Etat de la traduction Merci. Caroline Guénette 17 novembre 2011 à 12h25

En suivant ces instructions, tu devrais obtenir un wiki traduit entièrement en français en utilisant les traductions par défaut ou en fournissant les tiennes.
Sinon pour répondre plus précisément à ta question, les traductions du site sont en grande partie contenues dans la page PmWikiFr.XLPage dans laquelle tu trouveras les liens pointants vers les pages traduites du groupe 'Site' :

  ### Page locations
  '{$SiteGroup}/EditQuickReference' => 'PmWikiFr/EditQuickReference',
  '{$SiteGroup}/UploadQuickReference' => 'PmWikiFr/UploadQuickReference',
  '{$SiteGroup}/Search' => 'PmWikiFr/Recherche',
  '{$SiteGroup}.PageNotFound' => 'PmWikiFr.PageNotFound',

Tu peux également faire pointer ses substitutions par tes propres pages personnalisées si tu veux. D'autres pages du groupe Site et SiteAdmin sont plus réservées pour la configuration et n'ont pas lieu d'être traduites directement. Antony Templier 21 novembre 2011 à 11h29

Lorsque la page Main.Thème est créée, j'obtiens le fichier wiki.d/Main.Thèmes. Vous aussi? Je me demande pourquoi ça fait ça!

Il s'agit certainement d'une différence d'encodage des caractères entre celui utilisé avec la page web (utf8 par exemple) et celui utilisé par ton système de fichier (iso-8859-1 par exemple).

Quelle est la différence entre une PageList et un WikiTrail ?

La directive pagelist génère dynamiquement une liste de pages. Il existe plusieurs façons de générer cette liste, notamment en utilisant un WikiTrail comme source.
La directive pagelist affiche ensuite les pages correspondant aux critères à l’aide d’un modèle optionnel : par exemple, en affichant le nom de chaque page sur une ligne distincte sous forme de lien ou en incluant le contenu intégral.
La directive pagelist ne dispose actuellement d’aucun balisage de navigation intégré que vous pouvez ajouter aux pages de la liste.
En revanche, les WikiTrails sont simplement spécifiés par des liens sur une page "index" et vous pouvez ajouter un balisage de navigation précédent/suivant sur chaque page. Les deux ont des objectifs très différents. Les WikiTrails sont utiles pour spécifier les pages dans les web feeds, pour créer un "tour" à travers un ensemble prédéfini de pages, et bien d'autres choses.