@DATABASE Documentation de WoW
@WORDWRAP

@NODE main
@TITLE "WoW - A lire !"
@{JCENTER}@{B}WoW v0.28@{UB}
Utilitaire de conversion de textes - Mathias PARNAUDEAU


@{"Mais qu'est-ce que c'est ?" LINK "Whatisit"}

@{"Pourquoi un tel logiciel ?" LINK "Pourquoi"}

@{"Possibilités              " LINK "Possibilités"}

@{"Comment ça marche ?       " LINK "Utilisation"}

@{"Questions & réponses      " LINK "Questions"}

@{"Une longue histoire       " LINK "Historique"}

@{"Contactez-moi             " LINK "Auteur"}

@{"Remerciements             " LINK "Merci"}
@{JLEFT}
@ENDNODE

@NODE Whatisit

WoW est un convertisseur de textes qui j'espère permettra d'étendre la compatibilité entre logiciels ou standards et d'éviter la frustration de ne pouvoir lire un fichier texte.
Il fonctionne comme une commande classique, avec ou sans argument (@{"cf. Utilisation" LINK "Utilisation"}). Dans le deuxième cas, une interface apparaît (c'est quand même plus pratique).

WoW est programmé en Blitz Basic sur un Amiga 1200. Il tourne à priori sur toutes les machines et a été testé avec succès sur processeur 060 (merci Rafy).

Commencé le 18 octobre 1998, ce programme continuera d'être développé jusqu'à ce que les objectifs soient atteints. La suite dépendra de vos @{"propositions" LINK "Questions"}

@ENDNODE


@NODE Pourquoi
@TITLE "Pourquoi WoW ?"

1. J'en avais assez qu'on veuille bien reconnaître les capacités de l'Amiga avant ... d'acheter un PC, parce-que c'est "plus compatible" et qu'on peut s'échanger des fichiers. Faux ! La pratique le montre : personne à ma connaissance n'a réussi, d'un PC à un autre,  à lire un document Word dans le même état que le fichier sauvegardé. Quelle puissance dans la compatibilité ! Et il n'y a bien que ce genre de fichiers (formats verrouillés par M$) que l'on ne peut récupérer sur Amiga. Pour le reste, c'est compatible : images, sons et musiques, html, vidéos (Quicktime, Avi, etc.) ... tout passe (hormis les executables bien sûr). Même les fichiers XPress sont récupérables via PageStream (dans quel état ?).

2. La deuxième raison de ce développement est double :
        - un programme similaire n'existe pas (ben, je crois) ;
        - j'aime le côté "Je veux un programme qui réponde à mes besoins, je n'ai qu'à le développer" (ce n'est pas peu dire).


@{U}Moyens existants pour convertir un fichier Word@{UU}

- Le sauver en RTF (Rich Text Format) pour le récupérer sous Wordworth par exemple. Un problème cependant : on perd les images, les tableaux, ... et Ww6 a quelques problèmes de reconnaissance (les apostrophes disparaissent par exemple).

- Le sauver en ASCII et là on perd tout ! Sauf le texte de base, bien entendu :-)
Je crois qu'il existe un programme du DP qui convertit un fichier .doc en .asc. En gros, il fait la même chose que Word ;-)

@ENDNODE


@NODE Possibilités
@TITLE "Ce que permet WoW et pourquoi ces choix ?"

Dans un premier temps, avec WoW, pour pourrez au moins lire le contenu de bon nombre de fichiers textes. Souvent on récupère des fichiers personnels ou des documents divers (techniques, notices de logiciels, ...) et l'Amiga ne vous permet pas de voir le texte contenu, à moins de tout éditer en hexa. Pas très fonctionnel, tout ça.
Donc WoW permet de convertir en ASCII les fichiers :

@{B}Ww6 -> Ascii @{UB}: Wordworth est un des logiciels les plus répandus sur Amiga. Ceux qui ne l'ont pas voudront peu être lire le dernier essai de leur ami écrivain qui n'a pas pensé à sauver en Ascii (c'est juste un exemple).

@{B}Word -> Ascii @{UB}: C'est un logiciel assez répandu sur une autre plate-forme. Ca aurait manqué de ne pas le faire à beaucoup ...
@{U}Attention@{UU} : ce n'est pas au point, ça convertit bien certains fichiers Word 6 mais pas d'autres : beaucoup de variantes ?

@{B}Rtf -> Ascii @{UB}: Le Rich Text Format est le standard des fichiers textes lorsque l'on transfère un document d'une plate-forme à une autre.

@{B}Html -> Ascii @{UB}: Au cas où on récupère une page Web et qu'on veuille juste le texte, là encore. Tout bon butineur permet la sauvegarde Ascii. C'est juste pour être exhaustif (à tes souhaits).

@{B}AGuide -> Ascii @{UB}: Cette conversion peut-être utile pour remettre en forme une documentation. Le texte ascii obtenu peut être modifié par exemple sous Wordworth et converti en Html. Ok, une conversion directe (Guide -> Ww6 ? Guide -> Html ?) serait plus pratique. Mais tout est envisageable :-)

