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.

Comment incorporer une image dans une page wiki?

Utilisez http://site/image.jpg avec l'adresse absolue de l'image, ou Attach:image.jpg pour une image jointe au wiki (cf. Fichiers joints).

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.