cvs: phpdoc-fr /reference/hw reference.xml

From: Date: Tue, 02 Mar 2004 14:30:25 +0000
Subject: cvs: phpdoc-fr /reference/hw reference.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-1924@lists.php.net to get a copy of this message
dmanusset Tue Mar 2 09:30:25 2004 EDT Modified files: /phpdoc-fr/reference/hw reference.xml Log: typo

http://cvs.php.net/diff.php/phpdoc-fr/reference/hw/reference.xml?r1=1.6&r2=1.7&ty=u Index: phpdoc-fr/reference/hw/reference.xml diff -u phpdoc-fr/reference/hw/reference.xml:1.6 phpdoc-fr/reference/hw/reference.xml:1.7 --- phpdoc-fr/reference/hw/reference.xml:1.6 Tue Feb 24 13:10:07 2004 +++ phpdoc-fr/reference/hw/reference.xml Tue Mar 2 09:30:24 2004 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> +<!-- $Revision: 1.7 $ --> <!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - +<!-- Reviewed: yes --> <reference id="ref.hyperwave"> <title>Hyperwave</title> <titleabbrev>Hyperwave</titleabbrev> @@ -33,7 +33,7 @@ du document. Ces méta données sont des listes d'attributs qui peuvent être étendues par l'utilisateur. Un attribut est une paire clé/valeur de la forme : clé =valeur. L'enregistrement complet - contient autant de paire que le désire l'utilisateur. Le nom d'un + contient autant de paires que le désire l'utilisateur. Le nom d'un attribut n'a pas besoin d'être unique, c'est-à-dire qu'une même clé peut apparaître plusieurs fois dans un enregistrement. Cela peut être utile si vous devez donner un @@ -41,7 +41,7 @@ cas pareil, la convention est que chaque valeur de titre est précédée par deux lettres et deux points, tel que : 'fr:Titre en français' ou 'ge:Titel in deutsch'. D'autres attributs - comme une description ou des mots clés sont aussi susceptibles de + comme une description ou des mots-clés sont aussi susceptibles de recourir à ce genre de procédé. Vous pouvez aussi remplacer l'abréviation de langage par une autre chaîne, tant qu'elle est séparée de la valeur par les deux points. @@ -51,22 +51,22 @@ les paires clé/valeur, séparées par un retour à la ligne. L'extension Hyperwave reconnaît une autre représentation qui est un tableau associatif, où les attributs servent de clés. - Les attributs multilingues étant géré sous la forme d'un + Les attributs multilingues étant gérés sous la forme d'un autre tableau associatif, dont les clés sont les chaînes de langue. En fait, tous les attributs multiformes sont gérés sous la forme de tableau associatif. (Cela n'est pas encore complètement - codé. Uniquement les attributs de titre, description et mot clés + codé. Uniquement les attributs de titre, description et mot-clés sont traités correctement). </para> <para> - En dehors des documents, tous les hyper liens contenus dans un documents sont + En dehors des documents, tous les hyperliens contenus dans un document sont enregistrés dans un autre enregistrement. Les hyperliens qui sont à l'intérieur d'un document en seront supprimés, et - enregistrés dans des objets particuliers, au moment de l'insertion - dans la base de données. L'enregistrement des hyper-liens + enregistrés dans des objets particuliers au moment de l'insertion + dans la base de données. L'enregistrement des hyperliens contient les informations d'origine et d'objectif. Afin d'accéder au document original, vous devrez lire le document sans les liens, puis lire - les liens, et les réinsérer (les + les liens et les réinsérer (les <function>hw_pipedocument</function> et <function>hw_gettext</function> le font pour vous. L'avantage de séparer les liens du document est évident : une fois qu'un document, cible d'un hyperlien, a @@ -77,7 +77,7 @@ </para> <para> Dire que <function>hw_pipedocument</function> et <function>hw_gettext</function> - font l'insertion automatiquement n'est pas aussi simple qu'il n'y paraît. + font l'insertion automatiquement n'est pas aussi simple qu'il y paraît. L'insertion implique une certaine hiérarchie de documents. Sur un serveur web, la hiérarchie est fournie par le système de fichiers, mais Hyperwave dispose de sa propre hiérarchie et les noms de fichiers ne @@ -86,10 +86,10 @@ la construction de la hiérarchie et de l'espace des noms dans une hiérarchie web et un espace de nom web. La différence fondamentale entre Hyperwave et le web est qu'il y a une distinction claire - en les noms et la hiérarchie dans Hyperwave. Le nom ne contient aucune + entre les noms et la hiérarchie dans Hyperwave. Le nom ne contient aucune information à propos de la position de l'objet dans la hiérarchie. Sur le web, le nom contient les informations de localisation dans la - hiérarchie. Cela conduit à deux méthodes de d'accès : + hiérarchie. Cela conduit à deux méthodes d'accès : soit la hiérarchie Hyperwave et le nom de l'objet sont inscrits dans l'URL. Pour simplifier les choses, une deuxième approche est pratiquée. L'objet Hyperwave de nom 'mon_objet' correspond à @@ -103,16 +103,16 @@ Ayant pris cette décision, un deuxième problème surgit : comment faire l'interface avec PHP ? L'URL http://hote/mon_objet n'appellera aucun script PHP à moins que vous ne demandiez à votre serveur - web de le remplacer par autre chose, comme par exemple : + web de le remplacer par autre chose, comme : 'http://host/php3_script/mon_objet' et le script 'php3_script' utilise la variable $PATH_INFO pour rechercher l'objet 'mon_objet' sur le serveur Hyperwave. - Il y a juste un petit inconvénient , qui peut facilement être + Il y a juste un petit inconvénient, qui peut facilement être corrigé. Réécrire une URL ne vous permettra aucun accès aux autres documents du serveur web. Un script de recherche dans le serveur Hyperwave serait impossible. Il vous faudra donc au moins - une autre règle pour exclure certaines URL, comme par exemple celles + une autre règle pour exclure certaines URL, comme celles qui commencent par http://host/Hyperwave. Voici, de manière simple, - la manière de partager un espace de nom entre un serveur web et un + comment partager un espace de nom entre un serveur web et un serveur Hyperwave serveur. </para> <para> @@ -120,7 +120,7 @@ l'insertion dans les documents. </para> <para> - Il est plus compliqué d'avoir PHP ne fonctionne pas comme un module + Il est plus compliqué d'avoir PHP ne fonctionnant pas comme un module de serveur, ou un script CGI, mais comme une application indépendante. Dans ce cas, il est utile d'inscrire la hiérarchie et le nom de fichier Hyperwave dans le système de fichier. Mais comme cela risque d'entrer @@ -131,25 +131,25 @@ Le protocole réseau pour communiquer avec un serveur Hyperwave est appelé <ulink url="&spec.hyperwave;">HG-CSP</ulink> (Hyper-G Client/Server Protocol). Il est basé sur des messages qui - initie des actions, comme par exemple, lire l'en-tête de fichier. Dans - les premières versions de Hyperwave Server deux clients natifs + initient des actions, comme lire l'en-tête de fichier. Dans + les premières versions de Hyperwave Server, deux clients natifs (Harmony, Amadeus) étaient fournis pour permettre la communication avec le serveur. Ils ont disparu lors de la commercialisation de Hyperwave. - En tant qu'ersatz, un client appelé wavemaster est désormais - fourni. wavemaster est un espèce ce convertisseur de protocole de + En tant qu'ersatz, un client appelé wavemaster est désormais + fourni. wavemaster est un espèce de convertisseur de protocole de <abbrev>HTTP</abbrev> en <abbrev>HG-CSP</abbrev>. L'idée est de faire toute l'administration de la base et la visualisation des documents par une interface web. Le wavemaster implémente un jeu d'emplacement pour certaines actions de personnalisation de l'interface. Ce jeu est appelé <abbrev>PLACE</abbrev> language. <abbrev>PLACE</abbrev> pêche encore par - le manque de nombreuses fonctions de programmation, et le manque + le manque de nombreuses fonctions de programmation et le manque d'évolutivité. Cela a conduit à l'utilisation de JavaScript ce qui ne rend pas la vie facile. </para> <para> Que PHP supporte Hyperwave permet de combler ces manques. PHP implémente tous les messages définis par <abbrev>HG-CSP</abbrev> mais fourni - d'autres commandes puissantes, comme par exemple, celle de lire des documents + d'autres commandes puissantes, comme celle de lire des documents complets. </para> <para> @@ -160,37 +160,37 @@ <itemizedlist> <listitem> <simpara> - object ID: un entier, unique pour chaque objet sur le serveur Hyperwave. C'est - aussi un des attributs de l'enregistrement de l'objet (ObjectID).Les object ids - sont souvent utilisées comme paramètre d'entrée pour + object ID : un entier unique pour chaque objet sur le serveur Hyperwave. C'est + aussi un des attributs de l'enregistrement de l'objet (ObjectID). Les object ids + sont souvent utilisés comme paramètre d'entrée pour spécifier un objet. </simpara> </listitem> <listitem> <simpara> - object record: Une chaîne contenant des paires clé=valeur. Les + object record : une chaîne contenant des paires clé=valeur. Les paires sont séparées par un retour à la ligne. Un enregistrement d'objet peut facilement être converti en tableau, avec la fonction <function>hw_objrec2array</function>. De nombreuses fonctions - retournent un object records. Ces fonctions ont leur nom qui finit par obj. + retournent un object record. Ces fonctions ont leur nom qui finit par obj. </simpara> </listitem> <listitem> <simpara> - object array: Un tableau associatif qui contient tous les attributs d'un objet. + object array : un tableau associatif qui contient tous les attributs d'un objet. La clé est l'attribut. Si un attribut apparaît plusieurs fois, il sera représenté sous la forme d'un tableau associatif ou indexé. Les attributs qui dépendent des langues (comme title, keyword ou description) seront représentés sous la forme d'un - tableau associatif, dont les clés seront les abréviations de + tableau associatif dont les clés seront les abréviations de langues. Tous les autres attributs à valeur multiple prendront la forme d'un tableau indexé. </simpara> </listitem> <listitem> <simpara> - hw_document: Ce type est un nouveau type de données, qui contient le - document lui-même, comme par exemple HTML, PDF etc. Il est + hw_document : ce type est un nouveau type de données, qui contient le + document lui-même, comme HTML, PDF etc. Il est optimisé pour les documents HTML mais peut s'utiliser avec n'importe quel format. </simpara> @@ -215,7 +215,7 @@ <term>CollectionHead</term> <listitem> <simpara> - Nombre d'objet dont l'attribut PresentationHints est CollectionHead. + Nombre d'objets dont l'attribut PresentationHints est CollectionHead. </simpara> </listitem> </varlistentry> @@ -223,7 +223,7 @@ <term>FullCollectionHead</term> <listitem> <simpara> - Nombre d'objet dont l'attribut PresentationHints est FullCollectionHead. + Nombre d'objets dont l'attribut PresentationHints est FullCollectionHead. </simpara> </listitem> </varlistentry> @@ -248,7 +248,7 @@ <term>Total</term> <listitem> <simpara> - Total: Nombre d'enregistrements. + Total : nombre d'enregistrements. </simpara> </listitem> </varlistentry> @@ -271,7 +271,7 @@ <para> L'extension Hyperwave est utilisée de manière optimale lorsque PHP est compilé comme module Apache. Dans ce cas, le serveur Hyperwave - sous jacent peut être caché quasiment totalement aux utilisateurs, + sous-jacent peut être caché quasiment totalement aux utilisateurs, si Apache utilise son moteur d'écriture. Les explications suivantes vous éclaireront : </para> @@ -279,13 +279,13 @@ Etant donné que PHP avec l'extension Hyperwave et Apache tend à remplacer la solution native basée sur Wavemaster, je vais supposer que le serveur Apache servira seulement d'interface Hyperwave. Ce n'est pas - nécessaire, mais cela simplifie grandment la configuration. Le + nécessaire, mais cela simplifie grandement la configuration. Le concept est très simple. Premièrement, vous avez besoin d'un script PHP qui évalue la variable <envar>$_ENV['PATH_INFO']</envar> et considère que cette valeur est un objet Hyperwave. Appelons ce script 'Hyperwave'. L'URL <systemitem role="url">http://votre.hote/Hyperwave/nom_objet</systemitem> - retourne alors l'objet Hyperwave dont le nom est 'nom_objet'. Le script doit + retourne l'objet Hyperwave dont le nom est 'nom_objet'. Le script doit alors réagir suivant le type de l'objet. Si c'est un groupe, il devra probablement retourner une liste de fils. Si c'est un document, il pourra retourner son type MIME et son contenu. Une amélioration peut @@ -304,7 +304,7 @@ Maintenant toutes les URL pointent sur un objet Hyperwave. Cela conduit à un problème simple. Il n'y a pas d'autre façon d'exécuter, c'est-à-dire rechercher, un autre script que ce script 'Hyperwave'. - Cela pourra être corrigé avec une autre règle telle que: + Cela pourra être corrigé avec une autre règle telle que : <example> <title>Configuration d'Apache pour HyperWave (2)</title> <programlisting role="apache-conf"> @@ -316,12 +316,12 @@ Le dossier <filename class="directory">/usr/local/apache/htdocs/hw</filename> sera ainsi réservé pour d'autres scripts et fichiers. Assurez-vous que cette règle est évaluée avant la première - règle que nous avons définie. Il y a juste un léger + règle que nous avons défini. Il y a juste un léger inconvénient : tous les objets Hyperwave qui commencent par 'hw/' seront cachés. Alors, assurez-vous que vous n'utilisez pas de tels noms. Si vous avez besoin d'autres dossiers, par exemple, un dossier d'images, ajoutez simplement d'autres règles. N'oubliez pas de lancer le moteur de - réécriture avec + réécriture avec. <example> <title>Demarrer les règles de réécriture d'Apache pour HyperWave</title> <programlisting role="apache-conf"> @@ -357,7 +357,7 @@ <simpara> Un script pour chaque fonction supplémentaire, comme afficher un objet, afficher des informations sur les utilisateurs, afficher - le statut du serveur, etc... + le statut du serveur, etc. </simpara> </listitem> </itemizedlist>
« previous php.doc.fr (#1924) next »