SPIP-Contrib

Badge pour dons

b_b — 2012-02-08T13:33:55Z

Ce plugin permet d'afficher un badge dans les pages publiques de votre site pour inciter les visiteurs à faire des dons.

Vous pouvez observer le résultat sur le site de l'association et sur le site lestaxinomes.org.

Installation et configuration


Plugin Badge pour dons: Télécharger le plugin sur la zone.

Installation et activation comme tous les plugins.

Configuration et personnalisation

L'url du lien du badge est personnalisable de deux façons. Vous pouvez déclarer l'url depuis le fichier config/mes_options.php de votre site en y ajoutant la ligne suivante :

define('_BADGE_DON_URL', 'http://www.spip.net');

Si le plugin SPIP-bonux est installé, vous pouvez aussi déclarer l'url de la page de don depuis la page de configuration du plugin.


Badge par défaut - CC-BY Les petits débrouillards Bretagne

Vous pouvez aussi personnaliser l'image affichée par le badge en déposant un fichier nommé badge_don.png dans le répertoire squelettes/images de votre site. Votre image personnalisée doit être un carré de 100 pixels de côté.

Ce plugin permet d'afficher un badge dans les pages publiques de votre site pour inciter les visiteurs à faire des dons.

Ce plugin a été réalisé afin d'afficher un badge d'appel au don sur plusieurs sites gérés par l'association «Les petits débrouillards Bretagne». Le badge est affiché dans le coin en bas à droite des pages publiques du site et il comporte un lien vers la page de votre choix. Vous pouvez observer le résultat sur [le site de l'association->http://www.lespetitsdebrouillardsbretagne.org/] et sur le site [lestaxinomes.org->http://www.lestaxinomes.org/]. {{{Installation et configuration}}} [Installation et activation comme tous les plugins->http://www.spip.net/fr_article3396.html]. {{{Configuration et personnalisation}}} L'url du lien du badge est personnalisable de deux façons. Vous pouvez déclarer l'url depuis le fichier config/mes_options.php de votre site en y ajoutant la ligne suivante : define('_BADGE_DON_URL', 'http://www.spip.net'); Si [le plugin SPIP-bonux->2857] est installé, vous pouvez aussi déclarer l'url de la page de don depuis la page de configuration du plugin. Vous pouvez aussi personnaliser l'image affichée par le badge en déposant un fichier nommé badge_don.png dans le répertoire squelettes/images de votre site. Votre image personnalisée doit être un carré de 100 pixels de côté.

Brownygreen

E-cosystems — 2012-02-03T16:26:49Z

Un thème simple de couleur marron et vert, en largeur fixe, constitué de 2 colonnes avec une en-tête facilement personnalisable.

Présentation

Adaptation de Versatility par E-cosystems.

Si vous utilisez le plugin Menus, une navigation principale avec sous-menus est prévue et mise en page dans ce thème.

Démonstration

http://zpip.spip.org/?var_theme=zpip-1/brownygreen

Capture

{{Un thème simple de couleur marron et vert, en largeur fixe, constitué de 2 colonnes avec une en-tête facilement personnalisable.}} {{{Présentation}}} Adaptation de [Versatility->http://www.spip-contrib.net/Versatility] par [E-cosystems->http://www.e-cosystems.org/]. Si vous utilisez le plugin Menus, une navigation principale avec sous-menus est prévue et mise en page dans ce thème. {{{Démonstration}}} http://zpip.spip.org/?var_theme=zpip-1/brownygreen {{{Capture}}}

Navigation AJAX

bystrano — 2012-01-31T17:06:59Z

Ce plugin permet de modifier automatiquement une parties des liens internes de manière à ce qu'ils ne déclenchent pas un chargement complet de la page cible, mais un chargement en AJAX de certains éléments spécifiés à l'avance.

Il permet aussi de spécifier des éléments qui ne seront rechargés qu'en cas de changement de langue.

En clair, imaginons que nous sommes sur la page de sommaire de votre site, et qu'on clique sur un lien vers l'article no123. Le navigateur recharge alors la page en entier, y compris des éléments qui restent identiques, comme le pied de page ou l'en-tête. Avec “Navigation AJAX”, vous pouvez définir que la seule partie à recharger est l'intérieur de la balise div qui a l'id “contenu”. Le click sur le lien provoque alors un chargement AJAX de cette balise.

Le problème avec ce genre d'approche est que lorsqu'on charge la page de cette façon, l'URL de la barre d'adresse ne change pas. Dans notre exemple, l'utilisateur qui veut partager un lien vers l'article no123 enverra alors ses amis vers votre page de sommaire. Ce plugin règle ce problème en utilisant l'API History fournie par les navigateurs HTML5. Pour les utilisateurs dont le navigateur ne supporte pas cette API, on a le choix entre ne pas utiliser de chargements AJAX et utiliser une astuce avec des hashes (#) dans l'url comme le font des sites comme twitter par exemple.

Utiliser ce plugin a plusieurs avantages :

Comme la page n'est jamais complètement rechargée par le navigateur, la navigation est plus fluide et réactive.
Cela permet de réduire considérablement la quantité de données échangées entre votre serveur et l'utilisateur, ce qui accélère notablement le chargement des pages et économise la bande passante.
Pour certaine utilisations particulières, comme par exemple un site de radio, cela permet un plus grand confort d'utilisation. On peut s'arranger pour ne jamais recharger la liste de lecture et les visiteurs peuvent alors changer de page sans interrompre la musique.

Il semblerait qu'une fonctionnalité similaire sera disponible nativement dans SPIP3, mais en attendant, plus rien ne vous empêche de profiter des avantages de cette approche !

Configuration

Pour fonctionner, ce plugin doit être correctement configuré. La page de configuration est accessible depuis la page des plugins, qui nous amène au formulaire de configuration :

Le préfixe des urls : Ce plugin ne fonctionne qu'avec les sites qui utilisent des adresses url de type “page” (à choisir dans l'onglet “Fonctions Avancées” de la configuration du site). Il faut alors garder la valeur par défaut. Pour ceux qui utilisent un autre préfixe, il est possible de le définir ici.
Les types de page : Ce réglage permet de spécifier les types de liens qui seront traités. Le réglage dans la capture d'écran ci-dessus signifie que tous les liens vers le sommaire, vers un article ou vers une rubrique seront chargés en AJAX. Par contre, les liens vers une page de mot-clé ou vers la page de login seront laissé intacts et fonctionneront comme d'habitude.
Les ids des divs à charger en AJAX : Le réglage de la capture d'écran signifie que les divs ayant comme id “contenu” et “spip-admin” seront rechargés en AJAX. Vous devriez toujours laisser “spip-admin” dans ce champ, puisqu'il s'agit des boutons affichant les statistiques et le bouton “recalculer” qui s'affichent lorsqu'un contributeur du site est connecté.
Les ids des divs à recharger en cas de changement de langue : Ce réglage est utile pour les sites multilingues. Pour que ceci fonctionne correctement, il est impératif de placer un attribut lang à la balise html.
Activer les urls hash : Activez cette option si vous voulez que vos visiteurs qui utilisent des vieux navigateurs profitent aussi de la navigation AJAX. Ce choix ne devrait pas être pris à la légère, puisqu'il induit des problèmes. Par exemple, si un de vos visiteurs sur IE7 transmet un lien à quelqu'un qui a bloqué le Javascript, le lien ne l'enverra pas sur la bonne page. N'activez cette fonction que si le fonctionnement de votre site dépend fortement de la navigation AJAX, et que vous jugez que les inconvénients en valent la peine. Pour plus d'infos sur les problèmes crées en cochant cette option sur cette page (page en anglais).

Effets pré- et post-chargement

Si vous souhaitez utiliser des effets Javascript pour animer les chargements AJAX, vous pouvez vous appuyer sur les événements “onAjaxNavReq”, “onAjaxNavLoad” et “onAjaxNavLocalisedLoad”, qui sont déclenchés respectivement avant un chargement, après un chargement normal et après un chargement avec changement de langue. Ces événements sont déclenchés par chacun des éléments concernés, ce qui vous permet d'assigner des effets différents à chaque élément.

Par exemple, si vous voulez un effet de fondu sur la balise avec id “contenu” lors d'un chargement, vous pouvez utiliser le code Javascript suivant :

$('#contenu').bind('onAjaxNavReq',function () {
$('#contenu').animate({opacity: 0}, 'fast');
});
$('#contenu').bind('onAjaxNavLoad',function (){
$('#contenu').animate({opacity: 1}, 'fast');
});

Télécharger

Ou alors, si votre menu est rechargé en cas de changement de langue, et qu'il a des effets Javascript que vous avez groupés dans une fonction appelée “attachMenuFx”, chaque changement de langue va abimer vos beaux effets. Dans ce cas utilisez le code suivant :

$('#menu').bind('onAjaxNavLocalisedLoad', attachMenuFx);

Ce plugin fait une utilisation intensive de la librairie History.js, un grand merci à son auteur ! J'ai aussi utilisé la librairie Javascript Modernizr et la librairie phpQuery. Ces librairies sont inclues dans le plugin, donc pas besoin de vous en soucier.
Et évidement merci à toute la communauté SPIP pour ce fabuleux logiciel et sa multitude de contributions !

