Les Litanies de Sang sur son PC : guide d'installation 

But :
Installer les Litanies de Sang sur votre PC, afin de pouvoir les consulter sans connexion internet. Par exemple, sur votre PC portable alors que vous êtes en vancances, ou bien en pleine partie de jeu.

Matériel et connaisances nécessaire :
La présente installation est valable pour un système Windows. Elle décrit les étapes pas à pas, et ne nécessitent pas de connaissances poussées en informatique. Attention, nous décrivons ici une installation sur un Windows 98, mais tout est similaire sur un système plus récent.

Limites de la chose :

• Vous n'aurez pas la dernière version des Litanies de Sang sur votre PC, car les mises à jour se feront sur votre PC .... quand vous le désirerez. Et quand les webmestres mettront les mises à jour en ligne.

• Vous avez une version légèrement tronquée des Litanies de Sang. Nous avons supprimé certaines fonctionnalités, et des mesures de sécurité.

• Si vous saisissez vos personnages ou que vous modifiez les bases pour les conformer à vos désirs, n'espérez pas les intégrer facilement au site online. A moins de choses exceptionnellement intéressantes, ceci demande trop de travail de notre part

En cas de problèmes

• Si le problème est purement technique (problème d'installation de EasyPhp notament), vous devrez vous débrouiller seul avec l'aide des forums internet ... bon en fait ce n'est pa vrai, on aide parfois par mail. A signaler : si vous avez un serveur html déjà installé sur votre PC (IIS par exemple), vous allez avoir des pbs pour faire marcher le serveur Apache...

• Si la notice ne vous semble pas claire, ou si vous avez des questions spécifiques au contenu par exemple : bindusara@free.fr

Les fichiers à téléchargez suivant vos besoins :

Fichier pour les Litanies de Sang (755 Mo)	www.zip (535 Mo) gal.zip (238 Mo)
Contenu des tables de la base de donnée (indispensable pour la partie dynamique du site)	sauvegardes des tables.zip

Mises à jours du site : les mises à jours correspondent à des fichiers additionnels (de nouvelles pages), ou bien à des fichiers qui vont écraser ceux téléchargés précedemment (voir le fichier texte de consigne fourni dans chaque zip). Si ce sont des fichiers spécifiés comme "SQL", les ordres doivent être intégrés dans la gestion de la base de données (voir plus bas). ces fichiers doivent être placés sur le site les uns après les autres, afin de bénéficier de toutes les modifications. IMPORTANT : le fichier indispensable.zip ne comprend pas ces modifications!!!

Date	Fichier	Pages	Ordres SQL

Etape 1 : installer Easyphp

• Qu'est-ce que EasyPhp?

EasyPhp est un logiciel qui installe d'autres logiciels à savoir un moteur Apache, MySQL, un système d'administartion de base de données, et PHP.

• Pourquoi installer EasyPhp

Parce qu'un site comme les Litanies ont besoin d'un serveur (Apache) et de bases de données (MySQL). Quand vous consultez les Litanies sur internet, vous contactez un serveur. Pour faire marcher le site chez vous, l'ordinateur appelera le moteur apache, comme si c'était sur internet, et renverra la réponse à votre navigateur. De plus, l'installation de PHP permet au moteur Apache d'interpréter les pages avec extension ".php"

• Téléchargez EasyPhp sur http://www.easyphp.org. Le site est en français, la page de téléchargement accessible en haut sur le bandeau. Prenez la première version, qui est la plus récente.

• Installez easyPhp, comme n'importe quel autre programme Windows. De préférence, laissez les chemins par défaut, car c'est ceux-ci qui seront utilisés dans la suite du descriptif.

Etape 2 : configurer Easyphp

• Pourquoi changer la configuration de base?

Parce qu'elle renvoie des messages d'erreur de scripts. Autrement dit : certaines pages ne sont pas codées parfaitement mais fonctionent, et on se fiche de savoir qu'elles erreurs sont renvoyées.
Parce que la configuration de base de la dernière mouture ne permet pas l'interprétation de certaines parties du code des pages.

• Editer la configuration

  • lancer EasyPhp dans le menu démarrer Windows.

• vérifier en bas à droite que vous avez l'icône indiquant que le serveur Apache est lancé, le point rouge doit clignoter :

• clic droit sur l'icône, "Configuration", "PHP" (attention, pas EasyPhp!!). Ceci ouvre un fichier texte que nous allons éditer

• rechercher le texte "display_errors". Les lignes commençant par un point virgule ";" ne nous intéressent pas car sont du commentaire. La seule contenant ce texte et sans point virgule doit avoir : display_errors = On. Le modifier en display_errors = Off.
  rechercher le texte "short_open_tag". Les lignes commençant par un point virgule ";" ne nous intéressent pas car sont du commentaire. La seule contenant ce texte et sans point virgule doit avoir : short_open_tag = Off. Le modifier en short_open_tag = On.
  Enregistrez le fichier, et fermez le.

Etape 3 : installer les pages du site

Les pages sont fournies zippées, sous forme de plusieurs archives. La première archive est l'image de base du site. Il faut l'installer telle quelle, avec l'arborescence founie, dans  : C:/Program Files/EasyPhp X.XX/www (voir dessin à côté). Les autres archives (si elles existent) contiennent l'arborescence du site des Litanies de Sang : chaque contenu de répertoire doit être déplacé dans le repertoire correspondant sur votre site, afin d'écraser les anciennes pages. Attention : les images des personnages et des galeries ont été volontairement mises à part de l'image de base du site, à cause de la taille du téléchargement. Seules les images nécessaires au site (illustrations de pages, titres etc) ont été conservées. Si vous voulez l'intégralité du site, vous devez télécharger les fichiers zippés des images, et les placer dans les répertoires correspondants. A ce stade de l'installation, vous ne pouvez accéder qu'aux fichiers statiques, c'est à dire à une image du site sans les bases de données. Ceci vous permet par exemple de voir les pages de clan, mais pas les pages des disciplines, qui sont dynamiques. Pour visualiser le site  : Si EasyPhp n'est pas lancé (le e avec le point rouge en bas à droite), le lancer dans le menu Démarrer. Clic droit sur l'icône, puis Web local.

Vous devez voir apparaître la page suivante (si vous avez déjà votre explorateur ouvert, la page s'ouvrira dedans. Si aucun explorateur n'est ouvert, une fenêtre doit s'ouvrir) :

Quelques explications : en haut, dans l'URL, le "http://127.0.01/" signifie "adresse du serveur hébergé par cette machine". Donc on interroge le serveur Apache.
En l'occurence, il renvoie une page par défaut : la liste des répertoires contenu dans le répertoire racine WWW d'Apache.

• Cliquez sur www : vous aboutissez sur les Litanies de Sang

Etape 4 : installer la base de données

Cette étape est la plus compliquée et la plus délicate, surtout si vous n'y connaissez rien.

• Téléchargez les fichiers contenant les ordres sql si vous ne l'avez pas déjà fait

• Dézippez le tout : les fichiers sql obtenus vous serviront plus tard.

• Clic droit sur l'icône de EasyPhp en bas à droite, clic sur administration       

• Vous aboutissez sur une page permettant l'administration d'EasyPhp :

Cliquez sur Manage Database

• Vous aboutissez sur la page suivante :

• Vous allez créez la base de données (qui contiendra les tables de données). Dans le champs Create new database, taper litanies_worldofdarkness, puis cliquez sur le bouton Create.

Vous obtenez la page suivante :



J'attire votre attention sur deux des éléments de la page, que vous allez retrouver constament :

• la liste déroulante database à gauche, montrant toutes les bases de données gérées. En cliquant sur l'une des bases, vous pouvez afficher les tables contenues, et ensuite, afficher les lignes de ces tables, les modifier etc... (notez bien que dans le shoot suivant, il s'agit de mes bases. Vous ne devez avoir en théorie que litanies_worldofdarkness et mysql)

• l'onglet SQL

• Positionnez vous sur la base litanies_worldofdarkness en la sélectionnant dans le menu déroulant comme décrit ci-dessus.

• Cliquez sur l'onglet SQL. Vous obtenez la page suivante :

Cliquez sur Browse, et sélectionnez l'un des fichiers d'ordre sql que vous avez dézippé plus haut. Cliquez sur go. Le fichier sélectionné va créer des tables et/ou insérez des lignes dedans. Répétez le processus pour chaque fichier.

Le tableau ci-dessous récapitule le nombre d'ordres, que vous devez vérifier à chaque nouveau fichier :

ATTENTION : le fichier base_personnages1 doit être chargé avant base_personnages2.sql, base_personnages3.sql et base_personnages4.sql. Si vous ne le faites pas, vous aurez un message d'erreur : vous tenterez en fait d'insérez des lignes dans une table qui n'existe pas.


ATTENTION : parfois, l'interface va vous affichez ce message :
Your SQL-query has been executed successfully
avec une liste d'ordres SQL en dessous. Ceci signifie que tout s'est bien passé. Et parfois, la réalisation des ordres est un peu longue. Si le temps vous parait disproportionné (plus de deux minutes par exemple, tout dépend de votre machine et de sa puissance), recommencez l'opération. Si la table a été partiellement créée (vérifiez le nombre de lignes qu'elle doit avoir), vous pouvez cliquez sur l'onglet Drop pour la faire disparaître,avant de tenter de la recréer.

