[spip-dev] [Sondage] messages d'avertissement, remarques, exemples…

Dev
1

Hello,

Je profite du coup de peinture du moment sur les sites de doc de SPIP qui nous remet le nez dedans, pour vous sonder (dans l’idée d’un futur hypothétique plugin)… Lorsqu’on rédige de la documentation, on a parfois besoin de distinguer certains textes pour amener un exemple, une remarque, un rappel technique, un avertissement de compatibilité, ou autre.

Par exemple ici :
https://contrib.spip.net/-Versions-Modifies-de-SPIP-Archives-

1) De quels types de blocs, d’encadrés spécifiques avez-vous généralement besoin ?
2) Comment les lookez-vous ? ou avez-vous envie qu’ils soient lookés ?

-- tetue

2

Vite fait :
- Exemple (un cadre comme Programmer avec un titre)
- Information (i)
- Avertissement / Important (!)
- Note (crayon)

Éventuellement
- Note de version (à partir de la version X, alors ...)

MM.

3

Yo !

1) De quels types de blocs, d’encadrés spécifiques avez-vous généralement besoin ?

Vite fait :
- Exemple (un cadre comme Programmer avec un titre)

Tiens, en ce moment j’essaye un bloc pour les exemples, visible à cette page :
http://romy.tetue.net/mettez-du-code-dans-vos-pages-web

Quand tu dis « avec un titre » souhaites-tu qu’il soit éditable/personnalisable ?

- Information (i)
- Avertissement / Important (!)

Ces deux-là relèvent des « messages systèmes » traditionnels (info, warning, danger, success) qui me semblent être déjà proposés par spip, non ?

- Note (crayon)

Plus précisément : pour des trucs et astuces ? des remarques, rappels ?

Éventuellement
- Note de version (à partir de la version X, alors …)

Yep :slight_smile:
Question : pourquoi ne pas le faire avec un bloc info ou warning ?

-- tetue

4

Salut

Il y a un plugin encart qui existe qui semblent s'approche de cette
idée "d'encadrées"

Pour le reste je ne sais, je ne fais pas de doc :confused:

Km

5

tres intéressant ce pseudo-style .kbd
kbd {
white-space: nowrap;
padding: .1em .3em;
background-color: #eee;
background-color: rgba(243,244,236,0.5);
border: 1px solid #aaa;
border-radius: 4px;
box-shadow: 0 2px 0 rgba(0,0,0,0.2), 0 0 0 1px #fff inset;
color: #333;
}

Que je me suis empressé d'ajouter sur SPN
Merci Romy

6

Hello

7

Si on est dans le cas où l'on se trouve hors de la version actuelle, les archives devraient se trouver dans les versions antérieures et dans une rubrique spé correspondant aux versions pour laquelle les contributions ont été faites à l'époque... Inutile par exemple de trouver comment faire du wysiwyg dans l'espace public en 3.0... Contrib ce devrait être: 3.0 en premier et un menu d'archives pour les versions surannées, non?