Vous êtes dans un espace restreint en écriture. << PmWiki - Ferme | PmWiki | PmWiki - Mise À Jour >> (:numbered-sections format=0.1.1.a.1.1.1 :)

Un Cookbook est une recette permettant d'étendre les fonctionnalités de PmWiki.

Recettes installées

AutoTOC : Table des matières automatique

source: http://www.pmwiki.org/wiki/Cookbook/AutoTOC

Installation

Copier autotoc.php [1] dans le répertoire pmwiki/cookbook.
Copier autotoc.js [2] dans le réperoire pmwiki/pub.
Ajouter dans local/config.php:

if($action=='browse') include_once("$FarmD/cookbook/autotoc.php");

[$[Get Code]]

Utilisation

C'est automatique !

forcer une table des matière avec (:toc:)
supprimer une table des matière avec (:notoc:)
supprimer un titre de la table avec le code

       !! le titre %block notoc%

NumberedSections

source: http://www.pmwiki.org/wiki/Cookbook/NumberedSections

Installation

Copier numberedsections.php dans le répertoire pmwiki/cookbook.
Ajouter dans local/config.php:

include_once("$FarmD/cookbook/numberedsections.php");

[$[Get Code]]

Utilisation

Il suffit d'ajouter la code

(:numbered-sections format=format_string:)

[$[Get Code]]

avec format_string de la forme :

format_string ::== [ <character_level> <character_separator> ] [1,6]

<character_level> ::== A | a | 0 | 1

[$[Get Code]]

Par exemple, la structure suivante:

exemple de structure
(:numbered-sections format=0.A.1.a:) ! chap1 !! sec 1 !! sec 2 !!! subsec 2_1 ! chap2 !! sec 1	(:numbered-sections format=0.A.1.a:) chap1 sec 1 sec 2 subsec 2_1 chap2 sec 1

ExternalLinks : Lien externe avec une icône

source: http://www.pmwiki.org/wiki/Cookbook/ExternalLinks
icônes wikipedia: http://commons.wikimedia.org/wiki/Category:External_link_icons

Installation

Dans le fichier pub/css/local.css, ajouter le code:

#wikibody a.external {
background: url(http://upload.wikimedia.org/wikipedia/commons/6/64/Icon_External_Link.png) center right no-repeat;
padding-right: 13px;
color: #2f6fab;
}
#wikibody a.external:visited {color: #006699;}

[$[Get Code]]

Utilisation

L'ajout de l'icône est automatique pour tout lien externe.

SourceBlock

source: http://www.pmwiki.org/wiki/Cookbook/SourceBlock
GeShi: http://qbnz.com/highlighter

Colorisation de code source utilisant GeShi,

Installation

wget http://sourceforge.net/projects/geshi/files/latest/download?source=files -O geshi-latest.tgz
tar xzf geshi-latest.tgz -C /var/www/wiki/pmwiki/cookbook

[$[Get Code]]

Utilisation

 (:source PARAMETERS... :)
 source code
 (:sourceend:)

ou encore :

 (:source PARAMETERS... :)[=
 source code 
 =]

Avec comme paramètres:

lang=LANGUAGE pour spécifier une langue parmi cette liste
linenum pour afficher les numéros de ligne

Exemples

bash script
(:source lang=bash :) #!/bin/bash # print the date in LDAP format TZ=Z date +%Y%m%d%H%M%SZ (:sourceend:)	#!/bin/bash # print the date in LDAP format TZ=Z date +%Y%m%d%H%M%SZ [$[Get Code]]

MathJax

source: http://www.pmwiki.org/wiki/Cookbook/MathJax
utilisation de CDN: http://www.pmwiki.org/wiki/Cookbook/MathJax-Talk

Installation

J'ai choisi d~~e ne pas~~ installer les binaires ~~mais d'utiliser la version en-ligne, dite Content Delivery Network (CDN)~~

installer les sources de MathJax dans pub/

wget https://github.com/mathjax/MathJax/archive/v2.6-latest.zip
unzip v2.6-latest.zip
ln -sf MathJax-2.6-latest MathJax

[$[Get Code]]

installer MathJax.php dans le répertoire pmwiki/cookbook
Ajouter dans local/config.php:

# MathJax -- bien mettre include avant
include_once("$FarmD/cookbook/MathJax.php");
# version online CDN $HTMLHeaderFmt['MathJax'] = '<script type="text/javascript" src="http://cdn.mathjax.org/mathjax/latest/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>' ;
$HTMLHeaderFmt['MathJax'] = '<script type="text/javascript" src="pub/MathJax/MathJax.js?config=TeX-AMS-MML_HTMLorMML"></script>' ;

[$[Get Code]]

Utilisation

équations inline: utiliser $ and $ pour les équations inline
équations: utiliser \[ and \]

exemples

équation inline ou pas
Une petite $x=\frac{1+y}{1+2z^2}$ (inline) ou pas : \[x=\frac{1+y}{1+2z^2}\]	Une petite $x=\frac{1+y}{1+2z^2}$ (inline) ou pas : \[x=\frac{1+y}{1+2z^2}\]