Il permet aussi de spécifier des éléments qui ne seront rechargés qu'en cas de changement de langue. En clair, imaginons que nous sommes sur la page de sommaire de votre site, et qu'on clique sur un lien vers l'article no123. Le navigateur recharge alors la page en entier, y compris des éléments qui restent identiques, comme le pied de page ou l'en-tête. Avec “Navigation AJAX”, vous pouvez définir que la seule partie à recharger est l'intérieur de la balise div qui a l'id “contenu”. Le click sur le lien provoque alors un chargement AJAX de cette balise. Le problème avec ce genre d'approche est que lorsqu'on charge la page de cette façon, l'URL de la barre d'adresse ne change pas. Dans notre exemple, l'utilisateur qui veut partager un lien vers l'article no123 enverra alors ses amis vers votre page de sommaire. Ce plugin règle ce problème en utilisant l'API History fournie par les navigateurs HTML5. Pour les utilisateurs dont le navigateur ne supporte pas cette API, on a le choix entre ne pas utiliser de chargements AJAX et utiliser une astuce avec des hashes (#) dans l'url comme le font des sites comme twitter par exemple. Utiliser ce plugin a plusieurs avantages : -* Comme la page n'est jamais complètement rechargée par le navigateur, la navigation est plus fluide et réactive. -* Cela permet de réduire considérablement la quantité de données échangées entre votre serveur et l'utilisateur, ce qui accélère notablement le chargement des pages et économise la bande passante. -* Pour certaine utilisations particulières, comme par exemple un site de radio, cela permet un plus grand confort d'utilisation. On peut s'arranger pour ne jamais recharger la liste de lecture et les visiteurs peuvent alors changer de page sans interrompre la musique. [Il semblerait->http://www.spip-contrib.net/spip-info-net-Les-fonctionnalites-de-SPIP3] qu'une fonctionnalité similaire sera disponible nativement dans SPIP3, mais en attendant, plus rien ne vous empêche de profiter des avantages de cette approche ! {{{Configuration}}} Pour fonctionner, ce plugin doit être correctement configuré. La page de configuration est accessible depuis la page des plugins, qui nous amène au formulaire de configuration : -* {{Le préfixe des urls :}} Ce plugin ne fonctionne qu'avec les sites qui utilisent des adresses url de type “page” (à choisir dans l'onglet “Fonctions Avancées” de la configuration du site). Il faut alors garder la valeur par défaut. Pour ceux qui utilisent un autre préfixe, il est possible de le définir ici. -* {{Les types de page :}} Ce réglage permet de spécifier les types de liens qui seront traités. Le réglage dans la capture d'écran ci-dessus signifie que tous les liens vers le sommaire, vers un article ou vers une rubrique seront chargés en AJAX. Par contre, les liens vers une page de mot-clé ou vers la page de login seront laissé intacts et fonctionneront comme d'habitude. -* {{Les ids des divs à charger en AJAX :}} Le réglage de la capture d'écran signifie que les divs ayant comme id “contenu” et “spip-admin” seront rechargés en AJAX. Vous devriez toujours laisser “spip-admin” dans ce champ, puisqu'il s'agit des boutons affichant les statistiques et le bouton “recalculer” qui s'affichent lorsqu'un contributeur du site est connecté. -* {{Les ids des divs à recharger en cas de changement de langue :}} Ce réglage est utile pour les sites multilingues. Pour que ceci fonctionne correctement, il est impératif de placer un attribut lang à la balise html. -* {{Activer les urls hash :}} Activez cette option si vous voulez que vos visiteurs qui utilisent des vieux navigateurs profitent aussi de la navigation AJAX. Ce choix ne devrait pas être pris à la légère, puisqu'il induit des problèmes. Par exemple, si un de vos visiteurs sur IE7 transmet un lien à quelqu'un qui a bloqué le Javascript, le lien ne l'enverra pas sur la bonne page. N'activez cette fonction que si le fonctionnement de votre site dépend fortement de la navigation AJAX, et que vous jugez que les inconvénients en valent la peine. Pour plus d'infos sur les problèmes crées en cochant cette option sur [cette page->https://github.com/balupton/history.js/wiki/Intelligent-State-Handling] (page en anglais). {{{Effets pré- et post-chargement}}} Si vous souhaitez utiliser des effets Javascript pour animer les chargements AJAX, vous pouvez vous appuyer sur les événements “onAjaxNavReq”, “onAjaxNavLoad” et “onAjaxNavLocalisedLoad”, qui sont déclenchés respectivement avant un chargement, après un chargement normal et après un chargement avec changement de langue. Ces événements sont déclenchés par chacun des éléments concernés, ce qui vous permet d'assigner des effets différents à chaque élément. Par exemple, si vous voulez un effet de fondu sur la balise avec id “contenu” lors d'un chargement, vous pouvez utiliser le code Javascript suivant : $('#contenu').bind('onAjaxNavReq',function () { $('#contenu').animate({opacity: 0}, 'fast'); }); $('#contenu').bind('onAjaxNavLoad',function (){ $('#contenu').animate({opacity: 1}, 'fast'); }); Ou alors, si votre menu est rechargé en cas de changement de langue, et qu'il a des effets Javascript que vous avez groupés dans une fonction appelée “attachMenuFx”, chaque changement de langue va abimer vos beaux effets. Dans ce cas utilisez le code suivant : $('#menu').bind('onAjaxNavLocalisedLoad', attachMenuFx);

Ce plugin fait une utilisation intensive de la librairie [History.js->https://github.com/balupton/history.js], un grand merci à son auteur! J'ai aussi utilisé la librairie Javascript [Modernizr->http://www.modernizr.com/] et la librairie [phpQuery->https://code.google.com/p/phpquery/]. Ces librairies sont inclues dans le plugin, donc pas besoin de vous en soucier. _ Et évidement merci à toute la communauté SPIP pour ce fabuleux logiciel et sa multitude de contributions!

Personnalisation de la page 404 de SoyezCréateurs

RealET — 2012-01-31T10:56:42Z

L'image affichée dans la page 404 de SoyezCréateurs peut être personnalisée.

Qu'est-ce qu'une page 404 ?

Il s'agit de la page qui s'affiche lorsqu'on demande à voir une page qui n'existe pas dans le site.

Apparence par défaut dans SoyezCréateurs


Erreur 404 de SoyezCréateurs

Le texte affiché est imposé. Il est le fruit de ma veille technologique sur les 404.

L'objectif est de se placer du côté du visiteur, et donc, de ne surtout pas le culpabiliser, mais, au contraire, de l'accompagner en douceur.

Personnalisation de l'image

Pour cela, il suffit de placer l'image que vous souhaitez dans le dossier squelettes/images/ avec comme nom : 404.jpg.

L'image affichée dans la page 404 de SoyezCréateurs peut être personnalisée.

{{{Qu'est-ce qu'une page 404 ?}}} Il s'agit de la page qui s'affiche lorsqu'on demande à voir une page qui n'existe pas dans le site. {{{Apparence par défaut dans SoyezCréateurs}}} Le texte affiché est imposé. Il est le fruit de ma [veille technologique sur les 404->http://delicious.com/jpyrat/404]. L'objectif est de se placer du côté du visiteur, et donc, de ne surtout pas le culpabiliser, mais, au contraire, de l'accompagner en douceur. {{{Personnalisation de l'image}}} Pour cela, il suffit de placer l'image que vous souhaitez dans le dossier {{squelettes/images/}} avec comme nom : {{404.jpg}}.

Nouvelle version - Modération de modifications

fwedboot — 2012-01-29T12:07:27Z

Suite à une migration depuis SPIP-Agora, j'ai développé ce plugin permettant de reprendre la fonctionnalité « Nouvelle version » non reprise sur SPIP 2.

Cette fonctionnalité permet de :

- Modérer a priori les modifications d'un article publié en ligne
- Archiver la version antérieure complète de l'article une fois la modification validée par un administrateur.

Des rédacteurs peuvent donc modifier un article en ligne (tout le monde peut créer une nouvelle version d'article), mais seuls des administrateurs peuvent publier la version modifiée.

Ce plugin s'appuie sur le plugin duplicator pour la partie duplication d'article.

La partie « remplacement et publication » est écrite ex-nihilo.

- Fonctionnement du plugin :

1. Un bouton apparait dans la zone de contrôle de l'article affiché avec la mention « Nouvelle Version »

2. Un message d'alerte demande de confirmer la duplication de cet article. L'opération est irreversible car c'est un insert en base.

3. Une fois l'alerte approuvée, un message s'inscrit après la création de la nouvelle version de l'article, et propose de se rendre sur la nouvelle version.

4. La nouvelle version est maintenant accessible et 'en cours de rédaction'. On note qu'il s'agit d'un article avec un nouvel ID mais avec le contenu de l'article publié. On peut modifier tranquillement cet article sans toucher à l'article en ligne. Une fois les modifications apportées et si on est administrateur avec le droit de publier sur le site, on peut choisir de « Publier cette version » comme le montre le nouveau bouton dans la zone de modification de statut de l'article.

5. Une fois le bouton « Publier cette version » cliqué, on est prié d'en confirmer la publication :

6. La version en cours de rédaction est publiée dans l'article en ligne.

7. En cliquant le lien vers l'article publié, on notera que l'id du message n'a pas changé, mais que les textes eux, sont à jour. La version antérieure est mise à la poubelle.

Le plugin est sous SVN spip-zone : http://zone.spip.org/trac/spip-zone/browser/_plugins_/nouvelle_version

À faire :

- Afficher la possibilité d'une nouvelle version uniquement si l'article en cours est « publié » ce qui n'est pas le cas aujourd'hui
- Faire un cfg pour ce plugin permettant de choisir le statut appliqué à la version antérieure.

Suite à une migration depuis SPIP-Agora, j'ai développé ce plugin permettant de reprendre la fonctionnalité "Nouvelle version" non reprise sur SPIP~2.

Cette fonctionnalité permet de : - Modérer a priori les modifications d'un article publié en ligne - Archiver la version antérieure complète de l'article une fois la modification validée par un administrateur. Des rédacteurs peuvent donc modifier un article en ligne (tout le monde peut créer une nouvelle version d'article), mais seuls des administrateurs peuvent publier la version modifiée. Ce plugin s'appuie sur le plugin [duplicator->art3354] pour la partie duplication d'article. La partie "remplacement et publication" est écrite ex-nihilo. - Fonctionnement du plugin: 1. Un bouton apparait dans la zone de contrôle de l'article affiché avec la mention "Nouvelle Version" 2. Un message d'alerte demande de confirmer la duplication de cet article. L'opération est irreversible car c'est un insert en base. 3. Une fois l'alerte approuvée, un message s'inscrit après la création de la nouvelle version de l'article, et propose de se rendre sur la nouvelle version. 4. La nouvelle version est maintenant accessible et 'en cours de rédaction'. On note qu'il s'agit d'un article avec un nouvel ID mais avec le contenu de l'article publié. On peut modifier tranquillement cet article sans toucher à l'article en ligne. Une fois les modifications apportées et si on est administrateur avec le droit de publier sur le site, on peut choisir de "Publier cette version" comme le montre le nouveau bouton dans la zone de modification de statut de l'article. 5. Une fois le bouton "Publier cette version" cliqué, on est prié d'en confirmer la publication: 6. La version en cours de rédaction est publiée dans l'article en ligne. 7. En cliquant le lien vers l'article publié, on notera que l'id du message n'a pas changé, mais que les textes eux, sont à jour. La version antérieure est mise à la poubelle.

Le plugin est sous SVN spip-zone: http://zone.spip.org/trac/spip-zone/browser/_plugins_/nouvelle_version À faire: - Afficher la possibilité d'une nouvelle version uniquement si l'article en cours est "publié" ce qui n'est pas le cas aujourd'hui - Faire un cfg pour ce plugin permettant de choisir le statut appliqué à la version antérieure.

Mon premier formulaire pas à pas : c'est Formidable !

RastaPopoulos — 2012-01-23T21:36:28Z

http://spip.arscenic.tv/sites/spip.arscenic.tv/IMG/mp4/formidable-encoded.mp4

Version originale sur : http://spip.arscenic.tv/medias/video-tutorials/article/formidable-mon-premier-formulaire

http://spip.arscenic.tv/sites/spip.arscenic.tv/IMG/mp4/formidable-encoded.mp4

Version originale sur : [http://spip.arscenic.tv/medias/video-tutorials/article/formidable-mon-premier-formulaire->http://spip.arscenic.tv/medias/video-tutorials/article/formidable-mon-premier-formulaire]

Formidable, le générateur de formulaires

RastaPopoulos — 2012-01-23T21:00:00Z

Un générateur de formulaires facilement configurable pour les non-informaticiens et facilement extensible pour les développeurs.

Introduction

L'objectif était de créer un plugin permettant de générer des formulaires. Historiquement, 2 plugins avaient déjà été développés précédemment pour remplir cette fonction :

Forms &Tables, qui n'a pas été complètement porté pour SPIP 2.
et spip-formulaire créé par artego mais qui n'est plus maintenu.

La question s'est donc posée : construire sur la base d'un des deux plugins ou repartir de zéro ?
Form &Table, très complet pour les utilisateurs, présentait l'inconvénient d'avoir un côté « fourre-tout » qui le rendait difficilement modifiable et difficile à personnaliser par les développeurs.

Il a finalement été décidé de repartir de zéro pour proposer quelque chose :

de plus facile à utiliser pour les utilisateurs d'une part,
mais aussi de plus facile à personnaliser pour les développeurs. Avec le parti pris de se baser de préférence sur plusieurs petits plugins spécialisés et de tirer parti de la nouvelle norme CVT.

Installation

Le plugin nécessite les plugins suivants :

Il faut installer le plugin jQuery UI pour pouvoir déplacer les champs à la souris pendant la création d'un formulaire.

Interface utilisateur

L'utilisation basique de l'interface est abordée dans ce screencast : Mon premier formulaire pas à pas : c'est Formidable !

Appeler mon formulaire

Vous devez appeler le formulaire ayant le nom « formidable », en lui passant en paramètre l'identifiant de votre formulaire.

Dans un contenu

Utilisez le modèle classique : ou bien

Dans un squelette
#FORMULAIRE_FORMIDABLE{34} ou bien #FORMULAIRE_FORMIDABLE{contact}

Pré-remplir dynamiquement les champs d'un formulaire depuis un squelette

À noter que dans un squelette, vous avez la possibilité de surcharger dans l'appel, les valeurs par défaut des champs de votre formulaire. Pour cela, vous devez passer un tableau de nom=>valeur en deuxième paramètre. Vous pourrez trouver les noms de vos champs dans l'aide-mémoire situé sur la page de configuration des traitements.

Le tableau en deuxième paramètre :

#FORMULAIRE_FORMIDABLE{contact, #ARRAY{nom_du_champ, Ma valeur}}

C'est particulièrement utile pour remplir un champ caché avec une valeur dynamique venant du squelette :

#FORMULAIRE_FORMIDABLE{contact, #ARRAY{hidden_1, #ID_DOCUMENT}}

Champs oui-non et case unique

Pour rendre obligatoire la réponse « oui » à un champ de type oui-non ou case unique (pour la validation de conditions d'utilisation par exemple), il faut simplement rendre le champ obligatoire.

Courriels de notification

Une option des traitements proposés permet d'envoyer un mail de notification automatiquement, à chaque saisie d'un formulaire.

Le squelette par défaut employé pour la mise en forme de ces mails est plugins/formidable/notifications/formulaire_email.html. Vous pouvez le copier dans le répertoire 'notifications' de votre squelette et l'y modifier à votre guise. Cette modification vaudra pour tous les formulaires.

Pour utiliser un squelette spécifique pour les mails de notification de l'un seulement des formulaires définis avec Formidable, il suffit d'ajouter son squelette dans le répertoire 'notifications' de votre dossier squelettes, mais en ajoutant l'identifiant.

IDENTIFIANT étant l'identifiant du formulaire défini dans Formidable, les squelettes doivent se nommer :
formulaire_IDENTIFIANT_email.html pour le mail aux destinataires
formulaire_IDENTIFIANT_accuse.html pour l'accusé de réception du visiteur

Voir aussi sur le wiki

todoFormidable | Formidable, présentation aux Grottes (2010)

Un générateur de formulaires {{facilement configurable}} pour les non-informaticiens et {{facilement extensible}} pour les développeurs.

{{{Introduction}}} L'objectif était de créer un plugin permettant de générer des formulaires. Historiquement, 2 plugins avaient déjà été développés précédemment pour remplir cette fonction: -* Forms &Tables, qui n'a pas été complètement porté pour SPIP 2. -* et spip-formulaire créé par artego mais qui n'est plus maintenu. La question s'est donc posée : construire sur la base d'un des deux plugins ou repartir de zéro ? _ Form &Table, très complet pour les utilisateurs, présentait l'inconvénient d'avoir un côté "fourre-tout" qui le rendait difficilement modifiable et difficile à personnaliser par les développeurs. Il a finalement été décidé de repartir de zéro pour proposer quelque chose: -* de plus facile à utiliser pour les utilisateurs d'une part, -* mais aussi de plus facile à personnaliser pour les développeurs. Avec le parti pris de se baser de préférence sur plusieurs petits plugins spécialisés et de tirer parti de la nouvelle [norme CVT->http://programmer.spip.org/-Les-formulaires-]. {{{Installation}}} Le plugin nécessite les plugins suivants : -* [Bonux->art1146] : [télécharger->http://files.spip.org/spip-zone/spip-bonux.zip] -* [Saisies->art3364] : [télécharger->http://files.spip.org/spip-zone/saisies.zip] -* [Vérifier->3852] : [télécharger->http://files.spip.org/spip-zone/verifier.zip] -* [YAML->3666] : [télécharger->http://files.spip.org/spip-zone/yaml.zip] -* [Facteur->art3371] : [télécharger->http://files.spip.org/spip-zone/facteur.zip] Il faut installer [le plugin jQuery UI->3612] pour pouvoir déplacer les champs à la souris pendant la création d'un formulaire. {{{Interface utilisateur}}} L'utilisation basique de l'interface est abordée dans ce screencast : [->3854] {{{Appeler mon formulaire}}} Vous devez appeler le formulaire ayant le nom "formidable", en lui passant en paramètre l'identifiant de votre formulaire. {{Dans un contenu}} _ Utilisez le modèle classique : ou bien {{Dans un squelette}} _ #FORMULAIRE_FORMIDABLE{34} ou bien #FORMULAIRE_FORMIDABLE{contact} {{{ Pré-remplir dynamiquement les champs d'un formulaire depuis un squelette }}} À noter que dans un squelette, vous avez la possibilité de surcharger dans l'appel, les valeurs par défaut des champs de votre formulaire. Pour cela, vous devez passer un tableau de nom=>valeur en deuxième paramètre. Vous pourrez trouver les noms de vos champs dans l'aide-mémoire situé sur la page de configuration des traitements. _ Le tableau en deuxième paramètre :

#FORMULAIRE_FORMIDABLE{contact, #ARRAY{nom_du_champ, Ma valeur}}

C'est particulièrement utile pour remplir un champ caché avec une valeur {dynamique} venant du squelette :

#FORMULAIRE_FORMIDABLE{contact, #ARRAY{hidden_1, #ID_DOCUMENT}}

{{{ Champs oui-non et case unique }}} Pour rendre obligatoire la réponse "oui" à un champ de type oui-non ou case unique (pour la validation de conditions d'utilisation par exemple), il faut simplement rendre le champ obligatoire. {{{Courriels de notification }}} Une option des traitements proposés permet d'envoyer un mail de notification automatiquement, à chaque saisie d'un formulaire. Le squelette par défaut employé pour la mise en forme de ces mails est plugins/formidable/notifications/formulaire_email.html. Vous pouvez le copier dans le répertoire 'notifications' de votre squelette et l'y modifier à votre guise. Cette modification vaudra pour {{tous}} les formulaires. Pour utiliser un squelette spécifique pour les mails de notification de l'un seulement des formulaires définis avec Formidable, il suffit d'ajouter son squelette dans le répertoire 'notifications' de votre dossier squelettes, mais en ajoutant l'identifiant. IDENTIFIANT étant l'identifiant du formulaire défini dans Formidable, les squelettes doivent se nommer : _ formulaire_IDENTIFIANT_email.html pour le mail aux destinataires _ formulaire_IDENTIFIANT_accuse.html pour l'accusé de réception du visiteur {{{Voir aussi sur le wiki }}} [todoFormidable->3754] | [Formidable, présentation aux Grottes (2010) ->3755]

Référence de ZipTeX

Maïeul — 2012-01-22T14:44:36Z

Cet articles est la documentation technique du plugin ZipTeX, qui permet de mettre dans un même zip plusieurs fichiers .tex. Il sert dans les projets de fabrication d'un livre à partir d'une base de donnée SPIP.

On se reportera au tutoriel pour une première approche.

On consultera aussi la documentation sur la balise #ARRAY, qui est beaucoup utilisée dans ziptex.

À chaque fois que nous parlerons de chemin, sauf si nous précisons « à l'intérieur de ziptex, la notion de chemin s'entend au sens SPIP.

Rappelons aussi que ce plugin nécessite le plugin zippeur

Le filtre `|ziptex_zipper`

C'est le filtre de base. Il zippe le dossier local/ziptex et retourne l'url du Zip.

Mais avant de zipper, le filtre peut ajouter du contenu dans le dossier local/ziptex.

Pour ce faire, il reçoit un tableau, généré via #ARRAY, dont la structure est la suivante :

0. Un tableau contenant les .tex direct, c'est à dire sans code SPIP dedans, avec à chaque fois :
- 0. Chemin du fichier .tex dans l'arborescence SPIP
- 1. Chemin du fichier .tex dans le future ZIP
1. Un tableau contenant les squelettes qui généreront du latex avec à chaque fois :
- 0. Chemin du squelette, sans le .html
- 1. Chemin du .tex correspondant, avec le .tex
- 2. Option du squelette

Il retourne le chemin du zip. Exemple : générer un zip contenant :

Un fichier de configuration pour latexmk.
Un fichier principal.tex généré à partir du squelette principal.tex.html, recevant l'id_rubrique courant.

#SET{tableau,
#ARRAY{
0,#ARRAY{
0,#ARRAY{0,latexmk,1,latexmk}
},
1,#ARRAY{
0,#ARRAY{
0,principal.tex,
1,principal.tex,
2,#ARRAY{id_rubrique,#ID_RUBRIQUE}
}
}
}
}
[(#GET{tableau}|ziptex_zipper)]

Télécharger

Le filtre `|ziptex_creer_tex`

Produit à partir du squelette un fichier .tex dans le dossier ziptex.

S'applique sur le nom du squelette (sans le .html), le premier argurment est le chemin du fichier à produire dans ziptex, le second est un tableau des arguments à passer au squelette.

Exemple :

[(#REM)Créer un fichier articlexxx.tex depuis le squelette article.tex, en fournissant l'id_article]
(ARTICLES)
[(#VAL{article.tex}|ziptex_creer_tex{inclure/article#ID_ARTICLE.tex,#ARRAY{id_article,#ID_ARTICLE}})]
>

Télécharger

Le filtre `|ziptex_dir`

Il s'applique sur un tableau généré via #ARRAY. Il crée dans le dossier ziptex des sous répertoires.

Exemple :

[(#REM) Créer des dossiers inclure et img]
[(#SET{rep,#ARRAY{0,inclure,1,img}})]
[(#GET{rep}|ziptex_dir)]

Télécharger

Le filtre `|ziptex_copier_tex`

Copie un fichier .tex dans le dossier ziptex.

Exemple :

[(#REM)Copier le fichier principal.tex dans ziptex]
[(#VAL{principal.tex}|ziptex_copier_tex{principal.tex})]

Télécharger

Le filtre `ziptex_copier_img`

Il est à utiliser dans les modèles d'insertion des images.

Ce filtre reçoit le chemin d'une image, mais le chemin absolue, pas au sens SPIP.

Si l'image est un .gif, il le convertit en .png.

Il copie ensuite l'image dans le dossier ziptex/IMG et retourne ensuite le nom du fichier dans le dossier IMG, précédé de #IMG.

Exemple : dans un modeles d'insertion d'image, on réduit d'abord l'image à 200 px de large, puis on copie dans ziptex/img.

(DOCUMENTS){id_document=#ENV{id}}>
\includegraphics{[(#URL_DOCUMENT|image_reduire{200}|extraire_attribut{src}|ziptex_copier_img)]}
>

Télécharger

Le filtre `ziptex_polyglossia`

Il permet de convertir un code de langue fournit par SPIP via la balise #LANG en code de langue du package XeLaTeX polyglossia.

[(#LANG|ziptex_polyglossia)]

Pour le moment, sont intégrés :
- l'espagnol
- l'anglais
- le français

Pour ajouter une nouvelle langue :
- soit faire la modification directement sur la zone
- soit me demander de le faire

Cet articles est la documentation technique du plugin ZipTeX, qui permet de mettre dans un même zip plusieurs fichiers .tex. Il sert dans les projets de [fabrication d'un livre à partir d'une base de donnée SPIP->rub1568]. On se reportera [au tutoriel->4045] pour une première approche. On consultera aussi [la documentation sur la balise #ARRAY->http://www.spip.net/fr_article4009.html], qui est beaucoup utilisée dans ziptex. À chaque fois que nous parlerons de chemin, sauf si nous précisons « à l'intérieur de ziptex, [la notion de chemin s'entend au sens SPIP->http://programmer.spip.org/La-notion-de-chemin]. Rappelons aussi que ce plugin nécessite le [plugin zippeur->3576]

{{{Le filtre |ziptex_zipper}}} C'est le filtre de base. Il zippe le dossier local/ziptex et retourne l'url du Zip. Mais avant de zipper, le filtre peut ajouter du contenu dans le dossier local/ziptex. Pour ce faire, il reçoit un tableau, généré via #ARRAY, dont la structure est la suivante : -* 0. Un tableau contenant les .tex direct, c'est à dire sans code SPIP dedans, avec à chaque fois : -** 0. Chemin du fichier .tex dans l'arborescence SPIP -** 1. Chemin du fichier .tex dans le future ZIP -* 1. Un tableau contenant les squelettes qui généreront du latex avec à chaque fois : -** 0. Chemin du squelette, sans le .html -** 1. Chemin du .tex correspondant, avec le .tex -** 2. Option du squelette Il retourne le chemin du zip. Exemple : générer un zip contenant : -* Un [fichier de configuration pour latexmk->http://geekographie.maieul.net/Introduction-a-Latexmk-pour]. -* Un fichier principal.tex généré à partir du squelette principal.tex.html, recevant l'id_rubrique courant.

 #SET{tableau, #ARRAY{ 0,#ARRAY{ 0,#ARRAY{0,latexmk,1,latexmk} }, 1,#ARRAY{ 0,#ARRAY{ 0,principal.tex, 1,principal.tex, 2,#ARRAY{id_rubrique,#ID_RUBRIQUE} } } } } [(#GET{tableau}|ziptex_zipper)]

{{{Le filtre |ziptex_creer_tex}}} Produit à partir du squelette un fichier .tex dans le dossier ziptex. S'applique sur le nom du squelette (sans le .html), le premier argurment est le chemin du fichier à produire dans ziptex, le second est un tableau des arguments à passer au squelette. Exemple : [(#REM)Créer un fichier articlexxx.tex depuis le squelette article.tex, en fournissant l'id_article] {{{Le filtre |ziptex_dir}}} Il s'applique sur un tableau généré via #ARRAY. Il crée dans le dossier ziptex des sous répertoires. Exemple : [(#REM) Créer des dossiers inclure et img] [(#SET{rep,#ARRAY{0,inclure,1,img}})] [(#GET{rep}|ziptex_dir)] {{{Le filtre |ziptex_copier_tex}}} Copie un fichier .tex dans le dossier ziptex. Exemple : [(#REM)Copier le fichier principal.tex dans ziptex] [(#VAL{principal.tex}|ziptex_copier_tex{principal.tex})] {{{Le filtre ziptex_copier_img}}} Il est à utiliser dans les modèles d'insertion des images. Ce filtre reçoit le chemin d'une image, mais le chemin absolue, pas au sens SPIP. Si l'image est un .gif, il le convertit en .png. Il copie ensuite l'image dans le dossier ziptex/IMG et retourne ensuite le nom du fichier dans le dossier IMG, précédé de #IMG. Exemple : dans un modeles d'insertion d'image, on réduit d'abord l'image à 200 px de large, puis on copie dans ziptex/img. \includegraphics{[(#URL_DOCUMENT|image_reduire{200}|extraire_attribut{src}|ziptex_copier_img)]} {{{Le filtre ziptex_polyglossia}}} Il permet de convertir un code de langue fournit par SPIP via la balise #LANG en code de langue du package XeLaTeX polyglossia. [(#LANG|ziptex_polyglossia)] Pour le moment, sont intégrés : - l'espagnol - l'anglais - le français Pour ajouter une nouvelle langue : - soit faire la modification directement sur la zone - soit me demander de le faire

Référence de LaTeXWheel

Maïeul — 2012-01-21T20:46:19Z

LaTeXWheel est le plugin qui permet de convertir des raccourcis SPIP en code LaTeX.

Il fonctionne grâce à textwheel, généralement en conjonction avec ZipTeX.

Cet article liste :

les transformations de LaTeXWheel
les packages LaTeX nécéssaire pour chaque outils.

On consultera le tutoriel pour une première approche.

Les fonctions de base

La fonction de base est la fonction |propre_latex. Elle s'applique sur un champ brut, c'est à dire suivi d'une * [1].

[(#CHAMP*|propre_latex)]

Si on utilise le système de langue avec , il faut appliquer au préalable le filtre extraire_multi.

[(#CHAMP*|extraire_multi{#LANG}|propre_latex)]

Les raccourcis qui ne demandent pas de package supplémentaire

Les caractères suivants : \$%&_# qui ont une signification particulière en LaTeX sont automatiquement protégés en étant précédés de \.

{texte en emphase} donne \emph{texte en emphase}

{{texte en gras}} donne \textbf{texte en gras}

{{{intertitre}}} donne \subsection{intertitre}

[[Note de bas page]] donne \footnote{Note de bas de page}

texte cité produit \begin{quotation}texte cité\end{quotation}

Les raccourcis du type :

- x

- x

- x

ne sont pas encore traités.

En revanche :

-* élément non numéroté

-* élément non numéroté

produit

\begin{itemize}

\item élément numéroté

\item élément numéroté

\end{itemize}

On consultera aussi un article de Bébert pour faire des styles persos de listes à puce en LaTeX.

De même :

-# élément numéroté

-# élément numéroté

produit

\begin{enumerate}
\item élément numéroté
\item élément numéroté
\end{enumerate}

Télécharger

Pour rappel en LaTeX, en standard, on ne peut pas imbriquer plus de quatre niveaux de listes [2].

Les liens externes

Il est nécessaire d'utiliser le package hyperref.

[->http://url.com] produit \url{http://url.com}

[lien externe->http://url.com] produit \href{http://url.com}{lien externe}

Les liens internes

Pour mettre des liens internes, il est nécessaire d'insérer des \label correspondant à l'endroit vers lequel un liens veut pointer.

On relira d'abord une introduction aux références croisées en LaTeX.

Par exemple :

(ARTICLES)>
\chapter{[(#TITRE*|propre_latex)]}\label{art#ID_ARTICLE}
>

Télécharger

Pour rappel, il existe trois commandes qui permettent de se servir d'une référence croisée :

\ref renvoie au numéro de la référence.
\pageref renvoie à la page de la référence.
\nameref, du package hyperref, donne le titre de l'élément sur lequel on renvoie.

Voici comment LaTeXwheel transforme les raccourcis :

[texte->xxx] donne texte (p.~\pageref{artxxx})

[texte->artxxx] donne texte (p.~\pageref{artxxx})

[->artxxx] donne \nameref{artxxx} (p.~\pageref{artxxx})

Par défaut, les abréviations de type art,rub,sont conservés.

En revanche articlexxx donne artxxx et rubriquexxx donne rubxxx.

En revanche motxxx ou autxxx reste tel que, simplement mis dans la commande LaTeX.

Les tableaux

Gros morceaux. Je ne rentrerais pas dans les détails, car pour avoir des tableaux correspondant aux styles voulus, il faut mettre la main « dans le camboui » une fois le fichier .tex produit.

Je renvoie aux fiches de Bébert sur les tableaux.

Sachons juste les réglages par défaut :

les tableaux sont de type longtable, donc nécéssitent le package du même nom.
la largeur des colonnes correspond à la largeur \textwidth, c'est à dire la largeur du texte, divisé par le nombre de colonnes. Les colonnes sont de type p
il n'y a pas de traits.
le \endhead est géré pour les entêtes.
les colonnes et les lignes peuvent être fusionnés. Le cas échéant, il faut utiliser le package \multirow.

Le modèles

Il faut se rappeler ce qu'est un modèle : http://www.spip.net/fr_article3454.html. Les modèles sont utilisés par SPIP, par exemple pour insérer des images. Le principe adopté pour la conversion vers LaTeX est de laisser de la souplesse.

Tout modèle xxx.html qui produit du html devrait avoir un équivalent latex_xxx.html.

À l'intérieur, on utilisera les commandes LaTeX adaptées. Voir par exemple :

Il faut faire particulièrement attention.

En effet, soit un modèle document.html. Si je l'appelle de la manière suivante : , je possède alors une variable d'environnement #ENV{id_document} égale à 1.

Je peux donc faire

(DOCUMENTS){id_document}>
…
>

Télécharger

En revanche, je ne peux pas dans le modèle correspondant latex_document.html faire cela. Il faut que je fasse :

(DOCUMENTS){id_document=#ENV{id}}>
…
>

Télécharger

Par ailleurs, si on utilise une image, il faudra se servir du filtre |ziptex_copier_img du plugin ziptex, pour s'assurer que l'image sera bien présente dans le zip.

On pourra s'inspirer des modèles présents dans le squelette Documentation2LaTeX.

Le code

Un code entre deux balises code produit \verb¡lecode¡.

Si on utilise le plugin coloration code, alors il faudra utiliser le package minted dans le fichier LaTeX final.

Ce package nécéssite :

d'avoir pygments installé.
de compiler en ligne de commande, avec xelatex -shell-escape xxx.

En outre, il faudra avoir l'anglais déclaré comme langue, dans le préambule :

\setotherlanguage{english}

On obtiendra les résultats suivants :

Pour un code présent présent :
\begin{english}
\begin{minted}[linenos]{langage}
Code numéroté
\end{minted}
\end{english}
Télécharger

Pour un code présent entre : \begin{english} \begin{minted}{langage} Code non numéroté \end{minted} \end{english} Télécharger


En outre, deux cas particulier :

- Si on cite du code PHP, il faut ajouter : #FILTRE{latex_recuperer_php} dans le squelette.

- Si on cite du code SPIP, il faut installer le module de coloration syntaxique de SPIP pour pygments.


		
		
[1] On relira la documentation sur les balise étoilées.

[2] Je cherche encore un package permettant de le faire.

		
LaTeXWheel est le plugin qui permet de convertir des raccourcis SPIP en code LaTeX. Il fonctionne grâce à [textwheel->http://zzz.rezo.net/Presentation-de-Textwheel.html], généralement en conjonction avec ZipTeX. Cet article liste : -* les transformations de LaTeXWheel -* les packages LaTeX nécéssaire pour chaque outils. [On consultera le tutoriel pour une première approche->4045]. 

		{{{Les fonctions de base}}} La fonction de base est la fonction |propre_latex. Elle s'applique sur un champ brut, c'est à dire suivi d'une *[[On relira [la documentation sur les balise étoilées->http://programmer.spip.org/Empecher-les-traitements].]]. [(#CHAMP*|propre_latex)] Si on utilise le système de langue avec , il faut appliquer au préalable le filtre extraire_multi. [(#CHAMP*|extraire_multi{#LANG}|propre_latex)] {{{Les raccourcis qui ne demandent pas de package supplémentaire}}} Les caractères suivants : \$%&_# qui ont une signification particulière en LaTeX sont automatiquement protégés en étant précédés de \. {texte en emphase} donne \emph{texte en emphase} {{texte en gras}} donne \textbf{texte en gras} {{{intertitre}}} donne \subsection{intertitre} [[Note de bas page]] donne \footnote{Note de bas de page} texte cité produit \begin{quotation}texte cité\end{quotation} Les raccourcis du type : 
- x
- x
- x
 ne sont pas encore traités. En revanche : 
-* élément non numéroté
-* élément non numéroté
 produit 
\begin{itemize}
\item élément numéroté
\item élément numéroté
\end{itemize}
 On consultera aussi un article de Bébert pour [faire des styles persos de listes à puce en LaTeX->http://bertrandmasson.free.fr/index.php?article5/dompter-ses-puces]. De même : 
-# élément numéroté
-# élément numéroté
 produit 
\begin{enumerate}
\item élément numéroté
\item élément numéroté
\end{enumerate}
 Pour rappel en LaTeX, en standard, on ne peut pas imbriquer plus de quatre niveaux de listes[[Je cherche encore un package permettant de le faire.]]. {{{Les liens externes}}} Il est nécessaire d'utiliser le package hyperref. [->http://url.com] produit \url{http://url.com} [lien externe->http://url.com] produit \href{http://url.com}{lien externe} {{{Les liens internes}}} Pour mettre des liens internes, il est nécessaire d'insérer des \label correspondant à l'endroit vers lequel un liens veut pointer. On relira d'abord une introduction [aux références croisées en LaTeX->http://www.tuteurs.ens.fr/logiciels/latex/references.html]. Par exemple :


\chapter{[(#TITRE*|propre_latex)]}\label{art#ID_ARTICLE}

 Pour rappel, il existe trois commandes qui permettent de se servir d'une référence croisée :
-* \ref renvoie au numéro de la référence.
-* \pageref renvoie à la page de la référence.
-* \nameref, du package hyperref, donne le titre de l'élément sur lequel on renvoie. Voici comment LaTeXwheel transforme les raccourcis : [texte->xxx] donne texte (p.~\pageref{artxxx}) [texte->artxxx] donne texte (p.~\pageref{artxxx}) [->artxxx] donne \nameref{artxxx} (p.~\pageref{artxxx}) Par défaut, les abréviations de type art,rub,sont conservés. En revanche articlexxx donne artxxx et rubriquexxx donne rubxxx. En revanche motxxx ou autxxx reste tel que, simplement mis dans la commande LaTeX. {{{Les tableaux}}} Gros morceaux. Je ne rentrerais pas dans les détails, car pour avoir des tableaux correspondant aux styles voulus, il faut mettre la main « dans le camboui » une fois le fichier .tex produit. Je renvoie aux [fiches de Bébert sur les tableaux->http://bertrandmasson.free.fr/index.php?categorie4/latex-tableau]. Sachons juste les réglages par défaut :
-* les tableaux sont de type longtable, donc nécéssitent le package du même nom.
-* la largeur des colonnes correspond à la largeur \textwidth, c'est à dire la largeur du texte, divisé par le nombre de colonnes. Les colonnes sont de type p
-* il n'y a pas de traits.
-* le \endhead est géré pour les entêtes.
-* les colonnes et les lignes peuvent être fusionnés. Le cas échéant, il faut utiliser le package \multirow. {{{Le modèles}}} Il faut se rappeler ce qu'est un modèle : http://www.spip.net/fr_article3454.html.
Les modèles sont utilisés par SPIP, par exemple pour insérer des images.
Le principe adopté pour la conversion vers LaTeX est de laisser de la souplesse. Tout modèle xxx.html qui produit du html devrait avoir un équivalent latex_xxx.html. À l'intérieur, on utilisera les commandes LaTeX adaptées. Voir par exemple : -* https://fr.wikibooks.org/wiki/LaTeX/%C3%89l%C3%A9ments_flottants_et_figures
-* https://fr.wikibooks.org/wiki/LaTeX/Images#Extension_graphicx Il faut faire particulièrement attention. En effet, soit un modèle document.html. Si je l'appelle de la manière suivante : , je possède alors une [variable d'environnement->2298] #ENV{id_document} égale à 1. Je peux donc faire 

…
  En revanche, je ne peux pas dans le modèle correspondant latex_document.html faire cela. Il faut que je fasse : 

…
  Par ailleurs, si on utilise une image, il faudra se servir du filtre |ziptex_copier_img du [plugin ziptex->4052], pour s'assurer que l'image sera bien présente dans le zip. On pourra s'inspirer des modèles présents dans [le squelette Documentation2LaTeX->http://www.spip-contrib.net/Fabriquer-les-tex-puis-le-PDF]. {{{Le code}}} Un code entre deux balises code produit \verb¡lecode¡. Si on utilise le [plugin coloration code->rub577], alors il faudra utiliser le package minted dans le fichier LaTeX final. Ce package nécéssite :
-* d'avoir [pygments installé->http://pygments.org/docs/installation/].
-* de compiler en ligne de commande, avec xelatex -shell-escape xxx. En outre, il faudra avoir l'anglais déclaré comme langue, dans le préambule : 
\setotherlanguage{english}
 On obtiendra les résultats suivants : -* Pour un code présent présent  :

\begin{english}
\begin{minted}[linenos]{langage}
Code numéroté
\end{minted}
\end{english}

-* Pour un code présent entre  :

\begin{english}
\begin{minted}{langage}
Code non numéroté
\end{minted}
\end{english}
 En outre, deux cas particulier :
- Si on cite du code PHP, il faut ajouter : #FILTRE{latex_recuperer_php} dans le squelette.
- Si on cite du code SPIP, il faut [installer le module de coloration syntaxique de SPIP pour pygments->4053].



Installer la coloration syntaxique pour SPIP dans Pygments
Maïeul — 2012-01-21T20:33:20Z

		Pygments est un logiciel écrit en Python, qui permet d'intégrer de la coloration syntaxique dans un certain nombre de logiciels.
 Un module pour la syntaxe des squelettes SPIP a été écrit. Cet article vient expliquer comment l'installer.
 Il ne vient pas expliquer comment installer pygments, ni comment s'en servir.
		Pour pouvoir faire l'installation, il faut se rendre sur la page Github du projet.
 Cliquez ensuite sur le bouton « ZIP ».
 
 Dézipper le fichier téléchargé, puis avec le Terminal, se rendre dans le dossier ainsi dézippé, et saisir les ligne suivantes :
python setup.py build

python setup.py bdist_egg

cd dist

easy_install *egg
 Télécharger
		
[Pygments->http://pygments.org/] est un logiciel écrit en Python, qui permet d'intégrer de la coloration syntaxique dans un certain nombre de logiciels. Un module pour la syntaxe des squelettes SPIP a été écrit. Cet article vient expliquer comment l'installer. {Il ne vient pas expliquer comment installer pygments, ni comment s'en servir.}

		Pour pouvoir faire l'installation, il faut [se rendre sur la page Github du projet->https://github.com/maieul/spip-pygments]. Cliquez ensuite sur le bouton « ZIP ».  Dézipper le fichier téléchargé, puis avec le Terminal, se rendre dans le dossier ainsi dézippé, et saisir les ligne suivantes : 
python setup.py build
python setup.py bdist_egg
cd dist
easy_install *egg




Comment créer un environnement de travail pour développer du SPIP sur un MAC avec MAMP
Alexandra — 2012-01-21T13:12:04Z

		Cet article est le premier de la série :

- Comment créer un environnement de travail pour développer du SPIP sur un MAC avec MAMP

- Ouvrir MAMP sur l'extérieur : Vhost, routeur, Domaine et DNS

- Quelques outils pour développer du SPIP sous Mac
 Nous allons utiliser MAMP 2 en version gratuite et licence GPL comme serveur web local (différent de MAMP Pro version payante). MAMP est l'acronyme de Macintosh Apache MySQL PHP et permet de lancer un serveur web local sous mac os X.
 C'est donc une solution toute clé en main et tout-en-un, qui comprend Apache, PHP5 et PHP4, MySQL, PHPMyAdmin et SQLiteManage ...
 Avantage par rapport à d'autres solutions :

- MAMP ne compromettra pas une autre installation d'Apache.

- MAMP peut se copier sur un autre mac pour être tout de suite opérationnel quand on change d'environnement.

- MAMP permet de switcher de version php.

- MAMP ne modifie aucun fichier du système.
 Cet article se veut un complément à l'excellent article de Fil qui reste toujours d'actualité, pour configurer au mieux votre environnement sous Mac OS X. Il est valable pour du Léopard, Snow Léopard et Lion. Un petit clin d'œil à Xdjuj que je remercie :-)
		Plan de la première partie : MAMP 
 - I/ Installation et lancement de MAMP

- II/ Structure du MAMP

- III/ Réglages de l'interface

- IV/ Les réglages avancés et personnalisés

- V/ Mettre à jour sa version de MAMP en toute tranquillité, sans rien perdre de ses sites et de ses bases de données SQL

- VI/ En cas de problèmes
 
I/ Installation et lancement de MAMP
1. On télécharge MAMP sur le site officiel 
 http://www.mamp.info/en/index.html
 On récupère donc le pacquage zippé nommé MAMP_MAMP_PRO_2.0.x.zip, on le dé-zippe puis on lance l'installation. Suivre les différentes étapes de l'installeur. MAMP s'installe à la racine du dossier Applications. On doit avoir un compte administrateur sur le mac et connaitre son mot de passe d'admin.
 
 2. On lance le logiciel en cliquant sur l'icône de l'application MAMP
 Une fenêtre s'ouvre nous permettant de contrôler le bon lancement du serveur apache et du serveur de données MySQL.
 
 Les voyants sont verts en cas de réussite, et rouges en cas d'échec. Il y a deux diodes correspondant l'une au serveur Apache, l'autre au serveur MySQL.
 Une deuxième fenêtre, celle de la page d'accueil s'ouvre aussi. Cette page prouve également que tout fonctionne et que l'installation de MAMP a réussi.
 
 L'URL par défaut du serveur web local sous MAMP est :
 http://localhost:8888/MAMP
 Mais on peut également y accéder en tapant l'adresse ip de localhost :
 http://127.0.0.1:8888/MAMP
 On peut utiliser l'adresse Rendez-Vous du partage web, Préférence système/partage/
avec l'option partage web de cochée. Les ordinateurs de votre réseau local peuvent accéder à votre ordinateur par le biais de l'adresse : imacalex.local
 http://imacalex.local:8888/MAMP
 On peut aussi ouvrir son serveur local vers l'extérieur, au prix de quelques opérations que l'on détaillera par la suite sur son modem (mappage de port, DMZ …), sur son fichier hosts et ses zones DNS, et utiliser l'adresse ip sortante fourni par son FAI, un domaine ou un dyndns.org :

- http://mondomaine.info:8888/MAMP/

- http://monipfixe:8888/MAMP/

- http://mondyndns.org:8888/MAMP/
 3. Configurer les préférences de MAMP selon ses besoins.
 Si vous débutez, laissez les options cochées par défaut.
 - L'onglet Démarrer / Arrêter :
 
 - Cocher lancer les serveur au démarrage de MAMP

- Cocher Arrêter les serveurs en quittant MAMP

- Décocher Vérifier MAMP Pro au démarrage de MAMP. On n'utilise pas la version payante

- Cocher la page d'accueil au démarrage, URL de la page d'accueil /MAMP/ qui correspond donc à http://localhost:8888/MAMP ou http://127.0.0.1:8888/MAMP
 - L'onglet Port :
 
 Par défaut ce ne sont pas les ports traditionnels qui sont utilisés par MAMP pour Apache et MySQL, pour ne pas rentrer en conflit avec d'autres serveurs.
MAMP propose en standard le port 8888 pour Apache, le port 80 étant normalement le port utilisé par défaut pour le serveur web. MAMP propose en standard le port 8889 pour MySQL, le port 3306 étant normalement le port utilisé par défaut.
 On peut switcher depuis cet onglet sur les Ports par défaut d'Apache et de MySQL ou revenir aux Ports par défaut de MAMP selon ses besoins.
Mais on peut aussi définir ses propres ports si on le souhaite.
 - L'onglet PHP :
 
 MAMP a l'énorme avantage de proposer deux versions de PHP :

- La version 5.2.17

- et la 5.3.6
 Ceci s'avère très utile pour tester et développer sous différentes versions de PHP. Par défaut on prendra la version proposée qui est à plus récente, à savoir le 5.3.6.
 MAMP nous propose aussi des extensions PHP pour le cache, à savoir XCache eAccelerator et APC. J'avoue ne pas trop savoir à quoi cela correspond. Nous avons laissé le XCache proposé par défaut.
 - L'onglet Apache :
 
 Il faut définir ici le Document Root. Par défaut il s'agit de /Applications/MAMP/htdocs
Mais on peut choisir un répertoire n'appartenant pas à MAMP si on le souhaite, n'importe où dans sa maisonnette d'utilisateur mac.
 Traditionnellement, ceux qui n'utilisent pas /Applications/MAMP/htdocs se servent du répertoire Sites de leur dossier utilisateur /Users/user/Sites. L'avantage de conserver en Document Root le répertoire htdocs est que l'on peut copier l'application MAMP sur un autre mac et être tout de suite opérationnel. On centralise en un même endroit tous les éléments. Mais les autres choix de Document Root peuvent tout aussi bien se justifier et de défendre. Il s'agit donc du choix du document racine du serveur web, et c'est là qu'il conviendra de déposer tous ses répertoires de sites web.
 - Créer une base SQL :
 depuis l'onglet PhpMyadmin, dans la case créer une nouvelle base de données en entrant son nom.
 
 Dans interclassement pour la connexion MySQL cocher utf8_general_ci et cliquer ensuite sur créer. On pourra éventuellement créer un user spécifique pour cette base de donnée avec les privilèges qu'il convient. Pour ce faire, cliquer sur l'onglet Privilèges de PhpMyAdmin, puis cliquer sur ajouter un utilisateur et remplir les cases du formulaire.
 
 
II/ Structure du MAMP


MAMP.app sert à lancer l'application. Elle a été installée dans Applications, et elle devra impérativement y rester. Les répertoires principaux de MAMP sont les suivants :
 - /Applications/MAMP : répertoire racine de l'application MAMP

- /Applications/MAMP/cgi-bin

- /Applications/MAMP/library : on y mettra notamment le my.cnf

- /Applications/MAMP/bin : répertoire contenant les exécutables d'Apache, PHP4, PHP5, MySQL5 et SQLite.

- /Applications/MAMP/conf : répertoire contenant les fichiers de configuration d'Apache (httpd.conf), et SQLiteManager (config.db).

- /Applications/MAMP/tmp : répertoire contenant les fichiers temporaires créés par les exécutables. Le répertoire /tmp/php contient notamment les fichiers temporaires des sessions PHP.

- /Applications/MAMP/db : répertoire contenant les bases de données SQLite et MySQL.

- /Applications/MAMP/logs : répertoire contenant les fichiers de logs d'erreurs de PHP, Apache et MySQL.

- /Applications/MAMP/htdocs : répertoire contenant les différents projets de sites Web si un autre dossier n'a pas été sélectionné.
 
III/ Réglages de l'interface
- Onglet Start
Sur la page d'accueil où dans l'onglet start, se trouvent les informations importantes dont on a besoin pour configurer un CMS, à savoir le hôte : localhost, le port SQL : 8889, l'user : root, le mot de passe : root
 - Onglet Phpinfo
Toutes les informations au niveau de la configuration de PHP.
On y trouve notamment les informations du traditionnel php.info, avec la version de PHP active, ici Version 5.3.6, le chemin du fichier php.ini, il peut changer selon les versions de MAMP, /Applications/MAMP/bin/php/php5.3.6/conf/php.ini. On pourra y lire les valeurs par défaut de max_execution_time à 30 et de memory_limit à 32M du php.ini qu'il conviendra d'augmenter d'office pour une utilisation sereine de MAMP avec un CMS dont SPIP.
 - Onglet : Xcache
On y touche pas. Je sais même pas trop à quoi ça sert.
 - Onglet Phpmyadmin
L'interface de contrôle de MySQL.
 - Onglet SQLiteManager
l'interface de contrôle de SQLite pour ceux qui utilise du SQLlight nativement proposé avec SPIP 3. Même si le manager nous semble beaucoup moins au point que le traditionnel Phpmyadmin. Nous continuons pour notre part à utiliser MySQL avec SPIP 3.
 - Onglet Faq
Foire aux questions en anglais
 - Onglet Try MAMP Pro
On ne l'abordera pas ici, mais nos différents réglages nous permettront d'avoir plus ou moins les mêmes options que la version Pro.
 
IV/ Les réglages avancés et personnalisés
Voici quelques réglages et quelques éléments de personnalisation du MAMP à faire pour travailler sereinement comme sur un vrai serveur dédié mais en local. Toutes ne seront pas obligatoires, à vous de voir selon vos besoins.
 1. Ajuster les valeurs de php.ini
 Il conviendra de modifier le php.ini de chacune des versions php proposées par MAMP. Le chemin vers le php.ini peut changer selon les versions de MAMP. Ne pas hésiter à faire dans le terminal ces lignes :
alexmacapple:~ alex$ cd /Applications/MAMP
 alexmacapple:~ alex$
 alexmacapple:MAMP alex$ find / -name php.ini 2>/dev/null
Qui nous donnera les bons chemins :
 /Applications/MAMP/bin/php/php5.2.17/conf/php.ini
 /Applications/MAMP/bin/php/php5.3.6/conf/php.ini
 memory_limit set est à 8MB par défaut dans MAMP, il conviendra de lui donner une valeur de 32 MB pour être tranquille. Ce réglage là est impératif pour lancer confortablement un SPIP récent sous peine d'obtenir des erreurs de timeout.
 On pourra également vérifier que max_execution_time est à 30 MB
 On peut également rajouté ces lignes pour activer les erreurs php
error_reporting : E_ALL
 display_errors : On
2. Créer dans MAMP le fichier de configuration MySQL (my.cnf)
 Si vous avez besoin d'ajuster vos paramètres SQL, il conviendra de créer un fichier my.cnf dans le répertoire suivant /Applications/MAMP/Library/my.cnf
 Il faut copier et surcharger le fichier qui se trouve dans /Applications/MAMP/Library/support-files/my-medium.cnf et le placer dans le répertoire /Applications/MAMP/Library/ et le renommer en my.cnf
 On peut le faire en ligne de commande à l'aide des lignes suivantes
sudo
 cp
 /Applications/MAMP/Library/support-files/my-medium.cnf
 /Applications/MAMP/Library/my.cnf
Attention l'emplacement peut changer selon les versions de MAMP utilisées. On peut sinon rechercher le fichier par le terminal en tapant les commandes pour voir s'ils existent et où ils se trouvent :
find / -name my.cnf 2>/dev/null
 find / -name my-medium.cnf 2>/dev/null
Éditer le fichier my.cnf et notamment modifiant la valeur de max_allowed_packet :
passer de max_allowed_packet = 1M à max_allowed_packet = 128M pourra nous être d'un grand secours dans le cas de très grosses bases de données.
 3. Utiliser MySQL en ligne de commande avec MAMP sans passer par PhpMyAdmin
 Il faut ouvrir le terminal, dans /applications/utilitaires/Terminal
Et taper la commande suivante :
/Applications/MAMP/Library/bin/mysql --host=localhost -uroot -proot

 On peut dès lors utiliser les commandes de MySQL. Taper par exemple : show databases ;
 
 On peut aussi créer un lien symbolique pour n'avoir à taper que mysql depuis le shell
sudo ln -s /Applications/MAMP/Library/bin/mysql /usr/local/bin/mysql
Une autre méthode, alternative au lien symbolique, consiste à créer un fichier .profile, fichier caché, dans son répertoire de home du mac /users/nom, de façon à y renseigner le PATH, à savoir le chemin de recherche des fichiers exécutables de MySQL
export PATH=/Applications/MAMP/Library/bin:$PATH

 On peut taper . .profile dans le terminal pour relancer son profile
alexmacapple:~ alex $ . .profile
puis écho $PATH pour s'assurer que la ligne a bien été prise en compte
alexmacapple:~ alex$ echo $PATH
On pourra alors désormais taper un simple mysql -u root -p pour se connecter à MySQL en ligne de commande
 Injecter un dump SQL :
mysql -uUSER -pPASS spip_db < mabase_db.sql 
cat Fichier.sql | mysql -uroot --password=root --database=nombase
Faire un sauvegarde SQL
mysqldump --opt spip > sauvegarde_spip.sql
4. Changer le password de MySQL :
 Par défaut le login et le mot de passe de MySQL est root/root. Si vous n'ouvrez pas le serveur MAMP vers l'extérieur, aucun souci, vous pouvez laisser comme cela. En revanche si vous voulez l'ouvrir sur le monde extérieur, et que votre serveur est accessible sur internet, il sera préférable de changer le mot de passe attribué par défaut pour des raisons de sécurité.
 Pour changer le mot de passe MySQL, il faudra faire deux choses :
 1. Utiliser la ligne de commande suivante dans le terminal
/Applications/MAMP/Library/bin/mysqladmin -u root -p password [NEWPASSWORD]
2. Prendre un éditeur de texte pour modifier l'ancien mot de passe à quatre endroits différents :
 /Applications/MAMP/bin/phpMyAdmin-X.X.X/config.inc.php

ligne 86
$cfg['Servers'][$i]['password'] = 'root';
/Applications/MAMP/bin/mamp/index.php

ligne 15
$link = @mysql_connect(':/Applications/MAMP/tmp/mysql/mysql.sock', 'root',
 'root');
/Applications/MAMP/bin/stopMysql.sh

Remplacer -proot par -pvotrepass
 On peut également le changer dans la page d'accueil de MAMP

/Applications/MAMP/bin/mamp/French/mamp.inc.php
ligne 16 et ligne 23
 5. Ouvrir MAMP automatiquement au démarrage du mac
 Allez dans le menu pomme, puis Préférences Système
 
 Puis dans l'onglet compte/ouverture, rajouter MAMP en ouverture automatique de session
 
 Cliquer sur ajouter
 
 Et c'est tout bon. Si votre mac s'éteint, le MAMP s'ouvrira automatiquement tout seul à la prochaine ouverture.
 On peut même, toujours dans les préférences system et dans l'onglet économiseur d'énergie cocher la case démarrer automatiquement le mac après une panne de courant.
 
 
V/ Mettre à jour sa version de MAMP en toute tranquillité, sans rien perdre de ses sites et de ses bases de données SQL
- 1. On quitte l'application MAMP ce qui a pour effet d'arrêter les serveurs Apache et MySQL, et on arrête les process pouvant tourner grâce au moniteur d'activité.

- 2. On Quitte l'application MAMP ce qui a pour effet d'arrêter les serveurs Apache et SQL

- 3. On renomme dans Applications le dossier MAMP en MAMP.old 
- 4. On lance la nouvelle installation de MAMP que l'on aura au préalable téléchargée sur le site officiel

- 5. On va copier certaines données de MAMP.old dans MAMP : Copier le contenu du sous-dossier /htdocs vers MAMP (Si vos sites sont dans ce Document Root). Copier le contenu du sous-dossier /db/mysql vers MAMP (Mais pas les sous-dossiers mysql/, performance_schema/ et le fichier mysql_upgrade_info)

- 6. Copier le fichier /conf/apache/httpd.conf vers MAMP si vous aviez modifié le fichier de conf (faire un diff pour voir ce qui a changé dans la nouvelle version et les répercuter)

- 7. Copier le fichier /bin/php/[Votre version]/conf/php.ini vers MAMP si vous aviez modifié le fichier (faire un diff pour voir ce qui a changé dans la nouvelle version, répercuter notamment le memory limait)

- 8. Relancer MAMP dans sa nouvelle version. La mise à jour est terminée
 (Et si on est un brin para-no :-), on peut également, avant de mettre a jour le MAMP, faire un backup manuel de toutes les bases sql dans PhpMyAdmin, mais de toute façon pas de panique, on pourra toujours revenir à son ancien MAMP en supprimant le .old et en renommant le nouveau MAMP, puis en fermant les process.)
 
VI/ En cas de problèmes
Il est possible que le MySQL de votre version de MAMP parfois refuse de se lancer ou ne fonctionne plus. Il convient tout d'abord de fermer MAMP.
 Il faut ensuite ouvrir le moniteur d'activité (Applications/Utilitaires/Moniteur d'activité/) et de fermer le ou les process sql qui pourraient être en conflit.
 
 On peut également aller directement dans le terminal et taper le code suivant d'un seul coup, même si personnellement je préfère la méthode avec le moniteur d'activité qui liste précisément les process SQL ouverts qui pourraient rentrer en conflit
ps aux | grep mysql
 lsof -i
 killall -9 mysqld
On redémarre ensuite le mac (pas obligatoire mais c'est une bonne veille habitude), on ouvre le MAMP et les serveurs devraient redémarrer.
 On peut aussi, par précaution, bien que cela ne soit pas forcément utile faire un chmod récursif 777 sur MAMP pour écarter tout problème de permission (sinon Pomme i, et donner les droits en écriture pour tous les répertoires)
# sudo chmod -Rfv 777 /Applications/MAMP
Lire la suite :
Ouvrir MAMP sur l'extérieur : Vhost, routeur, Domaine et DNS
		Nous n'avons pas abordé ici la question de la mutualisation, car nous ne l'avons jamais pratiqué, et surtout parce qu'un très bon article fait par Maïeul existe déjà.
http://geekographie.maieul.net/Gere...
Cet article est le premier de la série : - [->art4050] - [->art4048] - [->art4049] Nous allons utiliser MAMP 2 en version gratuite et licence GPL comme serveur web local (différent de MAMP Pro version payante). MAMP est l'acronyme de Macintosh Apache MySQL PHP et permet de lancer un serveur web local sous mac os X. C'est donc une solution toute clé en main et tout-en-un, qui comprend Apache, PHP5 et PHP4, MySQL, PHPMyAdmin et SQLiteManage ... Avantage par rapport à d'autres solutions : - MAMP ne compromettra pas une autre installation d'Apache. - MAMP peut se copier sur un autre mac pour être tout de suite opérationnel quand on change d'environnement. - MAMP permet de switcher de version php. - MAMP ne modifie aucun fichier du système. Cet article se veut un complément à [l'excellent article de Fil->article2606] qui reste toujours d'actualité, pour configurer au mieux votre environnement sous Mac OS X. Il est valable pour du Léopard, Snow Léopard et Lion. Un petit clin d'œil à Xdjuj que je remercie :-)

		{{Plan de la première partie : MAMP }} - [I/ Installation et lancement de MAMP->#Installation] - [II/ Structure du MAMP->#Structure] - [III/ Réglages de l'interface->#Reglages] - [IV/ Les réglages avancés et personnalisés->#ReglageAvances] - [V/ Mettre à jour sa version de MAMP en toute tranquillité, sans rien perdre de ses sites et de ses bases de données SQL->#MiseAJour] - [VI/ En cas de problèmes->#Probleme] [Installation<-] {{{I/ Installation et lancement de MAMP}}} {{1. On télécharge MAMP sur le site officiel }} [->http://www.mamp.info/en/index.html] On récupère donc le pacquage zippé nommé MAMP_MAMP_PRO_2.0.x.zip, on le dé-zippe puis on lance l'installation. Suivre les différentes étapes de l'installeur. MAMP s'installe à la racine du dossier Applications. On doit avoir un compte administrateur sur le mac et connaitre son mot de passe d'admin.  {{2. On lance le logiciel en cliquant sur l'icône de l'application MAMP}} Une fenêtre s'ouvre nous permettant de contrôler le bon lancement du serveur apache et du serveur de données MySQL.  Les voyants sont verts en cas de réussite, et rouges en cas d'échec. Il y a deux diodes correspondant l'une au serveur Apache, l'autre au serveur MySQL. Une deuxième fenêtre, celle de la page d'accueil s'ouvre aussi. Cette page prouve également que tout fonctionne et que l'installation de MAMP a réussi.  L'URL par défaut du serveur web local sous MAMP est : [->http://localhost:8888/MAMP] Mais on peut également y accéder en tapant l'adresse ip de localhost : [->http://127.0.0.1:8888/MAMP] On peut utiliser l'adresse Rendez-Vous du partage web, Préférence système/partage/ avec l'option partage web de cochée. Les ordinateurs de votre réseau local peuvent accéder à votre ordinateur par le biais de l'adresse : imacalex.local [->http://imacalex.local:8888/MAMP] On peut aussi ouvrir son serveur local vers l'extérieur, au prix de quelques opérations que l'on détaillera par la suite sur son modem (mappage de port, DMZ …), sur son fichier hosts et ses zones DNS, et utiliser l'adresse ip sortante fourni par son FAI, un domaine ou un dyndns.org : - http://mondomaine.info:8888/MAMP/ - http://monipfixe:8888/MAMP/ - http://mondyndns.org:8888/MAMP/ {{3. Configurer les préférences de MAMP selon ses besoins.}} Si vous débutez, laissez les options cochées par défaut. {{- L'onglet Démarrer / Arrêter :}}  - Cocher lancer les serveur au démarrage de MAMP - Cocher Arrêter les serveurs en quittant MAMP - Décocher Vérifier MAMP Pro au démarrage de MAMP. On n'utilise pas la version payante - Cocher la page d'accueil au démarrage, URL de la page d'accueil /MAMP/ qui correspond donc à [->http://localhost:8888/MAMP] ou [->http://127.0.0.1:8888/MAMP] {{- L'onglet Port :}}  Par défaut ce ne sont pas les ports traditionnels qui sont utilisés par MAMP pour Apache et MySQL, pour ne pas rentrer en conflit avec d'autres serveurs. MAMP propose en standard le port 8888 pour Apache, le port 80 étant normalement le port utilisé par défaut pour le serveur web. MAMP propose en standard le port 8889 pour MySQL, le port 3306 étant normalement le port utilisé par défaut. On peut switcher depuis cet onglet sur les Ports par défaut d'Apache et de MySQL ou revenir aux Ports par défaut de MAMP selon ses besoins. Mais on peut aussi définir ses propres ports si on le souhaite. {{- L'onglet PHP :}}  MAMP a l'énorme avantage de proposer deux versions de PHP : - La version 5.2.17 - et la 5.3.6 Ceci s'avère très utile pour tester et développer sous différentes versions de PHP. Par défaut on prendra la version proposée qui est à plus récente, à savoir le 5.3.6. MAMP nous propose aussi des extensions PHP pour le cache, à savoir XCache eAccelerator et APC. J'avoue ne pas trop savoir à quoi cela correspond. Nous avons laissé le XCache proposé par défaut. {{- L'onglet Apache :}}  Il faut définir ici le Document Root. Par défaut il s'agit de /Applications/MAMP/htdocs Mais on peut choisir un répertoire n'appartenant pas à MAMP si on le souhaite, n'importe où dans sa maisonnette d'utilisateur mac. Traditionnellement, ceux qui n'utilisent pas /Applications/MAMP/htdocs se servent du répertoire Sites de leur dossier utilisateur /Users/user/Sites. L'avantage de conserver en Document Root le répertoire htdocs est que l'on peut copier l'application MAMP sur un autre mac et être tout de suite opérationnel. On centralise en un même endroit tous les éléments. Mais les autres choix de Document Root peuvent tout aussi bien se justifier et de défendre. Il s'agit donc du choix du document racine du serveur web, et c'est là qu'il conviendra de déposer tous ses répertoires de sites web. {{- Créer une base SQL :}} depuis l'onglet PhpMyadmin, dans la case créer une nouvelle base de données en entrant son nom.  Dans interclassement pour la connexion MySQL cocher utf8_general_ci et cliquer ensuite sur créer. On pourra éventuellement créer un user spécifique pour cette base de donnée avec les privilèges qu'il convient. Pour ce faire, cliquer sur l'onglet Privilèges de PhpMyAdmin, puis cliquer sur ajouter un utilisateur et remplir les cases du formulaire.  [Structure<-] {{{II/ Structure du MAMP}}}  MAMP.app sert à lancer l'application. Elle a été installée dans Applications, et elle devra impérativement y rester. Les répertoires principaux de MAMP sont les suivants : - /Applications/MAMP : répertoire racine de l'application MAMP - /Applications/MAMP/cgi-bin - /Applications/MAMP/library : on y mettra notamment le my.cnf - /Applications/MAMP/bin : répertoire contenant les exécutables d'Apache, PHP4, PHP5, MySQL5 et SQLite. - /Applications/MAMP/conf : répertoire contenant les fichiers de configuration d'Apache (httpd.conf), et SQLiteManager (config.db). - /Applications/MAMP/tmp : répertoire contenant les fichiers temporaires créés par les exécutables. Le répertoire /tmp/php contient notamment les fichiers temporaires des sessions PHP. - /Applications/MAMP/db : répertoire contenant les bases de données SQLite et MySQL. - /Applications/MAMP/logs : répertoire contenant les fichiers de logs d'erreurs de PHP, Apache et MySQL. - /Applications/MAMP/htdocs : répertoire contenant les différents projets de sites Web si un autre dossier n'a pas été sélectionné. [Reglages<-] {{{III/ Réglages de l'interface}}} {{- Onglet Start}} Sur la page d'accueil où dans l'onglet start, se trouvent les informations importantes dont on a besoin pour configurer un CMS, à savoir le hôte : localhost, le port SQL : 8889, l'user : root, le mot de passe : root {{- Onglet Phpinfo}} Toutes les informations au niveau de la configuration de PHP. On y trouve notamment les informations du traditionnel php.info, avec la version de PHP active, ici Version 5.3.6, le chemin du fichier php.ini, il peut changer selon les versions de MAMP, /Applications/MAMP/bin/php/php5.3.6/conf/php.ini. On pourra y lire les valeurs par défaut de max_execution_time à 30 et de memory_limit à 32M du php.ini qu'il conviendra d'augmenter d'office pour une utilisation sereine de MAMP avec un CMS dont SPIP. {{- Onglet : Xcache}} On y touche pas. Je sais même pas trop à quoi ça sert. {{- Onglet Phpmyadmin}} L'interface de contrôle de MySQL. {{- Onglet SQLiteManager}} l'interface de contrôle de SQLite pour ceux qui utilise du SQLlight nativement proposé avec SPIP 3. Même si le manager nous semble beaucoup moins au point que le traditionnel Phpmyadmin. Nous continuons pour notre part à utiliser MySQL avec SPIP 3. {{- Onglet Faq}} Foire aux questions en anglais {{- Onglet Try MAMP Pro}} On ne l'abordera pas ici, mais nos différents réglages nous permettront d'avoir plus ou moins les mêmes options que la version Pro. [ReglageAvances<-] {{{IV/ Les réglages avancés et personnalisés}}} Voici quelques réglages et quelques éléments de personnalisation du MAMP à faire pour travailler sereinement comme sur un vrai serveur dédié mais en local. Toutes ne seront pas obligatoires, à vous de voir selon vos besoins. {{1. Ajuster les valeurs de php.ini}} Il conviendra de modifier le php.ini de chacune des versions php proposées par MAMP. Le chemin vers le php.ini peut changer selon les versions de MAMP. Ne pas hésiter à faire dans le terminal ces lignes :  alexmacapple:~ alex$ cd /Applications/MAMP alexmacapple:~ alex$ alexmacapple:MAMP alex$ find / -name php.ini 2>/dev/null  Qui nous donnera les bons chemins : {/Applications/MAMP/bin/php/php5.2.17/conf/php.ini} {/Applications/MAMP/bin/php/php5.3.6/conf/php.ini} {{memory_limit set}} est à 8MB par défaut dans MAMP, il conviendra de lui donner une valeur de 32 MB pour être tranquille. Ce réglage là est impératif pour lancer confortablement un SPIP récent sous peine d'obtenir des erreurs de timeout. On pourra également vérifier que {{max_execution_time}} est à 30 MB On peut également rajouté ces lignes pour activer les erreurs php  error_reporting : E_ALL display_errors : On  {{2. Créer dans MAMP le fichier de configuration MySQL (my.cnf)}} Si vous avez besoin d'ajuster vos paramètres SQL, il conviendra de créer un fichier {{my.cnf}} dans le répertoire suivant /Applications/MAMP/Library/my.cnf Il faut copier et surcharger le fichier qui se trouve dans /Applications/MAMP/Library/support-files/my-medium.cnf et le placer dans le répertoire /Applications/MAMP/Library/ et le renommer en my.cnf On peut le faire en ligne de commande à l'aide des lignes suivantes  sudo cp /Applications/MAMP/Library/support-files/my-medium.cnf /Applications/MAMP/Library/my.cnf  Attention l'emplacement peut changer selon les versions de MAMP utilisées. On peut sinon rechercher le fichier par le terminal en tapant les commandes pour voir s'ils existent et où ils se trouvent :  find / -name my.cnf 2>/dev/null find / -name my-medium.cnf 2>/dev/null  Éditer le fichier my.cnf et notamment modifiant la valeur de {{max_allowed_packet}} : passer de max_allowed_packet = 1M à max_allowed_packet = 128M pourra nous être d'un grand secours dans le cas de très grosses bases de données. {{3. Utiliser MySQL en ligne de commande avec MAMP sans passer par PhpMyAdmin}} Il faut ouvrir le terminal, dans /applications/utilitaires/Terminal Et taper la commande suivante :  /Applications/MAMP/Library/bin/mysql --host=localhost -uroot -proot   On peut dès lors utiliser les commandes de MySQL. Taper par exemple : show databases ;  On peut aussi créer un {{lien symbolique}} pour n'avoir à taper que mysql depuis le shell  sudo ln -s /Applications/MAMP/Library/bin/mysql /usr/local/bin/mysql  Une autre méthode, alternative au lien symbolique, consiste à créer un fichier {{.profile}}, fichier caché, dans son répertoire de home du mac /users/nom, de façon à y renseigner le PATH, à savoir le chemin de recherche des fichiers exécutables de MySQL  export PATH=/Applications/MAMP/Library/bin:$PATH   On peut taper . .profile dans le terminal pour relancer son profile  alexmacapple:~ alex $ . .profile  puis écho $PATH pour s'assurer que la ligne a bien été prise en compte  alexmacapple:~ alex$ echo $PATH  On pourra alors désormais taper un simple mysql -u root -p pour se connecter à MySQL en ligne de commande Injecter un dump SQL :  mysql -uUSER -pPASS spip_db < mabase_db.sql   cat Fichier.sql | mysql -uroot --password=root --database=nombase  Faire un sauvegarde SQL  mysqldump --opt spip > sauvegarde_spip.sql  {{4. Changer le password de MySQL :}} Par défaut le login et le mot de passe de MySQL est root/root. Si vous n'ouvrez pas le serveur MAMP vers l'extérieur, aucun souci, vous pouvez laisser comme cela. En revanche si vous voulez l'ouvrir sur le monde extérieur, et que votre serveur est accessible sur internet, il sera préférable de changer le mot de passe attribué par défaut pour des raisons de sécurité. Pour changer le mot de passe MySQL, il faudra faire deux choses : 1. Utiliser la ligne de commande suivante dans le terminal  /Applications/MAMP/Library/bin/mysqladmin -u root -p password [NEWPASSWORD]  2. Prendre un éditeur de texte pour modifier l'ancien mot de passe à quatre endroits différents : /Applications/MAMP/bin/phpMyAdmin-X.X.X/config.inc.php _ ligne 86  $cfg['Servers'][$i]['password'] = 'root';  /Applications/MAMP/bin/mamp/index.php _ ligne 15  $link = @mysql_connect(':/Applications/MAMP/tmp/mysql/mysql.sock', 'root', 'root');  /Applications/MAMP/bin/stopMysql.sh _ Remplacer -proot par -pvotrepass On peut également le changer dans la page d'accueil de MAMP _ /Applications/MAMP/bin/mamp/French/mamp.inc.php ligne 16 et ligne 23 {{5. Ouvrir MAMP automatiquement au démarrage du mac}} Allez dans le menu pomme, puis Préférences Système  Puis dans l'onglet compte/ouverture, rajouter MAMP en ouverture automatique de session  Cliquer sur ajouter  Et c'est tout bon. Si votre mac s'éteint, le MAMP s'ouvrira automatiquement tout seul à la prochaine ouverture. On peut même, toujours dans les préférences system et dans l'onglet économiseur d'énergie cocher la case démarrer automatiquement le mac après une panne de courant.  [MiseAJour<-] {{{V/ Mettre à jour sa version de MAMP en toute tranquillité, sans rien perdre de ses sites et de ses bases de données SQL}}} - 1. On quitte l'application MAMP ce qui a pour effet d'arrêter les serveurs Apache et MySQL, et on arrête les process pouvant tourner grâce au moniteur d'activité. - 2. On Quitte l'application MAMP ce qui a pour effet d'arrêter les serveurs Apache et SQL - 3. On renomme dans Applications le dossier MAMP en MAMP.old - 4. On lance la nouvelle installation de MAMP que l'on aura au préalable téléchargée sur le site officiel - 5. On va copier certaines données de MAMP.old dans MAMP : Copier le contenu du sous-dossier /htdocs vers MAMP (Si vos sites sont dans ce Document Root). Copier le contenu du sous-dossier /db/mysql vers MAMP (Mais pas les sous-dossiers mysql/, performance_schema/ et le fichier mysql_upgrade_info) - 6. Copier le fichier /conf/apache/httpd.conf vers MAMP si vous aviez modifié le fichier de conf (faire un diff pour voir ce qui a changé dans la nouvelle version et les répercuter) - 7. Copier le fichier /bin/php/[Votre version]/conf/php.ini vers MAMP si vous aviez modifié le fichier (faire un diff pour voir ce qui a changé dans la nouvelle version, répercuter notamment le memory limait) - 8. Relancer MAMP dans sa nouvelle version. La mise à jour est terminée (Et si on est un brin para-no :-), on peut également, avant de mettre a jour le MAMP, faire un backup manuel de toutes les bases sql dans PhpMyAdmin, mais de toute façon pas de panique, on pourra toujours revenir à son ancien MAMP en supprimant le .old et en renommant le nouveau MAMP, puis en fermant les process.) [Probleme<-] {{{VI/ En cas de problèmes}}} Il est possible que le MySQL de votre version de MAMP parfois refuse de se lancer ou ne fonctionne plus. Il convient tout d'abord de fermer MAMP. Il faut ensuite ouvrir le moniteur d'activité (Applications/Utilitaires/Moniteur d'activité/) et de fermer le ou les process sql qui pourraient être en conflit.  On peut également aller directement dans le terminal et taper le code suivant d'un seul coup, même si personnellement je préfère la méthode avec le moniteur d'activité qui liste précisément les process SQL ouverts qui pourraient rentrer en conflit  ps aux | grep mysql lsof -i killall -9 mysqld  On redémarre ensuite le mac (pas obligatoire mais c'est une bonne veille habitude), on ouvre le MAMP et les serveurs devraient redémarrer. On peut aussi, par précaution, bien que cela ne soit pas forcément utile faire un chmod récursif 777 sur MAMP pour écarter tout problème de permission (sinon Pomme i, et donner les droits en écriture pour tous les répertoires)  # sudo chmod -Rfv 777 /Applications/MAMP  Lire la suite : [->art4048] 

		Nous n'avons pas abordé ici la question de la mutualisation, car nous ne l'avons jamais pratiqué, et surtout parce qu'un très bon article fait par Maïeul existe déjà. [->http://geekographie.maieul.net/Gerer-beaucoup-de-sites-SPIP-en]



Ouvrir MAMP sur l'extérieur : Vhost, routeur, Domaine et DNS
Alexandra — 2012-01-21T13:11:48Z

		Cet article est le deuxième de la série :

- Comment créer un environnement de travail pour développer du SPIP sur un MAC avec MAMP

- Ouvrir MAMP sur l'extérieur : Vhost, routeur, Domaine et DNS

- Quelques outils pour développer du SPIP sous Mac
 Dans ce deuxième article, nous aborderons comment ouvrir son serveur MAMP vers l'extérieur comme un vrai serveur WEB. Un petit clin d'œil à XDjuj que je remercie :-)
		 Plan de la deuxième partie : Ouvrir MAMP sur l'extérieur : Vhost, routeur, Domaine et DNS
 - I/ Apache Serveur virtuel : Etc/hosts

- II/ Configurer son modem routeur

- III/ Configurer son domaine et ses zones DNS

- IV/ Un domaine personnalisé pour chaque site avec la modification du fichier de configuration httpd.conf
 
I/ Apache Serveur virtuel : Etc/hosts
Pour configurer Apache de manière à ce qu'il utilise des noms de domaine, il faut d'abord faire quelques opérations sur le mac.
 Par défaut, le serveur Apache de MAMP est sur le port 8888. On peut laisser ce comportement ou obtenir quelque chose de plus standard.
L'adresse web locale est http://localhost:8888 au lieu de http://localhost.
Pour qu'Apache écoute sur le port 80, aller dans les préférences de MAMP, cliquer sur l'onglet Ports. Choisir “Utiliser les paramètres standards” et valider. Après le redémarrage de MAMP, les serveurs Apache et MySQL fonctionnent de façon classique.
 Le fichier hosts du mac se trouve dans le répertoire /etc/hosts. Le répertoire /etc est un dossier caché à la racine du disque dur. Il conviendra d'avoir les droits pour éditer le fichier hosts, sinon les modifications ne seront pas prise en compte.
 Voici comment se présente le fichier hosts.
On Ajoute une nouvelle ligne avec l'ip local du serveur web : 127.0.0.1 et le nom de domaine que l'on a retenu monsiteamoi.com
Penser à faire plusieurs espaces entre l'ip et le domaine
# localhost is used to configure the loopback interface
 # when the system is booting. Do not change this entry.
 ##
 127.0.0.1 localhost
 127.0.0.1 monsiteamoi.com
Personnellement, dans mon vhost, j'ai quelque chose comme ceci
##
 # Host Database
 #
 # localhost is used to configure the loopback interface
 # when the system is booting. Do not change this entry.
 ##
 127.0.0.1 localhost
 127.0.0.1 88.161.2xx.2xx (mon adresse ip free sortante qui est fixe, et donc qui ne change pas toute les 24 h. Dans le cas d'une ip dynamique pensez à utiliser les dyndns.org)
 127.0.0.1 mondomaine.info (mon domaine pour l'ensemble de mon MAMP)
 192.168.0.50 mondomaine.info (l'ip interne de mon mac, équivalente à 127.0.0.1 mais qui me permet d'accéder au MAMP depuis mon émulation windows avec IE)
Quand je tape http://mondomaine.info:8888/MAMP, j'accède à mon MAMP parce que j'utilise le port 8888 sur le Document Root htdocs, et http://mondomaine.info renvoie sur le serveur web Apache du mac, activé quand on coche partage web depuis les préférences mac et le bouton partage.
 Ouvrir un terminal en compte root, et taper cd /etc
 On édite le fichier hosts avec l'éditeur pico
alexmacapple:etc alex$ pico hosts
On descend avec les flèches du clavier pour se positionner au bon endroit ; Contrôle X pour quitter le mode édition ; Et on sauve les modifications en tapant Y pour Yes.
 Pour les récalcitrants du terminal, ou pour ceux qui n'ont pas de compte super admin sur leur mac, on peut prendre l'éditeur gratuit Textwrangler, récupérable à cette adresse : http://www.barebones.com/products/t...
 Puis dans le fin-der du mac, dans le menu Aller, cliquer sur Aller au dossier
 
 - Et taper dans la fenêtre : Aller au dossier /etc/ puis valider en appuyant sur le bouton Aller

- Une fenêtre s'ouvre avec le contenu de /etc/

- Clic droit sur le fichier hosts

- Ouvrir avec TextWrangler

- Éditer son hosts

- Une petite fenêtre s'ouvre avec le message savant : "Are you sure you want to unlock "hosts" .

- This document is owned by "root".

- Cliquer sur Unlock

- Faire un pomme s pour enregistrer sa modification du vhost

- Une autre fenêtre apparaît qui nous demande le mot de passe de notre compte admin mac.

- On valide et c'est tout bon.
 Dans ce cas de figure donc on a donc 1 domaine pour l'ensemble des sites web sous MAMP

- http://mondomaine.info:8888/site1

- http://mondomaine.info:8888/site2

- http://mondomaine.info:8888/site3
 site1, site2, et site3 étant des sous-répertoires de htdocs définis comme mon Document Root.
 
II/ Configurer son modem routeur
Les réglages pourront différer selon le type de modem : box, freebox neitgear etc … mais les principes de base restent identiques. À vous de vous balader dans l'interface de votre routeur pour paramétrer et cocher les options qui conviennent.
 En gros il vous faudra :

- Cocher le DMZ sur pour votre ip local ce qui peut simplifier les choses : Serveur DMZ sur 192.168.0.2 (ip local de mon mac) mais ce n'est pas forcément très sécurisé d'ouvrir sur tout.

- Sinon on pourra faire du spécifique avec mappage de port 80 ou 8888 de votre ip local du mac vers l'ip sortante du routeur.

- Réserver toujours la même ip local à votre mac qui fait office de serveur web avec MAMP (réservation de plage ip)

- Actualisation du dyndns.org depuis le routeur si vous utilisez un domaine chez eux en cas d'ip dynamique. Certains modems offre ce type d'option

- On pourra également selon le type de routeur ajouter des services personnalisés et régler certains paramètres de pare-feu
 Du temps ou j'utilisais un modem routeur Netgear chez Orange voici les réglages que je faisais depuis l'interface du routeur (http://192.168.0.1) pour vous donner une petite idée. À vous d'adapter selon votre routeur et les options qu'il vous propose :
 - Toujours attribuer ip 192.168.0.2 d'après adresse mac Adresse MAC : d4:9a:20:5b:df:01 (Cf menu pomme/plus d'info/réseau pour avoir son ip local)

- Router les ports web 80 et 8888 sur 192.168.0.2

- Sinon option DMZ
# Activer Nom du service Action Adresse IP serveur LAN Utilisateurs WAN Journal HTTP Toujours AUTORISER 192.168.0.2 Tous Toujours MAMP Toujours AUTORISER 192.168.0.2 Tous Toujours
 Depuis que je suis passée sur la freebox avec Free, voici les réglages que j'ai cochés dans l'interface freebox accessible en ligne depuis ce lien
  https://subscribe.free.fr/login/
 
 - Activer le mode routeur de la freebox qui n'est pas actif par défaut

- Mappage des port 80 et 8888

- DMZ pour l'ip local de mon mac 192.168.0.10

- Notons que free offre aussi une page de personnalisation de reverse DNS que nous n'avons pas utilisé, car nous avons gérer notre zone DNS depuis notre registar de domaine.
 
 
III/ Configurer son domaine et ses zones DNS
Chez mon registrar de domaine, je gère les DNS du domaine mondomaine.info de la sorte

- A mondomaine.info 88.161.2xx.2xx (mon ip free)

- A *.mondomaine.info 88.161.2xx.2xx (mon ip free pour gérer éventuellement n'importe quel sous domaine)

- CNAME www.mondomaine.info mondomaine.info
 
IV/ Un domaine personnalisé pour chaque site avec la modification du fichier de configuration httpd.conf
Ce fichier se trouve dans /Applications/MAMP/conf/apache/httpd.conf
 Il faut ajouter les lignes correspondantes au virtualhost du domaine qui doit planter sur un répertoire site bien précis.
 Attention penser à mettre le même port que celui défini dans les options : 8888 ou 80
"monsite" correspond au répertoire du dit site qui pointe sur le domaine.
 Pensez à remplacer "monsite" par le nom de votre répertoire site et "monsite.com" par votre domaine choisi

 DocumentRoot /Applications/MAMP/htdocs/
 ServerName localhost
 
 
 DocumentRoot /Applications/MAMP/htdocs/monsite/
 ServerName monsite.com
 ServerAlias *.monsite.com
  
 Options Indexes FollowSymLinks MultiViews 
 DirectoryIndex index.php index.html
 AllowOverride All
 Order allow,deny 
 Allow from all 
  
 
Enregistrez httpd.conf puis Arrêter et Démarrer les Serveurs MAMP.
 Lire la suite :
Quelques outils pour développer du SPIP sous Mac
 Lire l'article précédent :
Comment créer un environnement de travail pour développer du SPIP sur un MAC avec MAMP
		
Cet article est le deuxième de la série : - [->art4050] - [->art4048] - [->art4049] Dans ce deuxième article, nous aborderons comment ouvrir son serveur MAMP vers l'extérieur comme un vrai serveur WEB. Un petit clin d'œil à XDjuj que je remercie :-) 

		{{ Plan de la deuxième partie : Ouvrir MAMP sur l'extérieur : Vhost, routeur, Domaine et DNS}} - [I/ Apache Serveur virtuel : Etc/hosts->#Host] - [II/ Configurer son modem routeur->#Routeur] - [III/ Configurer son domaine et ses zones DNS->#Domaine] - [IV/ Un domaine personnalisé pour chaque site avec la modification du fichier de configuration httpd.conf->#DomainePerso] [Host<-] {{{I/ Apache Serveur virtuel : Etc/hosts}}} Pour configurer Apache de manière à ce qu'il utilise des noms de domaine, il faut d'abord faire quelques opérations sur le mac. Par défaut, le serveur Apache de MAMP est sur le port 8888. On peut laisser ce comportement ou obtenir quelque chose de plus standard. L'adresse web locale est [->http://localhost:8888] au lieu de [->http://localhost]. Pour qu'Apache écoute sur le port 80, aller dans les préférences de MAMP, cliquer sur l'onglet Ports. Choisir “Utiliser les paramètres standards” et valider. Après le redémarrage de MAMP, les serveurs Apache et MySQL fonctionnent de façon classique. Le fichier hosts du mac se trouve dans le répertoire {{/etc/hosts}}. Le répertoire /etc est un dossier caché à la racine du disque dur. Il conviendra d'avoir les droits pour éditer le fichier hosts, sinon les modifications ne seront pas prise en compte. Voici comment se présente le fichier hosts. On Ajoute une nouvelle ligne avec l'ip local du serveur web: 127.0.0.1 et le nom de domaine que l'on a retenu monsiteamoi.com Penser à faire plusieurs espaces entre l'ip et le domaine  # localhost is used to configure the loopback interface # when the system is booting. Do not change this entry. ## 127.0.0.1	localhost 127.0.0.1 monsiteamoi.com  Personnellement, dans mon vhost, j'ai quelque chose comme ceci  ## # Host Database # # localhost is used to configure the loopback interface # when the system is booting. Do not change this entry. ## 127.0.0.1	localhost 127.0.0.1 88.161.2xx.2xx (mon adresse ip free sortante qui est fixe, et donc qui ne change pas toute les 24 h. Dans le cas d'une ip dynamique pensez à utiliser les dyndns.org) 127.0.0.1 mondomaine.info (mon domaine pour l'ensemble de mon MAMP) 192.168.0.50 mondomaine.info (l'ip interne de mon mac, équivalente à 127.0.0.1 mais qui me permet d'accéder au MAMP depuis mon émulation windows avec IE)  Quand je tape [->http://mondomaine.info:8888/MAMP], j'accède à mon MAMP parce que j'utilise le port 8888 sur le Document Root htdocs, et [->http://mondomaine.info] renvoie sur le serveur web Apache du mac, activé quand on coche partage web depuis les préférences mac et le bouton partage. Ouvrir un terminal en compte root, et taper cd /etc On édite le fichier hosts avec l'éditeur pico  alexmacapple:etc alex$ pico hosts  On descend avec les flèches du clavier pour se positionner au bon endroit ; Contrôle X pour quitter le mode édition ; Et on sauve les modifications en tapant Y pour Yes. Pour les récalcitrants du terminal, ou pour ceux qui n'ont pas de compte super admin sur leur mac, on peut prendre l'éditeur gratuit {{Textwrangler}}, récupérable à cette adresse : [->http://www.barebones.com/products/textwrangler/] Puis dans le fin-der du mac, dans le menu Aller, cliquer sur Aller au dossier  - Et taper dans la fenêtre : Aller au dossier /etc/ puis valider en appuyant sur le bouton Aller - Une fenêtre s'ouvre avec le contenu de /etc/ - Clic droit sur le fichier hosts - Ouvrir avec TextWrangler - Éditer son hosts - Une petite fenêtre s'ouvre avec le message savant : "Are you sure you want to unlock "hosts" . - This document is owned by "root". - Cliquer sur Unlock - Faire un pomme s pour enregistrer sa modification du vhost - Une autre fenêtre apparaît qui nous demande le mot de passe de notre compte admin mac. - On valide et c'est tout bon. Dans ce cas de figure donc on a donc 1 domaine pour l'ensemble des sites web sous MAMP - [->http://mondomaine.info:8888/site1] - [->http://mondomaine.info:8888/site2] - [->http://mondomaine.info:8888/site3] site1, site2, et site3 étant des sous-répertoires de htdocs définis comme mon Document Root. [Routeur<-] {{{II/ Configurer son modem routeur}}} Les réglages pourront différer selon le type de modem : box, freebox neitgear etc … mais les principes de base restent identiques. À vous de vous balader dans l'interface de votre routeur pour paramétrer et cocher les options qui conviennent. En gros il vous faudra : - Cocher le {{DMZ}} sur pour votre ip local ce qui peut simplifier les choses : Serveur DMZ sur 192.168.0.2 (ip local de mon mac) mais ce n'est pas forcément très sécurisé d'ouvrir sur tout. - Sinon on pourra faire du spécifique avec {{mappage de port}} 80 ou 8888 de votre ip local du mac vers l'ip sortante du routeur. - {{Réserver toujours la même ip local}} à votre mac qui fait office de serveur web avec MAMP (réservation de plage ip) - Actualisation du dyndns.org depuis le routeur si vous utilisez un domaine chez eux en cas d'ip dynamique. Certains modems offre ce type d'option - On pourra également selon le type de routeur ajouter des {{services personnalisés}} et régler certains paramètres de pare-feu Du temps ou j'utilisais un modem routeur {{Netgear chez Orange}} voici les réglages que je faisais depuis l'interface du routeur (http://192.168.0.1) pour vous donner une petite idée. À vous d'adapter selon votre routeur et les options qu'il vous propose : - Toujours attribuer ip 192.168.0.2 d'après adresse mac Adresse MAC : d4:9a:20:5b:df:01 (Cf menu pomme/plus d'info/réseau pour avoir son ip local) - Router les ports web 80 et 8888 sur 192.168.0.2 - Sinon option DMZ # Activer Nom du service Action Adresse IP serveur LAN Utilisateurs WAN Journal HTTP Toujours AUTORISER 192.168.0.2 Tous Toujours MAMP Toujours AUTORISER 192.168.0.2 Tous Toujours Depuis que je suis passée sur {{la freebox avec Free}}, voici les réglages que j'ai cochés dans l'interface freebox accessible en ligne depuis ce lien [->https://subscribe.free.fr/login/]  - Activer le mode routeur de la freebox qui n'est pas actif par défaut - Mappage des port 80 et 8888 - DMZ pour l'ip local de mon mac 192.168.0.10 - Notons que free offre aussi une page de personnalisation de reverse DNS que nous n'avons pas utilisé, car nous avons gérer notre zone DNS depuis notre registar de domaine.  [Domaine<-] {{{III/ Configurer son domaine et ses zones DNS}}} Chez mon registrar de domaine, je gère les DNS du domaine mondomaine.info de la sorte - A mondomaine.info 88.161.2xx.2xx (mon ip free) - A *.mondomaine.info 88.161.2xx.2xx (mon ip free pour gérer éventuellement n'importe quel sous domaine) - CNAME www.mondomaine.info mondomaine.info [DomainePerso<-] {{{IV/ Un domaine personnalisé pour chaque site avec la modification du fichier de configuration httpd.conf}}} Ce fichier se trouve dans /Applications/MAMP/conf/apache/httpd.conf Il faut ajouter les lignes correspondantes au virtualhost du domaine qui doit planter sur un répertoire site bien précis. Attention penser à mettre le même port que celui défini dans les options : 8888 ou 80 "monsite" correspond au répertoire du dit site qui pointe sur le domaine. Pensez à remplacer "monsite" par le nom de votre répertoire site et "monsite.com" par votre domaine choisi   DocumentRoot /Applications/MAMP/htdocs/ ServerName localhost   DocumentRoot /Applications/MAMP/htdocs/monsite/ ServerName monsite.com ServerAlias *.monsite.com  Options Indexes FollowSymLinks MultiViews DirectoryIndex index.php index.html AllowOverride All Order allow,deny Allow from all    Enregistrez httpd.conf puis Arrêter et Démarrer les Serveurs MAMP. Lire la suite : [->art4049] Lire l'article précédent : [->art4050] 



Quelques outils pour développer du SPIP sous Mac
Alexandra — 2012-01-21T13:11:32Z

		Cet article est le troisième de la série :

- Comment créer un environnement de travail pour développer du SPIP sur un MAC avec MAMP

- Ouvrir MAMP sur l'extérieur : Vhost, routeur, Domaine et DNS

- Quelques outils pour développer du SPIP sous Mac
 Dans ce troisième article, nous aborderons d'autres outils qui pourront vous être d'une aide précieuse sous Mac Os X. Un petit clin d'œil à XDjuj que je remercie et à Kent1 :-)
		 Plan de la troisième partie : outils diverses
 - I/ Installer Postfix pour pouvoir envoyer des mails depuis le serveur

- II/ Installer subversion sous mac pour pouvoir versionner ses projets

- III/ Installer Homebrew
 
I/ Installer Postfix pour pouvoir envoyer des mails depuis le serveur
Il faut aller dans /etc/postfix puis trouver le fichier main.cf qui est le fichier de configuration du postfix
alexmacapple:~ alex$ cd /etc/postfix/
Pour visualiser le fichier avant de l'éditer avec pico :
alexmacapple:postfix alex$ cat main.cf
alexmacapple : alex$ pico main.cf
 Il convient de changer les lignes 69, 77 et 305
# INTERNET HOST AND DOMAIN NAMES

Ligne 69 : myhostname = mondomaine.com

Ligne 77 : mydomain = mondomaine.com

Et ligne 305 : mettre le smtp et le port de son FAI internet

ex : pour free et pour orange

relayhost = [smtp.orange.fr]:25

relayhost = [smtp.free.fr]:25
Il faudra ensuite reloader son Postfix avec la commande suivante :
alexmacapple:~ alex$ postfix alex$ sudo postfix reload
Notons également les commandes pro arrêter ou démarrer postfix :
alexmacapple:~ alex$ sudo postfix start

alexmacapple:~ alex$ sudo postfix stop
ou peut tester la fonction d'envoi de mail depuis un shell pour vérifier que cela fonctionne en tapant le code suivant en prenant soin de remplacer l'émail par votre adresse émail
alexmacapple:~ alex$ echo "12h03" | mail -s "12h03" alexandra.guiderdoni@gmail.com
On pourra également tester que la fonction php d'envoi de mail est bien active, en créant un fichier mail.php dans Applications/MAMP/htdocs/monsite/mail.php
et mettre dedans cette petite ligne de code en remplaçant par votre émail

mail('alexandra@guiderdoni.net','[Mail Serveur]','Pourquoi ça ne marcherait pas ? :)',"From: \"guiderdoni.net\" ");

echo "Le mail est parti ! (ou pas...)";

?>

II/ Installer subversion sous mac pour pouvoir versionner ses projets 
Subversion est un logiciel de gestion de sources et de contrôle de versions. Ce type de programmes a plusieurs fonctions, notamment :
 - garder un historique des différentes versions des fichiers d'un projet

- permettre le retour à une version antérieure

- garder un historique des modifications

- permettre un accès souple à ces fichiers, en local ou via un réseau

- permettre à des utilisateurs distincts et souvent distants de travailler ensemble
 Plusieurs paquets sont disponibles pour mac, mais je crois que le pacquage de Collabnet est le plus récent. http://www.open.collab.net/download...
 Il faut lire le read-me du fichier d'installation qui indique le bon pat de subversion
export PATH=/opt/subversion/bin:$PATH
Et il faut l'éditer dans le fichier .profile, fichier caché, à créer si besoin dans votre répertoire de home utilisateur
alexmacapple:~ alex$ cat .profile

export PATH=/opt/subversion/bin:/Applications/MAMP/Library/bin:$PATH
Vous pourrez donc ensuite utiliser le terminal pour taper vos commandes SVN :
alexmacapple:~ alex$ cd /Applications/MAMP/htdocs/monsitespip
puis taper cette ligne pour récupérer la version stable de la branche SVN :
alexmacapple:~ alex$ svn co svn://trac.rezo.net/spip/branches/spip-2-stable .
Aller dans le répertoire plugin pour récupérer ceux qui vous intéressent :
cd plugins

svn checkout svn://zone.spip.org/spip-zone/_plugins_/cfg

svn checkout svn://zone.spip.org/spip-zone/_plugins_/spip-bonux-2
vous pourrez par exemple taper ces commandes pour mettre à jour votre site et vider les caches
svn up

cd plugins

svn up *

cd ../extensions

svn up *

cd ../trunk

svn up

cd ../tmp

rm *.php

cd cache

rm -r *
Et pour les récalcitrants du terminal et de la ligne de commande, vous avez SvnX en client SVN gratuit pour mac. Je vous renvoie à un article de 2007, publié sur SPIP-ZINE :
 http://zine.spip.org/spip.php?article44
 Il faudra juste prendre les paquets plus récents de subversion et la version plus récente de SvnX.
 
III/ Installer Homebrew
Il s'agit d'un système de paquets Unix pour Mac OS X.
Le site officiel se trouve à cette URL : http://mxcl.github.com/homebrew/
 En prérequis de l'installation de Homebrew, vous devez vous assurez que :

- votre processeur est un Intel

- vous tournez sur un mac os X.5 ou plus élévé

- Xcode est installé sur votre mac avec X11 (téléchargeable sur le site d'Apple, sinon présent dans votre disque d'installation de Mac OS X).

- Et que vous avez bien Java Developer Update
 Pour plus d'information, https://github.com/mxcl/homebrew/wi...
 Pour l'installer, ouvrir un terminal et taper le code suivant :
/usr/bin/ruby -e "$(curl -fsSL https://raw.github.com/gist/323731)"

 Homebrew s'est donc installé dans /usr/local.
 Pour installer un paquet, comme GIT par exemple, il suffit de taper dans un shell la commande suivante :
brew install git
Puis pour mettre à jour
brew update

 Git est un système de contrôle de version qui vous de garder une trace de toutes les modifications que l'on fait quand on travaille sur un projet. C'est une alternative à subversion.
 On peut de la même manière installer la précieuse commande WGET
brew install wget
WGET, inclus dans la plupart des distributions GNU/Linux, est un superbe outil de téléchargement, qui permet le téléchargement récursif, la récupération d'un seul type de fichier, la reprise d'un téléchargement interrompu ... C'est une commande très puissante avec pleins d'options.
 On trouvera la liste complète des paquets de Homebrew ici :
https://github.com/mxcl/homebrew/tr...
 Lire les articles précédents :

- Comment créer un environnement de travail pour développer du SPIP sur un MAC avec MAMP

- Ouvrir MAMP sur l'extérieur : Vhost, routeur, Domaine et DNS
		
Cet article est le troisième de la série : - [->art4050] - [->art4048] - [->art4049] Dans ce troisième article, nous aborderons d'autres outils qui pourront vous être d'une aide précieuse sous Mac Os X. Un petit clin d'œil à XDjuj que je remercie et à Kent1 :-)

		{{ Plan de la troisième partie : outils diverses}} - [I/ Installer Postfix pour pouvoir envoyer des mails depuis le serveur->#Postfix]
- [II/ Installer subversion sous mac pour pouvoir versionner ses projets->#Subversion]
- [III/ Installer Homebrew->#Homebrew] [Postfix<-] {{{I/ Installer Postfix pour pouvoir envoyer des mails depuis le serveur}}} Il faut aller dans /etc/postfix puis trouver le fichier main.cf qui est le fichier de configuration du postfix 
alexmacapple:~ alex$ cd /etc/postfix/
 Pour visualiser le fichier avant de l'éditer avec pico : 
alexmacapple:postfix alex$ cat main.cf

alexmacapple:~ alex$ pico main.cf Il convient de changer les lignes 69, 77 et 305 
# INTERNET HOST AND DOMAIN NAMES
Ligne 69 : myhostname = mondomaine.com
Ligne 77 : mydomain = mondomaine.com
Et ligne 305 : mettre le smtp et le port de son FAI internet
ex : pour free et pour orange
relayhost = [smtp.orange.fr]:25
relayhost = [smtp.free.fr]:25
 Il faudra ensuite reloader son Postfix avec la commande suivante : 
alexmacapple:~ alex$ postfix alex$ sudo postfix reload
 Notons également les commandes pro arrêter ou démarrer postfix : 
alexmacapple:~ alex$ sudo postfix start
alexmacapple:~ alex$ sudo postfix stop
 ou peut tester la fonction d'envoi de mail depuis un shell pour vérifier que cela fonctionne en tapant le code suivant en prenant soin de remplacer l'émail par votre adresse émail 
alexmacapple:~ alex$ echo "12h03" | mail -s "12h03" alexandra.guiderdoni@gmail.com
 On pourra également tester que la fonction php d'envoi de mail est bien active, en créant un fichier mail.php dans Applications/MAMP/htdocs/monsite/mail.php
et mettre dedans cette petite ligne de code en remplaçant par votre émail 
");
echo "Le mail est parti ! (ou pas...)";
?>
 [Subversion<-] {{{II/ Installer subversion sous mac pour pouvoir versionner ses projets }}} Subversion est un logiciel de gestion de sources et de contrôle de versions. Ce type de programmes a plusieurs fonctions, notamment : - garder un historique des différentes versions des fichiers d'un projet
- permettre le retour à une version antérieure
- garder un historique des modifications
- permettre un accès souple à ces fichiers, en local ou via un réseau
- permettre à des utilisateurs distincts et souvent distants de travailler ensemble Plusieurs paquets sont disponibles pour mac, mais je crois que le pacquage de Collabnet est le plus récent. [->http://www.open.collab.net/downloads/community/] Il faut lire le read-me du fichier d'installation qui indique le bon pat de subversion 
export PATH=/opt/subversion/bin:$PATH
 Et il faut l'éditer dans le fichier .profile, fichier caché, à créer si besoin dans votre répertoire de home utilisateur 
alexmacapple:~ alex$ cat .profile
export PATH=/opt/subversion/bin:/Applications/MAMP/Library/bin:$PATH
 Vous pourrez donc ensuite utiliser le terminal pour taper vos commandes SVN : 
alexmacapple:~ alex$ cd /Applications/MAMP/htdocs/monsitespip
 puis taper cette ligne pour récupérer la version stable de la branche SVN : 
alexmacapple:~ alex$ svn co svn://trac.rezo.net/spip/branches/spip-2-stable .
 Aller dans le répertoire plugin pour récupérer ceux qui vous intéressent : 
cd plugins
svn checkout svn://zone.spip.org/spip-zone/_plugins_/cfg
svn checkout svn://zone.spip.org/spip-zone/_plugins_/spip-bonux-2
 vous pourrez par exemple taper ces commandes pour mettre à jour votre site et vider les caches 
svn up
cd plugins
svn up *
cd ../extensions
svn up *
cd ../trunk
svn up
cd ../tmp
rm *.php
cd cache
rm -r *
 Et pour les récalcitrants du terminal et de la ligne de commande, vous avez SvnX en client SVN gratuit pour mac. Je vous renvoie à un article de 2007, publié sur SPIP-ZINE : [->http://zine.spip.org/spip.php?article44] Il faudra juste prendre les paquets plus récents de subversion et la version plus récente de SvnX. [Homebrew<-] {{{III/ Installer Homebrew}}} Il s'agit d'un système de paquets Unix pour Mac OS X.
Le site officiel se trouve à cette URL : [->http://mxcl.github.com/homebrew/] En prérequis de l'installation de Homebrew, vous devez vous assurez que :
- votre processeur est un Intel
- vous tournez sur un mac os X.5 ou plus élévé
- Xcode est installé sur votre mac avec X11 (téléchargeable sur le site d'Apple, sinon présent dans votre disque d'installation de Mac OS X).
- Et que vous avez bien Java Developer Update Pour plus d'information, [->https://github.com/mxcl/homebrew/wiki/installation] Pour l'installer, ouvrir un terminal et taper le code suivant : 
/usr/bin/ruby -e "$(curl -fsSL https://raw.github.com/gist/323731)"
  Homebrew s'est donc installé dans /usr/local. Pour installer un paquet, comme {{GIT}} par exemple, il suffit de taper dans un shell la commande suivante : 
brew install git
 Puis pour mettre à jour 
brew update
  Git est un système de contrôle de version qui vous de garder une trace de toutes les modifications que l'on fait quand on travaille sur un projet. C'est une alternative à subversion. On peut de la même manière installer la précieuse commande {{WGET}} 
brew install wget
 WGET, inclus dans la plupart des distributions GNU/Linux, est un superbe outil de téléchargement, qui permet le téléchargement récursif, la récupération d'un seul type de fichier, la reprise d'un téléchargement interrompu ... C'est une commande très puissante avec pleins d'options. On trouvera la liste complète des paquets de Homebrew ici :
[->https://github.com/mxcl/homebrew/tree/master/Library/Formula/] Lire les articles précédents :
- [->art4050]
- [->art4048]


Tutoriel : produire sa propre structure de livre
Maïeul — 2012-01-20T14:07:37Z

		La structure proposée ne vous convient pas ? Il est possible de produire les fichiers .tex correspondant à vos besoins.
 Pour ce faire, c'est entièrement des boucles SPIP, avec une API spéciale.
 Ceci est donc une documentation dévellopeur. Pour être comprise, elle nécessite des compétences :

- En SPIP

- En LaTeX
		Les différent élèments de l'API
- Le plugin latexwheel propose des règles de transformation des raccourcis SPIP en code LaTeX. Il se base sur TextWheel.

- Le plugin ZipTeX, qui se base sur le plugin Zippeur.
 Cet article se veut un tutoriel visant à montrer comment se servir de ces deux plugins pour créer sa propre structure de liste avec SPIP.
 Deux articles plus détaillés donnent les détails de l'API.
Exemple de la structure prise
La structure sera simple : il s'agira dans un livre de regrouper tout les articles d'une rubrique. Par exemple, la rubrique éditoriale, en les classant par ordre chronologique, en mettant à chaque fois le titre, suivi de la date, du chapo, du corps du texte, puis de la signature des auteurs.
Organisation finale de notre Zip
Il est possible en LaTeX de diviser un projet en plusieurs fichiers .tex, un peu comme on ferait en SPIP avec des squelettes inclus, via  ou #INCLURE.
 Dans cette logique, le but est que SPIP produise un fichier livre.tex, qui appelle lui-même des des fichiers inclure/articlexxx.html correspondant à chaque article. L'ensemble de ces fichiers étant regroupés dans un fichier .zip.
 Pour les besoins de l'exercice, nous nous servirons de la base de donnée sqlite jointe [1]. L'identifiant pour se connecter est auteur et le mot de passe est demodemo.


Base de donnée exemple

Nous supposerons qu'il n'y a ni images dans nos articles, ni code informatique, ni liens. L'article détaillé sur l'API fournit les outils pour les intégrer le cas échéant.
 Pour éviter tout ennui de cache, désactivez le en mettant la ligne suivante dans le fichier mes_options.php :
define('_NO_CACHE',-1);
Étape 1 : le fichier parent
Créons un squelette livre.tex.html, en y mettant le contenu suivant :
#HTTP_HEADER{content-type:application/x-latex}
\documentclass[a4paper,12pt]{book}
\begin{document}
(ARTICLES){id_rubrique}{!par date}>
\input{inclus/article#ID_ARTICLE}
>
\end{document}
 Télécharger
Analysons le code :
 ligne 1, la balise #HTTP_HEADER permet, dans notre cas, deux choses : de dire au navigateur qu'on produit du latex et pas du html.
 d'empêcher SPIP d'insérer les boutons d'administrations.
 ligne 2, nous déclarons la classe de notre fichier .tex. Pour rappel, un fichier latex doit toujours commencer par une déclaration de classe. Ici nous disons que nous produisons un livre, sur du papier A4, avec une police de base de 12 pt.
 ligne 3, nous commençons le corps du document.
 ligne 4, une Boucle classique de SPIP : on demande les articles de la rubrique passée en argument lors de l'appel au squelette, classés par ordre antéchronologique.
 ligne 5, pour chaque article, nous insérons le code \input{inclus/articlexxx} qui permettra à LaTeX d'appeler le fichier inclus/articlexxx.tex.
 ligne 6, fin de la boucle.
 ligne 7, fin du corps du document LaTeX.
 Maintenant, rendons-nous sur http://votresite.dev/?page=livre.tex&id_rubrique=1. Notre navigateur va nous télécharger un fichier contenant les lignes suivantes :
\documentclass[a4paper,12pt]{book}
\begin{document}
 
\input{inclus/article1}
 
\input{inclus/article2}
 
\end{document}
 Télécharger
C'est bien, mais il serait bon d'avoir un préambule appelant les packages nécéssaires. Ces packages peuvent varier en fonction du contenu des articles, si par exemple on a des images, du code, des tableaux. Mais tout cela est sera détaillé dans l'article sur l'API LaTeXWheels.
 Pour le moment, contentons nous des packages minimums.
 Il nous faut : 
- fontspec et xunicode pour gérer correctement l'UTF-8.

- polyglossia, pour gérer les langues.
 Insérons donc entre le \documentclass[a4paper,12pt]{book} et le \begin{document} l'appel à ces packages :
\usepackage{fontspec}

\usepackage{xunicode}

\usepackage{polyglossia}
 Télécharger
Et puis, précisons quand même la langue, avec le code suivant :
\setmainlanguage{[(#LANG|ziptex_polyglossia)]}
Alors là, on a un mélange de LaTeX, la commande \setmainlanguage qui permet de dire à polyglossia qu'elle est la langue principale, et donc de gérer correctement les césures et la ponctuation, et le code [(#ENV{lang}|ziptex_polyglossia)], qui prend le code de la langue courante, en l'occurence fr et le transforme en code compréhensible par polyglossia, à savoir french, par le biais du filtre |ziptex_polyglossia.
 Tout ceci donne donc :
#HTTP_HEADER{content-type:application/x-latex}

\documentclass[a4paper,12pt]{book}

\usepackage{fontspec}

\usepackage{xunicode}

\usepackage{polyglossia}

\setmainlanguage{[(#LANG|ziptex_polyglossia)]}

\begin{document}

(ARTICLES){id_rubrique}{!par date}>

\input{inclus/article#ID_ARTICLE}

>

\end{document}
 Télécharger
Ce qui une fois interprété par SPIP, produit :
\documentclass[a4paper,12pt]{book}

\usepackage{fontspec}

\usepackage{xunicode}

\usepackage{polyglossia}

\setmainlanguage{french}

\begin{document}
 

\input{inclus/article2}
 

\input{inclus/article1}
 

\end{document}
 Télécharger
Et puis soyions fous, ajoutons une table des matières, à la fin, avec la commande \tableofcontents :
#HTTP_HEADER{content-type:application/x-latex}

\documentclass[a4paper,12pt]{book}

\usepackage{fontspec}

\usepackage{xunicode}

\usepackage{polyglossia}

\setmainlanguage{[(#LANG|ziptex_polyglossia)]}

\begin{document}

(ARTICLES){id_rubrique}{!par date}>

\input{inclus/article#ID_ARTICLE}

>

\tableofcontents

\end{document}
 Télécharger
Étape 2, les fichiers fils
Préparons le squelette qui va engendrer les fichiers inclus/articlexxx.tex. Appelons ce squelette article.tex.
#HTTP_HEADER{content-type:application/x-latex}

(ARTICLES){id_article}>

\chapter{[(#TITRE*|propre_latex)]}
 

[(#DATE|affdate|propre_latex)]
 

[(#CHAPO*|propre_latex)]
 

[(#TEXTE*|propre_latex)]
 

(AUTEURS){id_article}{","}>[(#NOM*|propre_latex)>

>
 Télécharger
Analysons :
 Ligne 1, le même #HTTP_HEADER que précédemment, vu que je veux à nouveau produire un fichier .tex
 Ligne 2 et 12, boucle ARTICLES classique.
 Ligne 3, mettre le titre dans la commande LaTeX \chapter{}.
 Ligne 5, mettre la date.
 Ligne 7, mettre le chapeau.
 Ligne 9, mettre le texte.
 Ligne 11, mettre les auteurs.
On remarque les lignes vides : rappelons qu'en LaTeX, les lignes vides produisent des changements de paragraphes.
 Toutes les balises SPIP qui retournent du texte sont présentés de la manière suivante :
[(#BALISE*|propre_latex)]
Rappelons une règle de fonctionnement de SPIP : le contenu de chaque champ de type texte est filtré automatiquement par le filtre |propre, qui transforme les raccourcis SPIP en code HTML.
 En revanche, si on écrit #BALISE*, |propre n'est pas appelé : on obtient alors le contenu du champ, de manière brute [2].
 C'est ce contenu brut qui est passé dans le filtre |propre_latex du plugin latexwheel. Ce filtre transforme les raccourcis SPIP en code LaTeX.
 Au final, si je me rend sur la page http://site/?page=article.tex&id_article=1, j'obtiens :
\chapter{De l'influence de LaTeX sur la sexualité humaine}

28 décembre 2011

Si selon le mot, peut-être apocryphe, de Freud, « tout est sexe », alors LaTeX a une influence sur la sexualité humaine. Qu'en est-il ?

On pourrait montrer trois influences de LaTeX en matière de sexualité humaine :

\begin{enumerate}

\item En tant que le LaTeX est généralement le principal composant des préservatifs.

\item Dans certaines pratiques sexuelles avec certains vêtements.

\item Dans la constitution de groupes d'utilisateurs de LaTeX, pouvant constituer des lieux de rencontres.

\end{enumerate}

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. 

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

auteur
 Télécharger
Étape 3 : générer automatiquement les fichiers .tex fils
L'étape suivante consiste à dire au squelette livre.tex.html de générer automatiquement, lorsqu'il est appelé, les fichiers .tex fils, comme article1.tex et article2.tex.
 Pour ce faire, on utilise le filtre |ziptex_creer_tex du plugin ziptex.
 Ce filtre s'applique sur le nom du squelette à interpréter, sans le .html final. Il reçoit comme premier argument le chemin du fichier à produire, à l'intérieur du dossier local/ziptex, et comme second argument un tableau d'arguments à passer lors de l'appel au squelette.
 Dans notre cas, nous souhaitons interpréter le squelette article.tex.html, pour produire un fichier inclus/articlexxx.tex, en passant à chaque fois au squelette l'id_article nous intéressant.
 Nous allons donc insérer dans le fichier livre.tex.html, après \input{inclus/article#ID_ARTICLE} la ligne suivante :
[(#VAL{article.tex}||ziptex_creer_tex{inclus/article#ID_ARTICLE.tex,#ARRAY{id_article,#ID_ARTICLE}})]
Par ailleurs, comme nous souhaitons créer un sous-dossier (inclus), il nous faut dire de générer le sous-dossier le cas échéant. Pour ce faire, on utilise la ligne suivante :
[(#ARRAY{0,inclus}|ziptex_dir)]
qu'on met dans le squelette livre.tex.html, en dehors de la boucle.
 Au final, on obtient :
#HTTP_HEADER{content-type:application/x-latex}

[(#ARRAY{0,inclus}|ziptex_dir)]

\documentclass[a4paper,12pt]{book}

\usepackage{fontspec}

\usepackage{xunicode}

\usepackage{polyglossia}

\setmainlanguage{[(#LANG|ziptex_polyglossia)]}

\begin{document}

(ARTICLES){id_rubrique}{!par date}>

\input{inclus/article#ID_ARTICLE}

[(#VAL{article.tex}|ziptex_creer_tex{inclus/article#ID_ARTICLE.tex,#ARRAY{id_article,#ID_ARTICLE}})]

>

\tableofcontents

\end{document}
 Télécharger
Désormais, en allant sur http://site.com/?page=livre&id_rubrique=1, non seulement SPIP nous retourne un fichier LaTeX, mais en plus il produit les fichiers inclus/article1.tex et inclus/article2.tex dans le dossier local/ziptex.
Étape 4 Fabriquer un zip contenant tout les fichiers .tex
Il va maintenant falloir produire un zip contenant tout les .tex nécéssaires à la production du livre.
 Pour ce faire, nous allons créer un squelette livre.html, qui nous retournera l'adresse du Zip.
 Pour que ce zip soit généré, on va appeler le filtre |ziptex_zipper.
 Ce filtre zipper le dossier local/ziptex et retourne l'url du Zip.
 Mais avant de zipper, le filtre peut ajouter du contenu dans le dossier local/ziptex.
 Pour ce faire, il reçoit un tableau (au sens PHP) dont la structure est la suivante :
 0. Un tableau contenant les .tex direct, c'est à dire sans code SPIP dedans, avec à chaque fois : 0. Chemin du fichier .tex dans l'arborescence SPIP
 1. Chemin du fichier .tex dans le future ZIP
 1. Un tableau contenant les squelettes qui généreront du latex avec à chaque fois : 0. Chemin du squelette, sans le .html
 1. Chemin du .tex correspondant, avec le .tex
 2. Option du squelette
Dans notre cas, l'entrée 0 doit être vide. En revanche l'entrée 1 contiendra elle même une seule entrée, correspondant à la transformation du squelette livre.tex.html en fichier livre.tex. On passera la rubrique courante comme argument.
 Nous allons mettre ce tableau dans un #GET, à l'aide la balise #ARRAY. Puis nous allons appeler sur ce tableau le filtre ziptex_zipper.
 Ce qui donne :
#SET{tableau,#ARRAY{
 0,#ARRAY{},
 1,#ARRAY{
 0,#ARRAY{
 0,livre.tex,
 1,livre.tex,
 2,#ARRAY{id_rubrique,#ID_RUBRIQUE} 
 }
 }
 }
 }

[(#GET{tableau}|ziptex_zipper)]">Le zip
 Télécharger
Si je me rend sur http://site.com/?page=livre&id_rubrique=1, j'obtiens un liens vers le zip contenant les fichiers .tex.
 Si on compile deux fois ce fichier, avec XeLaTeX, on obient alors le PDF joint.


Ensemble des fichiers .tex


Fichier PDF final
Conclusion


Squelette complet

 Cet article vous présente les base pour transformer du SPIP en LaTeX. Vous pouvez trouver ci joint le squelette complet de ce tutoriel.
  Il faut ensuite évidemment connaître LaTeX pour gérer la présentation. En outre, si nos textes sont plus complexes (liens, code, etc.) il faut appeler d'autres packages, ajouter des codes.
 On se reportera aux deux articles de références :
 Référence de LaTeXWheel
 Référence de ZipTeX
		
		
[1] Le niveau intellectuel qui est y présent n'engage pas son auteur, qui avait besoin de textes mais n'avait pas envie de se creuser la tête …

[2] À l'exception des sécurités vis-à-vis des codes javascripts et PHP.

		
La structure proposée ne vous convient pas ? Il est possible de produire les fichiers .tex correspondant à vos besoins. Pour ce faire, c'est entièrement des boucles SPIP, avec une API spéciale. Ceci est donc une documentation dévellopeur. Pour être comprise, elle nécessite des compétences : - En SPIP - En LaTeX

{{{Les différent élèments de l'API}}} - Le plugin latexwheel propose des règles de transformation des raccourcis SPIP en code LaTeX. [Il se base sur TextWheel->http://zzz.rezo.net/Presentation-de-Textwheel.html].
- Le plugin ZipTeX, qui se base sur le plugin [Zippeur->3576]. Cet article se veut un tutoriel visant à montrer comment se servir de ces deux plugins pour créer sa propre structure de liste avec SPIP. Deux articles plus détaillés donnent les détails de l'API. {{{Exemple de la structure prise}}} La structure sera simple : il s'agira dans un livre de regrouper {{tout}} les articles d'une rubrique. Par exemple, la rubrique {éditoriale}, en les classant par ordre chronologique, en mettant à chaque fois le titre, suivi de la date, du chapo, du corps du texte, puis de la signature des auteurs. {{{Organisation finale de notre Zip}}} Il est possible en LaTeX de diviser un projet en plusieurs fichiers .tex, un peu comme on ferait en SPIP [avec des squelettes inclus->http://programmer.spip.org/Inclure-des-squelettes], via  ou #INCLURE. Dans cette logique, le but est que SPIP produise un fichier livre.tex, qui appelle lui-même des des fichiers inclure/articlexxx.html correspondant à chaque article. L'ensemble de ces fichiers étant regroupés dans un fichier .zip. Pour les besoins de l'exercice, nous nous servirons de la base de donnée sqlite jointe[[Le niveau intellectuel qui est y présent n'engage pas son auteur, qui avait besoin de textes mais n'avait pas envie de se creuser la tête …]]. L'identifiant pour se connecter est auteur et le mot de passe est demodemo.  Nous supposerons qu'il n'y a ni images dans nos articles, ni code informatique, ni liens. L'article détaillé sur l'API fournit les outils pour les intégrer le cas échéant. Pour éviter tout ennui de cache, désactivez le en mettant la ligne suivante dans le fichier mes_options.php : 
define('_NO_CACHE',-1);
 {{{Étape~1 : le fichier parent}}} Créons un squelette livre.tex.html, en y mettant le contenu suivant : 
#HTTP_HEADER{content-type:application/x-latex}
\documentclass[a4paper,12pt]{book}
\begin{document}

\input{inclus/article#ID_ARTICLE}

\end{document}
 Analysons le code :
-* ligne~1, la [balise #HTTP_HEADER->http://www.spip.net/fr_article4631.html] permet, dans notre cas, deux choses :
-## de dire au navigateur qu'on produit du latex et pas du html.
-## d'empêcher SPIP d'insérer les boutons d'administrations.
-* ligne~2, nous déclarons la classe de notre fichier .tex. Pour rappel, un [fichier latex doit toujours commencer par une déclaration de classe->https://fr.wikibooks.org/wiki/LaTeX/Les_classes]. Ici nous disons que nous produisons un livre, sur du papier~A4, avec une police de base de 12~pt.
-* ligne~3, nous commençons le corps du document.
-* ligne~4, une Boucle classique de SPIP : on demande les articles de la rubrique passée en argument lors de l'appel au squelette, classés par ordre antéchronologique.
-* ligne~5, pour chaque article, nous insérons le code \input{inclus/articlexxx} qui permettra à LaTeX d'appeler le fichier inclus/articlexxx.tex.
-* ligne~6, fin de la boucle.
-* ligne~7, fin du corps du document LaTeX.
-* Maintenant, rendons-nous sur http://votresite.dev/?page=livre.tex&id_rubrique=1. Notre navigateur va nous télécharger un fichier contenant les lignes suivantes : 
\documentclass[a4paper,12pt]{book}
\begin{document} \input{inclus/article1} \input{inclus/article2} \end{document}
 C'est bien, mais il serait bon d'avoir un préambule appelant les packages nécéssaires. Ces packages peuvent varier en fonction du contenu des articles, si par exemple on a des images, du code, des tableaux. Mais tout cela est sera détaillé dans l'article sur l'API LaTeXWheels. Pour le moment, contentons nous des packages minimums. Il nous faut : - fontspec et xunicode pour gérer correctement l'UTF-8.
- polyglossia, pour gérer les langues. Insérons donc entre le \documentclass[a4paper,12pt]{book} et le \begin{document} l'appel à ces packages : 
\usepackage{fontspec}
\usepackage{xunicode}
\usepackage{polyglossia}
 Et puis, précisons quand même la langue, avec le code suivant : \setmainlanguage{[(#LANG|ziptex_polyglossia)]} Alors là, on a un mélange de LaTeX, la commande \setmainlanguage qui permet de dire à polyglossia qu'elle est la langue principale, et donc de gérer correctement les césures et la ponctuation, et le code [(#ENV{lang}|ziptex_polyglossia)], qui prend le code de la langue courante, en l'occurence fr et le transforme en code compréhensible par polyglossia, à savoir french, par le biais du filtre |ziptex_polyglossia. Tout ceci donne donc : 
#HTTP_HEADER{content-type:application/x-latex}
\documentclass[a4paper,12pt]{book}
\usepackage{fontspec}
\usepackage{xunicode}
\usepackage{polyglossia}
\setmainlanguage{[(#LANG|ziptex_polyglossia)]}
\begin{document}

\input{inclus/article#ID_ARTICLE}

\end{document}
 Ce qui une fois interprété par SPIP, produit : 
\documentclass[a4paper,12pt]{book}
\usepackage{fontspec}
\usepackage{xunicode}
\usepackage{polyglossia}
\setmainlanguage{french}
\begin{document} \input{inclus/article2} \input{inclus/article1} \end{document}
 Et puis soyions fous, ajoutons une table des matières, à la fin, avec la commande \tableofcontents : 
#HTTP_HEADER{content-type:application/x-latex}
\documentclass[a4paper,12pt]{book}
\usepackage{fontspec}
\usepackage{xunicode}
\usepackage{polyglossia}
\setmainlanguage{[(#LANG|ziptex_polyglossia)]}
\begin{document} 
\input{inclus/article#ID_ARTICLE}
 \tableofcontents
\end{document}
 {{{Étape~2, les fichiers fils}}} Préparons le squelette qui va engendrer les fichiers inclus/articlexxx.tex. Appelons ce squelette article.tex. 
#HTTP_HEADER{content-type:application/x-latex}

\chapter{[(#TITRE*|propre_latex)]} [(#DATE|affdate|propre_latex)] [(#CHAPO*|propre_latex)] [(#TEXTE*|propre_latex)] [(#NOM*|propre_latex)

 Analysons : -* Ligne 1, le même #HTTP_HEADER que précédemment, vu que je veux à nouveau produire un fichier .tex
-* Ligne 2 et 12, boucle ARTICLES classique.
-* Ligne 3, mettre le titre dans la commande LaTeX \chapter{}.
-* Ligne 5, mettre la date.
-* Ligne 7, mettre le chapeau.
-* Ligne 9, mettre le texte.
-* Ligne 11, mettre les auteurs. On remarque les lignes vides : rappelons qu'en LaTeX, les lignes vides produisent des changements de paragraphes. Toutes les balises SPIP qui retournent du texte sont présentés de la manière suivante :
[(#BALISE*|propre_latex)] Rappelons une règle de fonctionnement de SPIP : le contenu de chaque champ de type texte est filtré automatiquement par le filtre |propre, qui transforme les raccourcis SPIP en code HTML. En revanche, si on écrit #BALISE*, |propre n'est pas appelé : on obtient alors le contenu du champ, de manière brute[[À l'exception des sécurités vis-à-vis des codes javascripts et PHP.]]. C'est ce contenu brut qui est passé dans le filtre |propre_latex du plugin latexwheel. Ce filtre transforme les raccourcis SPIP en code LaTeX. Au final, si je me rend sur la page http://site/?page=article.tex&id_article=1, j'obtiens :  \chapter{De l'influence de LaTeX sur la sexualité humaine} 28 décembre 2011 Si selon le mot, peut-être apocryphe, de Freud, « tout est sexe », alors LaTeX a une influence sur la sexualité humaine. Qu'en est-il ? On pourrait montrer trois influences de LaTeX en matière de sexualité humaine : \begin{enumerate}
\item En tant que le LaTeX est généralement le principal composant des préservatifs.
\item Dans certaines pratiques sexuelles avec certains vêtements.
\item Dans la constitution de groupes d'utilisateurs de LaTeX, pouvant constituer des lieux de rencontres.
\end{enumerate} Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum. auteur
 {{{Étape~3 : générer automatiquement les fichiers .tex fils}}} L'étape suivante consiste à dire au squelette livre.tex.html de générer automatiquement, lorsqu'il est appelé, les fichiers .tex fils, comme article1.tex et article2.tex. Pour ce faire, on utilise le filtre |ziptex_creer_tex du plugin ziptex. Ce filtre s'applique sur le nom du squelette à interpréter, sans le .html final. Il reçoit comme premier argument le chemin du fichier à produire, à l'intérieur du dossier local/ziptex, et comme second argument un tableau d'arguments à passer lors de l'appel au squelette. Dans notre cas, nous souhaitons interpréter le squelette article.tex.html, pour produire un fichier inclus/articlexxx.tex, en passant à chaque fois au squelette l'id_article nous intéressant. Nous allons donc insérer dans le fichier livre.tex.html, après \input{inclus/article#ID_ARTICLE} la ligne suivante : 
[(#VAL{article.tex}||ziptex_creer_tex{inclus/article#ID_ARTICLE.tex,#ARRAY{id_article,#ID_ARTICLE}})]
 Par ailleurs, comme nous souhaitons créer un sous-dossier (inclus), il nous faut dire de générer le sous-dossier le cas échéant. Pour ce faire, on utilise la ligne suivante : 
[(#ARRAY{0,inclus}|ziptex_dir)]
 qu'on met dans le squelette livre.tex.html, en dehors de la boucle. Au final, on obtient : 
#HTTP_HEADER{content-type:application/x-latex}
[(#ARRAY{0,inclus}|ziptex_dir)]
\documentclass[a4paper,12pt]{book}
\usepackage{fontspec}
\usepackage{xunicode}
\usepackage{polyglossia}
\setmainlanguage{[(#LANG|ziptex_polyglossia)]}
\begin{document}

\input{inclus/article#ID_ARTICLE}
[(#VAL{article.tex}|ziptex_creer_tex{inclus/article#ID_ARTICLE.tex,#ARRAY{id_article,#ID_ARTICLE}})]

\tableofcontents
\end{document}
 Désormais, en allant sur http://site.com/?page=livre&id_rubrique=1, non seulement SPIP nous retourne un fichier LaTeX, mais en plus il produit les fichiers inclus/article1.tex et inclus/article2.tex dans le dossier local/ziptex

. {{{Étape~4 Fabriquer un zip contenant tout les fichiers .tex}}} Il va maintenant falloir produire un zip contenant tout les .tex nécéssaires à la production du livre. Pour ce faire, nous allons créer un squelette livre.html, qui nous retournera l'adresse du Zip. Pour que ce zip soit généré, on va appeler le filtre |ziptex_zipper. Ce filtre zipper le dossier local/ziptex et retourne l'url du Zip. Mais avant de zipper, le filtre peut ajouter du contenu dans le dossier local/ziptex. Pour ce faire, il reçoit un tableau (au sens PHP) dont la structure est la suivante : -* 0. Un tableau contenant les .tex direct, c'est à dire sans code SPIP dedans, avec à chaque fois : -** 0. Chemin du fichier .tex dans l'arborescence SPIP -** 1. Chemin du fichier .tex dans le future ZIP -* 1. Un tableau contenant les squelettes qui généreront du latex avec à chaque fois : -** 0. Chemin du squelette, sans le .html -** 1. Chemin du .tex correspondant, avec le .tex -** 2. Option du squelette Dans notre cas, l'entrée 0 doit être vide. En revanche l'entrée 1 contiendra elle même une seule entrée, correspondant à la transformation du squelette livre.tex.html en fichier livre.tex. On passera la rubrique courante comme argument. Nous allons mettre ce tableau dans un #GET, [à l'aide la balise #ARRAY->http://www.spip.net/fr_article4009.html]. Puis nous allons appeler sur ce tableau le filtre ziptex_zipper. Ce qui donne :


#SET{tableau,#ARRAY{ 0,#ARRAY{}, 1,#ARRAY{ 0,#ARRAY{ 0,livre.tex, 1,livre.tex, 2,#ARRAY{id_rubrique,#ID_RUBRIQUE} } } } }
Le zip

Si je me rend sur http://site.com/?page=livre&id_rubrique=1, j'obtiens un liens vers le zip contenant les fichiers .tex. Si on compile deux fois ce fichier, avec XeLaTeX, on obient alors le PDF joint. {{{Conclusion}}} Cet article vous présente les base pour transformer du SPIP en LaTeX. Vous pouvez trouver ci joint le squelette complet de ce tutoriel. Il faut ensuite évidemment connaître LaTeX pour gérer la présentation. En outre, si nos textes sont plus complexes (liens, code, etc.) il faut appeler d'autres packages, ajouter des codes. On se reportera aux deux articles de références : -* [->4051] -* [->4052]

Fabriquer les .tex puis le .PDF

Maïeul — 2012-01-17T16:54:09Z

Maintenant que votre livre est rédigé en version web grâce au squelette documentation, il s'agit de produire le PDF, pour ensuite l'imprimer.

Ceci se passe en deux étapes :
- générer un ensemble de fichiers .tex
- passer ces fichiers dans le « compilateur » LaTeX pour produire le PDF.

Faire une copie locale

La génération de l'ensemble des fichiers .tex est assez energivore. En effet il faut dans une même action :
- convertir les raccourcis SPIP en code LaTeX
- créer l'ensemble des fichiers .tex depuis la base de donnée.
- les mettre en ZIP.

Pour cette raison, nous recommandons lors du passage en .tex de faire une copie locale du site.

Pour ce faire, on se reportera à l'un des tutoriels suivant :
- Pour Mac
- Pour Windows

Une fois l'installation locale faite, il faut bien sûr récupérer le contenu de la base de donnée pour la copier en local. Ainsi que les éventuelles images du dossier IMG.

Générer les `.tex`

Pour générér les .tex, il faudra installer :
- le plugin latexwheel, qui permet de convertir les raccourcis SPIP en code LaTeX.
- le plugin ziptex qui permet d'assembler un ensemble de fichiers .tex en un zip. Ce plugin nécéssite le plugin Zippeur.
- le jeu de squelettes documentation2latex qui proposent des squelettes produisants des fichiers .tex correspondants au squelette documentations.

Une fois cela fait, on se rendra sur la page adressedusiteenlocal/?page=generer-zip.

L'ordinateur va ramer un peu pour générer les zips. Donc c'est normal que la page ne s'affiche pas tout de suite. Mais après, une fois que la page s'affiche, il suffit de cliquer sur le liens pour récuperer le zip.

Fabriquer le fichier `PDF` à partir des fichiers `.tex`

- Il faut disposer d'une installation LaTeX.

Sous Windows : http://miktex.org/
Sous Mac : https://www.tug.org/mactex/
Sous Linux : https://www.tug.org/texlive/

- En outre

Si on utilise colorationcode ou si on cite du code, il faut installer pygments : http://pygments.org/docs/installation/. Il faut du coup faire un peu de ligne de commande.
Si dans ce code coloré, il y a du code SPIP, il faut installer la coloration syntaxique pour SPIP dans Pygments.

La démarche varie selon que l'on utilise la coloration syntaxique ou non :
- Si on n'utilise pas la coloration syntaxique, on peut utiliser une interface graphique pour compiler. Il faut ouvrir le fichier documentation.tex du dossier contenu dans le zip avec le logiciel TeXWorks. Dans le menu déroulant en haut de la fenêtre, choisir XeLaTeX puis cliquer sur le bouton vert.

Une première compilation (= transformation du .tex en .pdf se lance. Une fois achevée, il faut cliquer une deuxième fois sur le bouton vert. Puis une troisième fois, pour s'assurer que le sommaire soit correcte. Une fois cela fait, on trouve le .pdf à côté du fichier .tex
- Si on utilise la coloration syntaxique, on doit utiliser la ligne de commande. Il faut alors se rendre dans le dossier du zip décompressé. Puis il faut frapper latexmk. Lorsque l'exécution est terminée (cela peut prendre plus ou moins de temps), on trouve le fichier .pdf à côté du fichier .tex.

Et si cela ne marche pas ?

- Vérifier que tout les raccourcis SPIP sont bien appareillés.
- M'écrire en me fournissant les fichiers .tex, pour que je puisse voir où est le problème (ou alors connaître LaTeX). C'est encore expérimental ! Me dire aussi le système sous lequel le fichier se fabrique.

Maintenant que votre livre est rédigé en version web grâce au [squelette documentation->4039], il s'agit de produire le PDF, pour ensuite l'imprimer. Ceci se passe en deux étapes : - générer un ensemble de fichiers .tex - passer ces fichiers dans le « compilateur » LaTeX pour produire le PDF.

{{{Faire une copie locale}}} La génération de l'ensemble des fichiers .tex est assez energivore. En effet il faut dans une même action : - convertir les raccourcis SPIP en code LaTeX - créer l'ensemble des fichiers .tex depuis la base de donnée. - les mettre en ZIP. Pour cette raison, nous recommandons lors du passage en .tex de faire une copie locale du site. Pour ce faire, on se reportera à l'un des tutoriels suivant : - [Pour Mac->2606] - [Pour Windows->http://www.generationcyb.net/Installer-SPIP-en-local-avec,1566] Une fois l'installation locale faite, il faut bien sûr récupérer le contenu de la base de donnée pour la copier en local. Ainsi que les éventuelles images du dossier IMG. {{{Générer les .tex}}} Pour générér les .tex, il faudra installer : - le plugin {{latexwheel}}, qui permet de convertir les raccourcis SPIP en code LaTeX. - le plugin {{ziptex}} qui permet d'assembler un ensemble de fichiers .tex en un zip. Ce plugin nécéssite le plugin [Zippeur->3576]. - le jeu de squelettes {{documentation2latex}} qui proposent des squelettes produisants des fichiers .tex correspondants au squelette documentations. Une fois cela fait, on se rendra sur la page adressedusiteenlocal/?page=generer-zip. L'ordinateur va ramer un peu pour générer les zips. Donc c'est normal que la page ne s'affiche pas tout de suite. Mais après, une fois que la page s'affiche, il suffit de cliquer sur le liens pour récuperer le zip. {{{Fabriquer le fichier PDF à partir des fichiers .tex}}} - Il faut disposer d'une installation LaTeX. -* Sous Windows : http://miktex.org/ -* Sous Mac : https://www.tug.org/mactex/ -* Sous Linux : https://www.tug.org/texlive/ - En outre -* Si on utilise colorationcode ou si on cite du code, il faut installer pygments : http://pygments.org/docs/installation/. Il faut du coup faire un peu de ligne de commande. -* Si dans ce code coloré, il y a du code SPIP, il faut [installer la coloration syntaxique pour SPIP dans Pygments->4053]. La démarche varie selon que l'on utilise la coloration syntaxique ou non : - Si on n'utilise pas la coloration syntaxique, on peut utiliser une interface graphique pour compiler. Il faut ouvrir le fichier documentation.tex du dossier contenu dans le zip avec le logiciel TeXWorks. Dans le menu déroulant en haut de la fenêtre, choisir XeLaTeX puis cliquer sur le bouton vert. Une première compilation (= transformation du .tex en .pdf se lance. Une fois achevée, il faut cliquer une deuxième fois sur le bouton vert. Puis une troisième fois, pour s'assurer que le sommaire soit correcte. Une fois cela fait, on trouve le .pdf à côté du fichier .tex - Si on utilise la coloration syntaxique, on doit utiliser la ligne de commande. Il faut alors se rendre dans le dossier du zip décompressé. Puis il faut frapper latexmk. Lorsque l'exécution est terminée (cela peut prendre plus ou moins de temps), on trouve le fichier .pdf à côté du fichier .tex. {{{Et si cela ne marche pas ?}}} - Vérifier que tout les raccourcis SPIP sont bien appareillés. - M'écrire en me fournissant les fichiers .tex, pour que je puisse voir où est le problème (ou alors connaître LaTeX). C'est encore expérimental ! Me dire aussi le système sous lequel le fichier se fabrique.

Utiliser le squelette « Documentation » pour rédiger un livre

Maïeul — 2012-01-17T16:54:06Z

La manière la plus simple pour se lancer dans le projet « un livre avec SPIP » est d'utiliser le squelette documentation pour SPIP 3.

Ce squelette est celui utilisé par le site de Marcimat Programmer avec SPIP, mais porté sur SPIP 3.

Dans cet article, j'explique comment installer et l'utiliser de manière à optimiser l'export en .tex.

Installation

Le squelette est distribué sous forme de plugin. Il s'installe comme n'importe quel plugin.

Toutefois il nécessite d'avoir SPIP 3 beta2.

En outre il a besoin des plugins :
- ZPIP 1.7.x
- Critères precedent et suivant
- Saisie
- Champ extra 3

Utilisation

Arborescence

Puisque le but est d'utiliser le squelette pour ensuite fabriquer un .tex pour l'impression, il est bon de savoir comment est organisé la hiérachie des titres dans un fichier LaTeX. Par défaut, tout les titres sont numérotés automatiquement. Voici les différents niveaux de titre, du plus important au plus faible.

Nom de titre	Code LaTeX	Spécificité lors de la conversion en PDF
Partie	`\part`	Le titre est sur une page de droite dédiée.
Chapitre	`\chapter`	Un chapitre commence en haut de page, sur une page de droite.
Section	`\section`	Une section provoque un changement de paragraphe.
Sous-section	`\subsection`	Une sous-section provoque un changement de paragraphe

Il existe également les niveaux \subsubsection, \paragraph et \subparagraph, mais ces nivaux ne sont pas utilisés lors de la génération des fichiers .tex par SPIP.

À ces niveaux de titre LaTeX correspondent des nivaux dans la hiérachie des rubriques.

- Le premier niveau (secteur) correspond à un livre entier. Un secteur correspondant à une langue.
- Le second niveau correspond à un partie au sens LaTeX (\part). Exemple de rubrique de niveau \part : http://programmer.spip.org/-Ecriture-des-squelettes-.
- Le troisième niveau correspond à un chapitre au sens LaTeX (\chapter) http://programmer.spip.org/-Les-boucles-.
- Un article correspond à une section au sens LaTeX (\section) http://programmer.spip.org/Syntaxe-des-boucles.
- Les raccourcis {{{…}}} provoquent des sous-sections. (\subsection).

Contenu des articles En plus du classique champs titre et texte, chaque article peut avoir un exemple, un exercice et une réponse à l'exercice. Le champ PS est également utilisé.

Lors de l'export en .tex, les trois champs supplémentaires (exemple, exercice, réponse) seront encadrés d'un code signalant qu'il faudra les mettre dans un cadre gris dans le PDF final.

Les champs exemple, exercice, réponse et PS seront précédés d'intertitres.

Ordre des rubriques / articles

Il est possible de ne pas écrire les rubriques / articles dans leur ordre logiques. Pour déterminer l'ordre des rubriques / articles, il suffit de faire précéder les titres d'un nombre, suivi d'un point, suivi d'un espace :

1. Rubrique qui apparaîtra en premier

Raccourcis typographique

On peut utiliser l'ensemble des raccourcis typographique de SPIP. Si on cite du code, il faut utiliser le plugin coloration code.

Un code entre aura ses lignes numérotées, pas un code entre .

 Par ailleurs, le module LaTeX de gestion du code sources colorés n'est pas capable de couper automatiquement les lignes trop longues : il faut donc les limiter directement au sein des balises  ou  (60 caractères approximativement, si vous gardez les réglage de format de papier et de marge standard).

Production du PDF
La production du PDF est détaillé dans un autre article.


		
La manière la plus simple pour se lancer dans le projet « un livre avec SPIP » est d'utiliser le squelette documentation pour SPIP 3. Ce squelette est celui utilisé par le site de Marcimat [Programmer avec SPIP->http://programmer.spip.org/], mais porté sur SPIP 3. Dans cet article, j'explique comment installer et l'utiliser de manière à optimiser l'export en .tex.

		{{{Installation}}} Le squelette est distribué sous forme de plugin. [Il s'installe comme n'importe quel plugin->http://www.spip.net/fr_article3396.html]. Toutefois il nécessite d'avoir [SPIP 3 beta2->http://spip-blog.net/SPIP-3-beta-2.html]. En outre il a besoin des plugins : - [ZPIP 1.7.x->3256] - [Critères precedent et suivant->3551] - [Saisie->3364] - [Champ extra 3->4028] {{{Utilisation}}} {{Arborescence}} Puisque le but est d'utiliser le squelette pour ensuite fabriquer un .tex pour l'impression, il est bon de savoir comment est organisé la hiérachie des titres dans un fichier LaTeX. Par défaut, tout les titres sont numérotés automatiquement. Voici les différents niveaux de titre, du plus important au plus faible. |{{Nom de titre}}|{{Code LaTeX}}|{{Spécificité lors de la conversion en PDF}}| |Partie|\part|Le titre est sur une page de droite dédiée.| |Chapitre|\chapter|Un chapitre commence en haut de page, sur une page de droite.| |Section|\section|Une section provoque un changement de paragraphe.| |Sous-section|\subsection|Une sous-section provoque un changement de paragraphe| Il existe également les niveaux \subsubsection, \paragraph et \subparagraph, mais ces nivaux ne sont pas utilisés lors de la génération des fichiers .tex par SPIP. À ces niveaux de titre LaTeX correspondent des nivaux dans la hiérachie des rubriques. - Le premier niveau (secteur) correspond à un livre entier. Un secteur correspondant à une langue. - Le second niveau correspond à un partie au sens LaTeX (\part). Exemple de rubrique de niveau \part : http://programmer.spip.org/-Ecriture-des-squelettes-. - Le troisième niveau correspond à un chapitre au sens LaTeX (\chapter) http://programmer.spip.org/-Les-boucles-. - Un article correspond à une section au sens LaTeX (\section) http://programmer.spip.org/Syntaxe-des-boucles. - Les raccourcis {{{…}}} provoquent des sous-sections. (\subsection). {{Contenu des articles}} En plus du classique champs titre et texte, chaque article peut avoir un exemple, un exercice et une réponse à l'exercice. Le champ PS est également utilisé. Lors de l'export en .tex, les trois champs supplémentaires (exemple, exercice, réponse) seront encadrés d'un code signalant qu'il faudra les mettre dans un cadre gris dans le PDF final. Les champs exemple, exercice, réponse et PS seront précédés d'intertitres. {{Ordre des rubriques / articles}} Il est possible de ne pas écrire les rubriques / articles dans leur ordre logiques. Pour déterminer l'ordre des rubriques / articles, il suffit de faire précéder les titres d'un nombre, suivi d'un point, suivi d'un espace : 1. Rubrique qui apparaîtra en premier {{{Raccourcis typographique}}} On peut utiliser l'ensemble des raccourcis typographique de SPIP. Si on cite du code, il faut utiliser le plugin [coloration code->2938]. Un code entre  aura ses lignes numérotées, pas un code entre . Par ailleurs, le module LaTeX de gestion du code sources colorés n'est pas capable de couper automatiquement les lignes trop longues : il faut donc les limiter directement au sein des balises  ou  (60 caractères approximativement, si vous gardez les réglage de format de papier et de marge standard). {{{Production du PDF}}} [La production du PDF est détaillé dans un autre article->4041].



Introduction à la création d'un livre
Maïeul — 2012-01-17T16:53:55Z

		Pour produire un livre avec SPIP, on peut produire un PDF. Une des solutions est d'utiliser LaTeX. C'est celle que nous avons choisie.
		SPIP et LaTeX
SPIP permet de produire n'importe quel fichier de type text. En général, il produit des fichiers HTML. Mais avec le language de boucle de SPIP, on peut aussi produire des javascript, des css, etc.
 L'idée d'un livre avec SPIP est la suivante : produire tantôt du HTML, pour une consultation avec un navigateur, tantôt des fichiers .tex.
 Ces fichiers sont des fichiers LaTeX. À partir d'un ensemble de fichiers LaTeX, il est possible en utilisant le compilateur LaTeX [1] de produire un fichier PDF. C'est ce fichier qui devra être envoyé à l'impression.
 L'avantage d'utiliser LaTeX est :

- utiliser un logiciel libre plutôt que PrinceXml (qui permet de convertir du HTML en PDF, mais qui est propriétaire)

- utiliser un logiciel réputé pour ses grandes qualités typographiques (réputation qui n'est pas volée).
 Au final, on peut résumer ainsi le processus de production d'un livre avec SPIP.


Schéma de production d'un livre avec SPIP

Pour ce projet, nous n'utilisons pas LaTeX, mais XeLaTeX qui est une variante de LaTeX ayant une gestion plus correcte de l'encodage Unicode [2].
Une structure de livre flexible
De même que SPIP peut produire n'importe quelle structure de page HTML, il peut produire n'importe quelle structure de fichier .tex.
 C'est pourquoi le système est divisé en deux plugins :

- LaTeXWheel qui permet à SPIP de transformer ses raccourcis typographiques ({,-* etc.) en code LaTeX.

- ZipTeX qui permet d'assembler en un seul ZIP une série de fichier .tex. En effet, il est possible de créer des sous-fichiers LaTeX, un peu comme on crée des sous-squelettes avec . Par conséquent, on demandera à SPIP de produire un zip contenant un ensemble de fichier .tex, plutôt qu'un seul fichier .tex de grande taille.
 Un squelette correspondant à la structure du site http://programmer.spip.org a été concu. Il propose ainsi une structure possible. Il s'appuie sur ces deux plugins.
Comment aborder ce projet « Un livre avec SPIP »
Cette documentation se divise en deux :
 - Une documentation pour les personnes ne connaissant ni LaTeX ni le mécanisme des boucles de SPIP. Cette documentation se subdivise en deux :
 Installer le squelette Documentation (celui de http://programmer.spip.org) et s'en servir pour faire un livre.
 Exporter le contenu du livre en LaTeX, puis le convertir en PDF (A4).
- Une documentation, encore à écrire, pour les personnes souhaitant personnaliser leur livre, ce qui nécéssite de connaître :
 Le système de squelettes de SPIP.
 Les bases de LaTeX. Pour les apprendre on pourra utiliser le wikibook sur LaTeX, en attendant que l'auteur sorte son propre livre.
Cette documentation se décompose en plusieurs parties :
 Tutoriel : produire sa propre structure de livre
 Référence de LaTeXWheel
 Référence de ZipTeX
		
		
[1] Voir l'article de Wikipédia pour plus de détails sur ce qu'est LaTeX.

[2] Sur les histoires d'encodage, voir le mémorable article sur la tour de Babel du net.

		
Pour produire un livre avec SPIP, on peut produire un PDF. Une des solutions est d'utiliser LaTeX. C'est celle que nous avons choisie.

		{{{SPIP et LaTeX}}} SPIP permet de produire n'importe quel fichier de type text. En général, il produit des fichiers HTML. Mais avec le language de boucle de SPIP, on peut aussi produire des javascript, des css, etc. L'idée d'un livre avec SPIP est la suivante : produire tantôt du HTML, pour une consultation avec un navigateur, tantôt des fichiers .tex. Ces fichiers sont des fichiers LaTeX. À partir d'un ensemble de fichiers LaTeX, il est possible en utilisant le compilateur LaTeX[[Voir l'article de Wikipédia pour plus de détails sur ce qu'est [?LaTeX].]] de produire un fichier PDF. C'est ce fichier qui devra être envoyé à l'impression. L'avantage d'utiliser LaTeX est :
- utiliser un logiciel libre plutôt que PrinceXml (qui permet de convertir du HTML en PDF, mais qui est propriétaire)
- utiliser un logiciel réputé pour ses grandes qualités typographiques (réputation qui n'est pas volée). Au final, on peut résumer ainsi le processus de production d'un livre avec SPIP.  Pour ce projet, nous n'utilisons pas LaTeX, mais XeLaTeX qui est une variante de LaTeX ayant une gestion plus correcte de l'encodage Unicode[[Sur les histoires d'encodage, voir [le mémorable article sur la tour de Babel du net->http://www.uzine.net/article1785.html].]]. {{{Une structure de livre flexible}}} De même que SPIP peut produire n'importe quelle structure de page HTML, il peut produire n'importe quelle structure de fichier .tex. C'est pourquoi le système est divisé en deux plugins :
- LaTeXWheel qui permet à SPIP de transformer ses raccourcis typographiques ({,-* etc.) en code LaTeX.
- ZipTeX qui permet d'assembler en un seul ZIP une série de fichier .tex. En effet, il est possible de créer des sous-fichiers LaTeX, un peu comme on crée des sous-squelettes avec . Par conséquent, on demandera à SPIP de produire un zip contenant un ensemble de fichier .tex, plutôt qu'un seul fichier .tex de grande taille. Un squelette correspondant à la structure du site http://programmer.spip.org a été concu. Il propose ainsi une structure possible. Il s'appuie sur ces deux plugins. {{{Comment aborder ce projet « Un livre avec SPIP »}}} Cette documentation se divise en deux : - Une documentation pour les personnes ne connaissant ni LaTeX ni le mécanisme des boucles de SPIP. Cette documentation se subdivise en deux :
-* Installer le squelette Documentation (celui de http://programmer.spip.org) et [s'en servir pour faire un livre->4039].
-* [Exporter le contenu du livre en LaTeX, puis le convertir en PDF (A4)->4041]. - Une documentation, encore à écrire, pour les personnes souhaitant personnaliser leur livre, ce qui nécéssite de connaître :
-* [Le système de squelettes de SPIP->http://programmer.spip.org/-Ecriture-des-squelettes].
-* Les bases de LaTeX. Pour les apprendre on pourra utiliser le [wikibook sur LaTeX->https://fr.wikibooks.org/wiki/LaTeX], en attendant que l'auteur sorte son propre livre. Cette documentation se décompose en plusieurs parties :
-* [->4045]
-* [->4051]
-* [->4052]



Mettre son site en grève
Maïeul — 2012-01-16T17:00:00Z

		La grève des sites web est un moyen qui se développe de plus en plus pour protester contre certains projets de lois menaçant les libertés numériques, par exemple contre le projet SOPA.
 Cela consiste à empêcher l'accès au contenu d'un site pendant un temps donné, en mettant à la place un texte explicatif.
 Le plugin En grève permet de programmer automatiquement la mise en grève de son site, entre deux moments.
		Installation
 Il s'installe comme n'importe quel plugin.
 Il nécessite le plugin saisie.
 Sous SPIP 2.1 il nécessite aussi le plugin spip-bonux.
Utilisation
Une fois le plugin correctement installé, les webmestres peuvent ajouter des grèves sur le site.
 Pour ce faire, il faut se rendre dans :

- Navigation -> Grèves sous SPIP 2.1

- Édition -> Grèves sous SPIP 2.1 avec le nouveau bandeau ou sous SPIP 3.
 Puis cliquer sur « Créer une nouvelle grève ».
 Dans le formulaire qui apparaît, mettre un titre à la grève, un texte explicatif (on peut utiliser les raccourcis SPIP), une date de début et une date de fin.
Fonctionnement
Entre la date de début de la grève et la date de fin, il n'est plus possible de consulter quoique ce soit sur le site : les pages sont automatiquement redirigées vers le squelette greve.html.
 La seule exception est la page login, pour permettre aux jaunes [1] de travailler le temps de la grève.
 À noter que les heures correspondent au fuseau horaire du serveur.
À faire
- Permettre de supprimer les vieilles grèves.

- Permettre de mettre un logo. En attendant, on peut mettre une image insérée via un raccourci classique .

- Configuration avancée ?
		
		
[1] Dans le vocabulaire ouvrier, un « jaune » est un traître à la cause, un briseur de grève. Voir https://fr.wikipedia.org/wiki/Syndicalisme_jaune.

		Le logo est de Gerd Arnzt.
La grève des sites web est un moyen qui se développe de plus en plus pour protester contre certains projets de lois menaçant les libertés numériques, [par exemple contre le projet SOPA->https://www.revoltenumerique.herbesfolles.org/2012/01/15/contre-la-censure-dinternet-rejoignons-le-blackout-du-web-le-1801/]. Cela consiste à empêcher l'accès au contenu d'un site pendant un temps donné, en mettant à la place un texte explicatif. Le plugin {{En grève}} permet de programmer automatiquement la mise en grève de son site, entre deux moments. 

		{{Installation}} Il s'installe [comme n'importe quel plugin->http://www.spip.net/fr_article3396.html]. [Il nécessite le plugin saisie->3364]. Sous SPIP 2.1 il [nécessite aussi le plugin spip-bonux->2857]. {{{Utilisation}}} Une fois le plugin correctement installé, les webmestres peuvent ajouter des grèves sur le site. Pour ce faire, il faut se rendre dans : - Navigation -> Grèves sous SPIP 2.1 - Édition -> Grèves sous SPIP 2.1 [avec le nouveau bandeau->3556] ou sous SPIP 3. Puis cliquer sur « Créer une nouvelle grève ». Dans le formulaire qui apparaît, mettre un titre à la grève, un texte explicatif (on peut utiliser les raccourcis SPIP), une date de début et une date de fin. {{{Fonctionnement}}} Entre la date de début de la grève et la date de fin, il n'est plus possible de consulter quoique ce soit sur le site : les pages sont automatiquement redirigées vers le squelette greve.html. La seule exception est la page login, pour permettre aux jaunes[[Dans le vocabulaire ouvrier, un « jaune » est un traître à la cause, un briseur de grève. Voir https://fr.wikipedia.org/wiki/Syndicalisme_jaune.]] de travailler le temps de la grève. À noter que les heures correspondent au fuseau horaire du serveur. {{{À faire}}} - Permettre de supprimer les vieilles grèves. - Permettre de mettre un logo. En attendant, on peut mettre une image insérée via un raccourci classique . - Configuration avancée ?

		[Le logo est de Gerd Arnzt->http://www.gerdarntz.org/content/gmdh0200102].



GIS 3 - intégration de cartes KML
Matthieu Marcillaud — 2012-01-16T15:49:35Z

		J'ai eu aujourd'hui à intégrer une carte KML de 4 départements d'une région. Nous allons décrire ici comment cela se passe avec GIS 3 pour SPIP 3.
		Nous décrivons ici l'ajout de calques KML superposés à une carte.
 Voici le résultat : chaque département du Poitou-Charentes est surligné légèrement par une couleur jaune pale, en partie transparente et avec un contour marron.
 
 Tout d'abord, il nous faut les fichiers KML. Si vous n'en avez pas, vous pouvez par exemple en choisir sur le site http://www.gitesdegaule.fr/KaraMeLise/choixcouleur.php qui vous donnera un zip avec un fichier KML par département français. C'est approximatif [1] mais c'est mieux que rien. Il doit certainement y avoir d'autres sources pour ce genre de KML quelque part. Et n'hésitez pas à poster vos sources dans les commentaires de l'article !
 Les KML récupérés sont placés quelque part dans un dossier de votre plugin ou du répertoire squelettes. Pour ma part, c'était dans un répertoire « kml » (original non ?)
 Ensuite il reste plus qu'à demander l'appel de ces KML en même temps que la carte.
Voici comment j'ai procédé pour afficher les points des articles d'une rubrique :
[(#INCLURE{fond=modeles/carte_gis,
 objets=articles,
 id_rubrique=#ID_RUBRIQUE,
 zoom=#CONFIG{gis/zoom},
 lat=#CONFIG{gis/lat},
 lon=#CONFIG{gis/lon},
 controle_type=non,
 kml=[(#LISTE{
 [(#CHEMIN{kml/16.kml}|timestamp|url_absolue)],
 [(#CHEMIN{kml/17.kml}|timestamp|url_absolue)],
 [(#CHEMIN{kml/86.kml}|timestamp|url_absolue)],
 [(#CHEMIN{kml/79.kml}|timestamp|url_absolue)]})]})]
 Télécharger
Par rapport à une utilisation habituelle de GIS, ce qui change est la présence de l'option kml.
 Cette option accepte une ou plusieurs entrées et types d'entrées :
 un unique élément ou un tableau comme ici, créé avec #LISTE
 pour chaque élément, un identifiant ou une url absolue. Un identifiant correspond à un numéro de document (id_document), document qui est alors un fichier KML donc, sinon ça n'a pas d'intérêt !
 Un fichier en url absolue, comme l'exemple, pointe sur un kml. On remarque ici la présence du filtre |timestamp, qui permet de donner un identifiant à l'URL en fonction de la date de mise à jour du fichier sur le serveur, parce que sinon, Google (ou les autres API de carte) met en cache votre fichier (1 cache pour 1 URL) et en phase de test c'est très ennuyant car changer le fichier kml sans changer son nom ne modifie alors pas la carte générée... pas pratique. Donc, en résumé, vive |timestamp !
Notes sur GIS 2, SPIP 2.1 et les KML
GIS 2 pour SPIP 2.1 accèpte aussi des kml, avec la limitation de ne pouvoir en mettre qu'un seul, c'est à dire que l'option kml n'accepte pas d'entrée tableau (du moins à l'heure où j'écris).
 Par ailleurs pour #LISTE en SPIP 2.1, utilisez le plugin « Itérateurs », sinon utilisez #ARRAY, mais la question ne se pose pas trop pour GIS 2, puisqu'il ne prend pas de tableau :)
 Voilà, je crois que tout est dit !
 Bonne utilisation de KML avec GIS :)
		
		
[1] Par exemple la Charente Maritime n'a pas l'île de Ré et l'île d'Oléron

		Pour ceux qui cherchent les icônes de marqueurs, elles ont été prises ici : http://mapicons.nicolasmollet.com/ , une vraie mine pour l'iconographie de cartographie.
J'ai eu aujourd'hui à intégrer une carte KML de 4 départements d'une région. Nous allons décrire ici comment cela se passe avec GIS 3 pour SPIP 3. 

		Nous décrivons ici l'ajout de calques KML superposés à une carte. Voici le résultat : chaque département du Poitou-Charentes est surligné légèrement par une couleur jaune pale, en partie transparente et avec un contour marron.  Tout d'abord, il nous faut les fichiers KML. Si vous n'en avez pas, vous pouvez par exemple en choisir sur le site http://www.gitesdegaule.fr/KaraMeLise/choixcouleur.php qui vous donnera un zip avec un fichier KML par département français. C'est approximatif[[Par exemple la Charente Maritime n'a pas l'île de Ré et l'île d'Oléron]] mais c'est mieux que rien. Il doit certainement y avoir d'autres sources pour ce genre de KML quelque part. Et n'hésitez pas à poster vos sources dans les commentaires de l'article ! Les KML récupérés sont placés quelque part dans un dossier de votre plugin ou du répertoire squelettes. Pour ma part, c'était dans un répertoire «kml» (original non ?) Ensuite il reste plus qu'à demander l'appel de ces KML en même temps que la carte. Voici comment j'ai procédé pour afficher les points des articles d'une rubrique :  [(#INCLURE{fond=modeles/carte_gis, objets=articles, id_rubrique=#ID_RUBRIQUE, zoom=#CONFIG{gis/zoom}, lat=#CONFIG{gis/lat}, lon=#CONFIG{gis/lon}, controle_type=non, kml=[(#LISTE{ [(#CHEMIN{kml/16.kml}|timestamp|url_absolue)], [(#CHEMIN{kml/17.kml}|timestamp|url_absolue)], [(#CHEMIN{kml/86.kml}|timestamp|url_absolue)], [(#CHEMIN{kml/79.kml}|timestamp|url_absolue)]})]})]  Par rapport à une utilisation habituelle de GIS, ce qui change est la présence de l'option kml. Cette option accepte une ou plusieurs entrées et types d'entrées : -* un unique élément ou un tableau comme ici, créé avec #LISTE -* pour chaque élément, un identifiant ou une url absolue. -** Un identifiant correspond à un numéro de document (id_document), document qui est alors un fichier KML donc, sinon ça n'a pas d'intérêt ! -** Un fichier en url absolue, comme l'exemple, pointe sur un kml. On remarque ici la présence du filtre |timestamp, qui permet de donner un identifiant à l'URL en fonction de la date de mise à jour du fichier sur le serveur, parce que sinon, Google (ou les autres API de carte) met en cache votre fichier (1 cache pour 1 URL) et en phase de test c'est très ennuyant car changer le fichier kml sans changer son nom ne modifie alors pas la carte générée... pas pratique. Donc, en résumé, vive |timestamp ! {{{Notes sur GIS 2, SPIP 2.1 et les KML}}} GIS 2 pour SPIP 2.1 accèpte aussi des kml, avec la limitation de ne pouvoir en mettre qu'un seul, c'est à dire que l'option kml n'accepte pas d'entrée tableau (du moins à l'heure où j'écris). Par ailleurs pour #LISTE en SPIP 2.1, utilisez le plugin «Itérateurs», sinon utilisez #ARRAY, mais la question ne se pose pas trop pour GIS 2, puisqu'il ne prend pas de tableau :) Voilà, je crois que tout est dit ! Bonne utilisation de KML avec GIS :)

		Pour ceux qui cherchent les icônes de marqueurs, elles ont été prises ici : http://mapicons.nicolasmollet.com/ , une vraie mine pour l'iconographie de cartographie. 



Boucles avec des conditions en OR (et explication des critères)
Matthieu Marcillaud — 2012-01-16T15:38:56Z
Comme vous le savez il n'est pas possible dans l'écriture des critères de boucle d'indiquer une condition OR, autrement appelé « OU logique », autrement dit d'indiquer : « trouve les éléments avec ça OU avec ça. »
 La seule possibilité [1] est de créer un critère spécifique. C'est ce que nous allons voir ici pour un cas assez simple.
		Quelqu'un est venu hier soir sur l'IRC de SPIP pour demander s'il était possible d'écrire une boucle brèves qui cherche (BREVES) {titre LIKE %#TITRE%} OU {texte LIKE %#TITRE%}, le #TITRE étant pris dans une boucle parente (une boucle ARTICLES il me semble, mais cela a peu d'importance...)
 Une solution à ce problème est de créer son propre critère, puisque SPIP fait systématiquement des ET entre ses critères (ils sont cumulatifs).
 J'annonce tout de suite que créer un critère peut être simple, mais peut aussi être très compliqué ! Par chance la demande ici est simple, et c'est pourquoi elle offre une jolie base pour un exemple.
 Nous allons donc imaginer un critère nommé « va_chercher » qui prendra un argument. Son utilisation sera : {va_chercher toto} ou encore {va_chercher #TITRE}
 Comme toute nouvelle définition (balise, filtre, critère, boucle), on mettra le code de notre critère dans un fichier de fonctions, par exemple dans squelettes/mes_fonctions.php.
Déclaration de base du critère
Voici une déclaration de la fonction PHP de notre critère. Ici il n'y a que la déclaration et aucune action encore.
function critere_va_chercher_dist($idb, &$boucles, $crit) {
 $boucle = &$boucles[$idb];
}
 Télécharger
Un critère arrive avec trois arguments :
 $idb est le nom de la boucle
 &$boucles est l'arbre de construction de toutes les boucles du squelette en question. $boucle, calculé ensuite, est celui de la boucle que le critère va modifier directement. Le & est important, il signifie en PHP que la variable est passée « par référence », autrement dit que toute modification de cette variable à l'intérieur de la fonction du critère affecte la variable à l'extérieur de l'appel. On peut aussi dire que le & permet de ne pas avoir une copie du contenu de la variable demandée, mais le contenu lui-même.
 $crit est l'arbre de construction du critère, il permet de savoir ce que contient le critère en question (nom, opérateur, négation, arguments...)
Effectuer une action
Nous allons voir comment ajouter un critère de sélection dans la boucle grâce à ce critère. Nous allons ajouter un élément dans le tableau $boucle->where.
 Notons déjà, que tous les éléments dans ce tableau where sont enchaînés par des opérateurs AND. Cependant, et c'est ce que nous verrons plus loin, un élément de ce tableau peut contenir des sous-éléments, et pour ceux-là, nous pouvons décrire précisément le type de liaison qui les affecte parmi une panoplie d'opérateurs à disposition (AND, OR, NOT, LIKE, REGEXP, >, <, =, >=, <= et je dois en oublier)
 Commençons simplement. D'une part, le $table calculé contient le nom de la table SQL concernant notre boucle. Le tableau $c contient trois éléments : Opérateur, Valeur1, Valeur2. Cela sera traduit ensuite par « Valeur1 Operateur Valeur2 » soit ici : « titre = '' ». En fonction des opérateurs, il n'y a pas obligatoirement trois éléments dans le tableau ; ainsi NOT ne compare qu'à une valeur. À la fin, le tableau $c est ajouté à where.
function critere_va_chercher_dist($idb, &$boucles, $crit) {
 $boucle = &$boucles[$idb];
 $table = $boucle->id_table;
 $c = array("'='", "'$table.titre'", "''");
 $boucle->where[] = $c;
}
 Télécharger
Comme vous le voyez, le contenu du tableau $c possède une drôle d'écriture à base de doubles guillemets tel que "'='". Il faut comprendre, qu'on est à un niveau d'abstraction un peu au dessus de celui des squelettes. On fait écrire, dans le critère, le code PHP que SPIP produira pour calculer la boucle.
 On comprendra donc que ces deux lignes ne donnent pas le même résultat
$c = array("'='", "'$table.titre'", "sql_quote('toto')");
$c = array("'='", "'$table.titre'", "'sql_quote(\'toto\')'");
 Télécharger
Cela écrira en PHP à peu près :
'spip_articles.titre' . '=' . sql_quote('toto')
'spip_articles.titre' . '=' . 'sql_quote(\'toto\')'
 Télécharger
Puis à l'execution, la rèquete SQL :
spip_articles.titre='toto'
spip_articles.titre=sql_quote('toto')
 Télécharger
La deuxième ligne créerait une erreur MySQL puisque sql_quote('toto') est une fonction PHP pour SPIP et non une fonction d'un gestionnaire de requête SQL.
 Cependant la seconde écriture peut être souhaitée si on veut utiliser une fonction SQL, tel que "MIN" ou "MAX", ou je ne sais quoi... Il faut donc bien comprendre ce qui se passe et ce que l'on souhaite obtenir :)
Ajouter la négation
La négation, c'est la présence dans le critère de NOT, représenté par le point d'exclamation (!) comme dans : {!va_chercher toto}.
 Prendre en compte la négation consiste —en général [2]— à demander l'inverse du résultat attendu, c'est à dire à encapsuler tout notre tableau $c dans un NOT avant de le donner à manger au where. Pour savoir si notre critère a une négation, on interroge $crit->not.
function critere_va_chercher_dist($idb, &$boucles, $crit) {
 $boucle = &$boucles[$idb];
 $table = $boucle->id_table;
 $c = array("'='", "'$table.titre'", "''");
 // Inversion de la condition ?
 if ($crit->not) {
 $c = array("'NOT'", $c);
 }
 $boucle->where[] = $c;
}
 Télécharger
Comme vous le voyez, $c, lorsqu'il y a une condition NOT devient un tableau d'une profondeur plus importante. C'est grâce à ce principe que nous pourrons faire un OU logique plus loin.
Récupérer un paramètre de critère
Nous allons rechercher le paramètre 'toto' ou '#TITRE' passé à notre critère via {va_chercher toto} ou {va_chercher #TITRE}. Pour cela, nous allons tester la présence de $crit->param[ n ] ou le nombre indique la présence du paramètre n (en comptant de 0), et utiliser la fonction adaptée calculer_liste.
 S'il n'y a pas de paramètre 0, nous pourrions mettre une valeur par défaut, mais nous dirons ici que c'est une erreur de squelettes pour forcer à avoir ce paramètre dans le critère. On aurait pu, aussi, en absence de paramètre récupérer automatiquement un paramètre de l'environnement ou le #TITRE de la boucle parente, mais cela n'entre pas dans l'objet de ce tutoriel. Sachez simplement que c'est possible, tout comme réaliser des jointures ou faire des calculs complexes. Vous pouvez en exemple regarder les critères de certains plugins (agenda, organiseur, tradsync, ... ) et de SPIP (ecrire/public/criteres.php)
function critere_va_chercher_dist($idb, &$boucles, $crit) {
 $boucle = &$boucles[$idb];
 $table = $boucle->id_table;
 // chercher quoi ?
 if (isset($crit->param[0])) {
 $quoi = calculer_liste($crit->param[0], array(), $boucles, $boucles[$idb]->id_parent);
 } else {
 # $quoi = "''";
 // rendons obligatoire ce parametre
 return (array('zbug_critere_necessite_parametre', array('critere' => $crit->op )));
 }
 $c = array("'='", "'$table.titre'", "$quoi");
 // Inversion de la condition ?
 if ($crit->not) {
 $c = array("'NOT'", $c);
 }
 $boucle->where[] = $c;
}
 Télécharger
 Ajouter la condition OR 
Le dernier élément, le plus simple finalement maintenant que tout est compris, est d'ajouter l'opérateur OR entre deux sélections. Nous l'obtenons avec :
 $c = array("'OR'",
 array("'LIKE'", "'$table.titre'", "sql_quote('%' . $quoi . '%')"),
 array("'LIKE'", "'$table.texte'", "sql_quote('%' . $quoi . '%')")
 );
 Télécharger
Je n'en dis pas plus. Voici le code complet :
// {va_chercher #TITRE}
function critere_va_chercher_dist($idb, &$boucles, $crit) {
 $boucle = &$boucles[$idb];
 $table = $boucle->id_table;
 $not = $crit->not;
 // chercher quoi ?
 if (isset($crit->param[0])) {
 $quoi = calculer_liste($crit->param[0], array(), $boucles, $boucles[$idb]->id_parent);
 } else {
 // rendons obligatoire ce parametre
 return (array('zbug_critere_necessite_parametre', array('critere' => $crit->op )));
 }
 $c = array("'OR'",
 array("'LIKE'", "'$table.titre'", "sql_quote('%' . $quoi . '%')"),
 array("'LIKE'", "'$table.texte'", "sql_quote('%' . $quoi . '%')")
 );
 // Inversion de la condition ?
 if ($crit->not) {
 $c = array("'NOT'", $c);
 }
 
 $boucle->where[] = $c;
}
 Télécharger
		
		
[1] hormis une sorte de contournement sur plusieurs boucles avec le critère {doublons}

[2] Ce n'est pas systématiquement vrai, notamment pour des critères complexes

		
Comme vous le savez il n'est pas possible dans l'écriture des critères de boucle d'indiquer une condition OR, autrement appelé «OU logique», autrement dit d'indiquer : «trouve les éléments avec ça OU avec ça.» La seule possibilité [[hormis une sorte de contournement sur plusieurs boucles avec le critère {doublons}]] est de créer un critère spécifique. C'est ce que nous allons voir ici pour un cas assez simple.

		Quelqu'un est venu hier soir sur l'IRC de SPIP pour demander s'il était possible d'écrire une boucle brèves qui cherche (BREVES) {titre LIKE %#TITRE%} OU {texte LIKE %#TITRE%}, le #TITRE étant pris dans une boucle parente (une boucle ARTICLES il me semble, mais cela a peu d'importance...) Une solution à ce problème est de créer son propre critère, puisque SPIP fait systématiquement des ET entre ses critères (ils sont cumulatifs). J'annonce tout de suite que créer un critère peut être simple, mais peut aussi être très compliqué ! Par chance la demande ici est simple, et c'est pourquoi elle offre une jolie base pour un exemple. Nous allons donc imaginer un critère nommé «va_chercher» qui prendra un argument. Son utilisation sera : {va_chercher toto} ou encore {va_chercher #TITRE} Comme toute nouvelle définition (balise, filtre, critère, boucle), on mettra le code de notre critère dans un fichier de fonctions, par exemple dans squelettes/mes_fonctions.php. {{{Déclaration de base du critère}}} Voici une déclaration de la fonction PHP de notre critère. Ici il n'y a que la déclaration et aucune action encore.  function critere_va_chercher_dist($idb, &$boucles, $crit) { $boucle = &$boucles[$idb]; }  Un critère arrive avec trois arguments : -* $idb est le nom de la boucle -* &$boucles est l'arbre de construction de toutes les boucles du squelette en question. $boucle, calculé ensuite, est celui de la boucle que le critère va modifier directement. Le & est important, il signifie en PHP que la variable est passée «par référence», autrement dit que toute modification de cette variable à l'intérieur de la fonction du critère affecte la variable à l'extérieur de l'appel. On peut aussi dire que le & permet de ne pas avoir une {copie} du contenu de la variable demandée, mais le contenu {lui-même}. -* $crit est l'arbre de construction du critère, il permet de savoir ce que contient le critère en question (nom, opérateur, négation, arguments...) {{{Effectuer une action}}} Nous allons voir comment ajouter un critère de sélection dans la boucle grâce à ce critère. Nous allons ajouter un élément dans le tableau $boucle->where. Notons déjà, que tous les éléments dans ce tableau where sont enchaînés par des opérateurs AND. Cependant, et c'est ce que nous verrons plus loin, un élément de ce tableau peut contenir des sous-éléments, et pour ceux-là, nous pouvons décrire précisément le type de liaison qui les affecte parmi une panoplie d'opérateurs à disposition (AND, OR, NOT, LIKE, REGEXP, >, <, =, >=, <= et je dois en oublier) Commençons simplement. D'une part, le $table calculé contient le nom de la table SQL concernant notre boucle. Le tableau $c contient trois éléments : Opérateur, Valeur1, Valeur2. Cela sera traduit ensuite par «Valeur1 Operateur Valeur2» soit ici : «titre = ''». En fonction des opérateurs, il n'y a pas obligatoirement trois éléments dans le tableau ; ainsi NOT ne compare qu'à une valeur. À la fin, le tableau $c est ajouté à where.  function critere_va_chercher_dist($idb, &$boucles, $crit) { $boucle = &$boucles[$idb]; $table = $boucle->id_table; $c = array("'='", "'$table.titre'", "''"); $boucle->where[] = $c; }  Comme vous le voyez, le contenu du tableau $c possède une drôle d'écriture à base de doubles guillemets tel que "'='". Il faut comprendre, qu'on est à un niveau d'abstraction un peu au dessus de celui des squelettes. On fait écrire, dans le critère, le code PHP que SPIP produira pour calculer la boucle. On comprendra donc que ces deux lignes ne donnent pas le même résultat  $c = array("'='", "'$table.titre'", "sql_quote('toto')"); $c = array("'='", "'$table.titre'", "'sql_quote(\'toto\')'");  Cela écrira en PHP à peu près :  'spip_articles.titre' . '=' . sql_quote('toto') 'spip_articles.titre' . '=' . 'sql_quote(\'toto\')'  Puis à l'execution, la rèquete SQL :  spip_articles.titre='toto' spip_articles.titre=sql_quote('toto')  La deuxième ligne créerait une erreur MySQL puisque sql_quote('toto') est une fonction PHP pour SPIP et non une fonction d'un gestionnaire de requête SQL. Cependant la seconde écriture peut être souhaitée si on veut utiliser une {fonction SQL}, tel que "MIN" ou "MAX", ou je ne sais quoi... Il faut donc bien comprendre ce qui se passe et ce que l'on souhaite obtenir :) {{{Ajouter la négation}}} La négation, c'est la présence dans le critère de NOT, représenté par le point d'exclamation (!) comme dans : {!va_chercher toto}. Prendre en compte la négation consiste --en général [[Ce n'est pas systématiquement vrai, notamment pour des critères complexes]]-- à demander l'inverse du résultat attendu, c'est à dire à encapsuler tout notre tableau $c dans un NOT avant de le donner à manger au where. Pour savoir si notre critère a une négation, on interroge $crit->not.  function critere_va_chercher_dist($idb, &$boucles, $crit) { $boucle = &$boucles[$idb]; $table = $boucle->id_table; $c = array("'='", "'$table.titre'", "''"); // Inversion de la condition ? if ($crit->not) { $c = array("'NOT'", $c); } $boucle->where[] = $c; }  Comme vous le voyez, $c, lorsqu'il y a une condition NOT devient un tableau d'une profondeur plus importante. C'est grâce à ce principe que nous pourrons faire un OU logique plus loin. {{{Récupérer un paramètre de critère}}} Nous allons rechercher le paramètre 'toto' ou '#TITRE' passé à notre critère via {va_chercher toto} ou {va_chercher #TITRE}. Pour cela, nous allons tester la présence de $crit->param[ n ] ou le nombre indique la présence du paramètre n (en comptant de 0), et utiliser la fonction adaptée calculer_liste. S'il n'y a pas de paramètre 0, nous pourrions mettre une valeur par défaut, mais nous dirons ici que c'est une erreur de squelettes pour forcer à avoir ce paramètre dans le critère. On aurait pu, aussi, en absence de paramètre récupérer automatiquement un paramètre de l'environnement ou le #TITRE de la boucle parente, mais cela n'entre pas dans l'objet de ce tutoriel. Sachez simplement que c'est possible, tout comme réaliser des jointures ou faire des calculs complexes. Vous pouvez en exemple regarder les critères de certains plugins (agenda, organiseur, tradsync, ... ) et de SPIP (ecrire/public/criteres.php)  function critere_va_chercher_dist($idb, &$boucles, $crit) { $boucle = &$boucles[$idb]; $table = $boucle->id_table; // chercher quoi ? if (isset($crit->param[0])) { $quoi = calculer_liste($crit->param[0], array(), $boucles, $boucles[$idb]->id_parent); } else { # $quoi = "''"; // rendons obligatoire ce parametre return (array('zbug_critere_necessite_parametre', array('critere' => $crit->op ))); } $c = array("'='", "'$table.titre'", "$quoi"); // Inversion de la condition ? if ($crit->not) { $c = array("'NOT'", $c); } $boucle->where[] = $c; }  {{{ Ajouter la condition OR }}} Le dernier élément, le plus simple finalement maintenant que tout est compris, est d'ajouter l'opérateur OR entre deux sélections. Nous l'obtenons avec :  $c = array("'OR'", array("'LIKE'", "'$table.titre'", "sql_quote('%' . $quoi . '%')"), array("'LIKE'", "'$table.texte'", "sql_quote('%' . $quoi . '%')") );  Je n'en dis pas plus. Voici le code complet :  // {va_chercher #TITRE} function critere_va_chercher_dist($idb, &$boucles, $crit) { $boucle = &$boucles[$idb]; $table = $boucle->id_table; $not = $crit->not; // chercher quoi ? if (isset($crit->param[0])) { $quoi = calculer_liste($crit->param[0], array(), $boucles, $boucles[$idb]->id_parent); } else { // rendons obligatoire ce parametre return (array('zbug_critere_necessite_parametre', array('critere' => $crit->op ))); } $c = array("'OR'", array("'LIKE'", "'$table.titre'", "sql_quote('%' . $quoi . '%')"), array("'LIKE'", "'$table.texte'", "sql_quote('%' . $quoi . '%')") ); // Inversion de la condition ? if ($crit->not) { $c = array("'NOT'", $c); } $boucle->where[] = $c; }

SPIP-Contrib

Badge pour dons

Installation et configuration

Configuration et personnalisation

Brownygreen

Présentation

Démonstration

Capture

Navigation AJAX

Configuration

Effets pré- et post-chargement

Personnalisation de la page 404 de SoyezCréateurs

Qu'est-ce qu'une page 404 ?

Apparence par défaut dans SoyezCréateurs

Personnalisation de l'image

Nouvelle version - Modération de modifications

Mon premier formulaire pas à pas : c'est Formidable !

Formidable, le générateur de formulaires

Introduction

Installation

Interface utilisateur

Appeler mon formulaire

Pré-remplir dynamiquement les champs d'un formulaire depuis un squelette

Champs oui-non et case unique

Courriels de notification

Voir aussi sur le wiki

Référence de ZipTeX

Le filtre |ziptex_zipper

Le filtre |ziptex_creer_tex

Le filtre |ziptex_dir

Le filtre |ziptex_copier_tex

Le filtre ziptex_copier_img

Le filtre ziptex_polyglossia

Référence de LaTeXWheel

Les fonctions de base

Les raccourcis qui ne demandent pas de package supplémentaire

Les liens externes

Les liens internes

Les tableaux

Le modèles

Le code

Installer la coloration syntaxique pour SPIP dans Pygments

Comment créer un environnement de travail pour développer du SPIP sur un MAC avec MAMP

I/ Installation et lancement de MAMP

II/ Structure du MAMP

III/ Réglages de l'interface

IV/ Les réglages avancés et personnalisés

V/ Mettre à jour sa version de MAMP en toute tranquillité, sans rien perdre de ses sites et de ses bases de données SQL

VI/ En cas de problèmes

Ouvrir MAMP sur l'extérieur : Vhost, routeur, Domaine et DNS

I/ Apache Serveur virtuel : Etc/hosts

II/ Configurer son modem routeur

III/ Configurer son domaine et ses zones DNS

IV/ Un domaine personnalisé pour chaque site avec la modification du fichier de configuration httpd.conf

Quelques outils pour développer du SPIP sous Mac

I/ Installer Postfix pour pouvoir envoyer des mails depuis le serveur

II/ Installer subversion sous mac pour pouvoir versionner ses projets

III/ Installer Homebrew

Tutoriel : produire sa propre structure de livre

Les différent élèments de l'API

Exemple de la structure prise

Organisation finale de notre Zip

Étape 1 : le fichier parent

Étape 2, les fichiers fils

Étape 3 : générer automatiquement les fichiers .tex fils

Étape 4 Fabriquer un zip contenant tout les fichiers .tex

Conclusion

Fabriquer les .tex puis le .PDF

Faire une copie locale

Générer les .tex

Fabriquer le fichier PDF à partir des fichiers .tex

Et si cela ne marche pas ?

Utiliser le squelette « Documentation » pour rédiger un livre

Installation

Utilisation

Raccourcis typographique

Production du PDF

Introduction à la création d'un livre

SPIP et LaTeX

Une structure de livre flexible

Le filtre `|ziptex_zipper`

Le filtre `|ziptex_creer_tex`

Le filtre `|ziptex_dir`

Le filtre `|ziptex_copier_tex`

Le filtre `ziptex_copier_img`

Le filtre `ziptex_polyglossia`

Étape 3 : générer automatiquement les fichiers `.tex` fils

Étape 4 Fabriquer un zip contenant tout les fichiers `.tex`

Générer les `.tex`

Fabriquer le fichier `PDF` à partir des fichiers `.tex`