Documentation |   
Fonctionnalités avancées
Arachnophilia est © Copyright 2015, P. Lutus.

Arachnophilia est CareWare

Configuration relocalisable | Support côté serveur PHP/ASP | Arachnophilia Macro Architecture
Opérations FTP avancées | Embellisseur HTML | Support Unicode

Cette page décrit les fonctionnalités intéressantes pour les utilisateurs d'Arachnophilia : comment exercer un meilleur contrôle sur le service FTP, comment répertorier et utiliser les commandes du système Arachnophilia, les problèmes d'internationalisation et quelques autres choses.
Configuration relocalisable

Normalement, Arachnophilia place sa configuration dans le répertoire personnel de l'utilisateur, sous un répertoire nommé ".Arachnophilia", mais pour des raisons particulières, l'utilisateur peut spécifier un autre emplacement de configuration sur la ligne de commande d'Arachnophilia. Cela permet à l'utilisateur de placer Arachnophilia sur une clé USB, accompagné de la configuration préférée de l'utilisateur, pour une utilisation sur n'importe quel ordinateur disponible. Une autre utilisation de cette fonctionnalité consiste à créer plusieurs configurations Arachnophilia avec des propriétés différentes et à spécifier laquelle doit être utilisée au moyen de l'argument de ligne de commande ci-dessus. Cela permet à l'utilisateur de créer des configurations spéciales pour différentes tâches et de basculer facilement entre elles. Voici les règles d'utilisation de cette fonctionnalité :

  • L'emplacement fourni doit spécifier un répertoire et non un fichier.
  • L'emplacement fourni est soumis sur la ligne de commande d'Arachnophilia et doit être le premier argument s'il y en a plusieurs. Exemple:
    java -jar (chemin d'accès à Arachnophilia)/Arachnophilia.jar (chemin de configuration alternatif) (noms de fichiers facultatifs)
  • Il n'est pas nécessaire de copier une configuration Arachnophilia existante vers l'emplacement spécifié ; si aucune n'est fournie, une configuration par défaut sera créée.
  • Si l'utilisateur choisit de copier une configuration existante, veillez à copier l'intégralité du répertoire de configuration d'Arachnophilia, portant le nom « .Arachnophilia », vers le nouvel emplacement, plutôt que les fichiers et répertoires qu'il contient.
Support côté serveur PHP/ASP
  • Vue d'ensemble

    Les pages PHP et ASP sont des pages Web spéciales qui sont traitées par un serveur avant d'être présentées au navigateur client. Si vous disposez d'un serveur sur votre machine de développement, vous pouvez utiliser Arachnophilia pour prévisualiser ces pages de manière interactive.

  • Procédure

    Lors de la préversion, Arachnophilia gère les types de fichiers PHP et ASP d'une manière particulière. Une chaîne d'appel spéciale leur est attribuée qui les amène à être gérés par votre serveur Web local. Cette chaîne est définie par l'utilisateur dans la boîte de dialogue de configuration du navigateur (HTML ... Configurer les navigateurs).

    Vous souhaiterez peut-être placer ces pages spéciales dans votre répertoire HTML par défaut, auquel cas il vous suffit de saisir le nom de votre serveur dans la chaîne d'initialisation, comme ceci :

    http://nom-de-votre-serveur/$1

    N'oubliez pas qu'un simple nom de fichier est ajouté à cette chaîne d'initialisation (et non un chemin), à la position prise par le jeton "$1". Cela signifie que si vous travaillez dans un sous-répertoire de l'arborescence de votre site Web, vous devrez fournir explicitement ces informations de chemin supplémentaires, ou vous pouvez configurer un alias dans votre logiciel serveur et saisir l'alias à la place. Contrairement à la prévisualisation de pages Web HTML ordinaires à l'aide de chemins de fichiers, vous devez trier la relation entre les chemins de fichiers littéraux et les chemins relatifs du site : Arachnophilia ne peut pas le faire à votre place.

    Un exemple. Si vous travaillez dans un répertoire nommé "php" qui est un sous-répertoire du répertoire "racine du document" de votre serveur, vous devez saisir :

    http://nom-du-serveur/php/$1

    Encore une chose. Si vous écrivez une page traitée par le serveur qui s'appelle de manière récursive, il est indéniable que vous devrez enregistrer la page et appuyer directement sur "Actualiser" sur votre navigateur. Dans un cas comme celui-ci, l'utilisation d'un fichier temporaire (l'approche de prévisualisation par défaut d'Arachnophilia) ne fonctionnera pas.

  • Un simple test PHP

    Une fois que vous avez configuré votre serveur Web local, créez une nouvelle page PHP et placez-y la ligne suivante, entre les balises <body> et </body> :

    <?php phpinfo() ?>

    Configurez la chaîne d'initialisation du serveur comme expliqué ci-dessus et appuyez sur le bouton Aperçu. Si vous avez correctement configuré votre serveur, vous verrez un résumé assez long des fonctionnalités PHP actuellement activées.

Arachnophilia Macro Architecture
  • Aperçu

    La liste de macros à gauche dans l'écran principal d'Arachnophilia est en fait une sorte de standard téléphonique qui relie les éléments de menu, les boutons de la barre d'outils et les frappes au clavier aux commandes d'Arachnophilia (ainsi qu'au texte saisi par l'utilisateur). La liste des commandes d'Arachnophilia est plutôt longue et toutes les commandes ne sont pas représentées par un élément de menu ou un bouton de barre d'outils dans la configuration par défaut.

    Pour voir une liste de toutes les commandes, utilisez Outils... Liste des commandes système. Il s’agit d’une liste très importante : rappelez-vous où elle se trouve et consultez-la souvent. Certaines des commandes les moins souvent utilisées ne sont décrites que dans la liste elle-même, nulle part ailleurs. Et n’importe lequel d’entre eux peut être inclus dans les macros que vous écrivez.

  • Arguments de commande

    Certaines commandes d'Arachnophilia acceptent des arguments, ce qui permet à l'utilisateur de créer des commandes spécifiques et puissantes. Un exemple pourrait être :

    [FindReplaceAll:/cat/chien/]


    Ce type de macro rend inutile la saisie manuelle du texte de recherche et de remplacement pour les opérations courantes.

    En résumé, la liste contient de nombreuses commandes puissantes, certaines non répertoriées ou décrites ailleurs. C'est une bonne idée de consulter cette liste avant de demander une fonctionnalité qui existe déjà .

Opérations FTP avancées
  • Détermination du type de fichier

    Certaines plates-formes doivent faire la distinction entre les fichiers texte et les fichiers binaires afin de traiter les fins de ligne des fichiers texte. Les services FTP maintiennent généralement une liste de suffixes de fichiers et leurs types respectifs. Arachnophilia maintient cette liste dans le cadre de son fichier de configuration de type de fichier.

    Le fichier de configuration du type de fichier se trouve à l'emplacement :

    /home/benutzer/.Arachnophilia/FileData.txt


    Ce fichier est auto-documenté et contient un enregistrement pour chaque type de fichier. Chaque enregistrement fait la distinction entre les types de fichiers binaires et texte.

    Pour ajouter un suffixe de fichier texte, disons "xyz", ajoutez-le simplement à un type de fichier texte existant, comme ceci (changement de rouge ) :

    Texte|t|-|txt,texte,doc,bat,log, à déterminer ,xyz ; fichiers texte


    Ou bien, vous souhaiterez peut-être ajouter un nouveau type de fichier simplement pour contenir des suffixes de type de fichier texte, comme ceci :

    TextFileSuffixes|t||abc,def,ghi,jkl ; types de fichiers texte pour FTP


    Le service FTP utilise par défaut le type de fichier binaire (après la build 1860) mais, pour prendre sa décision finale, il recherche dans ce fichier de configuration toutes les entrées identifiant un type de fichier comme texte.

  • Débogage des opérations FTP

    Le service FTP dispose d'une fonction de débogage, contrôlée par le curseur en bas de la boîte de dialogue FTP. Pour voir plus de messages de débogage, faites simplement glisser le contrôle vers la droite et exécutez la transaction. Chaque incrément vers la droite augmente le niveau de détail.

    Je reçois de nombreux "rapports de bogues" d'utilisateurs qui disent simplement "La transaction FTP vient de s'arrêter". Les utilisateurs doivent consulter les messages de débogage pour découvrir ce qui s'est réellement passé.

  • Chemin d'arrivée

    Les systèmes diffèrent considérablement quant au type d’entrée du chemin de destination dont ils ont besoin. Certains systèmes exigent que le chemin commence par une barre oblique ("/"), certains ne doivent pas l'avoir, d'autres s'en moquent. Il s'agit d'un problème de débogage très courant.

    Exemple : disons que vous disposez d'un site Web avec un répertoire cible "WebPages". Selon le système d'exploitation exécuté par le serveur, vous devrez peut-être effectuer l'une de ces entrées pour un chemin de destination :

    /accueil/nom d'utilisateur/Pages Web
    /Pages Web
    ~/Pages Web
    /


    Le moyen le plus simple de résoudre ce problème est de demander à votre service quelle option est correcte, mais la lecture de la trace de débogage complète est toujours utile. Le côté destination peut se plaindre si l'entrée n'est pas correcte (mais n'entrez pas un nom de répertoire sans un "/" ou un "~" précédent, ce n'est jamais correct).

    Si vous n'utilisez pas la fonction de débogage décrite ci-dessus, vous ne saurez peut-être jamais pourquoi le transfert a échoué. .

Embellisseur HTML
L'embellisseur HTML (situé dans le menu HTML) indentera votre page HTML tout comme le font les embellisseurs de code, sauf si la page contient du HTML hérité, il peut y avoir des problèmes que l'on ne voit pas dans les embellisseurs de code. La plupart des problèmes sont causés par une syntaxe HTML incohérente : certaines balises ont des partenaires de fermeture, d'autres non. Et certaines balises ont parfois des partenaires de fermeture, mais pas d'autres fois, les deux syntaxes sont valides. Exemple:
Mon paragraphe<p> (juridique)

<p align="left">Mon paragraphe</p> (also legal)

Étant donné que ces deux formulaires sont du HTML valide et qu'il existe de nombreux exemples valides, il n'existe aucun moyen significatif d'écrire un embellisseur fiable et robuste pour le HTML existant, ce que j'ai découvert au fil des années d'essais. Mais ces problèmes sont résolus par la conversion en XHTML, objectif principal des versions les plus récentes d'Arachnophilia.

La version majeure précédente d'Arachnophilia (4.0) avait un embellisseur beaucoup plus ambitieux qui tentait également de corriger la syntaxe HTML. Finalement, en raison des incohérences du HTML existant, ces deux fonctionnalités (embellir et valider) ont été minimisées et l'une d'entre elles a été entièrement abandonnée. Dans la nouvelle Arachnophilia (version 5.3 et ultérieure), en raison de la cohérence fournie par XHTML, HTML Beautify et HTML Validate sont des fonctions distinctes, et toutes deux fonctionnent comme prévu si la page contient une syntaxe XHTML valide.

Si vous souhaitez conserver vos pages telles qu'elles sont, par exemple ne pas les convertir en XHTML, mais que vous souhaitez utiliser les fonctionnalités avancées d'Arachnophilia, effectuez simplement ces modifications :
  • Assurez-vous que chaque balise de votre page possède un partenaire de fermeture :
    <open>contenu</close>
    ou se ferme automatiquement :
    <balise autonome/>
  • Des exemples de balises qui devraient avoir des partenaires de fermeture, mais qui n'en avaient pas dans les versions antérieures d'Arachnophilia, incluent <li></li> et <option></option>.
  • Des exemples de balises qui doivent être <auto-fermées/> incluent <img ... />, <input ... />, <frame .../>, <meta ... /> et environ une demi-douzaine d'autres. Le fait est qu'il ne devrait jamais y avoir de balise sans <soit> un </partenaire> ou la <syntaxe de fermeture automatique/> spéciale.
  • Si ce système est suivi, vous pouvez mettre à jour vos pages avec un minimum d'effort, et vos pages seront plus acceptables pour les navigateurs ainsi que pour Arachnophilia.
C'est un peu un commentaire éditorial. Je recommande fortement au lecteur d'envisager de convertir ses pages en XHTML. Ce changement permet un contrôle bien plus important sur la forme et le contenu des pages, et empêchera l'abandon éventuel de pages Web qui ne sont pas cohérentes en interne.

Au fil du temps, j'ai fait tout ce qui était en mon pouvoir pour automatiser la création de pages Web, et Arachnophilia représente quelques pas dans cette direction (bien que l'écriture de scripts soit la principale approche de l'automatisation). Dans le cas des pages Web HTML existantes, il est très difficile d'appliquer des méthodes automatisées car on ne peut pas compter sur le contenu de la page pour suivre des règles cohérentes. XHTML a été créé pour corriger les lacunes flagrantes du HTML, et Arachnophiila est désormais orienté vers XHTML, à tel point que certaines de ses fonctionnalités avancées ne fonctionneront plus avec HTML.

Support Unicode

À partir de la version 5.4 d'Arachnophilia, Unicode est pris en charge via le jeu de caractères UTF-8, sélectionnable à l'aide de l'élément de menu "Fichier... Encodage des caractères... UTF-8". Une fois cette sélection effectuée, le chargement et l'enregistrement des fichiers, ainsi que les opérations du presse-papiers, prendront en charge les caractères et les fichiers Unicode. Ce changement a été effectué en réponse à un certain nombre de demandes concernant des problèmes d'internationalisation, et j'ai effectué ce changement d'une manière qui ne devrait pas affecter les documents existants (en supposant qu'un encodage de caractères approprié soit choisi dans l'élément de menu "Fichier... Encodage de caractères").

Mais le fait qu'Arachnophilia prenne en charge Unicode ne signifie pas que les navigateurs classiques prendront soudainement et automatiquement en charge Unicode. Une séquence de caractères Unicode telle que « Здравствуйте » peut ou non apparaître correctement lors de l'édition dans Arachnophilia, et elle peut ou non apparaître correctement dans votre navigateur ou celui de vos visiteurs. Tous ces problèmes dépendent de la disponibilité des polices prenant en charge les caractères représentés par le contenu Unicode.

Une solution partielle aux problèmes de compatibilité concernant les caractères Unicode internationaux consiste à les convertir en entités HTML à l'aide de l'élément de menu "HTML... Plus de fonctions... HTML vers entité". Par exemple, le petit échantillon donné ci-dessus serait converti comme ceci :

"Здравствуйте" -> "Здравствуйте"

Le problème avec ce type de conversion est que le résultat n'est plus adapté à l'édition, un problème résolu en reconvertissant temporairement les entités en caractères à l'aide de "HTML... Plus de fonctions... Entité en HTML".

L'autre problème lié à l'utilisation des caractères Unicode est le fait que la conversion d'entité ne résout que certains problèmes triviaux de compatibilité du navigateur, elle ne résout pas le problème des polices d'affichage. Pour afficher les caractères Unicode dans un document dans Arachnophilia, votre système doit disposer des polices correctes et une police Unicode appropriée doit être choisie à l'aide du sélecteur de police situé dans « Texte… Définir la police de l'éditeur ». Pour voir les caractères Unicode dans les invites et les macros du programme, vous devez également sélectionner une police Unicode pour le programme lui-même, à l'aide de l'élément de menu "Texte... Définir la police du programme" (dans la plupart des cas, la même police peut être utilisée pour les deux choix). Enfin, pour voir les caractères Unicode prévus dans votre navigateur, celui-ci doit également disposer d'une police appropriée installée. Mais le dernier problème avec la prise en charge d'Unicode est que les visiteurs de votre site Web doivent également installer les polices appropriées pour pouvoir afficher votre contenu Unicode. Tous ces problèmes doivent être pris en compte avant d'ajouter du contenu Unicode à vos pages Web.

N'oubliez pas d'utiliser des caractères Unicode que vous avez peut-être configurés pour pouvoir voir les bons caractères dans Arachnophilia et sur votre propre navigateur Web de développement, mais cela ne signifie pas que vos visiteurs pourront voir le contenu que vous souhaitez. Pour cela, le visiteur doit disposer d'un navigateur compatible Unicode et les polices installées correctes.

Encore une remarque sur Unicode. Choisir une police d'édition appropriée avec la boîte de dialogue située dans "Texte ... Définir la police de l'éditeur" ne modifie pas le contenu de votre document, cela change uniquement la façon dont il est affiché dans l'éditeur. Si lors de l'édition vous voyez de petits blocs au lieu de caractères, le document peut toujours s'afficher correctement lorsqu'il est visualisé avec un navigateur. À l'inverse, l'apparition des caractères corrects dans l'éditeur ne garantit pas que la page Web résultante s'affichera correctement pour un visiteur de votre site.

Pour se familiariser avec Unicode, une bonne façon de commencer est d'acquérir quelques polices Unicode. Pour l'expérimentation, je recommande Bitstream Cyberbit, une police disponible à partir de plusieurs sources, et une tentative de police Unicode "universelle" (qui couvre de nombreuses langues). Vous pourriez éventuellement vous contenter d'une police moins ambitieuse, qui prend en charge moins de langues, mais cette police est un bon moyen d'essayer Unicode.

  • Téléchargez la police depuis l'une des sources répertoriées (la police doit être gratuite).
  • Installez la police à l'aide des outils de gestion des polices de votre système d'exploitation.
  • Exécutez Arachnophilia, puis sélectionnez l'élément de menu "Texte... Définir la police de l'éditeur". Choisissez "Bitstream Cyberbit" dans la liste déroulante.
  • Pour permettre aux invites du programme et aux macros de s'afficher correctement, sélectionnez l'élément de menu "Texte... Définir la police du programme". Encore une fois, choisissez "Bitstream Cyberbit" dans la liste déroulante.
  • Testez la capacité de l'éditeur à gérer Unicode en copiant du texte en langue étrangère dans l'éditeur :

    • Anglais : Bonjour
    • Russe : Здравствуйте
    • Japonais : こんにちは
    • Chinois : 你好
    • Coréen 여보세요
    • Arabe : مرحبا
    • Hébreu : שלום
Voici quelques notes supplémentaires sur la prise en charge Unicode d'Arachnophilia :
  • Si vous rencontrez des difficultés pour modifier vos fichiers existants, si certains caractères ne s'affichent pas correctement, essayez de modifier le codage des caractères : accédez à l'élément de menu "Fichier... Encodage des caractères" et sélectionnez "ISO-8859-1" ou "ASCII", puis essayez de charger un fichier. Si cela résout le problème et si vous ne vous souciez pas de la prise en charge d'Unicode, utilisez simplement l'encodage que vous avez sélectionné pour tous les chargements et sauvegardes de fichiers (Arachnophilia se souviendra de votre sélection).
  • À long terme, il est préférable de choisir un seul codage de caractères par défaut et, pour plusieurs raisons, UTF-8 constitue un très bon choix.
  • Si le codage des caractères d'un fichier n'est pas connu, un moyen simple de l'importer dans Arachnophilia consiste à utiliser le presse-papiers du système. Ouvrez simplement un document vierge dans Arachnophilia et collez-y le contenu du document. Cette astuce fonctionne car les presse-papiers utilisent normalement un codage de caractères plus cohérent que les fichiers.
  • Plus de détails : un nouveau sous-menu a été ajouté à la catégorie de menu "Fichier", nommé "Encodage des caractères", contenant certains encodages de caractères courants. Cliquer sur l'un de ces codages de caractères modifie le codage utilisé lors des opérations de lecture et d'écriture ultérieures. Les utilisateurs peuvent compléter cette liste à l'aide de l'éditeur de macros Arachnophilia.
  • Une nouvelle commande système a été ajoutée pour permettre à l'utilisateur de choisir un jeu de caractères de lecture/écriture de document autre que le jeu de caractères ISO-8859-1 par défaut. La commande est [FileEncoding] et, si elle est incluse dans une macro, elle peut être utilisée pour choisir parmi un grand nombre d'encodages de caractères (plus que celui proposé par la sélection de menu fournie). Lorsqu'elle est invoquée en tant que [FileEncoding:UTF-8], cette commande modifiera les opérations de fichiers ultérieures pour utiliser le jeu de caractères UTF-8 (prise en charge complète d'Unicode). Lorsqu'elle est invoquée en tant que [FileEncoding], cette commande revient au codage de caractères ISO-8859-1 par défaut. Cliquez ici pour en savoir plus sur l'écriture de macros.
  • Pour ceux qui souhaitent préparer Arachnophilia pour une utilisation dans des environnements non anglophones, n'oubliez pas que presque tout le contenu des menus et des barres d'outils d'Arachnophilia peut être traduit dans des langues étrangères à l'aide de jeux de caractères Unicode, et que le contenu du programme résultant peut être exporté sous forme de fichier distribuable. Une telle activité de traduction serait effectuée sur le contenu macro d'Arachnophilia, comme expliqué ici.
  • Si vous créez du contenu dans une langue qui se lit de droite à gauche, choisissez le mode d'édition « texte brut » (clic droit, « Passer à l'affichage simple »). Ce mode gère automatiquement le sens de frappe et possède un curseur de texte distinctif qui indique le sens d'édition actuel.

Au risque de me répéter, rappelez-vous les pièges d'Unicode. Si vous ne voyez pas les caractères rendus correctement dans Arachnophilia, cela ne signifie pas qu'ils ne seront pas rendus correctement dans un navigateur. À l'inverse, si vous voyez des caractères rendus correctement dans Arachnophilia, cela ne garantit pas qu'ils apparaîtront correctement sur votre navigateur de développement ou sur les navigateurs des visiteurs de votre site. Tous ces résultats dépendent de la sélection et de l'installation des polices appropriées.

 

Documentation |