Vous pouvez ensuite vous balladez sur les Litanies de Sang (voir plus haut, Web local sur le menu déroulant du logo EasyPhp).

Etape 5 : finaliser les fonctionnalités du site

• Activer les possibilités de recherches par mots clés

• Vider la table recherche_maitre

• Aller sur le site via la procédure habituelle

• Colonne droite en bas, cliquez sur "Gestion et Aléatoire"

• Dans Login, tapez "Officiel", dans le mot de passe, choisissez un mot de passe (le plus simple possible : il vous permettra d'accéder aux fonctionnalités. Si vous perdez le mot de passe, sachez que vous pouvez le retrouver dans la table base_login dans l'administration de la base de données)

• Cliquez sur OK. Normalement, vous devez obtenir "Actuellement, votre login est : Officiel". Si ce n'est pas le cas, recommencez. Au pire, vérifier la table base_login

• Une fois que le bon message affiché, cliquez sur Gérez les bases avec ce login

• Cliquez sur Autres gestions

• Cliquez sur Accéder à la gestion de la base de recherche

• Cliquez sur Mise à jour automatique de la table de recherche. ATTENTION : comme spécifié sur la page, la procédure est TRES longue. Laissez tourner votre ordinateur jusqu'à affichage du message indiquant que la mise en base est terminée. Si vous devez arrêtez avant, ce n'est pas grave : vous pouvez recommencer l'opération plus tard : l'indexation recommencera là où elle s'est arrêtée (en fait pas tout à fait, mais ce n'est pas important).