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
Pourquoi il reste encore des vieilleries comme ça en ligne ?
C’est dommage qu’en recherchant des choses simples comme « documentation spip » sur google on tombe sur des articles datant d’il y a plusieurs années et obsolètes !
Répondre à ce message
Où se trouve le pdf complet (200 pages) ?
Le lien pour le télécharger en seul fichier.
Merci
Répondre à ce message
N’existe t-il pas une version PDF des dernieres versions de SPIP ? a moins que la doc de base n’ait pas change....
merci !
Répondre à ce message
J’ai trouvé les « trucs et astuces » à cette adresse
URL :
http://www.ml.refer.org/tranfer2003/Documentation_SPIP_PDF/PDF sans navigation/
[ merci google ]
j’ai récupéré ces pdf et remis les bonnes versions des documents joints (même si cette doc date un peu elle est tout de même grandement utile), merci de signaler les pdf endommagés dans ce fil de discussion.
Répondre à ce message
Le seul moyen que je connaisse pour changer la couleur des liens est d’utiliser le package hyperref avec les options suivantes (à compiler avec pdflatex) : urlcolor=blue et linkcolor=blue. Voir les docs de pdflatex et surtout hyperref pour plus de détails.
Répondre à ce message
Je confirme : le PDF « Trucs et astuces » est vierge !
Sinon, bravo !
Répondre à ce message
Bonjour,
Le fichier « Squelettes : Guide du webmestre avec navigation » est endommagé !
Bravo pour votre travail et merci pour tout.
Répondre à ce message
Travail de très grande qualité
(bonjour la mise à jour).
J’ai aussi noté l’absence des
fichiers ’astuces’.
Dommage pour moi
Répondre à ce message
merci pour ce fabuleux travail (j’ai aussi fait des docs utilisateurs et sais ce que cela représente).
Un souci, le téléchargement des 2 docs Trucs et astuces me donnent une page vide. Tout le reste est OK
On peut la trouver ailleurs ?
Répondre à ce message
Hello,
Les 2 cahiers « trucs et astuces » sont absents apparemment.
Le cahier « Squelettes : Guide du webmestre » avec navigation semble quant à lui endommagé.
Merci en tout cas
Répondre à ce message
Nous sommes déjà à la version 1.7 de spip... ne serait-il pas temps de mettre à jours les PDF ?
c’est clair... mais voila le boulot !! peut-être un partage des tâches ??
Pour l’adaptation des fichiers PDF de la version 1.7 je suis partant.
En échange vous me filez un petit coup de main pour un utilisateur Mac (moi).
Questions en vrac :
1/Après avoir installé Apache 2, (erreur ? ou pas) puis bidouillé la config, installé MySql idoine, doit-on effacer des fichiers Apache obsoletes, si oui, où sont-ils. Je n’ai guère de place à perdre sur mon pauvre petit portable de prolo ;-)
2/J’ai téléchargé SPIP 1.7... Où dois-je l’installer pour qu’il soit utilisable en local afin de pouvoir m’initier. (Je suppose que le partage web ne fonctionne pas dans ma situation)
3/Lorsqu’ensuite on veut faire héberger notre site, et en admettant qu’on fasse le transfert par ftp, quels dossiers doit on inclure ?
Merci pour vos réponses
Question subsidiaire pour les fans d’Apple : Lorsqu’on reinstalle un systeme 10.3 sur un 10.2.8, comment retrouver le trousseau des autorisations ? Prend-on un risque de perdre d’autres données ?
Allez encore une pour la route : En cas d’une installation « from scratch » de macOSX 10.3 comment s’y prendre pour récupérer toutes les données, les règles, les comptes dEntourage ? J’hésite depuis pas mal de temps à me lancer dans cette entreprise risquée.
Dans l’espoir d’avoir quelques réponses d’habitués.. Les réponses directes acceptées.
Tu peux trouver réponse à toutes tes questions sur les forums de « macbidouille ».
http://www.macbidouille.com/
bonsoir en plus de ces infos , petites precautions, Apache 2 n’est pour l’instant guere utilisé sur le serveur Web, pour travailler en local de preférence fais le avec une version 1.3.27 ou 29 je ne sai ou il en sont pour le mac.
C’est bien stable, bien securisé et tout et tout.
j’ai sur un Imac Apache PHP et Mysql ca tourne bien carré sans soucis avec une 1O.2.8,
Un user le Mac, Linux et accessoirement Win.
Amicalement
eric
Répondre à ce message
Merci tout simplement pour ce travail de titan.
Répondre à ce message
Bonjour,
Je viens de me lancer en tant que free lance concepteur et réalisateur de site et d’application web. Etant un grand fan de spip et de flash, je pense faire une « doc » en flash pour la partie administration. Ayant besoin de me faire connaitre, je pense la distribuer gratuitement en prenant soin d’y mettre un lien vers mon site. Est ce que cela vous parait raisonnable ?
Salut,
Il est tres fréquent que les auteurs de contribs mettent un lien vers leur site dans le texte de leur article, on fait ce qu’on veut ici, hein.
évite juste que ta « pub » soit trop intrusive amha.
Fonce ! Fonce !
Aucun probleme, tu peut le faire.
Alors, ca avance cette doc en flash ?
Je suis impatient de voir ca !
C’est quoi ton site ? faut pas etre timide comme ca ...
Répondre à ce message
Clair, net, précis ...
Je ne sais pas qui s’est paluché tout ça mais en tout cas : BRAVO !
Répondre à ce message
je vois qu’il y a une belle docu, mais pour les simples rédacteurs qui sont invités à collaborer à un site sous SPIP il n’y a rien de prévu... à ma connaissance...
alors j’ai pondu un petit truc, mais j’aurais besoins d’avis éclairés... pour voir si on peut le proposer quelque-part...
n’hesites pas a venir proposer ton document sur spip-contrib : www.uzine.net/spip-contrib/ecrire
Bien vu pour la documentation pour rédacteurs. Juste deux remarques :
- il y a eu un problème d’encodage en pdf, le texte est entièrement rédigé avec des àààààààà ou des éééééééé, donc pas utilisable.
- on pourrait souhaiter une documentation « générique » et pas pour rédacteur catholiques...
Bruno.
Pour la doc du redacteur débutant j’ai trouvé ça ...
Ca m’as beaucoup aidé personellement alors si ça peux servir à d’autres...
le manuel
Oui elle est très bien cette doc de Indepnet
il y en a meme une pour l’administrateur de rubrique, que je suis en train d’angliciser
@+
Répondre à ce message
Bonjour :
merci pour « Spip ».
Juste une question :
« www.uzine.net/article1970.html »
« Pour les utilisateurs ayant un PC fonctionnant sous Windows, la solution la plus simple pour tester SPIP consiste à installer EasyPHP sur sa propre machine. »
Je serais heureux d’avoir aussi la reponse a la meme question pour Linux.
J’imagine qu’elle est quelque part dans la doc, mais je commence.
Andre
utilisez une distrib, avec mysql ET apache : installés tsles2 en standard, et sans rien faire.
(sous linux, il faut s’y connaitre un peu) mais
elle n’existe pas cette distrib je pense ...
?pingoo
?gentoo
?knoppix
nuance, elle existe partout, sinon il faut rajouter les paquets nécessaire (mysql apache et php). Ca depend beaucoup de la distribution, mais en général ça s’avère être entre simple, facile et moyennement difficile selon les distributions
La plupart des distrib le permet.
Avec la Mandrake 9 aucun problème (tout est « Windowsé », parfois ça reproduit même des bugs ;-) ).
Généralement Apache, PHP et MySQL font partie de la config serveur de base. (nota : j’ai cité la Mandrake car c’est une des plus facile à aborder, mais les autres sont capables des mêmes choses).
Je découvre SPIP depuis hier, c’est top.
sous debian :
sudo apt-get install mysql apache php4
Répondre à ce message
Doc vraiment super.... j’ai tout appris avec
merci encore
Laurent
Répondre à ce message
Pourquoi ne pas mettre une option « afficher en PDF » directement à la génération des articles de la documentation de SPIP. Un peu comme ce qui a déjà été fais dans des squelettes comme BioSPIP ?
Répondre à ce message
Bonjour,
Est-ce possible de récuperer quelque part la version où tous les PDFs sont en un seul..?
Car c’est un peu long de tous les imprimer les uns à la suite des autres, et de se retrouver ensuite dans les différentes tables des matières...
Merci d’avance
Pourquoi ne pas demander une version papier directement chez soi ?
Cette présentation par chapitre à le mérite d’être facilement et rapidement téléchargeable.
D’autre part, pas la peine de tout télécharger pour nombre d’entre nous.
Alors merci à l’équipe pour la documentation
Répondre à ce message
Merci pour la doc en *.pdf !!!
C’est quand même bien plus agréable de l’approfondir sur le papier qu’à l’écran.
Répondre à ce message
Je défie quelqu’un pour réaliser cette documentation en un seul fichier .doc ;-)
J’en ai besoin merci !!! :-D
Il te reste à te mettre au boulot. Toujours compter sur les autres... Pas le moindre effort. Vive les français ! :-> :-> :->
Tu fais du copier(depuis la doc dans Acrobat Reader) / Coller (dans Word ou al).
Et ensuite tu met en forme.
On va pas tout te faire non plus !
:o)
Et puis quoi aussi, créer un site pour toi, gratos, créer le contenu et faire les mises à jour ?
Tu fais du copier(depuis la doc dans Acrobat Reader) / Coller (dans Word ou al).
Et ensuite tu met en forme.
On va pas tout te faire non plus !
:o)
Et puis quoi aussi, créer un site pour toi, gratos, créer le contenu et faire les mises à jour ?
Proposé si gentiment, je suis d’accord.
Merci de me contacter le plus rapidement possible, j’ai un site (une centaine de pages) à mettre en ligne pour dans moins d’un mois. Je te fournis les textes & les photos, merci d’éviter les fautes d’orthographe.
Répondre à ce message
Que ce soit SPIP en lui même ou bien la documentation je trouve tout ce boulot réalisé et offert à la communauté démentiel. C’est tout bonnement formidable. Non je ne suis pas là pour cirer les pompes de personnes : de toute façon je ne connais personne d’aucune des équipes de développement ou de rédaction, mais je tenais réellement a dire un grand MERCI pour l’initiative, la réalisation, le travail. La GPL est réllement l’avenir d’une informatique accessible et libre, et SPIP peut se targuer d’en être désormais un pilier.
Félicitation, bonne continuation.
(je vais peut être pouvoir faire mon site communautaire grâce à vous tous).
Un étudiant qui rêve devant l’open source...
Répondre à ce message
Bonjour, je decouvre SPIP et je m’en trouve plein de questions :p
Tout d’abord bravo pour la doc elle semble clair et plutot bien faite apres un premier survole.
Cependant j’ai une question dont je n’arrive pas a trouver de soluce :
voila si par exemple je veux developper des scripts PHP pour mon site (un site sur lequel je veux mettre des formulaires qui font des calculs par exemple)
Sachant bien entendu que je connais deja le php hein
cela est il faisable « facilement » via spip ?
Merci d’avance :p
Manu
Tout est possible...
Après traitement du squelette par Spip, le résultat rangé dans le cache (puis affiché) est un fichier php.
Tout le code non « spip » s’y retrouve intégralement. C’est vrai du html, du javascript, du php, ...
A+
François
Répondre à ce message
La doc est superbe et ... elle existe, contrairement à de nombreux autres systèmes. La Classe ! :-) Cependant, avec SPIP comme avec les autres CMS, un aspect important est la création de thèmes. Il y a un chapître entier consacré à celle-ci dans ce document :-o (une 20aine de pages). J’me suis dit super, je vais pouvoir commencer à faire autre chose que des sites qui ressemblent à tant d’autres... Eh bien NON, JE NE SAURAIS PAS COMMENT CREER UN THEME... La chapître en question se borne à dire « oui, il est possible de personnaliser le front office » ! Soit 3 (TROIS) ligne !!! :-(( ARRRRRRRRRRRRGGGGG !!! Le reste du chapître est consacré au partage des thèmes créés avec SPIP ! Là je dit MINABLE. Désolé. :o)
Le terme SPIP est *squelette* et non thème, front-office, ou al. (mais c’est du pareil au même).
Ba, SPIP c’est super et pour les thèmes tous ceux que l’on trouve sur SPIP contrib permettent de se faire la main sur les boucles.
Pour faire son propre thème il suffit de faire tout simplement du html classique et ensuite d’y placer les boucles adéquates en fonction de ce que l’on recherche.
Enfin c’est une façon de voir les choses.
C’est en tout cas notre approche pour ce lien
Répondre à ce message
pffff... :-(
Ca a l’air énorme, mais je ne sais pas par où commencer tellement spip semble un truc gigantesque.
Quelqu’un aurait des adresses pour me mettre le pied à l’étrier ?
bah, avant d’imprimer la doc entière du SPIP Pro, imprimez d’abord les qq pages Mon premier squelette, je le sors du placard et les quelques articles l’accompagnant.
Largement suffisant, bien fait avec même une pointe d’humour... à l’uzine.
Répondre à ce message
Bonjour,
C’est très pratique de pouvoir imprimer simplement la doc. Bravo !
Par contre, moi qui découvre SPIP et le PHP je trouve la doc confuse. J’aurais préféré avoir un seul document pour avoir une bonne vue d’ensemble.
Par ailleurs, cela manque d’illustrations et on ne voit pas très bien ce que l’on peut faire avec SPIP sans rentrer dans une phase de personalisation des squelettes. Ce dernier point est très obscur. Sur quoi agir : les squelettes, les feuilles de styles, télécharger des modèles ?
Je suis encore dans le brouillard !!
Répondre à ce message
je me demande si spip n’est pas une sorte de passerelle pour l’autoformation à la programmation php, est ce que qqun peut confirmer ou infirmer cette remarque
Répondre à ce message
Tout simplement génial, la doc est parfaite... Le système génial. J’ai découvert SPIP il y a quelques jours... je ne dors plus.
Je ne pense qu’à SPIP. Je SPIP toute la nuit... ;-)
MERCI pour ce remarquable dévellopement.
Répondre à ce message
Bonjour à tous !
Jamais rien vu d’aussi bien fait !!!Bravo à toute l’équipe pour le boulot monstre...je me plonge dans la doc pour pouvoir réaliser mes propres squelettes.Bientôt, je pense tranformer le site dont je m’occupe (actualité sportive d’une commune Lyonnaise) en version Spip, mais obligation de création de squelettes.
Bravo encore, et pour moi ce systeme de découpage en chapitre, c’est idéal...
Répondre à ce message
juste un coup de chapeau à l’equipe la doc de spip , car j’avais du mal dépuis quelques mois pour me retrouver dans le projet spip
copier les fichier html page apres page était loin d’etre évident
Beaucoup de succès pour le projet spip et un salut à tous les spipiens du monde
Ferdinand
Répondre à ce message
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 :
|
