######################################################################
#
# 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 conformment
# aux dispositions de la Licence Publique Gnrale GNU, telle que publie par la Free Software
# Foundation ; version 2 de la licence, ou encore ( votre choix) toute version ultrieure.
#
######################################################################
# Ce fichier est principalement un memo sur la manire d'installer ManyPage
# Pour une aide plus dtaille, 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 systme, changez de systme... 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 faon utile puisque cet emplacement est souvent celui par dfaut)
- vous pouvez aussi diter la premire ligne des 2 fichiers
Bin/habille.pl et Bin/main.pl en remplaant '/usr/bin/perl' par '/votreEmplacement/perl'
3fr) Modifiez le fichier Bin/config afin de dfinir les parties
'Src' (documents HTML simple que vous ditez) et 'Docs'
(documents HTML habills et crits par le script). Ces rpertoires 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 rpertoires proposs dans ce package.
Vrifiez que l'utilisateur qui lancera le script a bien un droit d'criture sur
le rpertoire Docs, et de lecture dans le rperoire 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 rpertoire 'Src' ou dans un de ses sous rpertoires.
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) Crez 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'hsitez 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