Vous êtes sur la page 1sur 112

Manuel d'utilisation d'Amaya

Auteurs :
Irne Vatton, Vincent Quint, Jos Kahan
Collaborateurs :
Charles McCathieNevile, John Russell, Marja-Riitta Koivunen, Laurent Carcone

Ce manuel prsente l'interface utilisateur d'Amaya. L'interface utilisateur sur votre machine peut-tre un
peu diffrente puisqu'elle dpend de la plateforme et la configuration choisie. Ce manuel n'est pas
exhaustif, son but est simplement de vous aider dcouvrir les principales caractristiques du logiciel.
Ce document est organis comme un livre. Vous pouvez utiliser la commande Outils/Construire un
livre pour assembler et imprimer la totalit du manuel.
De nombreuses commandes d'Amaya sont identiques celles fournies par les traitements de texte
classiques. Elles ne sont pas prsentes ici. Seuls les aspects spcifiques d'Amaya sont dcrits.

Manuel d'utilisation d'Amaya

Naviguer

Naviguer
Amaya est essentiellement un diteur avec des capacits de navigation. Il vous permet de naviguer et
dditer des documents simultanment. Lorsqu'il est utilis comme navigateur, il se comporte comme
beaucoup d'autres navigateurs Web, except pour l'activation les liens et pour l'utilisation des
formulaires.
Amaya vous permet d'afficher et d'diter des documents HTML ainsi que certains types de documents
XML : XHTML, MathML (expressions mathmatiques) et SVG (graphique). Il vous permet aussi
d'accder aux autres types de documents XML et de visualiser leur contenu selon les feuilles de style
CSS qui leur sont associes. Pour ces documents, quelques fonctions d'dition sont disponibles.

Activer un lien, parcourir les liens


Comme Amaya est un diteur, vous obtiendrez un rsultat diffrent avec un simple-clic, un double-clic,
ou un clic-droit sur un lien.
Un simple-clic place seulement le point d'insertion l'intrieur du lien, pour que vous
puissiez modifier le texte, et il affiche l'URI complte du lien dans la barre d'tat en bas de la
fentre.
Un double-clic active le lien et se place sur la cible. Le document cible remplace le document
courant dans le mme onglet. Si le document initial a t modifi mais pas sauv, un dialogue
s'affiche pour pouvoir sauver ce document avant qu'il disparaisse.
Si vous avez choisi un profil sans navigation, ou si vous tes dans les pages d'aide, le document
cible s'ouvre dans un nouvel onglet.
Un clic-droit (ou Cmd + simple-clic sur MacOS X) active le lien et ouvre le document
cible dans un nouvel onglet ou une nouvelle fentre (un menu s'affiche pour vous offrir ce
choix).
Ce comportement par dfaut peut tre modifi, ainsi que d'autres paramtres, par l'intermdiaire du menu
dition/Prfrences/Navigation. En modifiant "Cliquer deux fois pour suivre un lien", vous pourrez
naviguer de document en document l'aide d'un simple-clic. Dans ce cas, vous ne pouvez pas mettre
aisment le point d'insertion l'intrieur des liens : vous devez soit utiliser une slection tendue soit
dplacer le point d'insertion l'intrieur des liens l'aide des touches flche du clavier.
Il est galement possible d'utiliser le clavier pour parcourir les liens et les activer. La touche Tab, vous
permet de trouver le prochain lien ou lment de formulaire HTML dans le document. La commande
Maj-Tab, vous permet de trouver le lien ou lment de formulaire HTML qui prcde dans le document.
La commande Alt- vous permet d'activer le lien courant. Vous pouvez choisir d'autres touches ou
combinaisons de touches pour toutes ces commandes.

Accs rapides
L'auteur d'une page HTML peut associer un attribut accesskey aux champs de formulaire, aux zones
activables, ou aux liens. Plus prcisment, les lments suivants acceptent cet attribut : a, area, button,
input, label, legend, et textarea.
Si l'auteur du document a associ un attribut accesskey un lien (par exemple accesskey="l") dans
un document, la commande Alt-accesskey (dans cet exemple Alt-l) active le lien (sur MacOS X, la
touche Ctrl est utilise la place de Alt). Quand elle est associe un lment de formulaire, la
commande Alt-accesskey donne le focus cet lment (ou l'lment qui suit dans le cas de label et

Manuel d'utilisation d'Amaya


legend). Ceci est important pour les utilisateurs qui ne peuvent pas manipuler une souris, mais il y a

d'autres conditions o c'est ncessaire ou utile.


Les accs rapides supplantent les raccourcis clavier de Amaya, mais pas ceux du systme. Les raccourcis
des menus, notamment, sont prioritaires.
titre d'exemple ces pages d'Aide dclarent les accs rapides suivants :
"n" pour aller la page d'aide suivante,
"p" pour aller la page d'aide prcdente,
"t" pour aller la table des matires.
Si vous avez associ un raccourci clavier Alt-p une commande d'dition de Amaya, ce raccourci
clavier ne sera pas utilisable quand les pages d'aide sont affiches.
Par dfaut la touche utilise pour les accs rapides est Alt (Ctrl sur MacOS X). Le menu de prfrences
Prfrences/Gnral permet de changer cela. Vous pouvez utiliser la touche Ctrl au lieu de Alt. Vous
pouvez aussi dsactiver le mcanisme des accs rapides fonds sur accesskey.

Ancres cibles
Certaines parties du texte peuvent tre affiches avec une icne en forme de cible . Ces icnes ne font
pas partie du document et peuvent tre soit visualises soit caches juste en modifiant le statut Montrer
les cibles du document courant, qui est une option du menu Affichage. Par dfaut la commande au
clavier est Ctrl-u Ctrl-t.
Ces icnes sont associes aux lments cibles, c'est--dire aux lments, quel que soit leur type, qui ont
un attribut id , ou aux ancres cibles, c'est--dire aux lments a qui ont un attribut name. Elles identifient
les cibles possibles pour les liens. Ces icnes sont destines rendre la cration de liens plus facile. En
effet, le fait de pouvoir reconnatre rapidement la cible possible d'un lien, permet de crer des liens plus
vite.

Aller en arrire et en avant


Il existe diffrentes manires de se dplacer dans l'historique des pages charges :
Menu Fichier
Il y a des entres dans le menu Fichier pour avancer (Suivant) ou reculer (Prcdent) dans
l'historique. Les raccourcis clavier sont par dfaut respectivement Alt- et Alt-.
Barre de navigation
Deux boutons :

et

vous permettent de retourner la page prcdente ou d'aller la page

suivante.
Notez que chaque onglet a son propre historique.
Si vous avez choisi un profil sans navigation, ou si vous tes dans les pages d'aide, ces commandes ne
sont pas disponibles.

Recharger une page


Les documents peuvent tre rechargs en utilisant l'option Recharger le document du menu Fichier, le
raccourci clavier Ctrl-r, ou le bouton

de la barre de navigation.

Utiliser les formulaires


Si vous avez choisi un profil sans navigation, ou si vous tes dans les pages d'aide, cette commande n'est
pas disponible.

Commandes au clavier
Amaya fournit un mcanisme pour associer des commandes clavier de nombreuses fonctions. Les
commandes clavier par dfaut sont indiques dans la documentation. La section d'aide Configurer
Amaya dcrit comment changer les valeurs par dfaut.
Pour les utilisateurs familiers de Emacs un fichier de configuration Amaya/config/amaya.emacs est
disponible. L'utilisateur peut donc crer un lien depuis son espace priv $HOME/.amaya/
amaya.keyboard vers ce fichier s'il veut disposer de raccourcis clavier la Emacs.
Quelques touches du clavier sont pr-affectes, comme :
La touche Entre dans un lment de formulaire input (de type text ou password) soumet le
formulaire correspondant.
La touche Tab dans un lment de formulaire dplace la slection sur l'lment de formulaire
suivant, ou saute au premier lment de formulaire du formulaire courant.

Utiliser les formulaires


Certains widgets utiliss par Amaya dans les formulaires HTML (les lments form) sont diffrents de
ceux utiliss dans les navigateurs courants. Cela vient du fait qu'Amaya doit permettre la fois la
cration et l'utilisation des formulaires. Cette section indique les diffrences les plus significatives.

Menus simples
Pour utiliser un menu comme celui qui suit ce paragraphe, il faut cliquer deux fois sur l'entre affiche
(ici, "pomme") ou sur le bouton droite. On peut aussi utiliser la touche Tab pour se positionner sur le
menu, puis la combinaison Alt- pour l'activer. Cela fait apparatre la liste de toutes les entres du
menu. Cette liste est ensuite utilisable avec la souris ou avec le clavier.
pomme
Avec le clavier, passez d'une entre l'autre avec les touches flches ( , ) puis slectionnez l'entre
courante avec la touche Entre. Vous pouvez annuler toute action en appuyant sur la touche chap
n'importe quel moment.
Avec la souris, il y a deux types de comportement. Un simple clic permet de slectionner une entre
tandis qu'un double clic sur une entre signifie que vous voulez activer cette entre. Avec les menus trs
longs, vous pouvez utiliser l'ascenseur pour vous dplacer rapidement dans la liste des entres. Pour
annuler, vous devez cliquer n'inporte o en dehors de la liste affiche.

Menus slection multiple


Certains menus, comme celui qui suit ce paragraphe, autorisent la slection de plusieurs entres. Leur
comportement est similaire celui d'un menu simple mais le fait d'agir sur une entre en cliquant avec la
souris fait basculer l'tat de cette entre : si elle tait slectionne elle ne l'est plus et inversement.
pomme
orange
citron
banane
fraise

Manuel d'utilisation d'Amaya

Utiliser les vues d'un document

Utiliser les vues d'un document


Amaya peut prsenter diffrentes vues d'un document simultanment. Chaque onglet correspond un
document et les vues du document peuvent tre visualises simultanment en partageant la page en deux,
ce qui vous permet de voir clairement ce qui se passe quand vous rdigez des documents complexes.
C'est galement une aide pour se dplacer travers un document.
Six vues sont disponibles :
Vue formate (dfaut)
Dans cette vue, vous voyez le document comme prsent dans les navigateurs classiques. C'est une
vue dynamique manipulation directe, qui montre tout instant les changements que vous tes en
train d'effectuer sur le document. Cette vue est toujours visible dans votre page.
Vue structure
Cette vue montre la structure actuelle du document qui est en train d'tre rdige. Chaque lment
est reprsent par son nom d'tiquette, suivi de ses attributs, sur la mme ligne. Les lments qu'il
contient sont reprsents dessous, le long d'une ligne verticale bleue qui montre l'tendue de
l'lment. Les parties visualises en noir peuvent tre dites directement , en cliquant et en tapant.
Les parties visualises en bleu peuvent tre modifies uniquement par l'intermdiaire des
commandes d'dition.
La vue structure montre tous les lment du document, mme ceux qui ne sont pas affichs dans la
vue formate comme les commentaires, le type du document (doctype), les instructions de
traitement ou les lments de la section head.
Elle prsente galement l'adresse de l'espace de noms utilis par l'auteur lorsqu'un lment est dfini
dans un espace de noms diffrent de celui de son parent.
Vue alterne (non disponible dans le profil Lite)
Cette vue vous permet de voir quoi ressemble le document quand il est visualis par un navigateur
en mode texte. Elle est utile pour vrifier l'accessibilit de vos documents.
Vue liens
Cette vue montre toutes les ancres d'un document (les ancres et leur contenu). Vous pouvez vous
focaliser sur cette vue pour travailler sur les liens de votre document.
Vue table des matires
Cette vue visualise tous les titres (lments Hn) et uniquement ces lments. Si le document est bien
structur, elle visualise une vue synthtique du document.
Vue source
Ici vous voyez le code source actuel du document. Vous pouvez l'utiliser pour diter la syntaxe de
votre document. (c'est la vue qui est ouverte par dfaut quand vous cliquez sur la bande rose en bas
de votre document)
Vous pouvez ouvrir et fermer n'importe quelle vue n'importe quel moment.

Ouvrir une vue


Pour ouvrir une vue, choisissez la commande Montrer ... correspondante dans le menu Affichage :
Entre du menu

Raccourci clavier

Montrer la structure

Ctrl-u Ctrl-s

Manuel d'utilisation d'Amaya

Montrer la vue Alterne

Ctrl-u Ctrl-a

Montrer les liens

Ctrl-u Ctrl-l

Montrer la table des matires Ctrl-u Ctrl-c


Montrer le source

Ctrl-u Ctrl-o

Astuce : vous pouvez ouvrir rapidement la vue source (ou la dernire vue active) en cliquant la souris
sur le barre rose en bas (Partager/tendre en horizontal) ou droite (Partager/tendre en vertical) de
votre document.

Fermer une vue


Pour fermer une vue choisissez la commande Partager horizontalement ou Partager verticalement du
menu Affichage. Une autre faon de fermer une vue est de double-cliquer sur la ligne rose en bas ou
droite de votre page.
Vous pouvez aussi fermer l'onglet (menu Fichier ou bouton Fermer de l'onglet, ou clic droit sur l'onglet,
except pour la version Mac OSX) si vous voulez fermer votre document ainsi que toutes ses vues.

Utiliser les vues


Toutes les vues (excepte la vue source) sont automatiquement synchronises : chaque fois que vous
slectionnez quelques caractres ou lments dans une vue, les autres vues du mme document se
positionnent automatiquement de telle sorte qu'on voie la mme partie du document.
Vous pouvez rdiger le document dans n'importe quelle vue. Quand vous tapez du texte, les caractres
entrs sont visualiss uniquement dans la vue o vous avez cliqu. Ds que vous activez une commande
ou cliquez ailleurs, ces caractres sont galement visualiss dans les autres vues.
La slection et les commandes d'dition agissent toujours sur l'arbre du document. Quand vous
slectionnez deux lments dans une vue, la slection est tendue au sous-arbre minimum qui inclut ces
deux lments, mme si certains lments ne sont pas affichs dans cette vue. Les commandes
appliques cette slection (Supprimer par exemple) agissent sur la totalit de la slection.

Slectionner

Slectionner
De nombreuses commandes agissent sur la slection courante. La slection courante peut tre change de
diffrentes manires.
Quelle que soit la manire dont vous effectuez la slection, le type du premier lment slectionn est
affich en bas de la fentre. Il est prcd par les types des lments qui l'englobent dans la structure du
document. Cela peut tre utile quand la structure du document est complexe.
Par exemple, la slection d'un mot dans cette phrase visualise la slection :
html > body > div > p

ce qui signifie que ce qui est slectionn est du texte dans un lment p qui est dans une division (div),
elle-mme dans le corps (body) du document html. Cette squence de noms d'lment est appele un
chemin.
La slection de cet lment de structure (par exemple cliquez sur le mot structure ) donne :
html > body > div > p > strong

Slectionner avec la souris


Pour placer le point d'insertion, cliquez avec le bouton gauche de la souris.
Pour slectionner du texte, glissez sur une zone : dplacez la souris en maintenant le bouton
gauche enfonc et relchez-la quand la partie dsire a t slectionne.
Pour slectionner un mot entier, double-cliquez sur un caractre du mot.
Pour slectionner un lment entier, comme cet item de liste, cliquez sur sa puce ou sur son
numro.
Pour tendre la slection, cliquez sur le bouton gauche de la souris en combinaison avec la
touche Maj.
Pour slectionner un lment de structure, slectionnez n'importe quel caractre de l'lment
puis slectionnez le niveau de structure dsir avec le clavier comme dcrit plus bas.

Slectionner dans la barre d'tat


Pour placer le point d'insertion, cliquez avec le bouton gauche de la souris dans un lment du
document.
Cliquez sur un lment du chemin affich dans la barre d'tat, en bas de la fentre. Cela
slectionne un lment anctre (et tout son contenu).
Par exemple en cliquant sur div, la division englobante sera slectionne
html > body > div > p > strong
Quand la slection est ainsi modifie, le chemin n'est pas mis jour pour que vous puissiez
ajuster la slection sur un anctre ou un descendant.

Slectionner avec le clavier


Slectionner un lment de structure
Pressez la touche F2 pour slectionner l'lment parent dans la structure du document. Presser
cette touche plusieurs fois pour slectionner les elements ascendants, et ce jusqu' la racine.
Pressez Maj-F2 pour slectionner le premier lment fils.

Manuel d'utilisation d'Amaya


Pressez F4 pour slectionner l'lment suivant au mme niveau, ou au niveau du parent s'il n'y a
pas d'lment suivant pour l'lment courant.
Pressez Maj-F4 pour slectionner l'lment prcdent au mme niveau, ou au niveau du parent
s'il n'y a pas d'lment prcdent pour l'lment courant.
Dplacer le point d'insertion
Pour dplacer le point d'insertion localement, utilisez les quatre touches de direction du clavier.
S'il n'y a pas de point d'insertion dans la fentre du document, ces touches en mettent un en haut
gauche de la fentre.
Pour dplacer le point d'insertion au dbut ou la fin de la ligne o il se trouve, utilisez les
touches Dbut et Fin.
Pour dplacer le point d'insertion sur le dbut du mot qui prcde ou qui suit, utilisez les touches
Ctrl- et Ctrl-.
tendre/rduire la slection
Pour tendre ou rduire la slection courante dans une des quatre directions, utilisez la
combinaison de la touche Maj avec une des quatre touches de direction (Maj-, Maj-, Maj-,
et Maj-).
Pour tendre la slection courante jusqu'au dbut du mot qui prcde ou jusqu' la fin du mot
qui suit, utilisez Maj-Ctrl- ou Maj-Ctrl-.
Dplacer le document
Pour faire dfiler le document d'une ligne vers le haut ou vers le bas, utilisez Ctrl- et Ctrl-.
Pour sauter au dbut ou la fin du document, utilisez Ctrl-Dbut et Ctrl-Fin.

Slectionner des images


Slectionner une image
1. Cliquez n'importe o l'intrieur de l'image et dplacez un peu la souris tout en maintenant le
bouton enfonc. Ne sortez pas de l'image avant d'avoir relcher le bouton. L'image entire est
alors slectionne.
2. Utilisez les commandes "copier", "couper" et "coller" pour dplacer ou dupliquer l'lment
image avec tous ses attributs.
Placer le curseur sur le ct d'une image
Cliquez sur la partie gauche d'une image pour placer le point d'insertion sur le ct gauche de
l'image. Ceci vous permet de taper du texte avant l'image.
Cliquez sur la partie droite d'une image pour placer le point d'insertion sur le ct droit de cette
image. Ceci vous permet de taper du texte aprs l'image.
Note : Quand vous utilisez les touches de direction pour vous dplacer, le curseur se dplace d'abord sur
un ct de l'image puis sur l'autre ct.

Slectionner dans la vue structure


La vue Structure est particulirement commode pour slectionner rapidement de gros lments ou des
groupes d'lments.
Slectionner un lment dans la vue structure
10

Slectionner
Il y a trois moyens de slectionner un gros lment comme une table ou une longue liste :
cliquez sur le nom bleu reprsentant l'lment, ou sur le nom d'un de ses attributs, ou encore sur
sa ligne verticale bleue.
Slectionner un caractre ou une chane
Cliquez sur un caractre noir dans la vue Structure pour slectionner ce caractre. Draguez pour
slectionner une chane.
Slectionner une valeur d'attribut
Un texte en violet dans la vue structure reprsente la valeur d'un attribut pouvant tre dit
directement partir du clavier. Une slection dans une telle valeur d'attribut ne peut pas tre
tendue en dehors de cet attribut.

11

Manuel d'utilisation d'Amaya

12

Crer et ouvrir des documents

Crer et ouvrir des documents


Crer un document
Amaya vous permet ce crer de nouveaux documents locaux ou distants. Trois types de documents sont
disponibles :
Nouveau document, pour saisir une page de texte, avec des liens ou des formules, etc.
Nouvelle formule, pour crer une expression mathmatique isole
Nouvelle feuille de style, pour crer une feuille de style CSS
Pour crer un document :
1. Choisissez l'entre Nouveau du menu Fichier et slectionnez le type de document dsir.
2. Amaya vous demande alors de spcifier l'URI ou le nom local du document crer (un nom par
dfaut est affect si aucun nom n'est spcifi). Un slecteur de fichier vous permet de trouver le
rpertoire voulu et de vrifier les fichiers qui existent dj.
3. Choisissez l'emplacement o le nouveau document doit s'ouvrir : onglet courant, nouvel onglet
ou nouvelle fentre.
4. Quand un nouveau document XHTML est cr :
Quand le titre du document est requis, Amaya engendre un titre par dfaut (le nom du
fichier sans suffixe). Ce titre pourra tre modifi ultrieurement par la commande
Outils/Changer le titre.
Si vous prvoyez d'utiliser un modle, cliquez sur le bouton A partir du modle et
slectionnez un des modles, soit en slectionnant dans la liste des modles enregistrs
ou en tapant l'URI ou le nom du fichier du modle qui n'est pas dans la liste. Vous
pouvez mettre jour la liste des modles dans Prfrences/Modles
Il est possible de spcifier le Profil du document cr (XHTML Transitional,
XHTML 1.1, XHTML strict, XHTML basic, HTML transitional, Compound
document). Vous pouvez laisser Amaya choisir pour vous.
Si vous prvoyez de crer un document XHTML compos (Compound document)
incluant des lments MathML ou SVG, il est recommand de crer un fichier avec un
suffixe .xml.
5. Slectionnez un Codage pour encoder le texte du document. Attention si vous prvoyez de
publier le document sur un serveur, ce Codage doit tre choisi en accord avec le serveur Web
qui va dlivrer le document.
Habituellement les pages .html sont servies avec iso-8859-1 and les pages .xml sont servies
avec utf-8.
6. Confirmez avec le bouton Crer. Amaya cre un nouveau document contenant l'lment racine
correspondant au type choisi.

Ouvrir un document
Vous pouvez ouvrir des documents locaux ou distants de diffrentes faons :
Menu Fichier
L'entre Ouvrir du menu Fichier vous permet d'ouvrir un nouveau document. La commande
clavier par dfaut est Ctrl-o Ctrl-o . Cette commande fait apparatre une bote de dialogue dans
laquelle vous pouvez entrer un nom de fichier local ou une URI. Vous pouvez galement choisir un

13

Manuel d'utilisation d'Amaya


fichier en utilisant le slecteur de fichiers locaux (cliquez sur l'icone de fichier en haut droite de
cette bote de dialogue).
Quand le document est correctement spcifi, cliquez sur le bouton Ouvrir.
Vous pouvez aussi utiliser le bouton droite de la zone de saisie du nom de fichier. Il affiche la liste
des fichiers ouverts rcemment avec Amaya. Chosissez dans cette liste celui que vous voulez ouvrir.
La commande Ouvrir peut aussi tre utilise pour crer un nouveau document local, en spcifiant le
nom d'un fichier qui n'existe pas encore.
Explorateur de fichiers
Un explorateur de fichiers peut tre affich dans la fentre d'Outils par la commande Affichage /
Barres d'outils / Fichiers. Cet outil donne accs tous les rpertoires locaux. Un simple clic
permet d'ouvrir ou de fermer un rpertoire et un double clic sur un nom de fichier ouvre le
document correspondant.
Adresse du document courant
Une zone affiche en haut de la fentre le nom du fichier ou l'URI du document courant. Vous
pouvez saisir le nom d'un autre document (local ou distant) qui va tre affich la place du
document courant. Tapez sur la touche Entre quand le curseur se trouve dans cette zone pour
activer le chargement du document. Cette commande peut aussi tre utilise pour crer un nouveau
document local, en entrant le nom d'un fichier qui n'existe pas encore.
Le bouton la droite de cette zone affiche la liste des derniers documents chargs. Vous pouvez
choisir un document dans cette liste. Ce document vient alors remplacer le document courant.
Notez que cette possibilit n'est offerte que si vous avez choisi un profil incluant l'option
Navigation.
Liens
En activant un lien vous chargez le document correspondant.
Note sur le codage des caractres
Les documents HTML sont chargs par dfaut comme des fichiers ISO-latin-1. Sans information sur le
"charset" dans l'en-tte HTTP ou dans un lment meta, un document HTML est considr comme cod
en ISO-latin-1. Les documents XML (y compris XHTML) sont lus par dfaut comme des fichiers UTF 8.
Quand il n'y a pas d'information sur le "charset" dans l'en-tte HTTP, dans la dclaration XML, ou dans
un lment meta, un document XML est considr comme cod en UTF 8. Comme les codages par
dfaut de HTML et de XML sont diffrents, il arrive souvent que des auteurs aient cr des documents
XML cods en ISO-latin-1 qui ne fournissent pas d'informations explicites sur leur codage. Si un
caractre analys par Amaya ne correspond pas un caractre UTF 8 valide (cela arrive si le document
est cod en ISO-latin-1 mais lu comme un fichier UTF 8), le document est considr comme incorrect: le
traitement s'arrte et un message d'erreur est affich. Ce message propose soit de recharger le document
comme un document HTML, soit de montrer les erreurs. Dans le premier cas, le document est recharg
avec le "charset" correspondant l'ISO-latin-1. Le document est maintenant considr comme modifi
(un charset a t ajout) et peut tre sauv.
Amaya interprte les entits caractres. Quand il ne dispose pas du caractre correspondant, il affiche un
'?' (ou il affiche le nom de l'entit lorsqu'elle figure dans un attribut ou quand elle est inconnue). Lorsque
le document est sauv, ces entits caractres sont restaures, sauf si le document est cod en ISO Latin-1
et que l'entit correspond un caractre ISO Latin-1. Dans ce cas c'est simplement le code ISO Latin-1
du caractre qui est sauv. Si le document est cod en ASCII, Amaya convertit en entits les caractres
ISO Latin-1 qui n'existent pas en ASCII.

14

Crer des lments

Crer des lments


Modes d'dition
Amaya propose deux modes d'dition :
Le mode XML est trs efficace pour manipuler les diffrents types de structure XML, mais cela
implique que l'utilisateur ait une bonne connaissance de la structure du document. Les
manipulations simples ralises via quelques touches de clavier sont gnriques : elles
s'appliquent tous les types d'lments de n'importe quel vocabulaire XML, quelque soit leur
smantique. Cela marche bien avec le texte HTML, mais aussi les quations MathML ou les
dessins SVG.
Le mode Texte permet aux utilisateurs de grer les lments HTML de faon identique aux
traitements de texte. Ce mode ne s'applique pas aux autres vocabulaires XML.
Vous pouvez facilement changer de mode d'dition (Texte/XML) en cliquant sur le bouton correspondant
dans le coin en bas droite de la fentre.

