Remarque : Les documents postés, le sont en deux versions identiques à un détail près (voir texte de l’article). Il n’est pas nécessaire de les charger toutes les deux.
La documentation en ligne est consultable sur le site officiel de Spip.
Après avoir fait un document unique (de plus de 200 pages) reprenant toute la documentation en ligne de SPIP, j’ai eu pas mal de réactions diverses.
- Document un peu lourd à manipuler. Des « cahiers » séparés par chapitres seraient préférables.
- Certains esthètes parmis vous trouvaient les liens internes au document trop voyants ;-))
- Distribution des documents sous licence FDL.
J’ai essayé de respecter ces souhaits. Mais certaines concessions ont dû être faites.
- Les références qui étaient internes dans le document unique (genre
voir section x page yyy) ne le sont plus si elles se rapportent à un cahier séparé (elles renvoyent l’adresse URL du site de SPIP en note de bas de page). - Je n’ai pas encore trouvé un moyen simple de changer la couleur des liens présents dans le document. Deux versions sont fournies :
- Une version non-navigable avec index, table des matières et liens en noir.
- Une version navigable avec index, table des matières et liens en rouge : fichier dont le nom contient le suffixe
_nav.
Voici donc, les « cahiers ».
Si vous avez quelque remarque que ce soit concernant la typo, l’orthographe, des liens cassés, références erronnées et erreurs diverses, n’hésitez pas à me le signaler.
Etat actuel de la documentation PDF
| Titre | Version du cahier | Version de Spip | Fichier sans Navigation | avec navigation |
|---|---|---|---|---|
| Présentation | 20021216 | 1.5 | 
|
|
| Installation | 20021216 | 1.5 |
|
|
| Evolution et mise à jour | 20021216 | 1.5 |
|
|
| Guide de l’utilisateur | 20021217 | 1.5 |
|
|
| FAQ Questions techniques | 20021220 | 1.5 |
|
|
| FAQ Premiers pas | 20021217 | 1.5 |
|
|
| Squelettes : Guide du webmestre | 20021217 | 1.5 |
|
|
| Manuel de référence | 20021214 | 1.5 |
|
|
| Spip pas à pas | 20021217 | 1.5 |
|
|
| Trucs et astuces | 20021217 | 1.5 |
|
|
| Tutorial avancé | 20021218 | 1.5 |
|
|
| Aide en ligne | 20021220 | 1.5 |
|
|
La version du cahier permet de déterminer la date de synchronisation du document avec le site SPIP. La référence à la version de Spip est plus ou moins précise en fonction de l’état de la mise à jour du site de documentation en ligne officiel de Spip.
Discussions par date d’activité
40 discussions
Super la doc, mais pas facile de s’y retrouver ! Ce serait possible d’avoir un petit descriptif du contenu de chaque opus, un peu plus précisément que juste un titre ?
Merci et bonne continuature !
oui ce serait pas mal d’avoir le lien sur les titres (au moins) genre :
- Présentation :
http://www.uzine.net/rubrique124.html
Répondre à ce message
Bonjour, la documentation est vraiment à la hauteur du logiciel, d’excellente qualité !
Juste un petit bémol, est-il possible de laisser la version pdf en un seul fichier aussi disponible, de facon à ce que chacun puisse utiliser la version qui lui est la plus agréable ?
Répondre à ce message
Pour les mêmes raisons que Beatnick, je partage ses commentaires concernant le cahier mise à jour. En plus, cela éviterait de réimprimer l’ensemble des cahiers modifiés simplement pour vouloir mettre à jour sa version papier de la documentation. On imprime le cahier mise à jour est hop, c’est terminé.
Répondre à ce message
Tout d’abord, bravo pour la doc de SPIP, c’est vraiment du bon boulot c’est vrai.
Ceci dit j’ajouterais encore un cahier mise à jour. Car en décembre j’avais imprimé la partie référence de la doc pour la version 1.4, mais maintenant il me manque dans mon classeur que je garde sous le coude les nouvelles fonctionnalités de 1.5. Serait-il possible d’avoir un truc pareil ?
Oh pour moi un simple « Quoi de neuf.txt » dans l’archive de chaque distribution suffirait et est manquant à mon avis, mais c’est peut-être une sale habitude que j’ai de toujours vouloir lire README et ChangeLog avant de faire quoi que ce soit avec un logiciel.
Répondre à ce message
Rien à dire...je connais des éditeurs pro (et payants !) qui pourraient en prendre de la graine !
Répondre à ce message
Mille merci ! Un travail fantastique !
Répondre à ce message
Ce serait bien que dans le zip spip, il y ait un fichier indiquant les diverses sources d’aide dont absolument l’url de ces documents. Dire que j’avais commencé à récupérer la doc page par page sur le site d’uzine. Si j’avais eu connaissance de ces fichiers dès le début, j’aurais gagné du temps. Et j’en aurais fait gagner aux autres...
Répondre à ce message
c’est très très bien fait et très utile a un débutant comme moi..
en gros, un cahier par matière ;)
Répondre à ce message
La possibilité d’avoir la doc en un seul tenant, en plus des chapitres séparés reviendra peut-être. Mais d’un point de vue « écologique » il est plus facile de ne réimprimer que le chapitre ayant été mis à jour ... ils le sont rarement tous en même temps.
Pour les liens colorés, je suis d’accord avec toi. Le fait d’avoir mis les deux versions laisse le choix aux gens (en doublant l’espace disque occupé sur le serveur :-( )
Finalement, j’essayerai de publier le code source LaTeX avec la prochaine version ... je dois encore un peu l’adapter.
Ainsi les gens qui connaissent ou savent utiliser LaTeX pourront avec les mêmes données se faire une version correspondant exactement à leurs goûts : l’avantage de l’Open Source ;-))
Répondre à ce message
Ta doc est vraiment bien faite et indispensable. Moi j’aimais bien le fichier unique ; au moins on avait tout sous la main. Mais peut-être effectivement est-ce plus pratique de découper la doc en chapitres. En tous les cas, il faut laisser des liens assez voyants car quand on cherche un truc , on n’ouvre pas forcément dès le départ la doc en taille très lisible (surtout avec un écran de taille modeste). C’est donc agréable de repérer immédiatement où cliquer avant d’agrandir la page qui nous intéresse.
Répondre à ce message
Ajouter un commentaire
Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :
Merci d’avance pour les personnes qui vous aideront !
Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.
Suivre les commentaires :
|
