Où je raconte ma vie et partage aussi un peu de lumière.
Hello
comme vous peut être, j'ai regardé la démo du travail de marcimat
> http://medias.spip.net/medias/demonstrations/article/presentation-de-minidoc
Dans cette vidéo, j'intuitais que l'image exemple téléversée
irait rejoindre le groupe "Portfolio"
puisqu'elle n'est pas inclue en tant qu'illustration dans le texte
et qu'elle ne sera affichée, a priori, que via le "portfolio"
qui existe par exemple dans les squelettes-dist en dessous du texte.
Ça aurait été d'une certaine logique, non ?
Ben non, elle va dans les "Illustrations"
et elle n'est affichée nulle part dans la page publique.
J'imaginais alors plusieurs hypothèses et voulais les tester...
En essayant sur demo.spip.net,
toutes mes images ont été dans "Illustrations",
qu'elles soient téléversées via la page de visu (où on "Ajoute un document")
ou d'édit (où on "Ajoute une Image ou un document")
et qu'elles soient inclues ou non dans le corps du texte avec <img...>
(ça aurait pu être en rapport avec le champ "vu").
Finalement, je n'arrivais plus à imaginer ce que peut être ce "Portfolio",
et la doc sur spip.net ne m'a jamais éclairé à ce sujet.
C'est finalement le bouton "déposer dans le Portfolio" qui m'a fait comprendre :
effectivement, dans le privé il fait apparaître l'image dans la liste "Portfolio",
et dans le public l'image apparaît dans le diaporama en dessous de l'article.
Donc le portfolio, c'est un sous ensemble des documents associés à un objet éditorial,
défini par le choix de l'utilisateur au moyen des boutons "déposer dans le Portfolio",
et cette sélection permet dans spip-dist de faire un diaporama en dessous de l'article.
En fait, il y a plusieurs plugins dans SPIP pour faire des sélections éditoriales,
des grappes ou des listes.
Le portfolio est donc une manière standard dans SPIP de faire ça,
mais uniquement pour les documents.
Ayant compris cela je comprend mieux (l'intérêt) d'autres parties de la doc.
Par exemple la doc précise que l'interface d'insertion des documents
est différente pour les documents du portfolio :
« Lorsque vous éditez votre article, l’ensemble des médias est listé sur le côté.
Les icônes permettent de distinguer les médias :
icône type d’image code d’insertion proposé
Carte postale Illustration <img>
Pièce jointe Portfolio <doc>,<emb> »
Ah.
Cette seconde fonctionnalité me semble ne pas avoir de rapport avec la première a priori
et je me demande un peu pourquoi elles sont combinées.
Une justification fournie par la doc est que le porfolio contient des documents plus gros, qui nécessiteraient un diaporama.
Un peu comme une distinction entre image css de déco et image porteuse de sens ?
Sauf que « Gros » / « Pas gros », ça ne me parle pas vraiment vu que les squelettes réduisent automatiquement à la taille désirée, que ce soit dans un diaporama a part ou dans le corps du texte.
Et d’ailleurs, même si l’interface ne le propose pas,
tous les raccourcis fonctionnent toujours, même pour des documents qui ne sont pas dans le portfolio.
Comme si cette distinction était somme toute assez floue.
Par ailleurs, continuant à explorer j'ai découvert qu'un document présent dans le portfolio
n'apparaissait PAS dans le diaporama en bas de l'article s'il était inclu
dans le corps de l'article.
Ça se compliquait.
Mais en allant voire squelette-dist/inclure/documents.html
j'ai vu que l'affichage public dans le portfolio résultait de la combinaison
de 2 critères : {mode=document} et {vu=non}
J'en ai déduit que
- les documents du portfolio apparaissent grâce à {mode=document},
qu'ils soient insérés ou non dans le corps du texte
- on exclu ceux qui sont dans le texte avec {vu=non}
Ouf, c'est plus simple comme ça.
Puis j'ai cherché à savoir comment ça se passait lorsqu'un document
est associé à plusieurs articles
et j'ai trouvé que si un document est mis dans le portfolio pour un article,
il est dans le portfolio "partout".
Le portfolio n'est donc pas une sélection relative à un article,
car c'est un objet global à tout le site.
OK.
Alors peut être y aurait il moyen d'indiquer, dans ces bandeaux qu'on voit sur la vidéo,
ce que signifient "Illustration" et "Portfolio" par un title malin sur le titre
voire par un lien "i" vers une aide plus conséquente ?
Mais je me suis dit que la priorité était de partager mes trouvailles.
Voilà.
Et pour référence ultérieure je reporte sur
https://contrib.spip.net/Comprendre-le-portfolio-et-les-illustrations
Je crois aussi que la doc sur cette notion de "portfolio" est éclatée
entre doc sur l'interface privée et doc sur les boucles DOCUMENT
et que c'est cela, probablement, qui avait bloqué ma compréhension jusqu'à présent.
Si cette notion est vouée à perdurer (il y aurait une refonte en vue ?)
ce serait bien, à mon avis, de rassembler dans un même article sur ce thème
ou d'ajouter des liens des uns vers les autres.
SPIP c'est fouuuuu !
JL