Boutons et menus
La manire la plus simple de crer de nouveaux lments dans un document est de placer le point
d'insertion la position voulue et d'utiliser le menu Insertion ou l'outil Elments, pour les lments les
plus communs (images, titres, listes...). Ces commandes crent simplement l'lment correspondant la
position courante.
L'outil Elments donne un moyen direct pour :
insrer (ou remplacer la slection courante par) un lment XHTML : division (
,

), paragraphe (P), table (

), ancre cible ou lment cible (

), liste numrote ( ), liste de dfinitions (


image ( ), objet ( ).

), titre (

), ancre lien (

), terme de dfinition (

), liste (

), dfinition (

),

ouvrir/fermer (ou englober la slection courante dans) un lment en-ligne de XHTML : mise en
vidence (
et indice (

), important (

) code (

), insertion (

), suppression (

), exposant (

),

).

Note : Dans le profil Lite d'Amaya seul un sous-ensemble de ces boutons est disponible.
Pour plus d'information sur ces lments voir la liste de tous les lments HTML 4.0.

Point d'insertion
Quand vous crez de nouveaux lments, il est important de slectionner un point d'insertion, et non du
texte ou mme un caractre unique : si la slection courante n'est pas vide, Amaya tente de transformer la
partie slectionne dans le type de l'lment choisi.
Dans certains cas, l'lment dsir ne peut pas tre cr exactement la position choisie cause des
contraintes imposes par le langage HTML. Amaya tente alors de crer l'lment l'endroit le plus
proche possible. Par exemple, si le point d'insertion se trouve l'intrieur d'un paragraphe, la fin de la
dernire ligne, quand vous cliquez sur le bouton
, Amaya ne cre pas la nouvelle en-tte cette
position (elle serait invalide) mais aprs le paragraphe, la position valide la plus proche.

15

Manuel d'utilisation d'Amaya


Dans d'autres cas, Amaya modifie la structure existante pour crer l'lment dsir tout en respectant les
contraintes du langage. Si le point d'insertion est quelque part dans un item de liste ( li) quand vous crez
une en-tte (avec le bouton
depuis l'outil Elment ou partir du menu), l'item et la liste laquelle il
appartient sont automatiquement diviss afin de crer l'en-tte demand et de se conformer aux
contraintes du langage HTML.

Sous-menu Elments cachs


Pour crer des lments dans la partie head du document, utilisez le sous-menu Elments cachs du
menu Insertion. Attention ces lments ne sont affichs que dans les vues structure et source. Vous
devez ouvrir la vue structure. Mettez le point d'insertion la position dsire et choisissez le type
d'lment crer dans le sous-menu Elments cachs.
Le menu Elments cachs vous permet aussi de crer des commentaires. Les commentaires sont
seulement visibles dans les vues structure et source, mais ils peuvent tre insrs n'importe quelle
position dans le document.

Elments crs automatiquement


Certains lments HTML sont constitus de plusieurs autres lments de diffrents types. Par exemple,
une table contient d'habitude une lgende (caption), plusieurs lignes (tr) et plusieurs cellules (td ou
th) dans chaque ligne.
Quand Amaya cre de tels lments, il cre aussi leurs composants. Pour crer une table, Amaya affiche
un dialogue qui vous permet de choisir de la crer avec ou sans lgende, le nombre de lignes et de
colonnes dsires et d'autre options de prsentation. Le point d'insertion est automatiquement plac dans
la premire cellule cre. Vous pouvez saisir le contenu de ce composant immdiatement ou plus tard.
Vous pouvez vous dplacer jusqu'au prochain composant (vide) avec la souris ou avec les flches de
direction.
HTML dfinit certains lments de niveau de caractre qui permettent d'associer du style aux chanes de
caractres. Voir Crer des lments de style HTML pour crer de tels lments.

La touche Entre
Lorsque vous crivez un nouveau document ou une nouvelle partie dans un document, vous tes souvent
amens crer de nouveaux lments. Pour cela, il suffit de presser la touche Entre. L'lment courant
est clos et un nouveau est cr juste aprs.
Quand le curseur est au dbut ou la fin d'un lment prformat ou d'une division (pre ou div), la
touche Entre cre une nouvelle ligne dans le pre ou un nouveau paragraphe dans l'lment div.
Dans certains cas le comportement de la touche Entre dpend du mode d'dition courant :
Mode XML
Pour crer un paragraphe aprs un pre ou une division aprs un div, vous devez slectionner le
pre ou le div en entier avec la touche F2 et presser la touche Entre. De la mme faon, vous
pouvez crer un nouveau paragraphe aprs une table en slectionnant la table entire et en
pressant la touche Entre.
Quand un lment complet comme h2 ou li est slectionn, la touche Entre cre un nouveau
h2 ou li aprs.
Mode Texte
Quand le curseur est au dbut ou la fin d'un item de liste (li), un nouvel item de liste frre et
de mme type est cr, au lieu d'un nouveau paragraphe dans l'item de liste. De plus, dans un
item de liste vide, la touche Entre cre un paragraphe qui coupe la liste en deux.

16

Crer des lments


Quand le curseur est dans un lment comme p, address, dt, h1, h2, etc. (ils sont appels des
lments blocs) la touche Entre coupe l'lment en deux lments frres de mme type.
Quand le point d'insertion est dans un lment HTML comme strong, em, code, span, a, etc.
(ils sont appels des lments en-ligne) la touche Entre coupe l'lment en-ligne et
l'vnement est transmis l'lment parent. Comme les lments en-ligne peuvent s'englober
dans une structure HTML, la coupure peut se faire plusieurs niveaux, jusqu' l'lment bloc ou
l'item de liste qui va traiter l'vnement comme indiqu plus haut.
Quand la touche Entre est active au dbut ou la fin d'un lment bloc, un nouveau
paragraphe (lment p) est cr, quelque soit le type de l'lment bloc courant.
Quand le nouvel lment cr est simplement un paragraphe, vous pouvez changer immdiatement le
type de cet lment, en slectionnant le type dsir dans le menu Insertion ou en cliquant sur le bouton
correspondant de l'outil Elments. Vous pouvez aussi continuer taper et changer le type de l'lment
plus tard.

Sortir des ancres, des lments en-ligne, etc.


Quand un paragraphe ou un autre bloc de texte se termine par une ancre ou une chane de caractres
style (en gras, en italique ou dans tout autre style) ou tout autre lment en-ligne, si vous placez le point
d'insertion la fin du paragraphe et tapez du texte les caractres sont ajouts l'intrieur de l'ancre ou de
l'lment en-ligne.
Dans le mode XML seulement
Si vous voulez saisir du simple texte aprs cet lment, il vous suffit de mettre le curseur la fin de
l'ancre ou de l'lment en-ligne et presser la touche Entre pour sortir de l'lment et de taper.
La mme mthode s'applique pour insrer du simple texte avant le premier lment en-ligne du bloc
de texte. Si vous voulez saisir du simple texte avant cet lment, il vous suffit de placer le curseur
au dbut de l'lment et de presser la touche Entre et continuer taper.
Dans le mode Texte et XML
Tous les lments Type d'information et Elments caractres peuvent tre ouvert/ferms avec la
mme commande ou bouton de l'outil Elments.
Les commandes Insrer ou Ajouter du menu Edition ou menu contextuel peuvent tre utilises
pour insrer avant le dbut ou aprs la fin de l'lment en-ligne.

Cration de structures imbriques


En mode d'dition XML (seulement), quand le point d'insertion est dans un lment vide, une pression
sur la touche Entre remplace cet lment par un autre lment vide au niveau suprieur de la structure
du document. Ce comportement permet de crer trs rapidement des structures embotes complexes.
Considrez par exemple la structure suivante :
1. Le premier item dans le plus haut niveau de la liste.
Un paragraphe dans le premier item.
2. Le second item.
a. Le premier item dans la liste embote.
b. Le second item dans la liste embote.
3. Le dernier item dans la liste.
Pour crer cette structure :
1. Crez d'abord une liste numrote avec un premier item, par exemple en cliquant sur le bouton
.
17

Manuel d'utilisation d'Amaya


2. Tapez le contenu de la premire ligne et pressez la touche Entre : cela cre un nouveau
paragraphe dans l'item de liste.
3. A la fin de ce paragraphe, pressez la touche Entre : cela cre un nouveau paragraphe. Par
contre, en pressant encore la mme touche, vous remplacez ce paragraphe dans un item vide 2.
4. Entrez le contenu de la premire ligne du second item.
5. A la fin de la premire ligne de l'item 2, crez une liste nouvelle avec son premier item (cliquez
par exemple sur le bouton
). La nouvelle liste sera automatiquement embote.
6. Entrez le contenu du premier item de la nouvelle liste et crez l'item b en appuyant deux fois sur
la touche Entre la fin de l'item a.
7. Entrez le contenu de l'item b. Quand le point d'insertion est la fin de l'item b, crez l'item 3 en
appuyant quatre fois sur la touche Entre.
8. Entrez le contenu du dernier item. Pour crer le paragraphe qui suit ces listes, pressez la touche
Entre trois fois lorsque le point d'insertion est la fin de l'item 3.
La touche Entre fonctionne de la mme manire que prcdemment quand le point d'insertion est au
dbut d'un lment, mais elle cre de nouveaux lments avant l'lment courant.
Par exemple, pour ajouter un paragraphe initial dans un item de liste, dplacez le point d'insertion devant
le premier caractre de cet item et pressez la touche Entre. Si vous appuyez deux fois sur Entre, vous
obtenez un nouvel item avant l'item en cours. Ceci est utile pour insrer un nouvel item avant le premier.
Note : Dans le mode XML, cette utilisation de la touche Entre ne s'applique pas seulement aux listes et
aux paragraphes, mais tous les lments.

Editer les listes de dfinitions (dl/dt/dd)


La touche Entre est galement utile pour diter des listes de dfinitions. Considrez l'exemple suivant :
Terme 1
Terme 2
Dfinition des deux termes.
C'est une liste de dfinitions (dl) contenant deux termes (dt) suivis par une dfinition (dd). Pour ajouter
un nouveau paragraphe l'intrieur de la dfinition (dd), placez le point d'insertion la fin (aprs le mot
"termes") et appuyez sur la touche Entre. Si vous pressez Entre deux fois, vous sortez de la
dfinition en cours (dd) et vous crez un nouveau terme (dt). Entrez le contenu de ce nouveau terme et
pressez une fois la touche Entre : vous crez encore un nouveau terme (dt). La presser deux fois cre
une nouvelle dfinition (dd).
Si vous voulez crer un nouveau terme avec sa dfinition avant le Terme 1, mettez le point d'insertion au
dbut du Terme 1 et appuyez sur Entre. Tapez le nouveau terme (dt), puis pressez Entre deux fois :
une nouvelle dfinition (dd) est cre immdiatement aprs le nouveau terme.

Les touches Suppr et Arrire


Le comportement des touches Suppr et Arrire ne dpend pas du mode d'dition:
Si le point d'insertion se trouve au dbut ou la fin d'un lment bloc (un lment comme p,
address, dt, h1, h2, etc.) et que la touche Suppr ou Arrire est presse, tout le contenu de
l'lment voisin suivant (resp. prcdent) est ajout au contenu de l'lment contenant le point
d'insertion.

18

Crer des lments


Si le point d'insertion se trouve dans un lment en-ligne (un lment HTML comme strong,
em, code, span, a, etc.), les touches Suppr et Arrire dtruisent seulement les caractres, en
traversant les limites d'lments en-ligne sans aucun effet sur la structure. Cependant, quand un
lment en-ligne devient vide, il est lui-mme dtruit.

Changer le titre du document


Vous pouvez diter le titre du document (lment title) en utilisant le menu Outils/Changer le titre.
Vous pouvez aussi diter le titre du document dans la vue structure.

19

Manuel d'utilisation d'Amaya

20

diter des attributs

diter des attributs


Il y a deux manires d'diter des attributs :
En utilisant l'outil Attributs
Directement dans la vue structure

Editer des attributs par le biais de l'outil Attributs


L'outil Attribut peut tre utilis pour crer un attribut, pour changer la valeur d'un attribut existant ou
pour effacer un attribut. Il prsente :
La liste des attributs dj appliqus au premier lment slectionn et leur valeur courante. Les
attributs obligatoires sont affichs en rouge et ne peuvent pas tre dtruits.
En dessous, un menu droulant tiquet Insrer donne accs la liste de tous les attributs qui
peuvent s'appliquer au premier lment slectionn.
Pour ajouter un attribut un lment :
1. Slectionnez d'abord l'lment appropri. Vous devez slectionner l'lment entier et pas
seulement un caractre l'intrieur de l'lment. Pour cela, utilisez la touche F2 .
2. Une fois l'lment slectionn, slectionnez l'attribut dans le menu Insrer. Cet attribut est
maintenant activ.
3. Pour les attributs boolens ( comme ismap pour une image), la commande est termine.
4. Pour les attributs valeur numre (comme lang), vous devez choisir une valeur dans la liste
des valeurs possibles.
5. Pour les autres attributs, vous devez taper la valeur puis confirmez soit avec la touche Entre,
soit avec le bouton appliquer (

).

Pour modifier la valeur d'un attribut :


1. Slectionnez d'abord l'lment. Vous devez slectionner l'lment entier et pas seulement un
caractre l'intrieur de l'lment. Pour cela, utilisez la touche F2 .
2. Une fois l'lment slectionn, cliquez sur le nom de l'attribut que vous voulez modifier, pour
afficher le formulaire d'dition de la valeur courante.
3. Pour les attributs valeur numre (comme lang), Amaya affiche :
Une liste droulante donnant la liste des valeurs possibles.
Un bouton (

) pour retirer l'attribut.

4. Pour les attributs valeur libre (comme href pour une ancre), Amaya affiche :
Une bote de saisie pour insrer la valeur.
Un bouton appliquer ( ) pour confirmer la valeur saisie. La touche Entre peut
aussi servir confirmer la valeur saisie.
Un bouton (

) pour supprimer l'attribut.

Pour supprimer un attribut d'un lment :


1. Slectionnez d'abord l'lment . Vous devez slectionner l'lment entier et pas seulement un
caractre l'intrieur de l'lment. Pour cela, utilisez la touche F2 .

21

Manuel d'utilisation d'Amaya


2. Une fois l'lment slectionn, cliquez sur le nom de l'attribut pour afficher le formulaire
d'dition de sa valeur.
3. Cliquez sur le bouton supprimer (

) pour retirer l'attribut.

Editer des attributs dans la vue structure


Tous les attributs sont affichs dans la vue structure. Les attributs peuvent tre affichs en bleu ou en
violet. Quand un attribut est affich en bleu, vous pouvez seulement le modifier avec l'outil Attributs.
Ceci assure que seules des valeurs correctes soient choisies.
Les attributs valeur libre peuvent tre dits dans la vue structure.
Vous pouvez cliquez dans la valeur (affiche en violet) et diter la valeur comme n'importe
quelle autre chane de caractres.
Pour slectionner la valeur entire de l'attribut, vous pouvez cliquer dans la valeur puis presser
la touche F2.
Pour retirer l'attribut, vous pouvez slectionner la valeur complte, puis presser deux fois la
touche Suppr. Le premier Suppr retire la valeur de l'attribut et le second dtruit l'attribut luimme.

Copier des attributs


Un attribut n'est pas la mme chose qu'un lment, et un attribut ne peut pas tre copi l'aide des
commandes Copier/Coller du menu Edition. Seule une valeur d'un attribut textuel peut tre copie/
colle.

22

Saisir du texte

Saisir du texte
Pour les caractres qui ne sont pas directement disponibles depuis le clavier, Amaya utilise le support
standard fourni par le systme.
Amaya fournit des raccourcis clavier pour certains caractres non disponibles au clavier comme :
Pour obtenir un espace non scable, vous pouvez taper Ctrl-espace. Ce caractre est visualis
dans la vue source avec le caractre color suivant : ~
Pour obtenir un (euro), vous pouvez taper Alt-e
Pour obtenir un (oelig), vous pouvez taper Ctrl-o Ctrl-e
Pour obtenir un (OElig), vous pouvez taper Ctrl-Shift-O Ctrl-Shift-E
Pour obtenir un , vous pouvez taper Ctrl-[
Pour obtenir un , vous pouvez taper Ctrl-]
On donne ci-dessous une description des mthodes de saisie multi-touches sous Unix et sous Mac OS X

Le support multi-touches standard des versions Unix


les caractres indisponibles sur le clavier peuvent tre insrs par une squence de deux caractres
disponibles prcds par la touche spciale Composer. Amaya vous permet d'inverser l'ordre de ces deux
caractres.
Si la touche Composer n'existe pas sur votre clavier, vous pouvez l'attacher une touche existante
comme Alt-Gr par la commande xmodmap suivante :
keycode 113 = Multi_key

Cette commande peut tre range dans le fichier $HOME/.Xmodmap. Elle sera applique ds que le serveur
X sera lanc.
Nom

Code Premire touche

Deuxime touche Rsultat

AElig

198

<Shift> A

<Shift> E

Aacute 193

<Shift> A

accent aigu

Acirc

194

<Shift> A

accent circonflexe

Agrave 192

<Shift> A

accent grave

Aring

197

<Shift> A

toile

Atilde

195

<Shift> A

tilde

Auml

196

<Shift> A

trma

Ccedil

199

<Shift> C

cdille

Eth

222

Eacute 201

<Shift> E

accent aigu

Ecirc

202

<Shift> E

accent circonflexe

Egrave 200

<Shift> E

accent grave

Euml

203

<Shift> E

trma

Iacute

205

<Shift> I

accent aigu

Icirc

206

<Shift> I

accent circonflexe
23

Manuel d'utilisation d'Amaya


Igrave

204

<Shift> I

accent grave

Iuml

207

<Shift> I

trma

Ntilde

209

<Shift> N

tilde

Oacute 211

<Shift> O

accent aigu

Ocirc

212

<Shift> O

accent circonflexe

Ograve 210

<Shift> O

accent grave

Oslash 216

<Shift> O

slash

Otilde

213

<Shift> O

tilde

Ouml

214

<Shift> O

trma

Thorn

222

<Shift> T

<Shift> H

Uacute 205

<Shift> U

accent aigu

Ucirc

206

<Shift> U

accent circonflexe

Ugrave 204

<Shift> U

accent grave

Uuml

207

<Shift> U

trma

Yacute 221

<Shift> Y

accent aigu

aelig

230

aacute

225

accent aigu

acirc

226

accent circonflexe

agrave 224

accent grave

aring

229

toile

atilde

227

tilde

auml

228

trma

brvbar

166

bar (pipe)

bar

ccedil

231

cdille

cent

162

slash

copy

169

current 164

deg

176

accent circonflexe 0 (zro)

eacute

233

accent aigu

ecirc

234

accent circonflexe

egrave 232

accent grave

euml

235

trma

eth

240

frac12

189

frac14

188

frac34

190

hyphen 173

- (moins)

iacute

accent aigu

24

237

Saisir du texte
icirc

238

accent circonflexe

igrave

236

accent grave

iexcl

161

! (exclam)

iquest

191

? (question)

laquo

171

< (infrieur)

<

macr

175

- (moins)

accent circonflexe

micro

181

middot 183

accent circonflexe

nbsp

160

<Ctrl> space

(aucun)

not

172

- (moins)

cdille

ntilde

241

tilde

oacute

243

accent aigu

ocirc

244

accent circonflexe

ograve 242

accent grave

oslash

248

slash

otilde

245

tilde

ouml

246

trma

ordf

170

_ (underscore)

ordm

186

_ (underscore)

para

182

<Shift> P

! (exclam)

plusmn 177

- (moins)

pound

163

- (moins)

raquo

187

> (suprieur)

>

reg

174

<Shift> R

<Shift> O

sec

167

sup1

185

sup2

178

sup3

179

szlig

223

thorn

254

uacute

250

accent aigu

ucirc

251

accent circonflexe

ugrave 249

accent grave

uuml

252

trma

yacute

253

accent aigu

yen

165

- (moins)

yuml

255

trma

25

Manuel d'utilisation d'Amaya

Saisie de caractres accentus sous Mac OS X


