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...><doc...><emb...>
(ç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,
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 :

<blockquote class="spip">

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>

</blockquote>

Ah.
Cette seconde fonctionnalité me semble n’avoir aucun rapport avec la première
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 ?
Hmm.
« 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,
les raccourcis <code></code emb > et <code></code doc > fonctionnent toujours,
même pour des documents qui ne sont pas dans le portfolio.
Comme si cette distinction était 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 : < code>mode=document</code > mode=document et < code>vu=non</code >
vu=non
J’en ai déduit que
-  les documents du portfolio apparaissent grâce à < code>mode=document</code >,
mode=document ,
qu’ils soient insérés ou non dans le corps du texte
-  on exclu ceux qui sont dans le texte avec < code>vu=non</code >
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 même si ce point délicat de spip n’est pas le sujet de ce nouveau dev ,
ce serait peut être y aurait il moyen l’occasion tout de même d’indiquer, dans ces bandeaux qu’on voit sur la vidéo ,
ce que signifientici « Illustration » et « Portfolio » par un title malin sur le bandeau 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à.

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
mais si cette notion est vouée à perdurer (mais il y aurait une refonte en vue ?)
ce serait bien de rassembler comme ici dans un même article
ou d’ajouter des liens des uns vers les autres

SPIP c’est fouuuuu !