@{B}Ascii -> Ascii ? @{UB}: Une conversion Ascii-Ascii : certains vont rire. Les autres savent qu'il existe des variantes : un comble quand on se veut référence universelle !
@{U}Attention !@{UU} : Cette conversion ne fait que dupliquer le fichier, donc il n'y a pas de possibilité de passer d'un type d'Ascii à un autre.


Voilà pour la conversion en Ascii. C'est bien gentil tout ça mais un texte nu n'a souvent que peu d'intérêt puisqu'il apparaît sans attribut. Une remarque en passant : souvent c'est le nu qui met les attributs en valeur, mais pas ici.


C'est pourquoi j'ai pensé qu'après avoir vu quelques formats par le biais de la conversion en Ascii, il serait bon de penser aux choses sérieuses, comme :

@{B}Rtf -> Ww6 @{UB}: laissez tomber votre PC, sauver vos documents Word en RTF (si ils ne contiennent pas d'images) et vive l'Amiga ! L'import standard de RTF par Wordworth est assez limité, j'espère vous offrir plus.
@{U}En projet ...@{UU}

@{B}Html -> Ww6 @{UB}: Utile quand on veut imprimer avec qualité une page Web, éventuellement après avoir ajuster les pages comme on voulait. Rq : l'Ours demandait comment imprimer le fond d'une page Web. WoW : une alternative ?
@{U}En projet ...@{UU}

@{B}Ww6 -> Html @{UB}: Wordworth ne possède pas de de sauvegarde Html, et ça serait pourtant pratique pour faire son site. Je peux vous dire que c'est éprouvant de faire "Sauvez sous", "Ascii", "Oui, je veux réécrire le fichier" car Wordworth, en sauvegarde rapide, considère le document comme étant dans son format. Pas de sauvegarde auto en Ascii : embêtant aussi pour les sauvegardes de scripts ARexx.
@{U}En cours :@{UU} les conversions supportées sont le texte, les styles (gras, souligné, italique) simples ou combinés et le changement de taille des polices, pour un paragraphe donné ou au sein d'un paragraphe.


@{B}Attention @{UB}: Le support des fichiers Word n'existera jamais, car la seule doc' que j'ai trouvé fait près de 500 ko (en ascii) et c'est vraiment une immondice à lire, et vraiment incompréhensible. Comment peut-on créer un format aussi lourd ??


@ENDNODE


@NODE Utilisation
@TITLE "Utilisation de WoW"

Privilégions la fonctionnalité d'un outil, si on a le choix. En plus d'un lancement par le Cli, je vous offre une interface. Elle n'est pas impérative car le programme doit aussi pouvoir être exécuté comme simple commande (pensons aux scripts ARexx, une inerface viendrait tout gâcher ; et comme dirait l'autre : faut pas gâcher).
Attention : en utilisant l'interface, il y a une mise en garde contre l'effacement d'un fichier déjà existant. Sous Cli, point de salut :-(

@{U}Usage@{UU}

Wow -Format Source Destination

-Format désigne le format de destination choisi. Pour ceux qui s'inquièteraient, le format du fichier source est détecté automatiquement.
Source et Destination désignent respectivement le fichier de départ et le fichier converti.

@{U}Les arguments@{UU}
WoW réagit suivant le nombre d'arguments de la façon suivante :
0 : l'interface est chargée et vous choisissez tranquillement vos paramètres. Si vous chargez un fichier à convertir, et exécutez la conversion sans mentionner de fichier destination, l'extension sera adaptée au format choisi (par défaut : Ascii).
1 : vous avez dû faire une erreur : pas de demi mesure ici, WoW vous indique comment l'utiliser. C'est pratique : que ceux qui veulent savoir pourront mettre ? ou -h suivant leur habitude. Ici, dans les deux cas, ils trouveront l'usage correct.
2 : WoW utilise le nom du premier fichier pour créer le deuxième, en lui ajoutant une extension adéquate (comme Sheila).
3 : C'est bien comme ça qu'il faut utiliser WoW. L'exécution suit son cours.
4 ou plus : Seuls les 3 premiers arguments sont pris en compte. Les suivants sont ignorés.