Avec un clavier US (qwerty), la saisie de caractres accentus sous Mac OS X se fait de la manire
suivante :
Accent aigu : alt-e puis la lettre (donc pour : alt-e puis e)
Accent grave : alt-` puis la lettre
Accent circonflexe : alt-i puis la lettre
Tilda : alt-n puis la lettre
Trma : alt-u puis la lettre
C cdille : alt-c
La touche alt est galement appele touche option.

Traitement des espaces


Pour les documents (X)HTML, MathML, SVG et pour les lments MathML ou SVG inclus dans des
documents (X)HTML, Amaya supprime les blancs non significatifs au chargement du document.
Les blancs non significatifs sont :
les caractres de fin de ligne (#xD et (#xA),
les caractres de tabulation (#x9),
les blancs de dbut d'lment,
les blancs de fin d'lment,
les blancs contigus (un seul blanc est alors prserv).
L'auteur d'un document peut vouloir spcifier son intention de prserver tous les caractres pour certains
lments. Pour cela, il peut utiliser l'attribut xml:space ou l'lment pre (ce dernier pour des documents
(X)HTML uniquement). Deux valeurs sont possibles pour l'attribut xml:space
default applique le traitement des blancs par dfaut dfini pour la DTD du document. Dans
Amaya, le traitement par dfaut supprime les blancs non significatif pour les DTD supportes
(voir ci-dessus)..
preserve indique Amaya de prserver tous les caractres, l'exception du premier caractre
qui suit immdiatement la fin de la balise de l'lment portant l'attribut si ce caractre est une fin
de ligne.
L'attribut xml:space s'applique tous les lments contenus dans l'lment porteur de l'attribut, moins
qu'il ne soit annul par l'apparition d'un autre attribut xml:space.
Dans la DTD XHTML, l'lment pre induit le mme comportement que l'attribut xml:space avec la
valeur preserve.

26

diter avec des modles

diter avec des modles


Qu'est-ce qu'un modle ?
Les modles sont utiliss pour produire plusieurs documents du mme type. Un modle est un squelette
reprsentant ce type de document, exprim dans le format du document final produire (par exemple
XHTML). Le format du document final est appel le langage cible et doit tre un langage XML.
Dans un modle, le squelette du document contient des dclarations, exprimes dans le langage XTiger
(eXtensible Templates for Interactive Guided Editing of Resources), qui spcifient comment le document
minimal peut voluer et grossir, en respectant le type de document final dsir. Les documents produits
partir de ce squelette en suivant les dclarations XTiger sont appels des instances du modle. Certaines
parties du modle peuvent tre figes, si elles doivent apparatre dans les instances telles quelles.
Certaines parties peuvent tre modifies quand une instance de document est produite, certaines autres
peuvent tre ajoutes, librement ou sous certaines contraintes.
Le fichier contenant le modle doit avoir l'extension .xtd.
Un modle est souvent accompagn d'un ensemble de ressources attaches (images, feuilles de style,
scripts). Un modle est une ressource web, qui peut tre stocke dans le systme de fichiers local ou
partag sur un serveur web.

Crer un modle
Vous pouvez crer vos propres modles, en utilisant le langage XTiger. Cependant, Amaya fournit un
support spcifique pour la cration et la mise jour des modles.
L'approche propose est de :
Crer d'abord un squelette d'instance de document (fichier .html) vous voulez engendrer.
Slectionner l'onglet Modle (Tpl) de l'outil Elments et cliquer sur la premire entre pour
engendrer un modle (fichier .xtd) partir du squelette de document.
Quand un document modle est slectionn, plusieurs entres de l'outil Modle sont
disponibles :
L'entre Crer et utiliser un composant engendre un component qui sera affich dans
la section head du document modle. Le contenu courant de la slection devient le
contenu du composant. Un lment use qui permet d'insrer ce composant est cr la
position courante du document. La slection doit tre valide (seulement des lments
complets ou une chane de caractres). La commande demande l'utilisateur de saisir
le nom du component. Ce nom doit tre unique.
Note : Le contenu du composant ne pourra pas tre dit dans les instances du modle.
L'utilisateur doit insrer des lments use et/ou bag dans le composant pour dfinir
des zones ditables. Ces zones peuvent tre dfinies avant ou aprs la cration du
composant.
L'entre Crer et rpter un composant engendre un component qui sera affich dans
la section head du document modle et un lment use dans un lment repeat. Cette
commande est un raccourci des commandes Crer et utiliser un composant et Rpter
l'utilisation courante.
L'entre Crer une nouvelle union de types engendre une union qui dfinit un nouveau
type comme le choix entre des types de base (number, string), des lments du
langage cible (div, h1, h2, p, ...), ou des noms de component. La slection courante n'a

27

Manuel d'utilisation d'Amaya

aucun effet. La commande demande l'utilisateur de saisir le nom de l'union. Ce nom


doit tre unique.
L'entre Crer une zone de texte engendre un lment use qui inclut une chane de
caractres. La slection doit tre une chane de caractres et devient la valeur initiale
de l'lment use. La commande demande l'utilisateur un label. Ce label est libre et est
utilis pour le chemin de slection affich en bas de la fentre.
L'entre Utiliser un composant ou un lment est utilise pour engendrer un nouveau
use.
Si la slection est vide, un dialogue propose la liste des lments qui peuvent tre
insrs cette position et demande l'utilisateur le label associ llement use. Un
lment use vide est engendr.
Si un lment du langage cible (div, h1, h2, p, ...) est slectionn, un lment use qui
permet d'insrer ce type d'lment est engendr cette position. L''lment slectionn
devient le contenu initial de l'lment use. La commande demande seulement
l'utilisateur un label.
L'entre Rpter l'utilisation courante est utilise pour engendrer une rptition
(repeat) de l'lment use slectionn. La commande demande l'utilisateur un label.
Ce label est libre et est utilis pour le chemin de slection affich en bas de la fentre.
L'entre Crer une zone d'dition libre engendre un lment bag. La commande
demande l'utilisateur un label. Ce label est libre et est utilis pour le chemin de
slection affich en bas de la fentre.

Le modle cr peut tre enregistr n'importe o, dans votre systme de fichiers local ou
distance.

Visualisation des lments du modle


Quand un document instance est affich, Amaya montre les lments XTiger sous la forme de cadres
colors qui englobent les lments XHTML.
Un lment use est affich comme une bote bleue hachure
Un lment bag est affich comme une bote verte hachure
Un lment repeat est affich comme une bote avec un

en haut gauche

Un lment attribute n'est pas affich dans la vue principale; il n'a d'effet que sur l'outil
Attributs.
Les lments XTiger peuvent aussi tre vus dans la vue structure. Ouvrez cette vue avec l'entre
Montrer la structure dans le menu Affichage. Dans la vue structure, les lments XTiger sont affichs
en dor, alors que les lments XHTML sont affichs en bleu. Les lments XTiger sont aussi montrs
dans la vue source, mais sans couleur spciale.
Un autre moyen de comprendre la structure imbrique des lments XTiger avec les lments XHTML
est le chemin de la slection affich dans la barre de statut (en bas de la fentre). L vous pouvez voir
tous les lments de la structure du document depuis l'lment racine jusqu' la slection. Ce chemin est
mis jour chaque fois que la slection change. Dans ce chemin, les lments XTiger sont affichs en
dor et les lments XHTML sont affichs en noir. Pour les lments XTiger, ce n'est pas le nom de
l'lment qui est affich ici (use, bag, repeat) mais le label attach ces lments, comme dclar dans
le modle.

Slectionner un modle
Vous pouvez slectionner vos propres modles ou utiliser les modles disponibles sur le site web
d'Amaya http://www.w3.org/Amaya/Templates/.
28

diter avec des modles


Pour faciliter la slection parmi vos modles prfrs, il y a une section Modles dans le dialogue des
Prfrences (dition/Prfrences, ou amaya/Prfrences sous Mac OS X). Utilisez ces prfrences
pour enregistrer les modles qu'Amaya proposera quand vous crerez un nouveau document. Quand vous
voulez enregistrer un modle local, vous pouvez appeler l'explorateur de fichiers avec le bouton pour
localiser et slectionner les modles ajouter. Vous pouvez aussi entrer l'URI des modles distants dans
la zone d'entre en dessous de la liste. Utilisez les boutons situs sur le ct droit de la liste pour retirer le
modle slectionn ou changer l'ordre dans la liste des modles.
L'enregistrement des modles n'est pas obligatoire. Quand vous crez une nouvelle instance, vous pouvez
aussi choisir un modle qui n'est pas dans cette liste.

Crer une instance de document


Pour crer un nouveau document depuis un modle, utilisez l'entre Nouveau/Nouveau document du
menu Fichier. Un dialogue s'affiche dans lequel vous pouvez slectionner :
Le modle, soit en slectionnant dans la liste des modles enregistrs, soit en tapant l'URI ou le
nom de fichier d'un modle qui n'est pas dans la liste,
L'URI ou le nom du fichier du document instance crer,
O ouvrir le nouveau document (Remplacer le document courant, Dans un nouvel onglet, Dans
une nouvelle fentre),
Le titre du nouveau document qui sera affich par les navigateurs (un titre par dfaut est
engendr quand l'utilisateur le ne spcifie pas).

Editer un document instance


L'dition n'est autorise que dans les lments repeat, use, et bag, c'est--dire dans les botes colores
hachures. Le reste du document est la partie fige du modle et ne peut pas tre modifi.

Edition dans un lment repeat


Dans une bote repeat, vous pouvez crer de nouvelles instances de la structure rpte ou en dtruire
une. Ceci est contrl par le modle, qui peut imposer un nombre minimum et/ou maximum
d'occurrences de la structure rpte.
Quand la cration de nouvelles occurrences de la structure rpte est autorise, des icnes + sont
affiches aux emplacements o cette cration est possible. Cliquez sur une des ces icnes pour crer une
nouvelle occurrence. Un menu vous donne la liste des lments qui peuvent tre crs cette position.
En slectionnant une entre de ce menu, vous crez une nouvelle occurrence du type correspondant.
Dans certains cas, le modle n'offre qu'un seul type. Le menu ne contient alors qu'une seule entre, pour
clairement informer l'utilisateur de ce qui va tre cr. Si vous cliquez en dehors du menu, rien ne sera
cr.
Une autre faon de crer des occurrences de la structure rpte est de slectionner une occurrence
existante, ou d'ajouter un point d'insertion la fin d'une occurrence, et d'appuyer sur la touche Entre.
Une nouvelle instance de la structure rpte est ainsi cre, condition que le nombre maximum
d'occurrences ne soit pas dj atteint. La nouvelle occurrence cre est alors du mme type que
l'occurrence slectionne quand on a appuy sur la touche Entre.
Quand une occurrence existante est vide ou compltement slectionne et que la touche Arrire ou
Suppr est presse, l'lment est dtruit, condition que le nombre minimum d'occurrences de la structure
rpte ne soit pas dj atteint.

29

Manuel d'utilisation d'Amaya

Edition dans un lment use


La plupart des lments use (bleu) vous permettent juste d'insrer du texte libre ou de remplacer/diter le
texte existant. D'autres lments use offrent le choix parmi diffrents types d'lments qui peuvent tre
insrs cette position. Dans ce cas, une icne triangulaire bleue est affiche dans le coin haut gauche de
la bote. En cliquant sur cette icne, vous pouvez choisir un de ces types dans le menu affich. Quand le
type est choisi, la structure correspondante est engendre et vous pouvez librement diter son contenu.

Edition dans un lment bag


Dans une bote bag (verte), vous pouvez insrer n'importe quel nombre d'lments des types spcifis par
le modle. Quand vous voulez insrer un lment XHTML, faite le de la faon habituelle, condition
que le modle autorise ce type d'lment. Il se peut que des lments ne soient pas autoriss. Les
lments autoriss sont proposs dans les sous-menus Insrer et Ajouter du menu contextuel. Les
composants dfinis par le modle sont aussi proposs dans les sous-menus Insrer et Ajouter du menu
contextuel.

30

Changer la structure d'un document

Changer la structure d'un document


Changer le type de l'lment
Pour changer le type d'un lment existant, slectionnez-le et choisissez le nouveau type soit dans le
menu Insrer, soit dans l'outil Elments. Vous pouvez ainsi par exemple changer une liste numrote
(ol) en une liste non numrote (ul), ou un paragraphe en un titre ou une liste.
Les types d'lment offerts par les sous-menus Types d'information et lments caractres du menu
Insrer fonctionnent comme des bascules. Si on slectionne une simple chane de caractres et qu'on
active une entre de ces sous-menus, la chane slectionne prend le type choisi. Si au contraire on
slectionne un lment ayant un de ces types et qu'on active l'entre correspondante, l'lment est retir,
mais son contenu subsiste.
Pour slectionner un lment entier, placez le point d'insertion n'importe o l'intrieur et appuyez sur la
touche F2.

La commande transformer
La commande Transformer du menu Outils accomplit des transformations de structure complexes.
Cette commande est base sur un langage de transformation de structure qui spcifie comment un modle
structural donn doit tre transform en diffrentes structures. Ainsi, il est possible de transformer des
listes embotes en table et inversement.

Transformations disponibles
Les transformations disponibles sont dfinies dans le fichier Amaya/amaya/HTML.trans. Rfrez-vous
au document Utilisation du fichier HTML.trans pour une description du langage dans lequel les rgles de
transformation sont crites.
Des transformations supplmentaires peuvent tre spcifies dans le fichier HTML.trans. Certaines sont
fournies en tant qu'exemples.

Utilisation de la commande Transformer


La commande Transformer affiche un menu qui donne la liste de toutes les transformations qui peuvent
tre appliques la slection courante. Il suffit de choisir la transformation dsire dans ce menu.

Insrer une division


Il est possible de grouper une srie de paragraphes, titres, listes, tables, etc. l'intrieur d'une division.
Pour cela, il faut slectionner les lments grouper puis activer l'entre Division du menu Insrer, ou
utiliser le bouton

de l'outil lments.

Fusionner des lments


Des lments conscutifs peuvent tre fusionns, mme s'ils ne sont pas au mme niveau dans la
structure du document. La fusion s'effectue l'aide des touches Arrire et Suppr. Quand le point
d'insertion est la fin d'un lment, utilisez la touche Suppr. Quand il est au dbut, utilisez la touche
Arrire. Dans les deux cas, ces touches n'effacent aucun caractre. Elles fusionnent simplement les
lments spars par une frontire de structure.
Quand le point d'insertion est l'intrieur d'un lment, ces deux touches effacent comme d'habitude le
caractre suivant ou le caractre prcdent.

31

Manuel d'utilisation d'Amaya

32

Crer et modifier des liens et des ancres

Crer et modifier des liens et des ancres


Crer une ancre cible
Une ancre cible est une partie du texte qui est rfrence par un lien (une ancre source). Avant de crer
un lien sur une telle partie du texte, vous devez tout d'abord la transformer en ancre cible.
Pour crer une ancre cible :
1. Slectionnez la chane de caractre approprie.
2. Choisissez Crer une cible dans le menu Liens ou activez le bouton
dans l'outil Elments.
Le texte ainsi slectionn est dsormais une cible.
Si vous avez activ Affichage/Montrer les cibles, le texte sera prcd d'une icne cible .
Dans la vue liens, les icnes cibles qui identifient les ancres cibles sont toujours visualises (il
n'existe pas d'option pour montrer ou cacher les icnes cibles dans cette vue).
3. Quand une ancre cible est cre, Amaya gnre automatiquement la valeur de son attribut id :
En extrayant un mot de plus de 3 caractres depuis le contenu de l'ancre
ou
En produisant un nombre.
Dans les deux cas, Amaya garantit que la valeur gnre est unique dans le document. Mais
vous pouvez changer cette valeur, comme celle de n'importe quel attribut.
Note: Si vous voulez ensuite crer un lien vers cette ancre cible, choisissez Lier la cible cre dans le
menu Liens aprs avoir slectionn l'origine du lien crer.

Crer un lment cible


En HTML 4.0, un lment peut tre utilis comme une cible de liens. Un lment cible est un lment
tap qui possde un attribut id qui est rfrenc par un lien (une ancre source). Avant de crer un lien
un tel lment, vous devez tout d'abord le transformer en lment cible.
Pour crer un lment cible :
1. Slectionnez dans l'lment puis utiliser la touche F2 afin de slectionner l'lment entier. Le
chemin de slection en bas de la fentre peut tre utile pour slectionner le bon lment.
2. Choisissez Crer cible dans le menu Liens ou le bouton
dans l'outil Elments. L'lment
slectionn a maintenant un attribut id qui en fait dsormais une cible possible.
Si vous avez fix le statut "Montrer les cibles" votre vue formate courante, le texte sera
prcd d'une icne cible . Dans la vue liens, les icnes cibles qui identifient les ancres cibles
sont toujours visualises (il n'existe pas d'option pour montrer ou cacher les icnes cibles).
3. Quand un lment cible est cr, Amaya gnre automatiquement la valeur de l'attribut id :
En extrayant un mot de plus de 3 caractres depuis le contenu de l'ancre
ou
En gnrant un label.
Dans les deux cas, Amaya garanti que la valeur gnre est valide et unique dans le document.
Mais vous pouvez changer cette valeur, comme celle de n'importe quel attribut.
Note : Il est galement possible de crer directement l'attribut id en utilisant la liste des Attributs quand
l'lment est slectionn, soit dans la vue liens soit dans la vue structure. Quand la valeur a t entre,
Amaya vrifie la valeur et la change si elle est dj utilise pour un autre attribut name ou id dans le
mme document.
33

Manuel d'utilisation d'Amaya


Note: Si vous voulez ensuite crer un lien vers cet lment cible, choisissez Lier la cible cre dans
le menu Liens aprs avoir slectionn l'origine du lien crer.

Crer un lien externe


Pour crer une ancre qui est un lien vers un autre document :
1. Slectionnez le contenu de l'ancre crer.
2. Cliquez sur le bouton
de l'outil Elments, ou choisissez Crer/changer un lien du menu
Liens, ou encore utilisez le raccourci clavier (par dfaut Ctrl-l Ctrl-l).
Si le document cible est visualis dans une autre fentre d'Amaya, utilisez le bouton
Clic puis cliquez n'importe o dans le document cible. Le lien est cr.
Si le document cible est visualis dans un autre onglet, utilisez le bouton Clic puis
changez d'onglet et cliquez n'importe o dans le document cible. Le lien est cr.
Si le document cible est local vous pouvez utiliser le bouton Parcourir pour le
slectionner.
Sinon entrez l'URI (comme http://www.w3.org) du document cible et tapez sur la
touche Entre pour confirmer. Le lien est cr.

Crer un lien interne


Pour crer un lien vers une ancre cible ou vers un lment cible dans le mme document ou dans
un autre document :
1. Slectionnez (par clic et drag ou au clavier) le contenu de l'ancre crer.
2. Cliquez sur le bouton
de l'outil Elments, choisissez Crer/changer un lien du menu
Liens, ou encore utilisez le raccourci clavier (par dfaut Ctrl-l Ctrl-l).
Si la cible est visualise (vous pouvez faire dfiler le document pour la visualiser),
activez sur le bouton Clic puis cliquez l'icne cible . Le lien est cr.
Sinon entrez l'URI (comme #name) du document cible et tapez sur la touche Entre
pour confirmer. Le lien est cr.
Note: Si vous avez cr l'ancre ou l'lment cible rcemment, inutile d'effectuer l'tape 2. Choisissez
plutt Lier la cible cre dans le menu Liens : la cible du nouveau lien sera la dernire cible que vous
avez cre.

Copier l'adresse de la cible


La commande Liens/Copier l'adresse enregistre l'adresse (URI) de la cible slectionne dans le
clipboard du systme. Si aucune cible n'est slectionne, c'est l'adresse du document courant qui est
enregistre. Cette adresse peut ainsi tre colle dans un formulaire ou dans une autre application externe.

Changer un lien
Utilisez cette procdure si vous voulez changer la cible du lien sans changer l'ancre.
Pour changer un lien :
1. Slectionnez dans l'ancre.
2. Cliquez sur le bouton
de l'outil Elments, ou choisissez Crer/changer un lien du menu
Liens, ou encore utilisez le raccourci clavier (par dfaut Ctrl-l Ctrl-l).
3. Dsignez ensuite la nouvelle cible de l'ancre comme pour crer un lien.
34

Crer et modifier des liens et des ancres


Note : Pour changer la cible d'un lien, vous pouvez galement diter l'attribut href, soit directement dans
la vue structure soit dans la vue liens, ou encore en utilisant l'outil Attributs.

Supprimer un lien ou une ancre cible


La commande Supprimer le lien ou la cible du menu Liens dtruit l'ancre qui englobe la slection
courante.
Pour utiliser cette commande, vous devez mettre la slection ou le point d'insertion n'importe o
l'intrieur de l'ancre dtruire (vous n'avez pas besoin de slectionner toute l'ancre, mais vous pouvez) et
activer la commande Supprimer le lien ou la cible. L'ancre est dtruite, mais son contenu reste.

35

Manuel d'utilisation d'Amaya

36

Editer des tables

Editer des tables


Il n'existe pas d'diteur de tables indpendant dans Amaya. Une table est simplement une structure
dcrite par la DTD HTML, comme tous les autres lments, et elle est dite comme telle. Les
commandes standard s'appliquent donc aux tables. Quelques commandes supplmentaires ont nanmoins
t ajoutes pour une manipulation plus aise.

Crer une nouvelle table


1. Dplacez le point d'insertion l'endroit du document o vous voulez crer une table.
2. Cliquez sur le bouton table
dans l'outil Elments ou slectionnez l'entre Table du menu
Insertion. Amaya affiche une bote de dialogue.
3. Spcifiez le nombre initial de lignes et de colonnes pour la nouvelle table, ainsi que l'paisseur
de sa bordure, etc.
4. Cliquez sur le bouton Confirmer. Amaya cre une table vide.
5. Le point d'insertion est automatiquement plac dans la premire cellule. Vous pouvez rentrer
son contenu immdiatement.
6. Pour entrer le contenu d'une cellule, cliquez puis insrez du texte, des images et tout type
d'lment..
7. Vous pouvez galement diter le texte de la lgende de la table, l'ajouter si elle n'existe pas, ou
la supprimer si elle n'est pas ncessaire.

Ajouter une colonne


Deux commandes spcifiques permettent de crer une nouvelle colonne :
Pour crer une nouvelle colonne gauche d'une cellule existante, choisissez Insrer une
colonne dans le sous-menu Outils/Editer la table, ou cliquez le bouton
de l'outil Elments,
ou tapez Ctrl-t Ctrl-b.
Pour crer une nouvelle colonne droite d'une cellule existante, choisissez Ajouter une
colonne dans le sous-menu Outils/Editer la table, ou cliquez le bouton
de l'outil Elments,
ou tapez Ctrl-t Ctrl-a.
Dans le mode d'dition XML, une nouvelle colonne peut aussi tre cre simplement avec la touche
Entre. Quand une cellule complte est slectionne (utilisez la touche F2), la touche Entre cre une
nouvelle colonne aprs et la colonne de la cellule slectionne.

Dtruire, copier, coller une colonne


Lorsqu'une colonne entire est slectionne, il est possible de la dtruire, de copier ou de la couper et de
la coller avant ou aprs une autre colonne, dans la mme table ou dans une autre.
Slectionner une colonne
Il y a deux mthodes pour slectionner une colonne :
1. Utilisez l'entre Slectionner la colonne dans le sous-menu Outils/Editer la table (Ctrl-t
Ctrl-c).
2. Vous pouvez aussi tendre la slection verticalement sur au moins deux cellules de la mme
colonne (Cell 1.1 Cell 2.1 dans l'exemple ci-dessous) puis pressez F2 pour slectionner la
colonne.
37

Manuel d'utilisation d'Amaya


Cell 1.1

Cell 1.2

Cell 1.3

Cell 2.1

Cell 2.2

Cell 2.3

Cell 3.1

Cell 3.2

Cell 3.3

Quand une colonne est slectionne, utilisez les commandes habituelles pour la dtruire, la copier, ou la
couper. Deux commandes spcifiques permettent de coller un colonne :
1. Pour coller une colonne avant une autre colonne
Slectionnez le dbut d'une cellule et activez la commande coller ( Ctrl-v),
Vous pouvez aussi utiliser l'entre Coller avant du sous-menu Outils/Editer la table
(Ctrl-t Ctrl-p).
2. Pour coller une colonne aprs une autre colonne
Slectionnez la fin d'une cellule et activez la commande coller ( Ctrl-v),
Vous pouvez aussi utiliser l'entre Coller aprs du sous-menu Outils/Editer la table
(Ctrl-t Ctrl-v).

Ajouter une ligne


Il existe deux commandes spcifiques pour crer une nouvelle ligne dans une table :
Pour crer une ligne avant une ligne existante, utilisez l'entre Insrer une ligne du sous-menu
Outils/Editer la table (Ctrl-t Ctrl-i), ou le bouton
de l'outil Elments.
Pour ajouter une nouvelle ligne aprs une ligne existante, utilisez l'entre Ajouter une ligne du
sous-menu Outils/Editer la table (Ctrl-t Ctrl-n), ou le bouton
de l'outil Elments.
Dans le mode d'dition XML, une autre mthode consiste slectionner une ligne complte (utilisez la
touche F2) puis presser la touche Entre pour crer une nouvelle ligne aprs la ligne slectionne.

Dtruire, copier, coller une ligne


Quand une ligne de table est slectionne, vous pouvez la dtruire, la copier, la couper ou la coller.
Pour slectionner une ligne de table deux mthodes sont disponibles :
1. Utilisez l'entre Slectionner la ligne dans le sous-menu Outils/Editer la table (Ctrl-t
Ctrl-r).
2. Vous pouvez aussi mettre la slection dans une cellule de la ligne puis utiliser la touche F2.
Quand une ligne est slectionne, vous pouvez la dtruire, la copier ou la couper avec les commandes
habituelles.
Deux commandes spcifiques permettent de coller des lignes de tables :
1. Pour coller la ligne avant une autre ligne
slectionnez le dbut d'une ligne et activez la commande coller (Ctrl-v),
ou utilisez l'entre Coller avant du sous-menu Outils/Editer la table (Ctrl-t Ctrlp).
2. Pour coller la ligne aprs une autre ligne
slectionnez la fin d'une ligne et activez la commande coller (Ctrl-v),
ou utilisez l'entre Coller aprs du sous-menu Outils/Editer la table (Ctrl-t Ctrlv).

38

Editer des tables

tendre une cellule


Pour tendre une cellule, la mthode la plus pratique est de slectionner l'ensemble des cellules
fusionner, en draguant, puis d'utiliser la commande Fusionner les cellules dans le sous-menu Outils/
Editer la table, ou le bouton
de l'outil Elment.
Quatre autres commandes spcifiques permettent d'tendre ou de rduire l'extension d'une cellule :
Joindre avec la cellule de droite dans le sous-menu Outils/Editer la table (Ctrl-t Ctrl-e)
tend la cellule d'une colonne droite et fusionne le contenu des deux cellules.
Joindre avec la cellule au-dessous dans le sous-menu Outils/Editer la table (Ctrl-t Ctrlj) tend la cellule d'une ligne vers le bas et fusionne le contenu des deux cellules.
Rduire extension horizontale (Ctrl-t Ctrl-s), ou le bouton
de l'outil Elments, rduit
l'extension horizontale de la cellule d'une colonne et engendre une cellule vide.
Rduire extension verticale (Ctrl-t Ctrl-m), ou le bouton
de l'outil Elments rduit
l'extension verticale de la cellule d'une ligne et engendre une cellule vide.
On peut aussi diter directement les attributs colspan et rowspan de la cellule.

Ajouter un nouveau corps de table (tbody)


Fonction non disponible dans le profil Lite d'Amaya.
Pour crer un nouveau corps de table (tbody) en dessous d'un corps de table existant, il faut
placer le curseur la fin de la dernire cellule de la dernire ligne du corps de table et
slectionner l'entre Corps (tbody) dans le sous-menu Insertion/Table.
Pour crer un nouveau corps de table au-dessus d'une ligne existante, il faut placer le curseur au
dbut de la premire cellule de la premire ligne du corps de table et slectionner l'entre Corps
(tbody) dans le sous-menu Insertion/Table.
Dans le mode d'dition XML, de nouveaux corps de table peuvent aussi tre crs avec la touche
Entre. Quand le corps de table entier est slectionn (utilisez la touche F2), en tapant la touche Entre
vous crez une nouveau corps de table aprs le corps de table slectionn.
Notez que le modle de table implment dans Amaya est le modle de HTML 4.0. Celui-ci comporte
des lments comme les corps multiples (tbody), des enttes de table (thead) et des bas de table
(tfoot).

Ajouter quelque chose aprs une table


De nombreux types d'lment peuvent tre inclus l'intrieur des cellules de la table. En cliquant un
bouton de l'outil Elments, ou en slectionnant une entre dans le menu Insertion, Amaya va essayer
d'insrer l'lment choisi dans la cellule qui contient le point d'insertion.
Pour contourner ce problme dans le mode d'ditons XML, vous pouvez slectionner la table entire
(utilisez la touche F2) et taper la touche Entre. Amaya engendre alors un paragraphe aprs la table. Ce
nouveau paragraphe peut tre modifi si besoin est.
La mthode gnrale consiste slectionner la table entire (use F2) et utiliser la commande Ajouter
du menu Edition ou du menu contextuel.

39

Manuel d'utilisation d'Amaya

40

diter des images et des zones actives

diter des images et des zones actives


Ajouter une image
Pour insrer une image, choisissez l'entre Image depuis le menu Insertion ou cliquez sur le bouton
(ou encore utilisez le raccourci clavier Ctrl-h Ctrl-i). Ceci fait apparatre une bote de dialogue qui
vous permet de rentrer
le nom du fichier,
le texte de remplacement (Attribut alt) de l'image
et la position dsire dans le flot du texte (dans la ligne, cadr gauche, centr, ou cadr
droite).
Note: le texte de remplacement est obligatoire. Vous devez saisir une brve description de l'image dans
le champ correspondant ou confirmer deux fois.
Pour faciliter la recherche d'un fichier image vous pouvez entrer une valeur de filtre et utiliser le bouton
filtre. Ainsi le dialogue listera seulement les fichiers qui correspondent votre critre.
Si vous souhaitez fournir une longue description (par exemple si votre image prsente une information
complexe) vous devez le faire dans un document spar et le relier en donnant l'URI comme un
descripteur long (longdesc), galement disponible dans la liste des Attributs.

Remplacer une image


Pour remplacer une image slectionnez cette image en draguant sur l'image avec la souris. Procdez alors
comme pour l'ajout d'une image (voir ci-dessus). Lorsqu'une image (et seulement une image) est
entirement slectionne, la bote de dialogue des images effectue le remplacement de l'image
slectionne au lieu d'insrer une nouvelle image.

Redimensionner une image ou une zone active


Aprs avoir insr une image ou dfini une zone active, vous pouvez avoir besoin de modifier sa taille.
Pour redimensionner une image ou une zone active directement sur l'cran :
1. Slectionnez l'image ou la zone active pour visualiser les poignes.
Quand vous cliquez sur une image, Amaya slectionne le bord gauche ou droit de l'image pour
vous laisser insrer du texte avant ou aprs l'image.
Pour visualiser les poignes, vous devez :
soit slectionner un bord et presser Echappement ou F2,
soit draguer au dessus de l'image
2. En slectionnant une poigne avec le bouton gauche de la souris et dplaant la souris toujours
avec le bouton gauche enfonc l'image ou la zone active vous pouvez modifier directement leur
taille.
Les poignes des quatre coins permettent de modifier la largeur et la hauteur.
Si la touche Majuscule est enfonce, la proportion entre largeur et hauteur de l'image
est maintenue.
Les autres poignes permettent de modifier uniquement la largeur ou la hauteur.

41

Manuel d'utilisation d'Amaya

Texte de remplacement et descriptions longues


Pour les lments comme les images et autres objets multimdia, vous devez fournir un texte de
remplacement. Celui-ci sera prsent, comme l'habitude, la place de l'image par un navigateur avec
un systme de sortie vocale, ou une transcription en Braille (utilis par de nombreux aveugles). Il est
galement courant que les utilisateurs ayant des connections de mauvaise qualit demandent la vue
alterne, le texte tant transmis beaucoup plus vite que les images.
Le texte de remplacement remplace l'image dans toutes ses fonctions. Par exemple, si l'image est utilise
pour fournir une icne de lien, le titre de la page rfrence serait un bon texte de remplacement.
Il existe des cas o une image n'est utilise que pour un effet visuel, et n'apporte aucune information
supplmentaire la page. Dans ce cas, il est appropri d'utiliser un blanc de remplacement car il faut
toujours un texte de substitution.
Dans les cas o l'image transporte une information importante qui n'est pas disponible depuis le texte du
document, vous devez fournir une description de l'information. L'option longdesc dans la liste des
Attributs vous permet de relier une description (qui est l'URI d'un document spar ou une partie
nomme du document courant) une image.
Pour donner une ide de la faon dont une page est prsente sans les images, Amaya fournit une option
Montrer la vue alterne dans le menu Affichage. Dans le cas d'un navigateur oral, la vue alterne
pourrait tre simplement lue voix haute. Sans des textes de remplacement pour les images, de
nombreuses pages deviendraient difficiles, voire impossibles, naviguer, et les utilisateurs seraient
condamns trouver "leur chemin dans le noir".

Utiliser des zones actives


Amaya vous donne la possibilit d'utiliser des zones actives :
Pour activer une zone d'une image
Double-cliquez sur la zone avec le bouton gauche de la souris. L'information correspondant
l'URI attach cette zone est alors affiche.
Pour visualiser les zones actives existantes
Choisissez Montrer les zones actives du menu Affichage.
Note : Vous pouvez aussi visualiser les zones actives depuis le clavier par la squence Ctrl-u
Ctrl-m.

42

diter des mathmatiques

diter des mathmatiques


Amaya propose une interface Wysiwyg o les expressions mathmatiques MathML sont traites comme
des composants structurs, de la mme manire que les lments (X)HTML. Vous pouvez donc
manipuler les expressions mathmatiques comme vous manipulez les autres parties des documents
(X)HTML. Toutes les commandes d'dition fournies par Amaya pour traiter le texte sont galement
utilisables pour les mathmatiques. Il y a quelques manipulations supplmentaires pour entrer des
constructions mathmatiques. Notez que les diffrents navigateurs ne se comportent pas de la mme
manire envers MathML : regardez la section sur la compatibilit des navigateurs pour plus
d'informations.

Crer une formule mathmatique


Nouvelle formule
Gnralement, les formules mathmatiques ne sont pas isoles, mais incluses dans un document avec du
texte, des tableaux, des images... pour cela vous devez crer un document XHTML. Sinon, vous pouvez
crer un document MathML (mml) par exemple pour utiliser les formules dans d'autres logiciels. Pour
cela, utilisez la commande Fichier / Nouveau / Nouvelle formule ou tapez Ctrl-n Ctrl-m.
Pour crer une expression mathmatique dans un document, il suffit de placer le point d'insertion
l'endroit o vous voulez insrer l'expression, puis de cliquer sur le bouton Math (le premier bouton de la
palette Math) ou de slectionner l'entre Insrer une formule du sous-menu Insertion/Math. Voici des
exemples avec une formule insre directement dans le document XHTML ou l'intrieur d'une image
SVG :
(x ) =

t
t x 1 t
+
0

Le sous-menu Math
Le sous-menu Insertion/Math contient les lments de prsentation dfinis dans MathML.
Les premiers lments crent un nouvel lment d'un type donn l'intrieur d'une expression
mathmatique : Texte (mtext), Identificateur (mi), Nombre (mn), Oprateur (mo). Ces
commandes peuvent aussi changer le type d'un lment seul ou d'une squence d'lments.
43

Manuel d'utilisation d'Amaya


La commande suivante, Espace (mspace), vous permet d'ajouter un espace dans une formule.
Pour changer sa taille, vous devez modifier l'attribut width. Voir la section sur l'espacement.
La commande Caractre (&xxx;) vous permet d'entrer un caractre qui n'est pas disponible sur
le clavier. Elle affiche une bote de dialogue dans laquelle vous devez entrer le nom du caractre
(par exemple alpha pour le caractre grec ).
Notez que vous pouvez aussi utiliser l'outil Caractres spciaux.
Les deux commandes suivantes, InvisibleTimes and ApplyFunction, sont utiliss pour entrer
les caractres invisibles correspondants. Voir la section sur les caractres spciaux.
Les entres suivantes du sous-menu Insertion/Math vous permettent de crer de nouvelles constructions
l'intrieur d'une formule. Si le point d'insertion n'est pas dans une formule, un lment math est d'abord
cr pour accepter la nouvelle construction. Les constructions disponibles sont :
3

Racine (mroot dans MathML) : x + 1


Racine carre ( msqrt) : x + 1
Englobe (menclose) : )1234
Fraction (mfrac) :

1
x+1
n

Indice et exposant Expression (msubsup) : xi + 1 ou 0


Indice (msub) : xi
Exposant (msup) : x

n
n

Dessous et dessus (munderover) :


Dessous (munder) :

i=1

maps to

Dessus (mover) : x y
Parenthses (mrow) : (a + b)
l

Multi-scripts (mmultiscripts) : kXi


Enfin, l'entre Nouvelle matrice (mtable) vous permet de crer et diter des tableaux MathML
a b
: c d
Vous devez alors choisir le nombre de lignes et de colonnes dsires et un tableau vide est cre
la position courante. Il se manipule comme les tableaux HTML grce aux commandes
disponibles dans le sous-menu Outils/Editer la table.

La palette Math
Cliquer sur un bouton de la palette Math insre la construction mathmatique reprsente par son icne.
Les parties en noir sont vraiment insre, les parties en rouge reprsentent des cases complter, les
parties en bleu sont demandes explicitement dans une bote de dialogue. Les parties en vert sont
simplement des informations supplmentaires qui ne sont pas insres.
La palette contient toutes les constructions dcrites dans le MathML de contenu (mais le code produit est
un quivalent en MathML de prsentation, voir la section sur les limites courantes) et mme plus. Vous
44

diter des mathmatiques


pouvez aussi enregistrer vos propres constructions dans un fichier mml pour les utiliser ultrieurement.
Les 6 onglets sont :
1.

Constructions diverses
nouvelle formule
mrow: utilis pour regrouper des lments. Voir la section sur la construction
row
mphantom: cache un fragment de la formule, utilisable pour l'alignement. Les
parties caches sont visibles si vous slectionnez la formule :

5x + 3y
2x +

=
7z =

11

3x + 2y 6z = 7

parenthses: (x)
intervalle: On demande les symboles ouvrants/fermants et sparateurs. [a; b]
fence: Idem, mais le nombre d'lments est demand. [1, c, Y, , }
a b
mtable: c d
menclose: )a or b
selector: On demande le nombre de coordonnes. aij
x =

xifx 0

xotherwise
accolades avec disjonction de cas ou accolades :
Constructions de MathML de prsentation : msup, msub, msubsup, mover, munder,
munderover, multiscripts.
Ensembles de nombres: naturels, entiers, rationnels, rels, complexes, quaternions,
premiers.
Accents et script en dessous.
2.

relations d'quivalence et relations d'ordre


galit, approx, congru, isomorphe
ingalits
inf, sup, max and min
logique
Vrai et Faux
Equivalence
Quantificateurs universels et existentiels
Non, Et, Ou, Ou exclusif, Implique, Equivalent

3.

thorie des ensembles


ensemble/liste construit par extension/sparation, nuplet
lement, sous ensemble
ensemble vide, ensemble des parties
complment, diffrence, diffrence symtrique
intersection, union, produit cartsien
cardinal, omega, aleph, intersection diagonale
fonctions et applications
construction lambda
dfinition d'application, flches
domaine, image, codomaine
45

Manuel d'utilisation d'Amaya


identit, composition, application rciproque
4.

arithmtique
somme, produit
factoriel, combinaison, cardinal
divise
ppcm, pgcd
reste, quotient
oprations
oprations lmentaires: plus, moins, fois, division, fraction
puissance, racine
plancher, plafond
complexes
abs (module), arg, conjugu
cartesien, polaire
partie relle et imaginaire
constantes: , , , , NaN (non un nombre)

5.

analyse

differentielle, differentielle partielle


intgrales: simple/double/triple, normal/contour, msub/msupsub
quivalence
limite, tend vers
+
supminus (1 ) ou supplus (0 )
l'infini
petit et grand O
algbre linaire
somme direct
vecteur ligne/colonne, matrice
transpose, dterminant
rot, div, grad, laplacien
produit vectoriel, produit scalaire, produit externe
orthogonal, parallle, complmentaire orthogonal, norme
statistique : moyenne, sdev, variance, mdiane, mode, moment
6. fonctions lmentaires classiques (trigonomtriques, rciproques...)

Entrer des constructions partir du clavier


Vous n'tes pas oblig d'utiliser le sous-menu Math ou la palette Math pour crer et diter des
expressions mathmatiques. Vous pouvez entrer des constructions mathmatiques directement partir du
clavier puisque que chaque entre du menu a un quivalent sur le clavier (les raccourcis sont indiqus
dans les menus). Voir les raccourcis clavier courant pour les versions Linux, Mac OS X, et Windows.
Vous pouvez aussi utiliser les touches directionelles (flches) pour faire passer le point d'insertion d'une
construction une autre. En particulier, les deux flches horizontales permettent de se dplacer selon la
structure de l'expression mathmatique. Par exemple, en fin de numrateur d'une fraction, la flche droite
fait passer au dbut du dnominateur. En outre, si vous utilisez la flche vers la droite l'intrieur d'une
construction non encore complte, le point d'insertion est directement plac dans la case vide la plus
proche.

46

diter des mathmatiques

Options d'ditions avances


Entrer des caractres
Quand vous tapez une chane de caractres dans un lment MathML, Amaya analyse cette chane et
engendre automatiquement des lments mo (oprateur), mn (nombre), mi (identificateur), et mtext
Par exemple, pour entrer la formulex = 2a + b
1. si vous n'tes pas dans une expression mathmatique, cliquer d'abord sur l'entre Insrer une
formule du sous-menu Insertion/Math.
2. taper cette squence de 6 caractres : x=2a+b
Vous pouvez vrifier dans le vue structure ou source la structure gnre par Amaya :
<mi>x</mi><mo>=</mo><mn>2</mn><mi>a</mi><mo>+</mo><mi>b</mi>

Si le rsultat ne correspond pas exactement ce que vous vouliez, il suffit de slectionner les caractres
mal interprts et de changer leur type avec l'une des commandes Texte (mtext), Identificateur (mi),
Nombre(mn), Oprateur (mo).

La construction row
La construction row de la palette est quivalente aux accolades en LaTeX : elle vous permet de donner
des informations sur la faon dont les diffrentes parties d'une formule sont lies entre elles. Elle
n'apparat pas l'cran mais peut avoir un effet indirect sur le rendu.
Par exemple, si vous crez des parenthses, comme dans l'expression suivante :
f (x ) =

1
x

taper la squence de caractres f(x)= . . . donnerait :

()

fx =

1
x

Ici, le (x) doit tre contenu dans un lment mrow. Vous pouvez corriger le problme en slectionnant la
partie de la formule puis en cliquant sur la construction row. Vous pouvez aussi directement obtenir le
mrow souhait en utilisant la commande Parenthses du menu Insertion/Math ou le bouton de la
palette.

Espacement
Amaya gre les espacements l'intrieur des expressions mathmatiques, mais vous avez parfois besoin
d'ajouter d'autres espaces. Dplacez le curseur l'endroit o vous voulez insrer un espace et choisissez
Espace (mspace) dans le sous-menu Insertion/Math. Ceci crer un espace horizontal par dfaut. Vous
pouvez alors changer son attribut width pour ajuster sa taille ou ajouter d'autres attributs (height,
depth, linebreak) pour changer l'espacement vertical. Voir la spcification MathML pour plus de
dtails.

Caractres spciaux
Pour entrer les caractres et symboles mathmatiques qui ne sont pas disponibles au clavier, vous pouvez
utiliser la commande Caractres du sous-menu Insertion/Math. Tapez le nom du caractre (la liste des
noms est disponible dans la spcification MathML). Au lieu du nom, vous pouvez entrer la valeur
Unicode du caractre. Pour entrer cette valeur en dcimal, commencez par '#'. Pour l'entrer en
hexadcimal, commencez par '#x'. Pour acclrer la frappe, vous pouvez entrer directement une valeur
hexadcimal, sans la faire prcder de '#x', mais cela peut donner une ambigut (comme 'af', par
exemple). En cas d'ambigut, la chane saisie est interprte comme un nom de caractre.

47

Manuel d'utilisation d'Amaya


Vous pouvez aussi utiliser l'outil Caractres spciaux qui se trouve dans la zone des outils. La partie
suprieure de cet outil est un menu qui vous permet de choisir un groupe de caractres qui sont alors
disponibles dans le tableau qui se trouve en-dessous. Cliquez sur le caractre voulu dans ce tableau pour
l'insrer dans le document.
En outre, la spcification MathML recommande d'ajouter des caractres invisibles pour que la lecture de
la formule soit plus facile pour les synthtiseurs vocaux. Ces caractres sont automatiquement insrs
dans les constructions de la palette, mais parfois vous devez le faire vous-mme. Vous pouvez utiliser le
sous-menu Insertion/Math ou des raccourcis. Les trois caractres invisibles sont :
1. le produit invisible : ab
2. l'application de fonction : f (x)
3. la virgule invisible : aij

Editer la structure
Si vous voulez changer la structure d'une expression existante, pour ajouter par exemple un exposant ou
mettre des parenthses autour d'une expression, il suffit de slectionner dans le document l'expression
transformer et d'entrer la nouvelle expression avec la palette Math, le sous-menu Insertion/Math ou le
clavier.
Vous pouvez galement utiliser la commande Transformer du menu Outils. Slectionnez l'expression
que vous voulez transformer et la commande Transformer affichera un menu avec tous les changements
possibles. Pour les constructions qui ne font pas parties du balisage de prsentation MathMP (i.e.
seulement disponibles partir de la palette) cliquer sur le bouton mettra l'expression slectionne dans la
case vide la plus naturelle.
diter la structure est utile pour garder une structure rcursive mme en rentrant une formule
linairement. Par exemple, pour rentrer

x2

9
25

x 35 vous pouvez,

soir rentrer "rcursivement" (plus rapide mais moins naturel pour les longues expressions) :
2
x x

x2

x2

...
soit rentrer linairement (vous crivez comme vous lisez, mais vous devez slectionner
plusieurs fois) :
9
x x x2 x2 x2 9 x2
...
Gnralement, vous combinerez les deux mthodes.

Vue structure
Toutes les fois qu'un document contient des lments MathML, la slection de l'article Montrer la
structure du menu Affichage ouvre la vue Structure qui montre la structure principale du document
HTML. Dans cette vue, les lments MathML et leur contenu effectif sont affichs.
Vous pouvez diter des expressions mathmatiques aussi bien dans la vue principale que dans la vue
Structure. La vue Structure est particulirement utile pour viter l'ambigut. Observez l'exemple suivant
:
x = a + b + 1
Lorsque vous dplacez le point d'insertion aprs le caractre b, il n'est pas vident de distinguer si vous
voulez ajouter quelque chose l'intrieur de la racine carre ou aprs elle. Slectionner (ou vrifier )
48

diter des mathmatiques


dans la vue Structure vite toute ambigut. Vous pouvez galement vrifier dans la ligne d'tat, en bas
de la fentre.

Les liens dans MathML


Vous pouvez crer et utiliser des liens hypertexte dans des expressions mathmatiques. Ces liens sont
reprsents en utilisant le XML Linking Language (XLink). Seuls les liens simples unidirectionnels sont
utilisables, mais vous pouvez associer un lien n'importe quelle partie d'une formule. Par exemple, la
fraction dans la formule ci-dessous est un lien vers la page d'accueil du W3C :
y=

x2 + 1

Cliquer deux fois sur un des caractres l'intrieur de la fraction fait apparatre la page d'accueil du
W3C.
Pour crer un tel lien, il suffit de slectionner une expression (la fraction dans l'exemple ci-dessus), de
cliquer sur le bouton
de l'outil Elments, ou de slectionner l'entre Crer/changer lien du menu
Liens, et de cliquer sur la cible dsire. Si la cible est une expression dans une formule, vous devez
d'abord faire de cette expression une cible. Il suffit de slectionner l'expression ainsi que l'entre Crer
cible du menu Liens. Ceci cre un attribut id pour l'expression cible.

Un peu plus propos de MathML


Compatibilit des navigateurs
Plusieurs navigateurs possdent un support MathML :
Internet Explorer avec le plugin MathPlayer
Firefox et les autres navigateurs bass sur le moteur de rendu Gecko
Opera depuis la version 9.5
Il faut utiliser le suffixe .xml pour tre sr que tous les navigateurs traitent les documents XHTML
comme du XML et donc affichent correctement les documents incluant des formules mathmatiques. Il
est aussi recommand d'utiliser le charset utf-8 pour les documents XML.
Par dfaut Amaya ajoute le doctype XHTML 1.1 plus MathML 2.0 en tte du document. Ce doctype
n'est pas obligatoire mais il est utile :
pour valider le document,
pour engendrer des entits alphanumriques (&int; par exemple) pour les symboles
mathmatiques, dans le code source. Sinon les symboles mathmatiques seront cods comme
tout autre caractre unicode.
Malheureusement, ce doctype n'est pas support par beaucoup de navigateurs. Il peut donc tre
ncessaire de le supprimer avec la commande Outils/Changer le doctype/Supprimer le doctype.
IE utilise la feuille de transformation pmathml.xsl et un plugin pour afficher le code MathML inclus.
Amaya ajoute automatiquement le lien vers la feuille de transformation, mais il faut penser dposer une
copie de cette feuille de transformation (pmathml.xsl) dans le rpertoire local du document.

Limitations courantes
Amaya implmente seulement les Balises de Prsentation de MathML 2.0, et non le Balisage
du Contenu.
Certaines balises de prsentation ne sont pas entirement disponibles: mglyph, maction

49

Manuel d'utilisation d'Amaya


Tous les lments de prsentation et les attributs sont utilisables, mais seuls les attributs suivant
sont pris en compte dans le formatage : display, alttext, mathvariant, mathsize,
mathcolor, mathbackground, fontsize, fontweight, fontstyle, fontfamily, color,
linethickness, numalign, denomalign, bevelled, notation, lquote, rquote, lspace,
rspace, largeop, movablelimits, subscriptshift, superscriptshift, form, width
(mspace), height (mspace), depth (mspace), align, rowalign, columnalign, frame,
framespacing, displaystyle,side, rowspan, columnspan, rowspacing,
columnspacing, rowlines, columnlines.
Les attributs class, id et style sont utilisables, avec la mme smantique que dans HTML :
vous pouvez associer du style CSS aux lments MathML (attribut class et style) et un
lment MathML peut tre la cible d'un lien (attribut id).
Amaya utilise les polices STIX pour afficher des symboles mathmatiques, mais tous ne sont
pas supports.

50

diter des graphiques SVG

diter des graphiques SVG


Amaya vous permet d'inclure des graphiques vectoriels dans des pages web, suivant la spcification
Scalable Vector Graphics (SVG). le but n'est pas de crer tous les lments et attributs de SVG, mais
d'implmenter un sous-ensemble du langage qui soit suffisant pour les dessins que les auteurs
scientifiques incluent dans leurs documents.
Amaya gre les lments SVG comme des composants structurs, de la mme faon que les lments
HTML.
Les lments SVG sont grs comme des composants structurs, de la mme faon que les lments
HTML. Donc vous pouvez manipuler les graphiques SVG comme n'importe quelle autre partie de
documents HTML.
Toutes les fonctions d'dition fournies par Amaya pour diter le texte sont aussi disponibles pour diter
le graphique.
Attention: L'dition SVG est en phase de dveloppement. Vous trouverez certainement des bugs et
l'interface utilisateur risque de changer dans le futur.

Crer des graphiques


Pour dessiner des graphiques, il faut un canevas SVG. Celui-ci peut tre le document lui-mme, ou un
lment <svg> dans un document XML. Un document SVG est cr par la commande Fichier>Nouveau->Nouveau Dessin. Un onglet de l'outil Elments vous permet de crer un canevas SVG et des
composants graphiques dans un document XML.
Quand l'utilisateur demande la cration d'un canevas SVG dans un document XML, Amaya cherche un
endroit autour du point d'insertion o un tel lment <svg> peut tre insr. L'lment est cr avec une
largeur et hauteur par dfaut. Par la suite, quand le canevas SVG est slectionn, il peut tre
redimensionn.
Si l'utilisateur essaie de crer un graphique hors d'un canevas SVG, un lment <svg> est
automatiquement engendr pour inclure le nouveau composant graphique.
Quand l'utilisateur clique dans un canevas SVG, l'outil SVG est prsent et l'utilisateur peut crer des
composants graphiques :
des connecteurs : ligne, flche simple ou double, "zigzag".
texte, fragment de HTML embarqu (foreignObject), formule mathmatique, image.
des figures lmentaires : carr, rectangle (optionnellement avec des coins arrondis), losange,
paralllogramme, trapze, triangles, cercle et ellipse.
polygone et segments de droite, courbes ouvertes et fermes.
des polygones rguliers : pentagone, hexagone, heptagone, octogone, diffrentes toiles
des objets 3D : cube, paralllpipde, cylindre, octadre, pyramide.
des symboles spciaux pour l'lectronique, la chimie, etc.
Dans la vue formate, la position et la taille de tous les composants crs sont donnes par une
interaction directe :
Pour les connecteurs (except pour les lignes), les figures lmentaires et les objets 3D, vous
devez tout d'abord slectionner la position du coin gauche en cliquant avec le bouton gauche de
la souris. Laissez le bouton appuy (drag) et dplacez la souris jusqu' la position du coin
oppos, puis lchez le bouton.
51

Manuel d'utilisation d'Amaya


Pour le texte et les foreignObject, cliquez la position o vous souhaitez insrer l'lment.
Pour les polygones et segments de droite, vous cliquez pour engendrer un point la position
correspondante avec le bouton gauche de la souris. Pour indiquer le dernier point, faites un
double clic. Un clic droit ou la touche Echappement arrte l'interaction sans ajouter de point.
Pour les courbes de Bzier, vous procdez comme pour les polygones, sauf que vous devez
indiquer aussi la direction des tangentes.
Quand une ligne, une flche, un polygone ou un segment de droite est cr, la touche shift peut tre
presse pour forcer une approximation de 15.
Quand la slection est dans la vue structure, les composants sont crs avec une position et une taille par
dfaut.

Slectionner des graphiques


Dans la vue formate, les rgles de slection des graphiques sont les suivantes :
Si l'lment est creux, alors il faut cliquer sur ses contours. Dans le cas contraire, vous pouvez
cliquer l'intrieur.
Si une polyline ou un chemin est slectionn, alors leurs points de contrles apparaissent et
peuvent tre slectionns individuellement. Si le point de contrle slectionn fait partie d'un
fragment de courbe de Bzier, la poigne de Bzier correspondante est affiche.
Si la touche shift est presse alors chaque nouveau lment sur lequel on clique est ajout la
slection.
Plusieurs composants peuvent tre slectionns en mme temps, l'aide de l'outil de slection
rectangulaire du panneau SVG.
Quand des composants sont groups, ces composants ne peuvent pas tre slectionns
individuellement dans le vue formate. Seul le groupe peut tre slectionn. Mais vous pouvez
les slectionner dans la vue structure.

Appliquer des transformations aux graphiques


Pour appliquer des transformations un composant, il faut d'abord le slectionner. Les transformations
disponibles sont proposes dans l'outil SVG, mais aussi dans le menu contextuel affich avec le bouton
droit.
Les transformations possibles sont :
grouper/dgrouper des composants
changer le niveau des objets: envoyer arrire-plan, descendre d'un niveau, monter d'une
niveau, monter au premier-plan.
tourner, pivoter de 90.
symtries verticale et horizontale.
alignements : gauche, centre, droite, haut, milieu, bas. Si un seul objet est slectionn,
l'alignement se fait par rapport au cadre SVG.

Appliquer du style aux graphiques


Vous pouvez changer quelques attributs de style des graphiques en utilisant le panneau Style. Quand un
composant SVG est slectionn, le panneau Style change pour prsenter les attributs de style
spcifiques :

52

diter des graphiques SVG


Opacity : contrle l'opacit globale du composant graphique (couleur du fond et couleur du
contour)
Fill : contrle la couleur de fond est utilise pour remplir le graphique et son opacit
Si l'entre n'est pas coche, le graphique est creux
Le bouton color donne la couleur courante
Le bouton palette permet de choisir une autre couleur
Stroke : contrle la couleur du contour du graphique et son opacit
Si l'entre n'est pas coche, le graphique n'a pas de contour
Le bouton color donne la couleur courante
Le bouton palette permet de choisir une autre couleur
Stroke-width : contrle l'paisseur des contours

53

Manuel d'utilisation d'Amaya

54

diter des documents XML

diter des documents XML


Chargement de document XML
Amaya permet de lire et d'afficher n'importe quel document XML bien-form, et de le formater si une
feuille de style CSS est associe.
Pour un document XML faisant rfrence une DTD ou un espace de noms non support (autre que
XHTML, MathML ou SVG), Amaya offre un support d'affichage et d'dition plus restreint. En effet,
comme Amaya n'analyse pas la DTD associe, il ne peut vrifier la validit d'un tel document et n'a pas
d'informations particulires sur les lments, les attributs ainsi que sur leur organisation dans le
document.

Utilsation du style dans XML


Pour ces documents XML, Amaya propose la vue source du document, une vue structure qui reflte
l'organisation du document et une vue formate qui affiche le contenu des lments. Sans autre indication
de style, tous les lments sont considrs comme blocs. Nanmoins, pour des raisons de lisibilit les
lments contenant au moins une chane de caractres sont considrs comme des lments en-ligne et
sont mis en ligne dans la vue formate. Amaya permet galement d'associer des feuilles de styles CSS
pour ces documents par l'intermdiaire d'instructions de traitement (PI) de type xml-stylesheet.

Edition de documents XML


L'dition des documents XML dans Amaya est encore exprimentale. Pour les parties supportes du
document (XHTML, SVG, MathML), l'dition suit les rgles propres chaque type. Pour les parties
gnriques, seule la commande Entre est actuellement disponible :
Si la slection est l'intrieur d'un lment, alors Amaya coupe l'lment slectionn.
Si un lment non vide est compltement slectionn, alors Amaya cre un lment vide de
mme type aprs la slection.
Si un lment vide est compltement slectionn, alors Amaya cre un voisin de mme type
pour le parent de l'lment slectionn.
Vous pouvez galement modifier des documents XML en utilisant la Vue source et en effectuant la
commande Fichier / Synchroniser. Vos modifications seront prises en compte dans la vue formate.

55

Manuel d'utilisation d'Amaya

56

Appliquer du style un document

Appliquer du style un document


Le menu Format vous permet de changer l'apparence de vos documents en utilisant les cascades des
feuilles de style (CSS).

Appliquer/Retirer un thme
Amaya fournit par dfaut deux thmes (Classique, Moderne) qui vous permettent de changer
globalement la prsentation du document courant.
Pour changer la prsentation du document avec un thme :
Slectionnez Classique ou Moderne dans la liste des thmes proposs par l'outil Style,
ou slectionnez Classique ou Moderne dans le sous-menu Format/Thme.
Pour retirer le thme courant :
Slectionnez Pas de thme dans la liste des thmes proposs par l'outil Style,
ou slectionnez Pas de thme dans le sous-menu Format/Thme.
Tous ces changements peuvent tre dfaits (dition/Dfaire ou Ctrl-z).
Quand un thme est appliqu un document, Amaya engendre un lment style dont le contenu vient
des fichiers Amaya/config/Classis.css ou Amaya/config/Modern.css. Vous pouvez crer vos
propres fichier Classic.css et Modern.css dans son rpertoire AmayaHome. Si vous le faites, Amaya
utilisera ces fichiers la place des fichiers par dfaut du rpertoire config.

Appliquer du style spcifique


Certaines proprits de style comme la couleur du texte, la couleur de fond, la police de caractres,
l'alignement, l'interligne, ou l'indentation peuvent tre appliqus une portion de texte ou un lment
complet avec l'outil Style ou avec les sous-menus du menu Format.
Pour appliquer un style spcifique :
1. Slectionnez un fragment de texte ou un lment.
Pour slectionner un lment, cliquez dans l'lment, puis utiliser la touche F2 jusqu' ce que la
ligne en bas de la fentre affiche le type de l'lment voulu en premire position.
2. Choisissez dans l'outil Style ou dans le menu Format l'entre correspondant la proprit de
style qui vous intresse.
L'outil Style propose deux boutons pour chacune des couleurs (couleur du texte et couleur de
fond). Le premier bouton de chaque paire permet d'appliquer la couleur visualise alors ; le
second permet de choisir une autre couleur et de l'appliquer.
Les entres polices et taille de caractres sont les seules mises jour en fonction de la slection.
Pour retirer un style spcifique :
L'outil Style ne permet pas de retirer le style spcifique. Il faut donc utiliser les entres Pas de
couleur ou Dfaut des sous-menus du menu Format.
Dans le profil d'dition avance, vous pouvez directement diter l'attribut style.

Associer une classe un lment


Toutes les valeurs disponibles pour l'attribut class dans le document sont listes dans l'outil Appliquer
classe.
57

Manuel d'utilisation d'Amaya


Pour appliquer une classe un lment :
1. Choisissez la valeur dans l'outil Appliquer classe.
2. Si vous voulez slectionner la classe applique un autre lment, vous devez slectionner cet
lment, puis cliquer sur le bouton
cet lment est slectionne.

. La liste Appliquer classe est mise jour et la classe de

3. Slectionnez un fragment de texte ou un lment.


Pour slectionner un lment, cliquez dans l'lment, puis utiliser la touche F2 jusqu' ce que la
ligne en bas de la fentre affiche le type de l'lment en premire position.
4. Cliquer sur le bouton
pour appliquer la classe la slection courante.
Si un fragment de texte est slectionn, Amaya engendre un lment span pour englober le
texte courant et l'attribut class est attach ce nouvel lment span.
Pour associer une classe (attribut class) un lment, vous pouvez galement utiliser l'outil Attributs
(dans le profil avanc seulement). Cet outil permet aussi de retirer l'attribut class d'un lment ou de le
modifier (l'attribut class se manipule comme n'importe quel autre attribut).
Pour retirer la classe d'un lment :
Vous pouvez diter l'attribut class dans l'outils Attributs.
Quand l'lment est slectionn, cliquez sur le [X] de l'entre pour supprimer l'attribut class,
ou cliquez sur l'entre et ditez sa valeur, puis confirmez avec le bouton appliquer

Vous pouvez aussi retirer ou diter l'attribut class dans la vue structure.
Pour retirer l'attribut class, cliquez dans la valeur, F2 pour slectionner la valeur entire, puis
deux Suppr pour dtruire l'attribut.

Crer des lments de style HTML


HTML dfinit certains lments de niveau caractre qui permettent d'associer du style aux chanes de
caractres. Deux entres depuis le menu Insertion permettent d'diter ces lments HTML.

Elments type information


La commande Types information du menu Insertion prsente un sous-menu offrant un choix
d'lments HTML qui dfinissent des styles abstraits.
Pour appliquer un des lments type information :
1. Slectionnez une chane de caractres.
2. Choisissez une commande dans le menu Types information.
La chane de caractres slectionne reoit le style correspondant.
Cinq de ces lments sont galement disponibles dans l'outil Elments : em (
), ins (

), del (

), stong (

), code (

).

Elments caractres
La commande lments caractres du menu Insertion offre un autre menu changeant le style du texte.
Pour appliquer un des lments caractres :
1. Slectionnez une chane de caractres.
2. Choisissez une commande dans le menu Elments caractres.

58

Appliquer du style un document


La chane de caractres slectionne reoit le style correspondant.
Deux de ces lments sont galement disponibles dans l'outil Elments : sup (

), sub (

).

Supprimer un lment type information ou charactres


Toutes les commandes des sous-menus Types information et lments caractres s'annulent si elles
sont appliques de nouveau.
Pour supprimer un lment style :
1. Slectionnez la chane de caractres dont vous voulez supprimer le style.
2. Appliquez de nouveau la commande du sous-menu Types information ou Elments
caractres du menu Insertion, ou utilisez le bouton de l'outil Elments : em (
), code (

), ins (

), del (

), sup (

), sub (

), strong (

).

Si vous voulez insrer un texte sans aucun style dans une chane de caractre style, placez le point
d'insertion la position dsire et activez la commande correspondant au style retirer (sous-menu
Types information ou Elments caractres du menu Insertion, ou utilisez le bouton de l'outil
Elments).

Utiliser l'diteur de style


Note : L'diteur de style n'est pas disponible dans le profil Lite d'Amaya
L'entre Editeur de style du menu Format, ou le bouton
de la barre de boutons, permet
d'engendrer une liste de proprits de style CSS, l'aide d'une boite de dialogue avec 4 onglets :
Caractres, Couleurs, Boites, Format.
Quand vous avez choisi un ensemble de proprits, vous pouvez les Appliquer la slection courante :
Si la slection se trouve dans une vue formate, Amaya engendre un attribut style pour l'lment
slectionn, crant un lment span lorsqu'une simple chane de caractres est slectionne.
Si la slection se trouve dans une vue source ou dans un fichier CSS, Amaya engendre la
position courante la syntaxe CSS des proprits que vous avez choisies.
Dans tous les cas, les adresses des images incluses dans la liste des proprits (background-image,
list-style-image) sont transformes en adresses relatives au document.

Les feuilles de style CSS externes et utilisateur


Note : Ces actions ne sont pas disponibles dans le profil Lite d'Amaya.
Un document peut associer plusieurs feuilles de style externes qui sont charges avec le document et lui
sont appliques.
Une feuille de style externe peut s'appliquer plusieurs documents. Quand la mme feuille de style
s'applique plusieurs documents affichs, Amaya ne charge qu'une seule instance de la feuille de style.
Vous pouvez dfinir une feuille de style spcifique qui s'applique tous les documents que vous chargez.
Cette feuille de style est appele feuille de style utilisateur. C'est le fichier local amaya.css conserv
dans votre environnement utilisateur (rpertoire AmayaHome).
Par exemple, si vous prfrez afficher les document en Helvetica et imprimer avec une police de
caractres de petite taille, vous pouvez crer votre feuille de style utilisateur avec les rgles CSS
suivantes :
59

Manuel d'utilisation d'Amaya


@media print {
body {font-size: 10pt}
}
@media screen {
body {font-family: Helvetica}
}

Grer des feuilles de style CSS externes


Le sous-menu Format/Feuilles de style donne accs une srie de commandes qui permettent de
contrler les feuilles de style CSS externes et de l'utilisateur.
La commande Ajouter permet de lier une nouvelle feuille de style CSS un document courant.
Cette commande fait apparatre une bote de dialogue :
Si la feuille CSS cible est visualise dans une autre fentre d'Amaya, cliquez sur le
bouton Clic puis n'importe o dans la feuille CSS cible. Le lien est cr.
Si la feuille CSS cible est visualise dans un autre onglet, cliquez sur le bouton Clic
puis changez d'onglet et cliquez n'importe o dans la feuille CSS cible. Le lien est cr.
Si la feuille CSS cible est locale vous pouvez utiliser le bouton Parcourir pour la
slectionner.
Sinon entrez l'URI (comme http://www.w3.org/file.css) de la feuille CSS cible et tapez
sur la touche Entre pour confirmer (ou cliquez sut le bouton Confirmer). Le lien est
cr.
La commande Ouvrir permet d'ouvrir une des feuilles de style CSS appliques au document
courant.
La commande Dsactiver permet de supprimer les effets d'une des feuilles de style active du
document courant. Cette commande n'affecte en rien le lien CSS dans le document. Elle l'ignore
simplement.
La commande Ractiver permet de rtablir les effets d'une des feuilles de style CSS dsactives
du document courant. Cette commande n'affecte en rien le lien CSS dans le document.
La commande Retirer permet de retirer une des feuilles de style CSS externes. Cette commande
agit comme la commande Dsactiver, mais en plus, le lien qui attache la feuille de style CSS est
supprim.
Les commandes Ouvrir, Dsactiver et Ractiver peuvent tre appliques la feuille de style de
l'utilisateur, mais les commandes Ajouter et Retirer concernent uniquement les feuilles de style
externes.
L'outil Liste des styles affiche la liste les feuilles de styles appliques au document. En mme temps, il
permet d'ajouter/retirer, activer/dsactiver, et ouvrir des feuilles de style.

Visualiser le style appliqu


Lorsque de multiples feuilles de style sont attaches un document, il est souvent difficile de
comprendre pourquoi un lment est visualis avec telle ou telle proprit de style. Pour vous aider dans
cette situation, Amaya fournit la commande Format/Montrer le style appliqu qui visualise dans une
fentre externe les proprits CSS appliques au premier lment de la slection courante.
Vous pouvez alors afficher la rgle CSS qui engendre chaque proprit en double-cliquant sur la
proprit. Aussi longtemps que la fentre des proprits CSS est ouverte, Amaya met jour son contenu
chaque fois que la slection change.
En appuyant sur la touche F2, vous pouvez ainsi voir les proprits CSS appliques aux lments
englobants. Quand vous cahngez la slection en slectionnant dans le chemin de la barre d'tat affich en
bas de la fentre, les proprits CSS appliques sont galement mises jour.
60

Appliquer du style un document

Crer un style gnrique pour un lment ou une classe


Quand un attribut style a t associ un lment, vous pouvez utiliser cet lment comme un modle
pour crer ou modifier une rgle de style en utilisant la commande Format/Crer une rgle.
Pour crer un style gnrique pour un lment ou une classe :
1. Slectionnez l'lment que vous dsirez utiliser comme modle. Par dfaut la slection est mise
sur la chane de caractres, et vous devez utiliser la touche F2 pour slectionner l''lment
englobant.
Note : Vous devez slectionner un seul lment et cet lment doit avoir un attribut style.
2. Choisissez Crer une rgle dans le menu Format. Une bote de dialogue s'affiche et montre
une liste de slecteurs CSS. Cette liste inclut toutes les classes qui sont dfinies pour le
document courant (y compris les classes dfinies par les feuilles de style lies au document),
ainsi que le type de l'lment auquel le style est associ.
3. Choisissez un slecteur dans cette liste ou entrez un nouveau nom de classe et cliquez sur le
bouton Confirmer.
Le style de l'lment slectionn est dsormais associ au slecteur choisi et l'attribut style est
supprim de l'lment slectionn. Sa valeur est dplace l'lment style, dans l'entte head
du document, et tous les lments correspondant au slecteur sont visualiss dans le nouveau
style.
Quand vous avez cr une nouvelle classe avec la commande Crer une rgle, cette classe est
automatiquement ajoute la liste de l'outil Appliquer une classe.

61

Manuel d'utilisation d'Amaya

62

Rechercher et remplacer du texte

Rechercher et remplacer du texte


Vous pouvez rechercher et remplacer du texte par l'intermdiaire de la bote de dialogue Rechercher. On
appelle cette bote soit en choisissant Rechercher dans le menu dition, soit en cliquant sur le bouton
correspondant

, ou encore en utilisant le raccourci clavier Ctrl-f.

Cette procdure vous permet de rechercher ou de remplacer du texte selon diffrents critres :
La chane de caractres cherche doit tre entre dans la zone Texte chercher.
Si le bouton Ignorer la casse est slectionn, l'criture en majuscules ou en minuscules est
indiffrente ; dans le cas contraire, la chane sera recherche telle qu'elle a t entre dans la
zone Texte chercher.
Les chanes peuvent tre galement remplaces en effectuant une opration similaire. Entrez le
texte de remplacement dans la zone Texte de remplacement et choisissez un mode de
remplacement dans le menu Remplacement. Les modes de remplacement disponibles sont les
suivants :
Sans remplacement : mme si la zone d'entre Texte de remplacement contient une
chane de caractres, rien ne sera remplac. On se trouve dans la configuration d'une
simple recherche.
Remplacement la demande : quand la chane recherche est trouve, elle est
slectionne. L'utilisateur peut alors slectionner l'un des boutons suivants :
Confirmer pour remplacer la chane slectionne et effectuer la recherche de
nouveau.
Sauter pour chercher le prochain rsultat de la recherche sans remplacer la
chane qui a t trouve.
Remplacement automatique : tous les rsultats de la recherche de la chane sont
remplacs automatiquement dans la partie concerne du document, dfinie dans le
menu O rechercher.
Le menu O rechercher vous permet de spcifier la partie du document dans laquelle la
recherche s'effectue :
Avant la slection : la recherche commence au dbut de la partie slectionne et
remonte jusqu'au dbut du document.
Dans la slection : la recherche s'effectue uniquement dans la partie slectionne,
depuis son dbut jusqu' sa fin.
Aprs la slection : la recherche commence la fin de la partie slectionne et
descend jusqu' la fin du document.
Dans tout le document : la recherche est effectue dans tout le document du dbut
jusqu' la fin, sans tenir compte des parties ventuellement slectionnes.
Pour lancer l'opration de recherche, cliquez sur le bouton Confirmer situ au bas de la bote de
dialogue. Si la chane recherche est trouve, elle est slectionne et le document est positionn de telle
sorte que la chane soit visible ; vous pouvez alors aller au prochain rsultat de la recherche en cliquant
de nouveau sur le bouton Confirmer. Si la chane n'est pas trouve, un message "Pas trouv" apparat
ct du bouton Confirmer.
L'opration de recherche ou de remplacement peut tre abandonne n'importe quel moment en cliquant
sur le bouton Annuler.
Les oprations de remplacement peuvent tre annules l'aide de la fonction Dfaire du menu dition,
ou par le raccourci clavier Ctrl-z.

63

Manuel d'utilisation d'Amaya

64

Vrifier l'orthographe

Vrifier l'orthographe
Amaya est pourvu d'un vrificateur d'orthographe multilingue. Cet outil est invoqu par la commande
Vrifier orthographe du menu Outils. L'attribut lang permet de choisir le bon dictionnaire. Vous
pouvez associer cet attribut n'importe quel lment dans un document, mme un seul mot. Utilisez
pour cela l'outil Attributs.

Le dictionnaire personnel
Le vrificateur d'orthographe vous permet d'avoir votre dictionnaire personnel qui se trouve dans
AmayaHome/dictionary.DCT.Ce dictionnaire est utilis pour tous les documents, en supplment des
dictionnaires des diffrentes langues. Il est cr, s'il n'existe pas dj, et automatiquement mis jour par
le vrificateur d'orthographe lorsque la commande Apprendre est active (voir plus bas).

Le dialogue Corriger
La commande Vrifier orthographe du menu Outils affiche une bote de dialogue qui vous permet de
choisir les paramtres de correction :
Le mot erron est affich dans la zone en haut gauche. La liste des corrections proposes est
affiche dans le slecteur localis en-dessous du mot erron. Par dfaut, la premire proposition
de correction est slectionne. Pour slectionner une autre proposition, cliquez simplement
dessus. La proposition slectionne est affiche en-dessous du slecteur. Cette proposition peut
tre dite. La correction se fait une fois que vous avez cliqu sur le bouton Remplacer.
Notez que vous pouvez effectuer une correction simplement en double-cliquant une des
corrections proposes.
La langue dans laquelle se fait la correction est spcifie dans le coin en bas gauche de la bote
de dialogue. Pour modifier la langue, il suffit d'appliquer un attribut lang au texte concern en
utilisant le menu Attributs, puis de redmarrer la procdure de correction.
Plusieurs boutons dans le menu Ignorer les mots vous permettent d'ignorer certains mots : par
exemple les mots entirement en lettres capitales, les mots incluant des chiffres, les chiffres
romains ou les mots contenant des caractres spciaux indiqus dans la liste voisine. Vous
pouvez modifier cette liste.
Le menu O corriger, similaire celui de la bote de dialogue Rechercher, vous permet de
spcifier la partie du document sur laquelle le vrificateur doit travailler.

Corriger un document
Avant de lancer la correction orthographique, assurez-vous que la slection courante est dans le
document que vous voulez corriger. Le correcteur distingue la vue source de la vue formate. Si la
slection est dans la vue source, tout le balisage sera pris en compte dans la correction. Si la slection est
dans la vue formate, seul le contenu du document sera trait.
Pour dmarrer la correction, cliquez sur le bouton Chercher/Suivant en bas de la bote de dialogue. Si
une erreur est trouve, le mot incorrect est slectionn dans le document. Si aucune erreur n'est dtecte,
le message "Correction termine" s'affiche en bas de la bote de dialogue.
Lorsqu'un mot incorrect est dtect, vous pouvez utiliser un des boutons placs en bas de la bote de
dialogue afin d'excuter l'une des oprations suivantes :
Chercher/suivant : le mot considr incorrect est acceptable. Aucun changement n'est effectu,
ni dans le texte, ni dans le dictionnaire. Le vrificateur cherche l'erreur suivante.

65

Manuel d'utilisation d'Amaya


Apprendre : mme action que "Chercher/suivant" sauf que le mot incorrect est ajout votre
dictionnaire personnel. Ainsi, le vrificateur ignorera toute future occurrence de ce mot.
Remplacer : le mot erron est remplac par le mot correct (que vous avez ventuellement
chang ou modifi) et le vrificateur cherche l'erreur suivante.
Fermer : la bote de dialogue disparat et la vrification est abandonne. Les corrections
effectues subsistent.

66

Enregistrer et publier des documents

Enregistrer et publier des documents


Amaya permet d'enregistrer les documents (X)HTML soit en format d'origine, soit en format texte. Les
documents MathML, SVG, XML, CSS sont sauvegards dans leur format d'origine.
Les sauvegardes distantes et locales peuvent tre effectues par les trois commandes Enregistrer,
Enregistrer sous et Enregistrer tout.
Il existe un certain nombre d'options de configuration que vous pouvez changer par l'intermdiaire du
menu de configuration.
Amaya ne fournit pas de vue d'ensemble de pages installes sur un serveur. Cependant il est possible
d'enregistrer des fichiers d'un serveur comme des fichiers locaux grce la commande Enregistrer sous.
Pendant ces oprations, Amaya tient compte des images prsentes dans le document, ainsi que des autres
ressources associes au document (feuilles de style, scripts).

La commande enregistrer
La commande Enregistrer peut tre invoque soit en choisissant Enregistrer depuis le menu Fichier
(Ctrl-s) soit en cliquant sur le bouton
. Cette commande sauve le document courant son adresse
d'origine. Si la rponse du serveur inclut l'en-tte HTTP Content-Location, la cible de la sauvegarde
sera l'URL prcise par cet en-tte. Ceci est utile pour enlever les ambiguts induites par la ngociation
du contenu. Soient par exemple "report.html.fr" et "report.html.en" deux versions d'un mme document,
une crite en franais, l'autre en anglais. On utilisera l'URL virtuelle "report.html" pour rfrencer ce
document. En fonction de la configuration du navigateur, le serveur retournera l'un ou l'autre document
lors de la consultation de l'URL report.html. Si le serveur supporte l'en-tte Content-Location, il
indiquera dans celle-ci l'URL du document qu'il a affectivement servi, par exemple, "report.html.fr".
Dans ce cas, la sauvegarde du document sera faite vers cette URL plutt que vers l'URL virtuel
"report.html".
Les images nouvellement ajoutes sont sauves dans le mme rpertoire que celui du document et
aucune confirmation n'est demande, sauf si le nom du document est inconnu. Les serveurs permettent en
effet d'accder en lecture un document quand seul le nom du serveur et le rpertoire sont donns. Cela
est utile au moment de la navigation, mais n'est pas support par la mthode "PUT" du protocle HTTP.
Dans ce cas, Amaya dtecte que le nom du document manque et propose d'utiliser un nom par dfaut.
Notez que l'utilisation de l'en-tte Content-Location permet de s'affranchir de ce problme.
Si vous voulez enregistrer des images nouvellement ajoutes dans un autre endroit que le document luimme, utilisez la commande Enregistrer sous.

La commande enregistrer tout


La commande Enregistrer tout vous permet de sauvegarder d'un coup tous les documents ouverts dans
Amaya que vous avez modifis mais pas encore sauvs. Elle fonctionne comme la commande Sauver,
mais pour tous ces documents au lieu du seul document courant.
Cette commande peut tre appele par le menu Fichier ou par le bouton

de la barre des boutons.

La commande enregistrer sous


Le fait de slectionner l'entre Enregistrer sous dans le menu Fichier ouvre une bote de dialogue qui
vous permet d'enregistrer le document courant en changeant le format et une adresse diffrente.
Vous pouvez :
67

Manuel d'utilisation d'Amaya


enregistrer le document seule ou avec ses ressources (images, objets, style, scripts) sur un
disque local ou un serveur web distant
les images et les objets inclus peuvent tre sauvs dans le rpertoire du document ou une
adresse diffrente
le style (y compris les feuilles de style et les images importes) et les scripts lis au document
peuvent tre sauvs dans le rpertoire du document ou une adresse diffrente
toutes les URIs du document peuvent tre mis jour pour tenir compte de la nouvelles adresse
du document et de ses resources associes.
La bote de dialogue comporte deux onglets et deux boutond. Le premier onglet permet de chosir les
options pour le document lui-mme, le deuxime les options pour les resources associes (images,
feuilles de style, scripts).
L'onglet Document contient :
Le champ Adresse du document indique l'adresse o le document doit tre sauv. Ce peut tre
dans le systme du fichier local (par exemple "/pub/html/welcome.html") ou un URI distant (par
exemple "http://www.w3.org/pub/Welcome.html").
Notez que vous devez donner le chemin complet. Vous devrez galement vous assurer que vous
avez le droit d'excuter une mthode PUT dans le cas d'une URI. Regardez la page configurez
votre serveur pour permettre la mthode PUT ou demandez votre administrateur Web.
Le menu Format de document propose le choix entre HTML, XML (XHTML) et Texte pour
les documents HTML. Ce menu n'est pas propos quand on sauve un document SVG, MathML,
CSS ou tout autre type que (X)HTML. Par dfaut Amaya conserve le format d'origine du
document.
Le format Texte (voir plus bas) supprime les balises HTML et produit du texte pur.
Le menu Options :
Le choix Transformer les URLs transforme toutes les URIs courantes en URIs
relatives quand c'est possible. Bien sr, si le document est sauv dans un fichier local
et si les URIs pointent sur des fichiers distants, les URIs resteront absolues. Ceci
assure que tous les liens dans le document soient prservs par la copie.
Si vous sauvez le document localement pour le publier ensuite par ftp parce que votre
fournisseur d'accs ou votre Webmaster ne vous permet pas d'utiliser la mthode
HTTP Put, vous devez dsactiver cette option pour ne pas altrer les liens calculs
quand le document tait sur le serveur http.
Le choix Copier les Images indique que les images et objets inclus dans le document
doivent tre copis avec le document une nouvelle adresse. Vous devez garder ce
bouton actif, quand vous voulez engendrer une copie complte du document.
Quand les images et les objets sont copis, Amaya met jour automatiquement tous les
attributs src et data pour pointer vers les nouvelles adresses. Les nouvelles adresses
sont des URIs relatifs.
Le choix Copier les ressources (styles et scripts) indique que les feuilles de style (y
compris les feuilles de style et les images importes) et les scripts inclus dans le
document doivent tre copis avec le document une nouvelle adresse. Vous devez
garder ce bouton actif, quand vous voulez engendrer une copie complte du document.
Quand ces ressources sont copies, Amaya met jour automatiquement tous les liens
et processing instructions pour pointer vers les nouvelles adresses. Les nouvelles
adresses sont des URIs relatifs.

68

Enregistrer et publier des documents


Le champ Charset permet de choisir l'encodage du document parmi la liste des encodages
disponibles. Notez que cette option n'est offerte que pour les documents supportant la notion
d'encodage, tels que les fichiers HTML ou XML. Cette option est valable pour la sauvegarde
locale et distante d'un document.
Trs souvent le charset des documents web est contrl par le serveur. Il dpend soit du suffixe
du document (html, xml, xhtml, svg, mml), soit des instructions donnes dans le fichier
.htaccess.
Le champ Mime Type permet de changer le type MIME d'un document lors d'une sauvegarde
sur un serveur web distant. En activant ce bouton, un menu apparat vous proposant un certain
nombre de types MIME. Vous pouvez galement saisir un type MIME diffrent de ceux qui
sont proposs.
L'onglet Images, style et scripts contient :
Le champ O enregistrer les images vous permet de donner le rpertoire o les images et les
objets doivent tre sauvs. Ce rpertoire peut tre sur un serveur web distant. Quand l'option
Copier les Images est slectionne, ce champ est initialis avec le nom du rpertoire du
document sauv.
Le champ O enregistrer les ressources vous permet de donner le rpertoire o les styles et
scripts doivent tre sauvs. Ce rpertoire peut tre sur un serveur web distant. Quand l'option
Copier les ressources (styles et scripts) est slectionne, ce champ est initialis avec le nom du
rpertoire du document sauv.
Cette bote de dialogue contient deux boutons :
Le fait de cliquer sur Enregistrer dbute le processus d'enregistrement du document. Si vous
avez choisi de suaver galement d'autres ressources, une liste de ces resources s'affiche et vous
pouvez en retirer certaines, qui ne seront pas enregistres.
Pour enregistrer distance, vrifiez que le proxy http n'est pas mis, ou que le serveur proxy et le
serveur cible sont configurs pour travailler avec la mthode PUT.
Le bouton Annuler arrte la commande.

Enregistrement et encodage de caractres (charset)


Trois encodages standard sont considrs :
us-ascii est un code 7-bit qui reprsente les 96 caractres imprimables (positions 32 127 en
dcimal).
iso-8859-1 est un code 8-bit qui reprsente les mmes caractres us-ascii, aux mmes
positions, plus 95 autres caractres imprimables.
utf-8 est un encodage de longueur variable pour un jeu de caractres universel (Universal
Character Set - UCS ou ISO10646). UCS reprsente des milliers de caractres. A noter que les
96 premiers caractres ont la mme position dans UCS que dans us-ascii (et aussi dans
iso-8859-1).
Si un document XML ou HTML contient un caractre non disponible dans le jeu de caractres (charset)
fourni avec l'encodage, une reprsentation est ncessaire. XML offre deux telles reprsentations des
caractres :
1. Une rfrence caractre reprsente la position (en dcimal ou hexadcimal) du caractre dans
UCS. Par exemple, la lettre grecque (alpha) est reprsente comme &#x3b1; (hexadcimal) ou
&#945; (dcimal)
69

Manuel d'utilisation d'Amaya


2. Une rfrence entit utilise un nom pour reprsenter un contenu (dans ce cas un caractre). Par
exemple la lettre grecque est reprsente comme &alpha;
Les rfrences caractre peuvent tre utilises dans n'importe quel document XML ou HTML, mais les
rfrences entit sont autorises seulement dans un document si lui-mme contient un moyen de rsoudre
ces rfrences.
La rsolution des rfrences entit est fournie par la dfinition du type qui se rfre une DTD o les
noms et les contenus associs sont dfinis. Pratiquement. cela signifie que vous pouvez utiliser des
rfrences entit seulement si le <!DOCTYPE ...> est prsent et rfrence une DTD qui dfinit les
noms utiliss.
Par dfaut, Amaya prserve l'encodage initial du document, c'est l'encodage associ au document au
chargement. Vous pouvez vrifier cet encodage avec la commande Affichage/Info document (champ
Codage). Les commandes Enregistrer et Enregistrer tout sauvent le document avec cet encodage,
tandis que la commande Enregistrer sous vous permet de choisir un autre encodage (champ Charset).
Quand un document est sauv (commandes Enregistrer, Enregistrer tout ou Enregistrer sous) tous les
caractres qui sont disponibles dans le jeu de caractres de l'encodage sont simplement crits en utilisant
cet encodage. Seules les autres caractres sont crits en utilisant les rfrences caractre ou entit. Le
choix entre ces deux options est fait en accord avec le doctype. S'il y a un doctype qui rfrence une
DTD qui dfinit un nom pour le caractre, une rfrence entit est utilise (c'est--dire un nom), sinon
Amaya engendre une rfrence caractre en hexadcimal.
Note : la commande Outils/Changer le doctype vous permet d'associer, de changer ou retirer le
doctype tout moment. Ceci vous permet de faire engendrer par Amaya soit des rfrences caractre
soit des rfrences entit.

Sauver le texte du document


La commande Enregistrer sous du menu Fichier visualise une bote de dialogue permettant de sauver le
document courant dans des formats diffrents. Le bouton Texte du menu Format de document sauve le
document sous forme de texte. Les balises HTML sont remplaces par des espaces, sauts de lignes, etc.
La liste de toutes les URIs utilises dans le document est ajoute la fin de ce fichier.

70

Cooprer

Cooprer
propos de WebDAV
WebDAV (WWW Distributed Authoring and Versioning) est un ensemble d'extensions du protocole
HTTP qui permettent d'diter et de grer de faon collaborative des ressources partages sur un serveur
web distant.
Le mcanisme de verrou dfini dans WebDAV a t conu pour viter qu'une ressource soit utilise en
criture par plusieurs utilisateurs simultanment et que les modifications des uns crasent celles des
autres. Un verrou contrle l'accs en criture une ressource en restreignant les oprations d'criture du
protocole HTTP telles que PUT, POST et DELETE. Seul un utilisateur qui connat le verrou associ
une ressource est habilit excuter ces oprations.
Le protocole WebDAV concerne aussi la port des verrous : il existe des verrous exclusifs et partags.
Un verrou exclusif garantit qu'une personne possde le verrou et que personne d'autre ne peut verrouiller
la ressource (ceci ne concerne pas l'accs en lecture cette ressource). Un verrou partag permet un
groupe d'utilisateurs de crer leurs verrous pour une ressource, mais ils doivent se faire confiance pour
prvenir les problmes d'accs.
Vous trouverez des informations dtailles propos de WebDAV dans la RFC 2518 et sur le site
WebDAV.org.

Support WebDAV dans Amaya


Amaya offre un support limit de WebDAV. Cela inclut le verrouillage et dverrouillage de ressources,
l'affichage des proprits WebDAV d'une ressource, et la possibilit de dcouvrir les verrous. Il y a aussi
des fonctions de notification qui informent automatiquement les utilisateurs sur les ressources
verrouilles.

Partager des documents


Le support de WebDAV prsent dans Amaya aide de petits groupes d'utilisateurs diter des pages web
de faon collaborative. Par exemple, supposons que vous ayez un serveur WebDAV dont l'adresse est
davserver.mycompany.com et que vous vouliez travailler avec quelques collgues sur des documents
qui sont dans le dossier WebDAV /shared/ (les dossiers WebDAV sont appels des collections). Dans
ce dossier, vous devez modifier le document http://davserver.mycompany.com/shared/
Doc1.html. Vous ouvrez ce document dans votre diteur Amaya. Vous pouvez alors le verrouiller avec
la commande Outils / Coopration / Verrouiller la ressource. Une fois le document verrouill, si l'un
de vos collgues essaie de sauver une version modifie du document, il sera inform de la prsence de
votre verrou et ses changements ne seront pas perdus. Ainsi, lorsque le document est verrouill, vous
pouvez le modifier en toute scurit. Lorsque vous avez termin et sauv le document, vous pouvez le
dverrouiller, permettant ainsi d'autres de le verrouiller leur tour et de faire des modifications.
Si vous voulez savoir savoir, avant de commencer travailler sur un document, si quelqu'un d'autre l'a
verrouill, utilisez la commande Outils / Coopration / Visualiser les proprits de la ressource pour
voir toutes les proprits du document. Vous pouvez aussi configurer Amaya pour tre inform
automatiquement si une page est verrouille. Pour cel, ouvrez la bote de dialogue Prfrences /
WebDAV, slectionnez l'option Notification gnral et mettez le nom de votre dossier partag dans la
Liste des ressources de l'utilisateur (http://davserver.mycompany.com/shared/ dans notre
exemple). Une fois cel fait, quand vous chargerez une page verrouille par un autre utilisateur dans ce
dossier, Amaya vous en informera.

71

Manuel d'utilisation d'Amaya

Options WebDAV
Les options suivantes peuvent tre choisies avec la bote de dialogue Prfrences / WebDAV. Elles sont
galement disponibles dans le registre d'Amaya :
Rfrences personnelles de l'utilisateur (URL)
Une URL qui vous identifie en tant qu'utilisateur, par exemple: mailto:myself@myhost.com ou
http://www.myhost.com/myhomepage.html
Registre: DAV_USER_URL= [ URL ]

Profondeur du verrou
Une profondeur infinie affecte tous les composants d'une collection (un dossier) verrouille. Sinon,
le verrou n'affecte que la collection elle-mme, empchant un utilisateur qui ne connat pas le
verrou de crer ou d'enlever des composants.
Registre: DAV_DEPTH= [ infinity | 0 ]
Type du verrou
Verrou exclusif ou partag..
Registre: DAV_LOCK_SCOPE= [ exclusive | shared ]
Expiration du verrou
Dure souhaite pour le verrou. Infini signifie qu'il n'y a pas de dlai d'expiration du verrou : il doit
tre retir explicitement. Autre (secondes) permet de choisir une dure d'expiration du verrou, qui
doit tre spcifie en secondes dans le champ suivant de la bote de dialogue.
Registre: DAV_TIMEOUT= [ Infinite | Second-XXXX ]
Notification gnral
Indique si vous souhaitez une notification propos des ressources verrouilles
Registre: DAV_AWARENESS= [ yes | no ]
Notification la sortie
Indique si vous voulez tre inform sur l'tat de vos verrous quand vous quittez une ressources
Registre: DAV_AWARENESS_ONEXIT=[ yes | no ]
Liste des ressources de l'utilisateur (URL URL)
Une liste des URL des ressources que vous utilisez comme des ressources WebDAV.
Registre: DAV_URLS= [ URL URL URL ... ]

Compiler Amaya avec WebDAV


Le support WebDAV est optionnel dans Amaya. Pour compiler Amaya avec WebDAV, vous devez
avoir :
Libwww avec support WebDAV
L'option --with-dav dans le configure d'Amaya
Un serveur WebDAV. Jigsaw et Apache, par exemple, sont des serveurs qui supportent
WebDAV.
Lorsque vous avez fait le check-out de Libwww avec support WebDAV et obtenu les sources d'Amaya,
suivez les instructions suivantes (pour les environnements Linux/Unix - pour Windows, rferez-vous aux
pages Amaya et Libwww) :

Dans le rpertoire libwww :


libtoolize -c -f
72

Cooprer
perl config/winConfigure.pl
aclocal; autoheader; automake; autoconf

Dans le rpertoire Amaya :


autoconf
mkdir LINUX-ELF (ou GTK, ou obj)
cd LINUX-ELF
../configure --with-dav ... (et toutes les autres options que vous souhaitez)
make

73

Manuel d'utilisation d'Amaya

74

Imprimer des documents

Imprimer des documents


Amaya est capable d'imprimer des document avec ou sans feuilles de style CSS pour les plates-formes
Linux et Windows.
Important : Pour Linux, il est uniquement possible de gnrer une description PostScript, donc vous
avez besoin d'une imprimante PostScript ou d'utiliser une application capable de traduire le PostScript
dans le langage de votre imprimante.
Il y a trois manires d'imprimer un document avec Amaya :
la commande Paramtrer et imprimer (Fichier/Paramtrer et imprimer), qui vous permet
de fixer certains paramtres et options avant d'imprimer.
la commande Imprimer (Fichier/Imprimer), qui imprime un document en utilisant la
configuration de la commande prcdente.
le bouton
, dans la barre des boutons, qui est un raccourci de la commande Imprimer sur
les plates-formes Linux. Sous Windows, ce bouton est le raccourci de la commande
Paramtrer et imprimer.

La commande Paramtrer et imprimer


Cette commande vous permet d'tablir diffrents paramtres et options. Notez que certains paramtres et
certaines options reprennent leur valeur par dfaut quand vous ouvrez un autre document. Cette proprit
dpend de la plate-forme.

Plates-formes Linux
Sous Linux, avec la commande Fichier/Paramtrer et imprimer vous pouvez fixer les paramtres
suivant :
le format du papier : A4, US
l'orientation : Portrait, Paysage
la disposition (le nombre de pages imprimes sur la mme feuille de papier) : 1, 2, 4 pages par
feuille
la destination : fichier PostScript ou imprimante
En plus, vous pouvez slectionner les options suivantes :
Alimentation manuelle
Gnrer la table des matires
Gnrer la table des liens : un numro est gnr aprs chaque lien dans le document qui rfre
un entre de la table de liens; chaque entre de la table liste l'URI correspondant
Imprimer l'URI du document sur chaque page
Imprimer sans feuille de style

Plates-formes Windows
Sur les stations Windows, une bote de dialogue vous proposera en premier lieu les options suivantes :
Gnrer la table des matires
Gnrer la table des liens
75

Manuel d'utilisation d'Amaya


Imprimer l'URI du document en haut de chaque page
Imprimer sans feuille de style
Puis le dialogue standard de Windows vous laissera choisir les autres paramtres d'impression.

La commande imprimer
Cette commande imprime le document courant avec le paramtre d'impression par dfaut ou avec les
valeurs prcdemment fixes grce la commande Paramtrer et imprimer.
Sur les stations Windows, la premire fois que vous lancez la commande Imprimer, le dialogue standard
de Windows est affich et vous laisse vrifier que l'imprimante par dfaut est correcte. Les commandes
Imprimer suivantes sont lances sans aucun dialogue.

Contrler l'impression avec les CSS


Les liens ne sont pas souligns l'impression sous Amaya. Pour ce faire, votre feuille de style utilisateur
(fichier amaya.css dans votre rpertoire AmayaHome) doit contenir :
@media print {a:link {text-decoration: underline} ... }

Amaya supporte les proprits de saut de page CSS : "page-break-before: always". Quand cette
proprit est attache un lment spcifique par un attribut style, elle gnre un saut de page avant
l'lment. Quand cette proprit est attache un type d'lment dans l'lment style du document ou
dans la feuille de style CSS externe, elle gnre un saut de page avant chaque occurence de cet lment.
Note : Quelques proprits CSS ne sont pas bien supportes par le processus d'impression.

76

Numroter les sections

Numroter les sections


Les en-ttes de section (lments h2 h6) peuvent tre automatiquement numrotes pour reflter la
structure du document.
L'lment h1 est suppos tre le titre du document et il n'est pas numrot. Toutes les autres en-ttes ( h2
h6) reoivent un numro calcul en fonction de leur type et de leur position dans la structure du
document. Ces numros sont introduits dans le document et les numros produits prcdemment sont
retirs chaque fois que la commande Outils/Numroter les sections est appele.

Engendrer la table des matires


La commande Outils/Ajouter-Actualiser la table des matires collecte tous les lment h2 h6 qui
suivent la slection courante pour engendrer une table des matires la position courante. Cette table
remplace la version courante quand la slection est dj dans une table des matires.
Cette commande ajoute :
Un attribut id chaque lment h2 h6 qui n'a pas cet attribut.
Une division (avec une valeur d'attribut class="toc") qui contient un embotement de listes
non numrotes (ul) la position courante. Vous pouvez utiliser l'attribut class pour associer
un style vos tables des matires.
Un item de liste (li) pour chaque lment h2 h6 avec un lien vers l'lment correspondant
dans le document.
Le contenu du lien est la copie du contenu de l'lment hn. Si l'lment hn est numrot, ce
numro est galement copi.

77

Manuel d'utilisation d'Amaya

78

Assembler des collections de documents

Assembler des collections de documents


Pour activer cette fonctionnalit, choisissez l'entre Construire un livre du menu Outils.
Amaya vous permet de manipuler des collections de documents. Une telle collection peut, par exemple,
reprsenter une documentation technique constitue de plusieurs pages web. Ce manuel est une
collection de documents.
Une des pages de la collection contient le titre de toute la documentation (un lment h1), une
introduction (d'autres lments), et une liste (ol ou ul) dont les items (li) contiennent les liens vers
chaque chapitre. Les chapitres sont des documents spars qui peuvent aussi avoir le mme type de
structure.
Une telle organisation est utile pour naviguer, mais elle a un certain nombre d'inconvnients lorsque la
totalit de la documentation doit tre imprime.
Amaya rgle ce problme l'aide de la commande Outils/Construire un livre. Il vous suffit d'utiliser les
liens typs pour lier les chapitres : associez un attribut rel="chapter" ou rel="subdocument" l'ancre
lien (crez un lien et utilisez l'outil Attributs pour l'attribut rel).
Chaque chapitre ou sous-document peut tre :
soit un document entier externe,
soit une partie d'un document externe.
Pour rfrencer une partie d'un document, la mthode habituelle est de dfinir un lment div qui
dlimite la partie du document que vous voulez inclure vous crez un lien vers cet lment div.
Ensuite, lorsque vous activez la commande Outils/Construire un livre, tous les blocs (lments li dans
l'exemple ci-dessus) contenant un lien vers un chapitre seront remplacs par les pages Web
correspondantes (ou les parties de pages Web). Vous obtiendrez ainsi un unique document contenant la
totalit de la collection :
Si le lien rfrence une page Web entire, tout le contenu de l'lment body du document cible
est inclus.
Si le lien rfrence un lment dans une page, cet lment et son contenu sont inclus.
Si le lien rfrence une ancre cible (lment a), le contenu de l'ancre cible est inclus, mais
l'ancre elle-mme ne l'est pas.
Avant chaque remplacement, la commande Construire un livre engendre un nouvel lment div avec
un attribut id. Ainsi, toutes les parties incluses sont clairement spares.
Les parties du nouveau document engendr peuvent contenir des liens, des ancres cibles et des lments
cibles. Pendant cette opration, Amaya vrifie que chaque valeur des attributs name et id reste unique
dans le nouveau document. Si besoin est, Amaya change ces valeurs et met jour les liens relatifs.
Les liens externes sont automatiquement mis jour quand ils se rfrent un document externe ou un e
partie de document nouvellement inclus. Par exemple, si un lien pointe vers un document entier externe,
ce lien rfrencera l'lment div engendr par la commande Construire un livre. Ainsi, le nouveau
document unique contient la totalit de la collection avec l'ensemble de ses liens.
Ce document assembl peut tre numrot et imprim avec une table des matires complte et une liste
de tous les liens.

79

Manuel d'utilisation d'Amaya

80

Annoter des documents

Annoter des documents


Qu'est-ce qu'une annotation ?
Une annotation est un commentaire, une note, une explication ou tout autre remarque externe qui peut
tre attache un document web ou une partie d'un document. Comme les annotations dans Amaya
sont externes au document, il est possible d'annoter n'importe quel document du web, mme sans avoir le
droit de le modifier. D'un point de vue technique, une annotation peut tre vue comme une mta-donne
puisqu'elle fournit une information supplmentaire sur une donne existante. Amaya utilise un schma
RDF pour dcrire les annotations.
Les annotations peuvent tre enregistres localement ou sur un ou plusieurs serveur(s) d'annotations.
Lorsqu'un document est charg, Amaya interroge chacun de ces serveurs et recherche les annotations
relatives ce document. Chaque annotation est ensuite reprsente par l'icne suivante
qui est ajoute
au document. Lorsque vous cliquez sur l'icne, le passage annot est mis en vidence. Si vous doublecliquez sur l'icne alors le contenu de l'annotation ainsi que les autres mta-donnes sont prsentes dans
une fentre spare.
Une annotation possde plusieurs proprits :
Point de stockage: dans le systme de fichiers de l'utilisateur ou sur un serveur d'annotations.
Etendue : l'annotation est associe un document entier ou une fragment de celui-ci.
Type de l'annotation: remarque, commentaire, question, ...

Annotations locales et distantes


Amaya peut enregistrer les annotations dans un fichier local (annotations locales) ou sur le Web
(annotations distantes).
Les annotations locales ne ncessitent pas l'utilisation de serveur. Elles sont enregistres sous le
rpertoire AmayaHome, dans un rpertoire spcifique appel annotations et peuvent tre visualises
uniquement par leur auteur (selon les droits d'accs en fonction).
Ce rpertoire comporte trois sortes de fichiers :
annot.index : les URL associes aux fichiers dans lesquels les mta-donnes des annotations
sont sauvegardes.
index + random suffix : un fichier contenant les mta-donnes d'une annotation relative
une URL. Les mta-donnes sont spcifies en RDF.
annot + random suffix.html : contient le corps de l'annotation enregistre en XHTML.
Vous pouvez tout moment transformer une annotation locale en une annotation partage en utilisant
l'entre Enregistrer sur le serveur du sous-menu Outils/Annotations. L'annotation est supprime
localement et transfre sur un serveur d'annotations.

Annotations distantes
Les annotations distantes sont enregistres sur des serveurs d'annotations et peuvent tre charges ou
enregistres par quiconque ayant les droits d'accs correspondants, comme pour les autres documents
HTML.
Les annotations distantes sont dites partages ou publiques parce qu'elles peuvent tre vues par plusieurs
personnes. Si vous dsirez installer votre propre serveur d'annotations, veuillez vous rfrer au document
"Annotation-Server HOWTO".

81

Manuel d'utilisation d'Amaya

Crer une annotation


Avant de crer une annotation il est recommand de fixer certains paramtres dans les Prfrences (voir
la section Configuration des annotations)
Amaya supporte deux sortes d'annotations : celles qui s'appliquent au document entier et celles qui
s'appliquent une position ou une slection du document.
Pour annoter un document entier, slectionnez l'entre Annoter le document du sous-menu
Outils/Annotations.
Pour annoter une position, placez le point d'insertion cette position et slectionnez l'entre
Annoter la slection.
Pour annoter une partie, faire la slection dsire et slectionnez l'entre Annoter la slection.
Dans tous les cas, un document d'annotation s'affiche, initialis avec les mta-donnes de l'annotation et
un corps d'annotation vide.
Les mta-donnes indiquent le titre de l'annotation, le nom de son auteur, le titre du document annot
(galement appel document source), le type de l'annotation, sa date de cration et la date de sa
dernire modification.
Certaines de ces mta-donnes ont des proprits spcifiques.
Le champ Document source est un lien qui pointe sur le texte annot. Si vous double-cliquez
dessus (comme pour tout lien dans Amaya), le document annot est affich en premier plan et le
texte annot est mis en vidence.
La mta-donne Type de l'annotation vous permet de classer les annotations et de changer leur
type. Un double-clic sur ce champ montre la liste des types disponibles. Voir plus loin comment
dfinir son propre type d'annotation.
Enfin, la mta-donne Date de dernire modification est automatiquement mise jour lorsque
l'annotation est sauvegarde.
Sous l'entte de l'annotation se trouve le corps de celle-ci. Il montre son contenu courant et peut tre
dit comme n'importe quel document HTML.
Certaines commandes accessibles dans la vue principale d'Amaya sont galement disponibles pour les
annotations comme par exemple le commande Imprimer qui imprime le corps de l'annotation ou la
commande Recharger.

Enregister une annotation


L'enregistrement d'une annotation se fait comme l'enregistrement de n'importe quel autre document.
Slectionnez l'entre Enregistrer du menu Fichier ou cliquez sur le bouton quivalent ou bien activer le
raccourci-clavier correspondant.
Les annotations locales sont sauves sous le rpertoire des annotations et les annotations distantes sont
sauves sur le serveur d'annotation, si l'utilisateur possde un droit d'criture.
Pour transformer une annotation locale en une annotation publique (distante), l'utilisateur doit utiliser
l'entre Enregistrer sur le serveur. Elle sera alors enregistre sous le serveur dfini dans le menu de
Prfrences puis, en cas de succs, supprimes du rpertoire local.
La sauvegarde des annotations se fera alors directement sur le serveur d'annotations.

82

Annoter des documents

Dtruire une annotation


Pour supprimer une annotation vous pouvez utiliser la commande Annotations/Supprimer du menu
Outils de la fentre de l'annotation supprimer.
Vous pouvez galement supprimer une annotation partir du document annot, en slectionnant l'icne
de celle-ci puis en appelant la mme commande dans le menu du document annot.

Charger et prsenter les annotations


La commande Outils/Annotations/Charger annotations indique Amaya de rechercher les annotations
associes l'URL du document charg dans la vue principale. Amaya va alors rechercher les annotations
correspondantes dans les serveurs d'annotations dfinis dans les Prfrences/Annotations.
Les annotations peuvent galement tre charges automatiquement en choisissant l'option Charger
automatiquement les annotations dans les Prfrences/Annotations. La recherche sur un serveur
d'annotations retourne toutes les annotations associes un document.

Les annotations dans la vue Liens


Les annotations apparaissent dans la vue Liens du document annot (avec les autres liens dfinis dans ce
document) et sont symbolises par la mme icne que dans la vue principale. Comme dans la vue
principale, un simple-clic sur l'icne met en vidence la partie annote du document et un double-clic
ouvre l'annotation.

Rpondre aux annotations / fils de discussion


Les annotations peuvent tre considres comme des commentaires sur des documents. La commande
Outils/Annotations/Rpondre l'annotation largit l'espace de travail collaboratif en permettant aux
utilisateurs de rpondre aux annotations des autres utilisateurs ainsi qu'aux autres rponses
Vous pouvez appeler cette commande depuis la fentre d'une annotation ou depuis la fentre d'une
rponse. Une nouvelle fentre de rponse est alors ouverte. Les champs de cette fentre peuvent tre
dits de le mme manire que ceux d'une fentre d'annotation (voir Crer une annotation).
Quand la rponse est termine, vous pouvez la poster sur un serveur par la commande Outils/
Annotations/Enregistrer sur le serveur ou l'enregistrer localement par la commande Fichier/
Enregistrer. La commande Outils/Annotations/Supprimer supprime la rponse.
Les rponses peuvent galement tre annotes comme n'importe quel document, comme expliqu dans la
section Crer une annotation.
Toutes les rponses relatives une mme annotation sont affiches en dessous de celle-ci, dans une
section "fil". Chaque lment du fil donne la date de la rponse, son auteur et son titre. Le contenu de
chacune des rponses est accessible en double-cliquant sur la rponse dans le fil. La rponse slectionne
est mise en sur-brillance et prsente dans une nouvelle fentre de rponse. Lorsqu'une autre rponse est
slectionne, la mme fentre de rponse est utilise.

Problmes connus: fils incomplets


Il n'y a pas de contrle pour dterminer quelle rponse devrait tre poste. Dans l'absolu, il ne devrait pas
tre possible de poster une rponse une rponse sur un autre serveur que la rponse elle-mme. De
mme, si vous supprimez une rponse vous devriez supprimer toutes les rponses se rapportant
l'annotation. Sans cela, vous pouvez avoir des fragments du fil qui ne peuvent tre correctement rattachs
celui-ci. Par exemple, soit R1 une rponse l'annotation A1 et R2 une rponse R1. Si vous postez R1
et sauvez localement R2 et si vous visualisez A1 en chargeant uniquement les annotations locales, alors
seule R2 sera visible. A ce niveau, Amaya ne sait pas que R1 existe et suppose que R2 a perdu sa rponse
83

Manuel d'utilisation d'Amaya


"mre". On identifie ces fils "orphelins" en plaant devant un point d'interrogation. Si par la suite Amaya
trouve de nouveaux lments du fil, par exemple en chargeant R1, il les triera correctement. Dans notre
exemple, la rponse R2 deviendra fille de R1, comme attendu.

Problmes relatifs aux annotations et aux documents modifis


Si vous utilisez les annotations sur des documents dont le contenu peut tre modifi, deux catgories de
problmes peuvent survenir: les annotations orphelines et les annotations trompeuses. Avant d'aller
plus loin sur ces problmes, nous allons d'abord dcrire comment Amaya relie les annotations aux
documents annots.
Pour cela, Amaya utilise le mcanisme XPointer. Les XPointers reposent sur la structure du document.
Pour construire un XPointer, par exemple pour une slection, on part du premier point de la slection et
on remonte travers la structure du document jusqu' trouver la racine de celui-ci. Si un lment possde
un attribut ID, on arrte la recherche et on considre que le dbut du XPointer est cet lment. Par
exemple, en regardant le source HTML de cette documentation, on s'aperoit que la section courante est
l'intrieur d'un lment DIV, lequel possde un attribut ID avec la valeur "Issues". Voici un extrait du
code source:
<div id="Issues">
<h3>Problmes sur ....</h3>
<p>Si vous utilisez ...</p>
<p>Pour cela, Amaya utilise le mcanisme <strong>XPointer</strong>...</p>
...
</div>

Et voici le XPointer qui pointe sur le second paragraphe:


xpointer(id("Issues")/p[2])

Le XPointer ci-dessus pointe sur le second lment p partir de l'lment parent qui possde l'attribut ID
avec la valeur "Issues". L'utilisation de l'attribut ID permet l'auteur du document de dplacer la totalit
de cette section n'importe o dans le document sans avoir besoin de remettre jour le XPointer
correspondant. Ce dernier de dpend pas des lments qui prcdent cette section.
Une annotation est dite orpheline lorsqu'elle ne peut plus tre rattache au document, c'est dire quand
le XPointer ne trouve plus l'lment correspondant dans la structure du document. Cela arrive notamment
quand la structure est modifie. Par exemple, le XPointer prcdent ne pourrait plus retrouver l'lment
correspondant si l'on supprimait l'attribut ID de celui-ci. Amaya avertit l'utilisateur s'il dtecte une
annotation orpheline au chargement. Les annotations orphelines sont visibles dans la vue Liens du
document et sont symbolises par l'icne des annotations sur laquelle est superpos un point
d'interrogation

Une annotation est dite trompeuse lorsqu'elle ne pointe pas sur la bonne partie du document. En
reprenant notre exemple, nous pouvons crer une annotation trompeuse en intervertissant le premier et le
second paragraphe. Le XPointer continuera de pointer vers le second paragraphe bien qu'il devrait
pointer dsormais sur le premier. Ce problme est encore plus frquent lorsque vous annotez un texte qui
peut changer. Dans sa version actuelle, Amaya n'avertit pas l'utilisateur des annotations trompeuses. Une
prochaine version l'avertira de la possibilit d'une annotation d'tre trompeuse.
Comment viter ces problmes ?
Si vous tes l'auteur du document, utilisez les attributs ID aux endroits stratgiques, par exemple pour les
lments DIV. Amaya vous permet d'associer ou de retirer automatiquement un attribut ID en
slectionnant l'entre Ajouter/Retirer des attributs ID du menu Liens. Dans notre exemple, on peut
viter le problme des annotations trompeuses en ajoutant un attribut ID au second paragraphe:
<p id="Amaya">Pour cela, Amaya utilise...</p>

84

Annoter des documents


Un XPointer qui pointe sur ce paragraphe est alors
xpointer(id("Amaya"))

Ainsi, ce XPointer pointera toujours sur le mme paragraphe, sans se soucier de la position de celui-ci
dans la structure du document.

85

Manuel d'utilisation d'Amaya

86

Configurer Amaya

Configurer Amaya
Amaya utilise diffrents fichiers de configuration pour initialiser les paramtres globaux, les dialogues,
les raccourcis, la taille et la position de la fentre, la feuille de style de l'utilisateur, etc. Vous pouvez
changer la plupart de ces paramtres de configuration par le biais de dialogues de prfrences.

> Une ou plusieurs instances d'Amaya


Par dfaut une seule instance de l'application est lance. Toute nouvelle invocation est redirige vers
l'instance active. Ce comportement peut tre modifi en forant la variable d'environnement
AMAYA_MULTIPLE_INSTANCES=yes.

> Rpertoires de configuration


Amaya utilise un certain nombre de rpertoires par dfaut pour conserver les informations de
configuration.

Le rpertoire config
Amaya enregistre la plupart des valeurs par dfaut et tous les messages de dialogue dans le rpertoire
config. Le rpertoire parent est celui o Amaya a t install (par dfaut Amaya/config sur Unix, voir le
tableau ci-dessous pour Windows et Mac OS X).
Amaya-x.x/config where Amaya-x.x=binary_path/../..

Unix

(e.g. /usr/lib/Amaya.x.x/config)
$HOMEDRIVE:\$HOMEPATH\amaya

Windows

by default
C:\Documents and Settings\$user_name\Amaya-x.x\config

Mac OS X /Applications/Amaya.app/Contents/MacOS/Amaya-x.x/config

Le rpertoire AmayaHome
Amaya stocke les prfrences de l'utilisateur ainsi que les autres fichiers de configuration de l'utilisateur
dans un rpertoire que nous appellerons le rpertoire AmayaHome. Un rpertoire existant peut tre
slectionn par l'utilisateur en utilisant la variable d'environnement AMAYA_USER_HOME. Sinon Amaya
slectionne un rpertoire par dfaut.
La table suivante montre la position par dfaut de ce rpertoire dans les diffrentes architectures :
Unix

$HOME/.amaya
$HOMEDRIVE:\$HOMEPATH\amaya

Windows

par dfaut
c:\Documents and Settings\$user_name\amaya

Mac OS X

~/Library/Application Support/amaya

Le rpertoire AmayaHome est conserv mme si on installe de nouvelles versions d'Amaya. Il peut
contenir les fichiers suivants :
thot.rc : les prfrences de l'utilisateur, changes grce au menu des prfrences.

87

Manuel d'utilisation d'Amaya


amaya.keyboard (Unix), amaya.kb (Windows) ou amaya.kb-mac : ce fichier dfinit les
raccourcis clavier d'Amaya pour la plate-forme correspondante.
amaya.css : contient la feuille de style de l'utilisateur.
dictionary.DCT : Amaya fournit un vrificateur d'orthographe multi-langues. Par dfaut le
vrificateur d'orthographe travaille avec deux dictionnaires : Le dictionnaire Anglais et le
dictionnaire Franais (d'autres dictionnaires peuvent tre tlchargs depuis les serveurs W3C).
Quand l'utilisateur veut enregistrer un nouveau mot, le vrificateur d'orthographe cre ou met
jour ce "dictionnaire personnel de l'utilisateur".
Note : les fichiers amaya.keyboard, amaya.kb, amaya.kb-mac, et amaya.css sont chargs au moment
du dmarrage. Si vous les changer, vous devrez quitter et redmarrer Amaya pour les prendre en compte.

Le rpertoire AmayaTemp
Amaya stocke tous les fichiers temporaires qu'il cre durant l'excution dans un rpertoire que nous
appelons le rpertoire AmayaTemp. La table suivante montre o ce rpertoire est stock dans les
diffrents architectures :
Unix

$HOME/.amaya

Windows

$HOMEDRIVE:\$HOMEPATH\Local Documents and Settings\Temp\amaya


par dfaut
c:\Documents and Settings\$user_name\Local Settings\Temp\amaya

Mac OS X

~/.amaya

Amaya cre des fichiers dans ce rpertoire pendant que vous naviguez ou que vous imprimez un
document. Le cache est stock dans ce rpertoire. L'utilisateur peut changer le rpertoire cache par le
biais du menu Prfrences Cache.
Amaya essaye toujours d'effacer tous les fichiers temporaires qu'il cre. Cependant, si Amaya termine
anormalement,, les fichiers temporaires ne seront pas effacs. Ceci n'aura pas d'impact sur les excutions
d'Amaya ultrieures.

Prfrences
Ce dialogue se trouve dans diter/Prfrences (Amaya/Prfrences sous Mac OSX). Il y a douze
onglets diffrents disponibles : Gnrales, Navigation, Publication, Cache, Proxy, Couleurs,
Gomtrie, Annotations, WebDAV, Modles, Courriel. Ce prsente trois boutons d'action :
Appliquer : ce bouton valide et stocke les options affiches.
Dfauts : ce bouton rtablit, mais ne sauve pas, les valeurs par dfaut. Utilisez le bouton
Appliquer pour valider les options.
Annuler : ce bouton ferme le dialogue sans appliquer.

Les prfrences gnrales

> Profil
Amaya peut tre configur pour prsenter un ensemble de fonctionnalits plus ou moins tendu et
l'interface utilisateur correspondante. L'ensemble des fonctionnalits disponibles un instant donn est
appel un profil.
Dans les prfrences Gnrales un menu droulant permet de choisir un profil (Lite, Lite+Math, etc.). Le
profil choisi ne s'applique pas immdiatement, mais seulement au prochain dmarrage d'Amaya.

88

Configurer Amaya

> Position des panneaux d'outils


Les panneaux d'outils peuvent tre affichs, sur le cot gauche de la fentre, ou sur le ct droit de la
fentre, ou paramtrables.
Si vous choisissez l'option Paramtrable, vous pouvez :
Rordonner la liste des panneaux : Vous cliquez sur le titre du panneau et le dplacez vers la
bonne position dans la liste.
Afficher des panneaux des deux cts pour avoir accs tous les outils en mme temps : Vous
pouvez dplacer un panneau d'outils en cliquant sur son titre et le dplacer vers l'autre ct de la
fentre. La position finale du curseur (non du panneau) doit tre exactement sur le bord de la
fentre.
Dtacher un panneau : Si vous dplacer un panneau vers une position autre qu'un bord de
fentre, le panneau reste dans l'tat flottant.
Supprimer/Ajouter un panneau : Quand vous cliquez sur la croix dans le titre du panneau, le
panneau est supprim. Vous pouvez aussi fermer et ouvrir un panneau avec le sous-menu
Barres d'outils du menu Affichage.

> Polices de caractres et langue


Zoom caractres. Il est possible d'augmenter et de diminuer l'effet de zoom, fentre de document par
fentre de document. Chaque document (texte et images) visualis l'intrieur d'une fentre zoome sera
visualise plus gros ou plus petit que sa taille relle selon le zoom courant. Cette option vous permet de
changer le zoom des caractres pour toutes les fentres. Ce changement affecte uniquement les tailles de
caractres mais pas les images. Cette option est reflte immdiatement sur tous les documents ouverts.
Langue du dialogue. Spcifie la langue utilise dans les menus et les messages. La langue par dfaut est
l'anglais amricain (en). D'autres langues sont possibles comme le franais (fr), l'italien (it), l'espagnol
(es), l'allemand (de), le portugais (pt), le finlandais (fi), le russe (ru) et le turc (tr), etc.. Au dmarrage,
Amaya charge les fichiers de dialogue selon la langue de dialogue courante : les fichiers en-, fr-, ou de-,
etc. Ces fichiers de dialogue se trouvent dans le rpertoire Amaya/config. Il est possible d'adapter
Amaya aux nouvelles langues ISO-Latin-1 en crivant les fichiers de dialogue correspondants. Ces
fichiers de dialogue doivent se trouver dans le mme rpertoire (c'est dire Amaya/config).

> Page de dmarrage


Ce champ spcifie l'URI qu'Amaya chargera au dmarrage ou quand l'utilisateur pressera le bouton
Home. Un exemple est http://www.w3.org.
Note : Un URI complet doit tre utilis.

> Options
Les options suivantes peuvent tre coches ou non en cliquant sur la case de gauche aligne avec
l'intitul de l'option.
Mode d'dition XML. L'utilisateur peut fixer son mode d'dition (Texte ou XML) par dfaut.
Prserver les lignes dans le coller. Cette option concerne le coller depuis une autre application. Quand
cette option est active, les lignes de l'application source sont conserves. Sinon les caractres fin de
ligne sont remplacs par des espaces.
Garder les espaces multiples. Quand cette option est active, Amaya engendre des espaces non
squables pour prserver les espaces multiples insrs.
Produire des fichiers de sauvegarde. Si cette option est active Amaya va produire priodiquement un
fichier de sauvegarde pour chaque document dit.
89

Manuel d'utilisation d'Amaya


Anti-aliasing. Contrle si l'usage de polices de caractres anti-aliased (meilleure qualit d'affichage
quand l'option est utilise).
ISO format for date. Contrle le format des date engendres par Amaya : soit au format ISO (DD-MMYYYY) soit au format amricain (YYYY/MM/DD).
Montrer les cibles. Contrle si les cibles de liens sont visualises ou non. Montrer les cibles peut aider
quand on veut crer de nouveaux liens.
Montrer tous les raccourcis. Contrle si les squences de touches sont visualises ou non dans les
menus.
Avertir avant de fermer plusieurs onglets. Demande Amaya d'afficher un dialogue quand plusieurs
onglets sont ferms en mme temps.
Afficher le "Conseil du jour" au dmarrage. Contrle si le "Conseil du jour" visualis au dmarrage.

> Accs rapides


Cette option spcifie la touche Alt ou Ctrl utilise pour mettre en oeuvre les accs rapides des
documents, ou indique que les accs rapides sont ignors.
Note : La touche Alt peut ne pas fonctionner parce qu'elle est utilise par les widgets d'interface.

Prfrences de navigation
les Prfrences de navigation contrle le chargement des pages.

> Options
Les options suivantes peuvent tre coches ou non en cliquant sur la case de gauche aligne avec
l'intitul de l'option.
Vrifier les IDs dupliqus. Demande la vrification des IDs dupliqus lors du chargement d'un
document. Cette option augmente le temps de lecture des documents.
Charger les images. Contrle si les images doivent tre charges et affiches. Sinon, l'attribut ALT est
visualis la place de l'image. Cette option prend effet ds que le formulaire est valid.
Charger les objets. Contrle si les objets doivent tre chargs et affichs. Sinon, le contenu de l'objet est
visualis la place de l'objet. Cette option prend effet ds que le formulaire est valid.
Montrer les images de fond. Contrle si les images en arrire plan doivent tre montres ou non. Cette
option prend effet ds que le formulaire est valid. document.
Appliquer CSS. Contrle si les feuilles de style CSS doivent tre charges et appliques ou non. Cette
option prend effet ds que le formulaire est valid.
Cliquer deux fois pour suivre un lien. Depuis la premire version d'Amaya, les utilisateurs ont besoin
de double cliquer sur un lien pour l'activer. Cela permet de diffrencier l'dition d'un lien de son
activation. Vous pouvez changer ce comportement en dsactivant cette option.

> Endroit d'ouverture


Cette option indique le comportement standard voulu par l'utilisateur quand :
Un document rcent est ouvert depuis le sous-menu Fichier/Ouvrir.
Une autre URI est choisie dans la liste droulante de la barre de navigation.

> Type d'cran courant


L'application des feuilles de style (CSS) dpendent du type d'cran choisi dans ce formulaire.

90

Configurer Amaya

> Ngociation de langues


Si un document existe en diffrentes langues et que votre serveur est configur pour faire une ngociation
de langue, vous pouvez utiliser ce menu pour entrer vos prfrences de langue (La premire a la plus
grande priorit). Essayez de naviguer ce communiqu, qui existe en versions Franaise, Anglaise et
Japonaise. En changeant la ngociation de la langue en code ISO pour les langues ci dessus (fr, en, ou
ja) vous pouvez demander de faon transparente n'importe laquelle de ces versions.

Prfrences de publication
Ces Prfrences vous permettent d'enregistrer vos prfrences pour les ETAGS et pr-conditions, pour
vrifier ou non chaque commande PUT avec une commande GET, pour dfinir un nom par dfaut pour
les URLs finissant par un '/' et pour autoriser la redirection automatique de la commande PUT dans des
domaines spcifiques.

> Charset pour les nouveaux documents


Dfinit le charset (groupe de caractres) utilis pour les nouveaux documents.

> Options
Les options suivantes peuvent tre coches ou non en cliquant sur la case de gauche aligne avec
l'intitul de l'option.
Ajouter la feuille xsl pour les lments MathML. Engendre un appel une feuille de style xsl capable
de transformer les lments MathML inclus en objets externes. Cette feuille de style xsl a t dveloppe
par le groupe de travail MathML pour permettre Internet Explorer de visualiser les types de documents
composs.
Utiliser le type MIME application/xhtml+xml pour les documents XHTML. Lorsqu'elle est active,
cette option associe le nouveau (et officiel) type MIME XHTML tout nouveau document XHTML
publi sur le Web. Elle est dsactiv par dfaut pour cette version d'Amaya car l'heure actuelle, tous les
serveurs ne grent pas ce type MIME. Cette option ne modifie pas le type MIME des anciens documents:
le type MIME qui est reu est celui qui sera utilis pour publier le document, sauf si vous utilisez la
commande Enregistrer sous. Il est noter que cette option ncessite aussi de modifier la configuration
de votre serveur si celui-ci n'enregistre pas les mta-donnes associes chaque document.
Utiliser les ETAGS et les conditions requises. HTTP/1.1 introduit des nouvelles enttes qui permettent
d'viter le problme de la perte des mises jour en publiant. Avec ce mcanisme, vous pouvez dtecter
les conflits quand deux utilisateurs publient le mme document.
Vrifie chaque PUT avec un GET. Si vous n'avez pas confiance en votre serveur, cette option dit
Amaya de rtablir chaque document ds qu'il a t publi et le compare la copie stocke dans votre
station de travail. Si les documents diffrent, Amaya vous alertera.
Exporter CR/LF. Indique si les fins de lignes des fichiers produits par Amaya se terminent par CR/LF
(format DOS) ou par un simple LF (format standard).

> Longueur de ligne fixe


Cette option fixe le nombre maximum de caractres attendus par lignes que doit engendr Amaya quand
il produit le fichier HTML ou XML. Quand la valeur est 0, Amaya utilise sa propre valeur par dfaut
(actuellement 78).

> Nom par dfaut pour les URLs finissant par '/'
Un serveur HTTP associe habituellement les URLs qui finissent par '/' un nom par dfaut, par exemple,
Overview.html. Cette option permet la spcification du nom par dfaut qu'Amaya devrait utiliser quand
on publiera un tel URL. S'il vous plat, consultez votre Webmaster pour dcouvrir quel est le nom par
dfaut de votre serveur.
91

Manuel d'utilisation d'Amaya

> Permettre des redirections PUT automatiques sur ces domaines


Selon la spcification HTTP/1.1, les oprations PUT ne devraient pas tre rediriges automatiquement
sans confirmation de l'utilisateur, puisque a peut changer les conditions sous lesquelles la requte est
d'origine. Vous pouvez viter d'avoir un avertissement d'Amaya avec une alerte de redirection PUT en
entrant le nom du domaine du serveur de publication. Vous pouvez spcifier un ou plusieurs domaines,
chacun spar d'un espace, par exemple, www.w3.org groucho.marx.edu.

Prfrences de cache
Amaya fournit un cache par l'intermdiaire de la libwww. Par dfaut, le cache est activ et est stock
dans le rpertoire AmayaTemp/libwww-cache. Cet onglet fournit galement un bouton Nettoyage du
Cache, pour effacer le rpertoire du cache.

> Options
Les options suivantes peuvent tre coches ou non en cliquant sur la case de gauche aligne avec
l'intitul de l'option.
Activer le cache. Active ou dsactive le cache
Stocker dans le cache des documents protgs. Par dfaut, les documents qui sont protgs par un mot
de passe sont stocks dans le cache. Utiliser ce drapeau pour passer outre ce comportement.
Mode dconnect. Rcupre toujours les documents depuis le cache.
Ignorer l'en-tte Expires. Ignore les dates d'expiration des entres de cache.

> Rpertoire du cache


Donne l'adresse du rpertoire libwww-cache. Le fait de changer ce rpertoire n'effacera pas le contenu du
prcdant. Vous aurez le supprimer vous mme.

> Taille du cache (Mo)


Donner la taille, en megabytes, du cache.

> Taille maximum des entres du cache (Mo)


Donne la taille maximum d'entre d'un cache.

> Vider le cache


Ce bouton vous permet de vider le cache courant.

Prfrences des mots de passe


Amaya vous permet d'enregistrer les donnes saisies lors du dialogue d'authentification. Ces donnes
sont le nom de l'utilisateur et le mot de passe associs une paire nom de serveur/nom de domaine.

> Enregistrer les mots de passe


Ce bouton, s'il est activ, permet de demander l'utilisateur s'il souhaite qu'Amaya enregistre les
informations de connexion saisies lors du dialogue d'authentification. S'il est dsactiv (option par
dfaut), l'utilisateur n'aura pas la possibilit d'enregistrer ces donnes.

> Tout effacer


Cette option vous permet d'effacer toutes les donnes d'authentification enregistres dans Amaya.

> Sites
Cette liste permet d'effacer les donnes d'authentification correspondant une paire nom de serveur/
nom de domaine.
92

Configurer Amaya

Prfrences du proxy
Vous pouvez spcifier un proxy et une srie de domaines o le proxy devrait ou ne devrait pas tre utilis
par le biais de ce menu.

Proxy HTTP
Donnes le proxy qui devrait tre utilis pour les requtes HTTP. Vous devez spcifier le nom du serveur
en entier. Si le serveur est en train de fonctionner sur un port autre que 80, alors, comme un URL, vous
devez ajouter un caractre ":" au nom du proxy, suivi par le numro du port. Voici deux exemples.
HTTP Proxy Entry
groucho.marx.edu

groucho.marx.edu:1234

Rsultat
Dclare un proxy appel groucho.marx.edu fonctionne par dfaut sur le port
80.

Dclare un proxy appel groucho.marx.edu, fonctionnant sur le port 1234.

Liste du domaine proxy


Donne une liste des domaines spars par des espaces pour lesquels vous utilisez votre proxy. Par
exemple :
harpo.marx.edu zeppo.marx.edu chico.marx.edu

^--------------^----> entres spares par des espaces

Utilisez le menu pour spcifier si le proxy doit ou ne doit pas tre utilis avec cette liste de domaines.

Prfrences des couleurs


Ce menu permet la slection des couleurs du premier plan et de l'arrire plan par dfaut pour les
documents. Il permet galement de contrler les couleurs utilises par Amaya pour visualiser la slection
courante.
Couleur du texte donne la couleur par dfaut du premier plan des pages affiches.
Couleur de fond donne la couleur par dfaut de l'arrire plan des pages affiches.
Couleur du point d'insertion donne la couleur du premier plan qui montre la slection quand
elle est limite un point d'insertion.
Slection de la couleur donne la couleur de l'arrire plan qui montre la slection courante
quand elle est tendue.
Toutes ces couleurs peuvent tre slectionnes par leur nom, leur code hexadcimal, ou leur format rgb :
Les noms valides proposs.
Le format hexadcimal valide est #FF00FF par exemple.
Le format rgb valide est rgb(255, 0, 255) par exemple.
Vous pouvez galement slectionner les couleurs par le biais de la palette associe.

> Option
L'option suivante peut tre coche ou non en cliquant sur la case de gauche aligne avec l'intitul de
l'option.

93

Manuel d'utilisation d'Amaya


Colorier le source. Active ou dsactive la coloration des documents source.
Note : le changement des couleurs sera effectif quand vous ouvrirez une nouvelle fentre de document.

Les prfrences de gomtrie


Enregistrer la gomtrie en quittant. La gomtrie courante des fentres sera automatiquement
sauvegarde en quittant l'application.
Deux boutons vous permettent
d'enregistrer la taille et la position de la fentre courante,
ou de restaurer les valeurs par dfaut.
Note : Ces changements seront effectifs quand vous ouvrirez des nouvelles fentres document.

Configuration des annotations


Nom de l'utilisateur
Ce champ est associ chaque nouvelle annotation et dfinit l'auteur de l'annotation. Par dfaut, Amaya
utilise le nom de connexion pour construire la mta-donne auteur. Le champ "Annotation user" permet
un utilisateur de remplacer ce nom par un nom plus significatif.

Serveur de publication
Ce champ dfinit le serveur sur lequel les annotations sont enregistres. Les annotations locales sont
toujours sauvegardes dans un rpertoire local, sans tenir compte de ce champ. Par dfaut, il est vide. Il
est noter que le serveur sur lequel les annotations distantes sont enregistres n'est pas ncessairement
inclus dans la liste des serveurs interrogs; pour cela, vous devez rentrer son nom dans chacun des deux
champs, dans l'ordre que vous voulez.

Serveurs d'annotations
Ce champ dfinit les serveurs d'annotations interroger lorsque Amaya cherche une annotation. Vous
pouvez spcifier un ou plusieurs serveurs. Le nom de serveur localhost est rserv, il indique Amaya
de chercher localement les annotations. Cela ne signifie pas que l'on utilise un serveur pour les
annotations locale, pour cela il faudrait donner l'URL complte de celui-ci. Sous Unix, les serveurs
d'annotations sont spcifis la suite, spars par un espace. Sous Windows, ils sont spcifis les uns
aprs les autres et spars par la touche Entre. Par dfaut, ce champ est initialis avec localhost.
ASTUCE: Vous pouvez inhiber la consultation d'un serveur d'annotations en prfixant l'URL du serveur
avec le caractre '-'.

> Options
Les options suivantes peuvent tre coches ou non en cliquant sur la case de gauche aligne avec
l'intitul de l'option.
Charger automatiquement les annotations locales. Cette option indique que les annotations locales
doivent tre charges automatiquement ou non lorsqu'une nouvelle page est charge. Si elle n'est pas
positionne l'utilisateur doit explicitement slectionner l'entre Charger les annotations pour visualiser
celles-ci. Par dfaut, cette options est dsactive.
Charger automatiquement les annotations distantes. Cette option indique que les annotations
distantes doivent tre charges automatiquement ou non lorsqu'une nouvelle page est charge. Si elle
n'est pas positionne l'utilisateur doit explicitement slectionner l'entre Charger les annotations pour
visualiser celles-ci. Par dfaut, cette options est dsactive.

94

Configurer Amaya
Note ; Il peut y avoir un certain dlai lorsque Amaya charge les annotations distantes, ce dlai tant du
la rsolution du nom DNS des serveurs d'annotations.
Dsactiver le chargement automatique des annotations distantes. Lorsque cette option est active,
Amaya rinitialise l'option Chargement automatique des annotations distantes au dmarrage. Cela est
trs utile si vous travaillez en mode dconnect de temps en temps et que vous voulez continuer charger
automatiquement les annotations locales tout en rechargeant les annotations distantes lorsque vous tes
connects.

95

Manuel d'utilisation d'Amaya

96

Dfinir des raccourcis clavier

Dfinir des raccourcis clavier


Il est utile de pouvoir invoquer les commandes des menus directement depuis le clavier. Vous pouvez
accomplir ceci par un fichier de raccourcis clavier (un fichier par plate-forme). Ces fichiers dfinissent
une liste d'associations entre une squence au clavier et la commande invoque. Ils sont stocks dans le
rpertoire Amaya/config et sont diffrent pour chaque plate-forme : amaya.keyboard (Linux), amaya.kb
(Windows) and amaya.kb-mac (Mac OS X).
Liste des raccoucis clavier par dfaut pour Linux
Liste des raccoucis clavier par dfaut pour Windows
Liste des raccoucis clavier par dfaut pour Mac OS X
Vous pouvez modifier ces fichiers pour dfinir vos propres raccourcis clavier. La syntaxe utilise pour
dfinir une association est :
Directive = KeySeq ':' IdentCommand ;
KeysSeq = KeySet [ ',' KeySet ] ;
KeySet = [ Modifier ] [ 'Shift' ] Key ;
Key = '<Key>' KeyValue / '<Key>' SpecialKey ;
Modifier = 'Ctrl' / 'Alt' / 'Meta' ;
KeyValue = 'a' / 'b' / ... ;
SpecialKey = 'Escape' / 'Delete' / 'Space' / 'BackSpace' /
'Enter' / 'Up' / 'Down' / 'Left' / 'Right' /
'Home' / 'End' / 'F1' / ... / 'L1' / ... / 'R1' / ... ;
IdentCommand = 'TtcInsertChar(' Char ')' / NAME '()' ;
Char = KeyValue / OctalValue / Entity ;
OctalValue = '\' NUMBER ;
Entity = DecEntity / HexaEntity ;
DecEntity = '&' '#' NUMBER ';' ;
HexaEntity = '&' '#' 'x' HEXADECIMAL ';' ;.

La liste des commandes disponibles est (une liste jour peut tre trouve dans les sources d'Amaya :
Amaya/amaya/EDITOR.A) :
Commandes de dplacement :
TtcNextChar, TtcPreviousChar : dplace caractre par caractre.
TtcNextWord, TtcPreviousWord : dplace mot par mot.
TtcStartOfLine, TtcEndOfLine : dplace au dbut ou la fin de la ligne courante..
TtcNextLine, TtcPreviousLine : dplace ligne par ligne.
TtcNextElement, TtcPreviousElement, TtcChildElement, TtcParentElement :
dplace lment par lment.
TtcPageDown, TtcPageUp, TtcPageTop, TtcPageEnd : fait dfiler page par page.
TtcLineUp, TtcLineDown fait dfiler une ligne en haut ou une ligne en bas.
Commandes d'extension de la slection :
TtcNextSelChar, TtcPreviousSelChar : slectionne caractre par caractre.
TtcNextSelWord, TtcPreviousSelWord : slectionne mot par mot.
TtcSelStartOfLine, TtcSelEndOfLine : slectionne jusqu'au dbut ou la fin de la
ligne courante.
TtcNextSelLine, TtcPreviousSelLine : slectionne ligne par ligne.
Une commande qui permet de suivre un lien ou d'activer un lment de formulaire HTML
(menu, bouton, etc.) :
DoAction.
97

Manuel d'utilisation d'Amaya


Une commande qui permet de sauter au prochain (ou au premier s'il n'y a pas de slection) lien
ou lment de formulaire HTML :
NextLinkOrFormElement.
Une commande qui permet de sauter lien ou lment de formulaire HTML prcdent :
PreviousLinkOrFormElement.
Dans le menu Fichier :
NewXHTML, NewMathML, NewSVG, NewCss, OpenDoc, Reload, GotoPreviousHTML,
GotoNextHTML, GoToHome, SaveDocument, SaveDocumentAs, Synchronize,
SetupAndPrint, PrintAs, CloseDocument, AmayaCloseTab,AmayaCloseWindow,
AmayaClose.
Dans le menu dition :
TtcUndo, TtcRedo, TtcCutSelection, TtcCopySelection, TtcPaste,
TtcDeleteSelection, SetBrowserEditor, TtcSearchText, SpellCheck, TransformType,
ConfigAmaya.
Dans le menu Affichage :
ShowPanel, FullScreen, ShowMapAreas, ShowTargets, ZoomIn, ZoomOut, ShowLogFile,
ShowFormatted, ShowStructure, ShowAlternate, ShowLinks, ShowToC, ShowSource,
SplitHorizontally, SplitVertically.
Dans le menu Insertion :
CreateAddress CreateParagraph, CreateImage, CreateHorizontalRule,
CreateBlockQuote, CreatePreformatted, CreateAddress, CreateDivision,
CreateNOSCRIPT, CreateObject, CreateParameter, CreateIFrame,
CreateBreak,MakeBook, CreateAreaRect, CreateAreaCircle, CreateAreaPoly,
CreateForm, CreateFileInput, CreateImageInput, CreatePasswordInput,
CreateHiddenInput, CreateLabel, CreateFieldset, CreateOptGroup,
CreateToggle, CreateRadio, CreateOption, CreateTextInput,
CreateTextArea, CreateSubmit, CreateReset, CreateHeading1,
CreateHeading2, CreateHeading3, CreateHeading4, CreateHeading5,
CreateHeading6, CreateList, CreateNumberedList, CreateDefinitionList,
CreateDefinitionTerm, CreateDefinitionDef, CreateObject,
CreateParameter

CreateTable, CreateCaption, CreateTHead, CreateTBody, CreateTFoot,


CreateRow, CreateDataCell, CreateHeadingCell
CreateBase, CreateMeta, CreateLinkInHead, CreateScript, CreateStyle,
CreateComment.

SetOnOffEmphasis, SetOnOffStrong, SetOnOffCite, SetOnOffDefinition,


SetOnOffCode, SetOnOffVariable, SetOnOffSample, SetOnOffKeyboard,
SetOnOffAbbr, SetOnOffAcronym, SetOnOffINS, SetOnOffDEL.
SetOnOffItalic, SetOnOffBold, SetOnOffTeletype, SetOnOffBig,
SetOnOffSmall, SetOnOffSub, SetOnOffSup, SetOnOffQuotation, SetOnOffBDO.
CreateInlineMath, CreateMath, CreateMROOT, CreateMSQRT, CreateMFRAC,
CreateMSUBSUP, CreateMSUB, CreateMSUP, CreateMUNDEROVER, CreateMUNDER,
CreateMOVER, CreateMROW, CreateMMULTISCRIPTS, CreateMTABLE
Dans le menu Format :
CreateClass, ApplyClass, LinkCSS, OpenCSS, DisableCSS, EnableCSS, RemoveCSS,
DoLeftAlign, DoRightAlign, DoCenter, DoJustify.
Dans le menu Liens :
LinkToPreviousTarget, CreateOrChangeLink, CreateTarget, DeleteAnchor, MakeID.

98

Dfinir des raccourcis clavier


Dans le menu Outils:
ChangeTitle,DeleteColumn, AnnotateSelection, AnnotateDocument, LoadAnnotations,

PostAnnotation, DeleteAnnotation, FilterAnnot, ConfigAnnot.

Dans le menu Aide :


HelpAmaya, HelpAtW3C, HelpBrowsing, HelpSelecting, HelpSearching, HelpViews,
HelpCreating, HelpLinks, HelpChanging, HelpTables, HelpMath, HelpSVG,
HelpImageMaps, HelpStyleSheets, HelpAttributes, HelpPublishing, HelpPrinting,
HelpNumbering, HelpMakeBook, HelpAnnotation, HelpConfigure, HelpShortCuts,
HelpAccess.

99

Manuel d'utilisation d'Amaya

100

Accessibilit

Accessibilit
Fonctions accessibles
Afin d'amliorer l'accessibilit pour les personnes handicapes, un grand nombre de fonctions d'Amaya
peuvent tre excutes sans utiliser la souris ou le clavier.
Les caractristiques d'accessibilit incluent :
Les vues liens, structure, et table des matires, qui peuvent tre utilises pour naviguer dans le
document. Elles sont synchronises avec la vue formate.
La possibilit d'diter le code source.
Les feuilles de style, qui peuvent tre ajoutes et dites dynamiquement, randant ainsi le
contenu des pages indpendant de leur prsentation.
Les accs rapides et l'activation au clavier des liens et des contrles de formulaires.

Produire un contenu accessible


Amaya peut tre utilis pour produire un contenu conforme au Web Content Accessibility Guidelines du
W3C. Certaines caractristiques, comme par exemple l'obligation de fournir un attribut alt pour les
images et les zones actives, sont dj disponibles (il est impossible d'ajouter une image tant qu'il n'y a pas
de texte altern).
Amaya produit aussi automatiquement un balisage valide, conforme aux recommandations du W3C.
D'autres caractristiques, comme l'ajout de descriptions longues et les lgendes, peuvent tre assures par
l'auteur l'aide de l'outil Attributs ou de la vue structure.
La documentation d'Amaya dcrit comment utiliser quelques lments individuels HTML et comporte
une aide en ligne sur la faon d'assurer que les pages produites soient accessibles. On peut aussi consulter
des guides en ligne plus complets, comme les Web Content Accessibility Guidelines du W3C. Le Web
Accessibility Initiative du W3C publie galement De brefs renseignements pour faire des sites Web
accessibles dont les dix conseils pratiques sont :
Images & animations. Utilisez l'attribut alt pour dcrire la fonction de chaque graphique.
Zones actives. Utilisez l'lment map et le texte pour les zones sensibles.
Multimdia. Fournissez des lgendes et des transcriptions pour l'audio, et des descriptions pour
la vido.
Liens hypertextes. Utilisez un texte qui a un sens mme lorsqu'il est lu en-dehors de son
contexte. Par exemple, vitez cliquer ici .
Organisation de la page. Utilisez les en-ttes, les listes, ainsi qu'une structure cohrente.
Utilisez les CSS pour la mise en page et le style quand cela est possible.
Graphiques et schmas. Rsumez ou utilisez l'attribut longdesc.
Scripts, applets, et plug-ins. Fournissez un contenu alternatif qui sera utilis dans le cas o les
caractristiques actives sont inaccessibles ou non supportes.
Frames. Utilisez l'lment noframe ainsi que des titres significatifs.
Tables. Assurez-vous qu'une lecture ligne par ligne aie du sens. Rsumez.
Vrifier votre travail. Validez. Utilisez les outils, la liste de vrification, et les aides en ligne
http://www.w3.org/TR/WCAG.

101

Manuel d'utilisation d'Amaya

102

Introduction HTML

Introduction HTML
Cette section donne une brve introduction au langage HTML. Elle dcrit quelques lments HTML et
explique comment les utiliser.

Types d'information dans HTML


HTML 4.0 (Strict) fournit des lments pour dsigner certains types "information". Bien qu'il existe une
prsentation par dfaut de chaque type d'lment, il est possible d'utiliser les feuilles de style pour
changer la prsentation de n'importe quel lment. Les types information qui peuvent tre reprsents par
les lments HTML sont :
En-ttes
Il y a six niveaux d'en-tte dans HTML, qui doivent tre utiliss pour marquer les en-ttes de page
ou de sujet selon leur importance.
HTML fournit deux types de listes simples :
1. Listes numrotes ( comme celle-ci)
2. Listes non ordonnes.
Il fournit galement des listes de termes et de dfinitions.
A propos de l'auteur
Un lment spcial est fourni pour contacter l'information sur l'auteur d'une page HTML.
Dfinitions
Celles-ci peuvent tre marques comme une dfinition en ligne (c'est--dire dfinie dans un
paragraphe normal) ou dans une liste de termes et de dfinitions. Cette liste de types information est
elle-mme une liste de dfinitions. Il est galement possible d'utiliser la valeur glossary dans
l'attribut rel d'un lien, si ce lien pointe vers une dfinition. Dans Amaya, les Vues liens et structure
incluent n'importe quel attribut rel aux liens.
Citations
Celles-ci peuvent tre au niveau ligne ou bloc. Dans chaque cas, il est possible de noter la source de
la citation en utilisant l'lment cite ou l'attribut cite.
Sample input, output, computer code
Ces lments correspondent des exemples de computer code, variables, text to be entered
et sample output.
Abrvations et acronymes
Les lments peuvent tre utiliss pour dsigner les abrviations et les acronymes.
Insertions et suppressions
Il existe des lments pour marquer le texte qui a t insr, ou qui devrait tre supprim. (Cela est
utile pour l'dition collaborative historique du document)
Mises en vidence
HTML fournit deux niveaux de mise en vidence :mise en vidence ordinaire et mise en vidence
forte.

103

Manuel d'utilisation d'Amaya

Structure du document HTML


Les documents HTML ont une structure assez uniforme. S'il y a des sections qui contiennent des soussections, la division du texte est ordinairement marque par des lments en-ttes de diffrents niveaux,
qui se trouvent sur le bord des paragraphes et autres blocs d'lments.
L'lment DIV est l pour regrouper une section dans une division _ pour l'utiliser, slectionnez la section
que vous voulez assembler au groupe (en incluant son en-tte), puis slectionnez l'option Division (div)
du menu Insertion (ou utilisez le raccourci-clavier Ctrl h Ctrl v ).
Il y a une structure spciale dans HTML, le lien, qui fait du Web une toile. Les informations sur
comment crer un lien et comment crer des tables sont fournies par la documentation du manuel
d'utilisation.
Une page normale HTML devrait inclure un titre, une en-tte de niveau un et une adresse ou une
information sur l'auteur. Elle devrait galement inclure des paragraphes, des listes, des images, des
tables, et un contenu organis en sous-sections avec diffrents niveaux d'en-ttes.

lments d'entte
HTML fournit 6 niveaux d'entte : h1, h2, h3, h4, h5, and h6. Ils devraient tre utiliss pour
marquer les enttes selon leur importance, H1 tant le plus important. Les enttes sont des lments bloc,
et peuvent re uniquement cres comme les filles d'lments qui ont un contenu de type bloc. Notez que
pour les tables de donnes, il existe des lments spciaux pour marquer les enttes.
Le premier des trois niveaux d'entte peut tre cr depuis la barre d'outils en utilisant les icnes

,
. Tous les niveaux d'entte peuvent tre crs depuis le menu Insertion, ou en utilisant les
raccourcis clavier. Les raccourcis clavier sont par dfaut Ctrl h Ctrl 1 pour h1, Ctrl h Ctrl 2 pour
h2, et pareil jusqu' Ctrl h Ctrl 6 for h6.
Il existe des styles d'entte par dfaut dans la plupart des navigateurs pour donner une ide de leur
importance relative, mais l'auteur peut galement utiliser les feuilles de style pour fournir une autre
prsentation.

lments de liste
Il y a trois types de liste dans HTML. Les deux types simples sont : liste ordonne et liste non ordonne.
Il y a aussi une liste de dfinitions. Les listes sont des structures de type bloc, mais elles peuvent tre
cres l'intrieur d'autres listes.
Par exemple :
Liste de dfinitions
C'est une liste de dfinitions. Elle contient des termes de dfinition (dt) et des textes explicatifs
(dd).
Un terme de dfinition peut tre suivi par un nombre ou par des dfinitions.
Liste ordonne
Il y a trois types de liste :
1. Liste ordonne (ol)
2. Liste non ordonne (ul)
3. Liste de dfinition (dl)
Liste non ordonne
Les listes ordonnes et les listes non ordonnes partagent quelques caractristiques :
104

Introduction HTML
Ce sont des listes simples.
Les deux types de liste ont des fils qui sont des items de liste (lments li)
Les trois types de liste peuvent tous les trois tre crs avec la barre d'outil en utilisant les boutons ,
, . Tous les types de liste peuvent tre crs partir du menu Insertion, ou en utilisant les raccourcis
clavier. Les raccourcis clavier par dfaut dans les systmes Unix sont Ctrl h Ctrl l pour une liste
ordonne, Ctrl h Ctrl n pour une liste non ordonne, et Ctrl h Ctrl d pour une liste de dfinitions.
Les feuilles de style peuvent tre utilises pour changer la prsentation des listes. Il est possible de
changer le style des puces de liste, et de changer le style du texte, par exemple en utilisant une police de
caractres diffrente pour les termes de dfinition et pour les dfinitions effectives.

propos de l'auteur
Une page Web devrait toujours contenir certaines informations qui permettent au lecteur de connatre qui
a crit la page ou qui en est responsable. Ceci peut inclure une adresse email (qui peut tre lie), un URL,
ou bien une adresse physique. Le type address est utilis pour identifier cette information, et il peut
contenir d'autres niveaux blocs d'lments comme les paragraphes, les enttes et les listes.
Il existe un style par dfaut pour les adresses des lments dans la plupart des navigateurs mais l'auteur
peut galement utiliser les feuilles de style pour fournir une prsentation suggestive.

Types en ligne
Un texte l'intrieur d'un paragraphe, une entte, ou un autre lment bloc peut tre balis de diffrentes
faons, par exemple pour mettre l'accent dessus, ou pour souligner ce qui devrait tre entr par
l'utilisateur sur un ordinateur. La plupart de ces lments en ligne sont dcrits dans cette page, alors que
les liens, qui sont eux aussi des lments en ligne, soient dcrits sparment.

Dfinitions
L'lment dfn est utilis pour marquer une dfinition en ligne (un mot qui est donn comme un exemple
de dfinition)
Les feuilles de style peuvent tre utiliser pour changer la prsentation des dfinitions en ligne.

Les citations en ligne


Les citations qui sont en ligne peuvent tre marques en utilisant l'lment d'information "citation" l'lment HTML q. Cet lment est slectionn depuis le sous-menu lments caractres du menu
Insertion, ou avec le raccourci clavier Ctrl i Ctrl q. Il est possible de donner l'URI de la source pour
la citation, utilisant l'attribut cite.
Les feuilles de style peuvent tre utilises pour changer la prsentation des citations en ligne. Les
spcifications HTML prcisent que les citations en ligne devraient tre rendues avec des guillemets
appropris la langue courante.

Les lments exemple, ins, etc.


Les lments sont fournis pour marquer les codes, comme statement:do-something, avec le balisage
diffrent pour variables, ainsi que user input et program output - les lments code, var, kbd et
samp. Ces lments sont trouvs l'aide du sous-menu Types information du menu Insertion, et il
existe des raccourcis clavier pour tous - Ctrl i suivi de Ctrl t pour code, Ctrl v pour variables, Ctrl
k pour user input et Ctrl m pour sample output.
Les feuilles de style peuvent tre utilises pour changer la prsentation de ces lments.

105

Manuel d'utilisation d'Amaya

Acronymes et abrviations
Les acronymes et les abrviations devraient tre marqus comme tels, en utilisant les lments abbr et
acronym disponibles dans le sous-menu Types information du menu Insertion. Il y a galement le
raccourci Ctrl i Ctrl y pour les acronymes. Ceci permet la reconnaissance des diffrents types de
systmes.
L'attribut title peut galement tre utilis pour spcifier l'expansion de l'acronyme. Slectionnez le
texte marquer, par exemple W3C, slectionnez le menu Style, le sous-menu types information, et
l'option acronyme. Puis slectionnez l'lment entier (touche Esc ou F2), ouvrez le menu Attributs,
slectionnez title, entrez World Wide Web Consortium, et appliquez le.
Les feuilles de style peuvent tre utilises pour changer la prsentation des acronymes ou des
abrviations.

Insertions et suppressions
Les lments del et ins sont disponibles dans le sous-menu Types information du menu Insertion pour
marquer le texte qui devra tre effac ou qui a dj t insr.
Les feuilles de style peuvent tre utilises pour changer la prsentation des insertions et des suppressions.

Les lments de mise en vidence


HTML a des lments pour dfinir deux niveaux de mise en vidence :
1. La mise en vidence ordinaire, utilisez l'lment em
2. La mise en vidence renforce, utilisez l'lment strong.
Deux types de mise en vidence peuvent tre appliqus depuis la barre d'outils en utilisant les boutons
et
, ou depuis le formulaire du sous-menu Types information du menu Insertion. Il y a
galement des raccourcis clavier - Ctrl i Cltr e pour accentuer (parce que l'interprtation par dfaut
est souvent le texte en italique) et Ctrl i Ctrl s pour la mise en vidence renforce (parce que
l'interprtation par dfaut est souvent le texte en gras). Si il y a une slection courante, la mise en
vidence lui est applique, autrement l'lment appropri est cr, en tant que fils de l'lment courant.
Les lments de la mise en vidence sont sous forme de choix dans Amaya - pour dsactiver une mise en
vidence, slectionnez l'lment et rappliquez la mise en vidence approprie. Par exemple, placez le
curseur quelque part sur un lment strong, utilisez la touche F2 ou Esc pour slectionner l'lment, et
ensuite utilisez le raccourci clavier, menu item, ou le bouton

- l'lment strong sera dsactiv.

Les feuilles de style peuvent tre utilises pour changer la prsentation des deux types de mise en
vidence.

L'lment span
L'lment span associ un attribut id (style ou class) permet d'enrichir la structure du document. Cet
lment est cr automatiquement par Amaya quand l'utilisateur applique un attribut sur une portion de
texte. Il est dtruit quand l'attribut correspondant est supprim.

Elments de style de HTML


Ce qu'il ne faut pas faire et ce qui doit tre fait...
HTML 4.0 (Strict) inclue des lments qui marquent des changements de style des caractres. Ces
lments devraient tre remplacs par l'utilisation d'lments structuraux ou par des feuilles de style
quand cela est possible.
106

Introduction HTML
Tous les lments en question, l'exeption de PRE, se trouvent dans le sous menu Elments caractres
du menu Insertion :
b et i

Ceux-ci devraient tre remplacs par les lments strong et em, quand ils sont utiliss pour fournir
des mises en vidences de mot ou de phrase. Il y a des lments spciaux pour noter des en-ttes,
des termes dfinir, ainsi que certains usages spciaux, comme par exemple une citation, un
fragment de code, etc. Si les lments sont simplement utiliss pour obtenir une police de caractre
plus grasse, les feuilles de style devraient tre utilises la place.
big et small

En gnral, ces rsultats devraient tre obtenus avec les feuilles de style. Quand ils sont utiliss pour
marquer des types spcifiques d'information, comme la source d'une citation, un sample, computer
input ou output, etc, les lments HTML appropris devraient tre utiliss.
sub et sup

Les Feuilles de style doivent tre utilises pour obtenir la prsentation de ces lments. Dans des cas
comme les expressions mathmatiques, un balisage de langage spcifique comme le MathML doit
tre utilis ds que possible.
tt et pre

Les auteurs doivent utiliser les feuilles de style pour obtenir ces rsultats.

Les lments HTML


Amaya reconnat tous les lments de HTML 4.0, mais ne produit que les lments non dprcis. La
liste qui suit donne les lments qui peuvent tre produits avec Amaya. Chaque lien pointe sur la
spcification de HTML. Vous pouvez aussi consulter quelques Informations sur les lments HTML.
a
ancre - un lien et/ou une cible
abbr
abrviation (e.g., WWW, HTTP, etc.)
acronym
un acronyme: un type d'abrviation qui peut-tre prononc comme un mot. (comme laser,
WYSIWYG)
address
information sur l'auteur
area
une zone de plan (map) activable
b
style de texte gras (Il est prfrable d'utiliser un style CSS ou une balise information structurale)
base
URI de base du document
bdo
force le sens d'criture (I18N BiDi)

107

Manuel d'utilisation d'Amaya


big
style de texte large (Il est prfrable d'utiliser un style CSS ou une balise information structurale)
blockquote
note longue
body
corps du document
br
rupture de ligne force
button
bouton poussoir
caption
lgende de table
cite
citation
code
fragment de code informatique
col
colonne de table
colgroup
groupe de colonnes de table
dd
description de dfinition
del
texte dtruit
dfn
instance de dfinition
div
langage gnrique ou conteneur de style
dl
liste de dfinitions
dt
terme de dfinition
em
mise en vidence
fieldset
groupe dans un formulaire

108

Introduction HTML
form
formulaire d'interaction
h1, h2, h3, h4, h5, h6
en-ttes
head
contient des mta-donnes sur le document
hr
rgle horizontale
html
lment racine du document
i
style de texte italique (Il est prfrable d'utiliser un style CSS ou une balise information structurale)
iframe
sous-fentre en ligne
img
image
input
lment de contrle
ins
texte insr
kbd
texte entrer par l'utilisateur
label
label d'un groupe dans un formulaire
legend
lgende d'un groupe dans un formulaire
li
item de liste
link
un lien indpendant du mdia
map
un plan (map) de zones actives
meta
mta-information sur le document
noscript
contenu altern pour une visualisation sans support de script

109

Manuel d'utilisation d'Amaya


object
objet gnrique
ol
liste numrote
optgroup
groupe d'options
option
choix slectionnable
p
paragraphe
param
valeur d'une proprit nomme
pre
texte prformat
q
note en ligne courte
samp
exemple de programme, sortie, scripts, etc.
script
code du script
select
slecteur d'options
small
style de texte petit (Il est prfrable d'utiliser un style CSS ou une balise information structurale)
span
langage gnrique ou conteneur de style
strong
texte important
style
information de style
sub
indice
sup
exposant
table
une table

110

Introduction HTML
tbody
corps de table
td
cellule de table
textarea
saisie de texte multi-lignes
tfoot
bloc de bas de table
th
cellule titre de table
thead
bloc de dbut de table
title
titre du document
tr
ligne de table, contient des cellules de table
tt
style de texte tltype (Il est prfrable d'utiliser un style CSS ou une balise information structurale)
ul
liste puces
var
instance de variable ou argument de programme
Amaya ne permet pas la cration de frames.
frame
sous-fentre
frameset
dfinition d'un ensemble de sous-fentres
noframes
contenu altern pour une visualisation sans support de frames
Amaya ne cre pas les lments suivant qui sont dprcis dans HTML 4.0 (ils ne devraient plus tre
utiliss). Il doivent tre remplacs par les lments indiqus
applet
Doit tre remplac par object
basefont
Doit tre remplac par un style CSS
center
Doit tre remplac par un style CSS
111

Manuel d'utilisation d'Amaya


dir
Doit tre remplac par ul
font
Doit tre remplac par un style CSS
isindex
Doit tre remplac par form
menu
Doit tre remplac par ul
s and strike
Doit tre remplac par del ( identifier un texte supprim) ou par un style CSS
u
Doit tre remplac un style CSS

Copyright 1994-2008 INRIA and W3C (MIT, ERCIM, Keio), All Rights Reserved. W3C liability,
trademark, document useand software licensingrules apply. Your interactions with this site are in accordance with
our public and Member privacy statements.

112

Vous aimerez peut-être aussi