###################################################################### # # ManyPage : Moteur de Publication de site Web # ManyPage : Web site Management tools # # # Auteur/Author : Pierre Cordani # Collaborateur/Contributor : Pascal Vuylsteker, MediaPort team # # Documentation : http://www.vrarchitect.net/ManyPage # Question : manypage@vuylsteker.net # # Creation : 1/1/00 # Modification : 1/12/00 # Version : 0.9 # SoftVersion : Perl 5 ###################################################################### # # Copyright (C) 2000 Pierre Cordani - Pascal Vuylsteker # # This program is free software; you can redistribute it and/or # modify it under the terms of the GNU General Public License # as published by the Free Software Foundation; either version 2 # of the License, or (at your option) any later version. # # Ce programme est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier conformŽment # aux dispositions de la Licence Publique GŽnŽrale GNU, telle que publiŽe par la Free Software # Foundation ; version 2 de la licence, ou encore (ˆ votre choix) toute version ultŽrieure. # ###################################################################### # Ce fichier est principalement un memo sur la manire d'installer ManyPage # Pour une aide plus dŽtaillŽe, voir # http://www.vrarchitect.net/ManyPage/index.fr.html # # This file contain contain the minimum things to know to # install ManyPage. # For more information, please consult the manual at # http://www.vrarchitect.net/ManyPage/index.en.html # Or go at the end of this file # ###################################################################### Installation de ManyPage Version 0.9 ------------------------------------------------ 1fr) Trouvez ou est localisŽ votre interpreteur Perl ( 'which perl' ). Si Perl n'est pas livrŽ avec votre systme, changez de systme... ou installez perl : il est disponible sur un nombre impressionant d'OS. 2fr) S'il ne se trouve pas en /usr/bin/perl, - vous pouvez rajouter un alias en /usr/bin par 'ln -s /votreEmplacement/perl /usr/bin/perl' (manipulation de toute faon utile puisque cet emplacement est souvent celui par dŽfaut) - vous pouvez aussi Žditer la premire ligne des 2 fichiers Bin/habille.pl et Bin/main.pl en remplaant '/usr/bin/perl' par '/votreEmplacement/perl' 3fr) Modifiez le fichier Bin/config afin de dŽfinir les parties 'Src' (documents HTML simple que vous Žditez) et 'Docs' (documents HTML habillŽs et Žcrits par le script). Ces rŽpertoires n'ont pas besoin de s'appeler 'Src' et 'Docs'... Vous trouverez un exemple en Bin/ConfigExample/config.example Vous pouvez par exemple commencer par pointer les deux rŽpertoires proposŽs dans ce package. VŽrifiez que l'utilisateur qui lancera le script a bien un droit d'Žcriture sur le rŽpertoire Docs, et de lecture dans le rŽperoire Src. 4fr) Lisez la documentation en ligne (http://www.vrarchitect.net/ManyPage/index.fr.html) ou jettez au moins un coup d'oeil au fichier Bin/README.txt 5fr) Lancez le script Bin/habille.pl dans le rŽpertoire 'Src' ou dans un de ses sous rŽpertoires. Vous pouvez en faire un alias dans votre environnement (alias manypage ~/manypage/Bin/habille.pl par exemple) ou encore ... ../Bin/habille.pl lancŽ seul, il vous affichera une aide sommaire - Si le test est effectuŽ en local, pensez ˆ habiller en mode relatif (option -a) - Si les images se trouvent seulement dans la partie source, penser ˆ les transferer (option -t) exemple pour un premier habillage : ../Bin/habille.pl -rat (dans Src) effectuera un habillage recursif (-r), avec relativisation des liens (-a) et transfert d'images (-t) 6fr) CrŽez votre propre habillage, en vous inspirant des exemples de ce package et de ceux fournis sur le site (Žditions des fichiers .obj , .dress et .link). 7fr) Si cet outil vous est utile, n'hŽsitez pas ˆ ajouter un lien vers notre site dans votre habillage, par exemple avec l'objet suivant... Site habillé par le moteur de publication ManyPage ----------------------------------------- ManyPage Installation Version 0.9 ------------------------------------------------ 1en) Find where Perl is ( 'which perl' ). If you don't have perl on your system, install it or change your OS (Why not using MacOSX for instance, it is as easy to install than MacOS and as powerfull than Unix : it is a unix and come with Perl 5 installed ... :-). 2en) If it is not at /usr/bin/perl - you may add an alias to perl in your /usr/bin directory with 'ln -s /whereYourPerlIs/perl /usr/bin/perl' (anyway, it is a useful thing to do, cause a lot of perl installations place it in that location) - you could either edit the first line of the 2 files 'Bin/habille.pl' and 'Bin/main.pl' and replace '/usr/bin/perl' by '/whereYourPerlIs/perl' 3en) Modify the file Bin/config in order to define the 'Src' part (where you put the plain HTML file that you have written) and the 'Docs' part (where ManyPage will write the rich HTML pages). These directories don't need to be called 'Src' and 'Docs'... Another example file 'config' can be found at Bin/ConfigExample/config.example To begin with, you can use the two directories in that package. Be sure that the 'Src' directory is readable by the user of the script and that he has writing right in the 'Docs' directory. 4en) RTFM ;-) Read the on line documention in english (http://www.vrarchitect.net/ManyPage/index.en.html) or at least have a look at file Bin/README.txt (in French !) 5en) Use the script Bin/habille.pl in the Src directory or in one of its subdirectories. You should make an alias to it (alias manypage ~/manypage/Bin/habille.pl for instance) Without any option (or with -h), it print a light manual. - if you want to test the script locally, use the option -a what will make all links relative - if the pictures are only in the 'Src' directory, option -t will transfert them in 'the Docs' directory. Example for a first use, within the 'Src' directory ../Bin/habille.pl -rat will deal recursivly (-r) with all the files, transfert the included images and make the links relative 6en) Cut your own design into objects and put all that into .obj , .dress and .link file (you will find some examples in this package and some more on the web site). 7en) If this publishing tool suits you, please add a little link to our web site on your site, for instance with a ManyPage object like the following one : Site published with the help of ManyPage