@ENDNODE


@NODE Questions
@TITLE "Questions / Réponses"

Les questions posées par les utilisateurs, les souhaits et suggestions ... accompagnées par mes réponses personnelles (je n'ai pas de secrétaire :-(

A ce propos, je suis ouvert à toutes les suggestions, concernant par exemple : la facilité d'utilisation, les performances, les choix des formats proposés, etc.
Je n'ai pas spécialement prévu de traiter l'AmigaGuide, mais ça pourrait être une idée.

Pour quoi que ce soit, n'hésitez pas : @{"contactez-moi" LINK "Auteur"}.

@{U}Les premières questions :@{UU}

@{B}Les textes Ascii ne sont convertibles en rien :-(@{UB}

C'est vrai qu'il existe différentes variantes d'Ascii mais certains utilitaires DP passent très bien de l'un à l'autre. A quoi servirait-il de convertir un tel fichier au format Wordworth par exemple, vu que l'Ascii est importé sans problème (heureusement !). 
C'est faux : ils peuvent se transformer en Html : l'avantage que j'y vois est d'ajouter automatiquement des tags "saut de ligne" si on veut un fichier Html.


@{B}Serait-il possible de visionner tout ou partie du texte dans une fenêtre indépendante ? @{UB}

Question suivante ! :-) Voilà un vrai défi. Malheureusement, je ne pense pas que ce soit primordial : ça serait utile si on pouvait modifier le texte affiché, mais là, WoW deviendrait un traitement de textes ! WoW restera un outil de conversion, de taille plutôt modeste.


@{B}Ca serait bien de convertir l'Html en Rtf ...@{UB}

Ca serait bien, oui. Le Rtf est à considérer avec attention, c'est le format standard, pivot, des traitements de textes.


@ENDNODE


@NODE Historique

L'évolution de WoW au fil des versions ... Réservé aux curieux :

0.24. 
    + Supporte les conversions en Ascii des formats : Ww6, Rtf, Html, AGuide, et Word dans une certaine mesure.
    + Convertit les textes Wordworth en Html en conservant les styles, couleurs, tailles, le centrage de paragraphes, ... Le support des images, lignes, listes, tableaux, etc. paraît compromis (dû à l'organisation des données au sein des fichiers Wordworth).

0.26.
	+ Le capricieux listview marche enfin !
	+ Ajout des conversions Ascii->Ascii (!) et Ascii->Html.

@ENDNODE


@NODE Auteur
@TITLE "L'auteur et le logiciel"

Si j'ai écrit WoW, c'est pour apporter ma contribution à l'Amiga, qui le mérite (il mérite même bien mieux :-) 
Freeware : c'est tout à fait l'esprit de l'Amiga : je ne veux aucunement livrer un logiciel bridé pour qu'on m'envoie obligatoirement de l'argent, je souhaite beaucoup plus que ce petit utilitaire dépanne le plus grand nombre.

Si vous pouvez, écrivez-moi pour me faire part de suggestions, bugs, souhaits, ...

Mes coordonnées :

Adresse permanente :	Mathias PARNAUDEAU
				Les Touches Cochin
				79 340 VASLES
				FRANCE

Par l'Internet :		mathias.p@wanadoo.fr
et visitez mon site : 	http://perso.wanadoo.fr/supersport/

@ENDNODE


@NODE Merci

@{U}Remerciements@{UU} :

- A mes dévoués testeurs :
		- OFS
		- Patrick ARTUS
		- David ZISLIN (Zet)
		- Raphaël PARNAUDEAU

- A Denis OBRIOT (Sidne) pour l'icone.

- Aux utilisateurs du Blitz qui m'ont aidé par le biais de la BlitzList (Curt Esser, David McMinn, Paul Burkey, ...)

- A ceux qui soutiennent l'Amiga, aujourd'hui et pendant encore longtemps.

Un petit coucou à toute la rédaction du fantastique aMiGa=PoWeR.

Désolé, mais je ne peux pas remercier ceux qui ont cédé au miroir aux alouettes que l'on appelle PC parceque c'était soit-disant plus compatible et plus puissant. Mais la notion de puissance ne se juge pas qu'en MHz. @{B}La force n'est rien sans la souplesse.@{UB}

@ENDNODE