équation avec \begin{equation}
\[\begin{equation} \begin{array}{l} \displaystyle \int 1 = x + C\\ \displaystyle \int x = \frac{x^2}{2} + C \\ \displaystyle \int x^2 = \frac{x^3}{3} + C \end{array} \label{eq:xdef} \end{equation}\]	\[\begin{equation} \begin{array}{l} \displaystyle \int 1 = x + C \displaystyle \int x = \frac{x^2}{2} + C \displaystyle \int x^2 = \frac{x^3}{3} + C \end{array} \label{eq:xdef} \end{equation}\]

The Lorenz Equations
\[\begin{aligned} \dot{x} & = \sigma(y-x) \\ \dot{y} & = \rho x - y - xz \\ \dot{z} & = -\beta z + xy \end{aligned}\]	\[\begin{aligned} \dot{x} & = \sigma(y-x) \dot{y} & = \rho x - y - xz \dot{z} & = -\beta z + xy \end{aligned}\]

The Cauchy-Schwarz Inequality
\[\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)\]	\[\left( \sum_{k=1}^n a_k b_k \right)^2 \leq \left( \sum_{k=1}^n a_k^2 \right) \left( \sum_{k=1}^n b_k^2 \right)\]

Maxwell’s Equations

\[\begin{aligned}
\nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} & = \frac{4\pi}{c}\vec{\mathbf{j}} \\   \nabla \cdot \vec{\mathbf{E}} & = 4 \pi \rho \\
\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} & = \vec{\mathbf{0}} \\
\nabla \cdot \vec{\mathbf{B}} & = 0 \end{aligned}\]

\[\begin{aligned} \nabla \times \vec{\mathbf{B}} -\, \frac1c\, \frac{\partial\vec{\mathbf{E}}}{\partial t} & = \frac{4\pi}{c}\vec{\mathbf{j}} \\ \nabla \cdot \vec{\mathbf{E}} & = 4 \pi \rho
\nabla \times \vec{\mathbf{E}}\, +\, \frac1c\, \frac{\partial\vec{\mathbf{B}}}{\partial t} & = \vec{\mathbf{0}}
\nabla \cdot \vec{\mathbf{B}} & = 0 \end{aligned}\]

EditSection

source: http://www.pmwiki.org/wiki/Cookbook/SectionEdit

Installation

copier http://www.pmwiki.org/pmwiki/uploads/Cookbook/sectionedit.php, http://www.pmwiki.org/pmwiki/uploads/Cookbook/signalwhenmarkup.php et http://www.pmwiki.org/pmwiki/uploads/Cookbook/markuptounstyled.php dans le répertoire pmwiki/cookbook
Ajouter dans local/farmconfig ou :

include_once("$FarmD/cookbook/sectionedit.php");

[$[Get Code]]

Configuration Optionnelle

Avant l' inclusion, vous pouvez changer les parametres suivants dans local/farmconfig.php:

ajouter le lien après le titre de la section:

$SectionEditHeaderLinkSpan = true;

[$[Get Code]]

ne fonctionne pas très bien avec la recette AutoToc

changer le texte du lien, en anglais et en français:

XLSDV('en', array('(Edit Section ↓)'=>'[edit]'));
XLSDV('fr', array('(Edit Section ↓)'=>'[Éditer]'));

[$[Get Code]]

Utilisation

Simplement cliquer sur le lien edit à droite.

Pour modifier le comportement dans une page:

(:nosections:) désactive EditSection

EProtect + `noscript` patch

source: http://www.pmwiki.org/wiki/Cookbook/EProtect-Talk

Installation

copier http://www.pmwiki.org/pmwiki/uploads/Cookbook/e-protect-nojavascriptmsg.php dans le répertoire pmwiki/cookbook
Ajouter dans local/farmconfig ou :

include_once("$FarmD/cookbook/e-protect-nojavascriptmsg.php");

[$[Get Code]]

Utilisation

[[mailto:username@domain.net]] est remplacé automatiquement par [[hidden-email:hfre@qbznva.arg]]

la version utilisée ajoute du code <noscript> pour avertir les utilisateurs ayant désactives le javascript

Recettes testées et non installées

Live Edit 2

source: http://www.pmwiki.org/wiki/Cookbook/LiveEdit

Installation

copier liveedit.php dans le répertoire pmwiki/cookbook
# Ajouter dans local/config.php:

include_once('cookbook/liveedit.php');

[$[Get Code]]

Utilisation

Permet une édition des pages et sections avec prévisualisation.

Remarque

Trop complexe.

<< PmWiki - Ferme | PmWiki | PmWiki - Mise À Jour >>

PmWiki - Cookbooks

Recettes installées

AutoTOC : Table des matières automatique

Installation

Utilisation

NumberedSections

Installation

Utilisation

chap1

sec 1

sec 2

subsec 2_1

chap2

sec 1

ExternalLinks : Lien externe avec une icône

Installation

Utilisation

SourceBlock

Installation

Utilisation

Exemples

MathJax

Installation

Utilisation

exemples

EditSection

Installation

Configuration Optionnelle

Utilisation

EProtect + noscript patch

Installation

Utilisation

Recettes testées et non installées

Live Edit 2

Installation

Utilisation

Remarque

EProtect + `noscript` patch