Blanc :
... Noir :
... Résultat :
... Évènement :
... Date :
...
/ Ronde :
...
Documents
>
Parties
>
Détails
Aide-mémoire pour le rédacteur de la LMPE
Pour un résumé des fonctions, cliquez directement sur ’Aide’ dans le menu.
Introduction sur les fonctions spéciales d’édition
Avant d’exploiter les fonctions spéciales offertes par le système, vous devez vous familiariser avec la saisie de texte simples éventuellement décorés (gras, italique...) et le téléversement de documents ou de photos. Les fonctions qui sont décrites dans cette aide vont vous permettre de visualiser vos photos et d’agencer vos documents à l’intérieur de vos articles (tout document pdf ou html, grille américaine ou berger, agenda, carte...). Vous pourrez également y incorporer des informations extraites directement de sites externes, en particulier du site de la FFE (calendrier d’une équipe, résultats d’un tournoi...).
Syntaxe générale
Appel de fonction sans paramètres
Tout appel de fonction décrite dans cette aide a la syntaxe suivante, dans sa forme la plus simple c’est-à-dire sans paramètre :
- <nomfonctionXXX>
- <nomfonction|id=XXX>
- <nomfonction|> ou <nomfonction1>
Le caractère | est la barre verticale obtenue au clavier par la frappe simultanée des touches altGr et le chiffre 6 sur le clavier Windows ou bien shift alt et la lettre L sur le clavier Mac.
XXX représente représente le plus souvent un numéro de document : c’est le numéro attribué par le système après l’avoir téléversé. Il peut également représenter un numéro d’article, en général, l’article en cours d’édition ou tout autre article si l’on veut faire référence aux documents de cet autre article.
Lorsque le document ne fait référence à aucun numéro, c’est la 3ème syntaxe qui est utilisée. N’oubliez pas la barre verticale (vous pouvez la remplacer par le chiffre 1).
Par exemple :
<doc546> <img|id=352>
<lecteurhtml7723>
<agendalmpe|>
Appel de fonction avec paramètres
Lorsque l’appel de la fonction comporte des paramètres supplémentaires, la syntaxe devient :
<nomfonctionXXX|nom1=valeur1|nom2=valeur2 ... >
<nomfonction|id=XXX|nom1=valeur1|nom2=valeur2 ... >
Par exemple :
<lecteurpdf7724|hauteur=1200|largeur=800>
<affichegaffe|tournoi=26035>
Affichage d’images
Pour simplifier, il y a 5 façons d’attacher une image ou photo à un article.
La première est de la définir en tant que logo de l’article. Il est très souhaitable qu’un article possède un logo, d’autant plus que seuls les articles avec logo pourront bénéficier de la présentation défilante (slider) en page d’accueil. Le logo apparaitra automatiquement dans toutes les listes d’articles du site et dans l’article lui-même. La hauteur du logo doit être comprise entre 300 et 480 pixels.
Les 4 autres façons peuvent être illustrées par le schéma suivant (tiré du remarquable article de Jacques Pyrat)
Techniquement, les images peuvent être insérées dans le corps de l’article par la fonction media.
Cas 1 et 2 : petites images généralement décoratives :
- ne pas leur donner de titre
- les insérer en les faisant flotter à gauche ou à droite :
<mediaXXX|left> : cas 1
<mediaXXX|right> : cas 2
Si l’on souhaite limiter la taille affichée, il est possible d’utiliser le paramètre largeur ou le paramètre hauteur. En outre, si l’on rajoute le paramètre vignette,l’image devient cliquable et un clic permet de l’afficher dans sa taille originale. C’est le cas de la figure ci-contre. Testez-le !
<mediaXXX|vignette|largeur=300|left> : vignette limitée en largeur
<mediaXXX|vignette|hauteur=250|right> : vignette limitée en hauteur
Cas 3 : grande image centrée seule sur sa ligne :
<mediaXXX|center > : cas 3a
Dans le cas d’une grande image, cette dernière est toujours porteuse de sens : il faut donc lui mettre un titre, et, éventuellement, un descriptif.
<mediaXXX|center|titre|descriptif> : cas 3b
La fonction media donne des possibilités importantes. Une description plus complète est donnée plus loin dans cette aide.
Cas 4 : galerie de photos :
Une photo placée dans le Portfolio sera automatiquement utilisée pour faire une galerie en bas de l’article. Comme ces photos sont porteuses de sens, il est impératif de leur donner un titre.
Remarque : si l’on insère une photo du portfolio dans le texte :
- elle sera affichée sous forme de vignette
- elle sera automatiquement cliquable
- le lien est fait automatiquement vers la version grand format de la photo
Affichage de documents divers
Les fichiers pdf
Les fichiers pdf peuvent être intégrés dans l’article sous 2 formes
Cas 1 : le contenu du fichier pdf est inséré dans la page
<lecteurpdfXXXX>
- Pour cela, vous utiliserez la fonction lecteurpdf. Le cadre d’affichage peut être dimensionné en largeur et en hauteur (paramètres largeur et hauteur). Veillez à choisir une largeur assez grande pour rendre le contenu suffisamment lisible. Il n’y a pas d’impératif particulier pour la hauteur : si le contenu n’est pas affiché en totalité, l’utilisateur pourra faire défiler le contenu verticalement.
- La visionneuse possède des fonctions intégrés comme le zoom, la recherche de texte, l’affichage en plein écran que vous pouvez tester sur le pdf ci-dessus.
- Voici un exemple de syntaxe :
<lecteurpdf7724|hauteur=1200|largeur=800>
Cas 2 : sous la forme d’icone
<mediaXXX>
- l’icone peut être positionné à droite, à gauche ou au centre en utilisant la fonction media
- il est cliquable. Le clic déclenche le téléchargement du fichier
- il est possible de préciser le titre ou la description (soit dans les informations du document, soit dans les paramètres d’appel de la fonction media).
- Voici un exemple de syntaxe :
- Statuts LMPE
<media7724|right|titre>
<media7724|right|titre=Statuts LMPE>
Autre cas
- Il est également possible de visualiser l’article complet sous la forme d’un fichier pdf.
- Attention, toutefois que certains contenus sont mal reproduits dans ce cas. Tester le résultat avant de mettre votre article en ligne.
- Ceci est réalisable par la fonction article_pdf La syntaxe est la suivante :
<article_pdf|>
On obtiendra alors le raccourci suivant —>
Les fichiers html
Comme pour les fichiers pdf, les fichiers html peuvent être intégrés dans l’article sous 2 formes
Cas 1 : le contenu du fichier html est inséré dans la page
<lecteurhtmlXXX>
- Pour cela, vous utiliserez la fonction lecteurhtml. Le cadre d’affichage peut être dimensionné en largeur et en hauteur (paramètres largeur et hauteur). La visionneuse html ne redimensionne pas le document html. Veillez à choisir une largeur et une hauteur assez grandes pour rendre le contenu totalement visible. Si vous ne précisez pas la largeur ou la hauteur, leurs valeurs respectives sont de 750 et 400px.
- Si vous souhaitez ne pas afficher le fichier html sur toute sa hauteur, comme c’est le cas dans l’affichage ci-dessus, vous pouvez alors utiliser un paramètre supplémentaire scroll qui correspond à la hauteur réelle du document (en pixels). L’utilisateur pourra alors faire défiler le document verticalement sur toute sa hauteur.Le schéma ci-contre illustre la signification donnée aux 3 paramètres largeur, hauteur et scroll.
- Voici un exemple de syntaxe :
<lecteurhtml7456|hauteur=300|largeur=800|scroll=900>
Cas 2 : sous la forme d’icone
<mediaXXX>
- l’icone peut être positionné à droite, à gauche ou au centre en utilisant la fonction media
- il est cliquable. Le clic déclenche le téléchargement du fichier
- il est possible de préciser le titre ou la description (soit dans les informations du document, soit dans les paramètres d’appel de la fonction media).
- Voici un exemple de syntaxe :
- Trophée Roger Pelat 2012
<media7456|right|titre>
<media7456|right|titre=Trophée Roger Pelat 2012>
Les fichiers pgn (parties)
Deux fonctions sont disponibles pour insérer une visionneuse de parties définies sous la forme de fichiers pgn :
- Pau 2012
La fonction pgn
<pgnXXX>
XXX désigne le numéro du fichier pgn.
Pour afficher l’icone du pgn, utilisez <mediaXXX> avec éventuellement les paramètres supplémentaires d’alignement et de titre ou description.
- Finale de la Coupe Midi-Pyrénées 2013
La fonction chess
<chessXXX>
XXX désigne le numéro de l’article.
Blanc :
... Noir :
... Résultat :
... Évènement :
... Date :
...
/ Ronde :
...
Pour afficher l’icone du chess, utilisez <mediaXXX> avec éventuellement les paramètres supplémentaires d’alignement et de titre ou description.
Les autres fichiers : la fonction media
La fonction media est une fonction générique permettant de traiter tous les types de documents.
Au minimum, elle affichera le document sous la forme d’icone cliquable, elle permettra de choisir l’alignement (left, right, center), de choisir une légende (titre, descriptif, crédit) et de définir un lien (vers le document lui-même ou vers un article ou une rubrique ou vers un lien externe : http://...).
Pour certains type de document comme les photos, elle permet d’insérer le contenu du document dans l’article (paramètre embed ou insert) en choisissant la taille. Le paramètre vignette permet, en cliquant sur le document, de l’afficher à sa taille réelle.
Le schéma ci-dessous résume l’ensemble des paramètres. A remarquer que les paramètres titre, descriptif et credits peuvent être utilisés sous deux formes (voir les 2 exemples du paragraphe précédent) :
- sans préciser de valeurs : les valeurs sont prises dans la définition du document.
- en précisant les valeurs sous la forme param=valeur. Dans ce cas, les valeurs données remplacent celles de la définition.
