Joomla! Documentation™

Les directives sur le nommage des images ont pour but de donner aux contributeurs de la documentation un ensemble de directives sur le nommage d'un fichier image téléchargé non utilisé par les Les écrans d'aide de Joomla.

Ces lignes directrices ne sont pas absolues, mais ont un but informatif. Elles ne doivent être utilisées qu'à titre de référence pour aider les contributeurs à trouver un nom de fichier image adéquat.

Nommer une image pour l'utiliser dans la documentation Joomla n'est pas difficile une fois que l'on a compris comment les images sont traitées et stockées. Les avantages de la méthode de stockage des images de Mediawiki sont les suivants

• historique de l'image,
• données d'image supplémentaires,
• et une mise à jour facile de l'image.

Nommage et Chargement d'une Image

Mediawiki autorise le nommage des images chargées suivant deux méthodes.

=Télécharger une image directement

L'image n'est pas référencée dans une page, mais elle sera utilisée. Le nom par défaut de l'image sera le nom "local" (nom dans votre système de fichiers), mais il peut être modifié avant le téléchargement proprement dit.

Cliquer sur un lien rouge

Une image est référencée dans une page déjà dotée d'un lien d'image, tel que

Des deux méthodes, cette dernière est la plus simple à utiliser.

Suggestions de type de nommage

Les noms d'images doivent être composés par des mots descriptifs séparés par des tirets bas (underscore _) ou des traits d'union (-). Pensez aux mots comme étant une description sommaire de l'image.

Formats suggérés pour les images Joomla!

Il serait très appréciable que la première partie de toute image Joomla! fasse référence à sa version. Cela permet à toute personne de connaître instantanément quelle version de Joomla! est associée à l'image. Par exemple : j3x. Il n'est pas conseillé d'insérer le .(point) de la version, veuillez le supprimer.

<jver>-<admin>-<view>.<extension('png' | 'jpg' | 'jpeg' | 'gif')>

Exemples pour les images Joomla!

Une capture d'écran dans l'administration d'un Joomla! 3.x du gestionnaire d'articles, peut être nommée comme ceci :

j3x_admin_content_article_manager_articles.png

Une capture d'écran d'une vue du module de connexion en front-end pour un Joomla! 3.x, peut être nommée comme ceci :

j3x_site_protostar_log_in_module.png

Formats suggérés pour des images autres que Joomla!

Le sens commun et un descriptif sommaire devraient être les guides pour le nommage des images autres que Joomla. Encore une fois, utilisez les tirets bas (underscore _) ou les traits d'union (-) pour séparer les éléments. Pour les images se rapportant à des personnes, veuillez utiliser le nom de cette même personne. Pour les images se rapportant à des logiciels ou des sites web, veuillez les nommer dans l'intitulé.

Exemples pour les images autres que Joomla!

Une demande de pull GitHub, une copie d'écran de l'outil Firebug ou d'autres peuvent être nommées comme ceci :

github-pull-request-how-to.png
eclipse_indigo_interface_egit_browsing_veiw.png
joomla-event-Nov-2013-John-Smith.png
firefox_addon_firebug_colour_picker.png

Ils sont courts, descriptifs et informent le lecteur qui regarde l'image de ce qu'elle représente rapidement.

Le nommage des images à traduire

Dans le cadre de la préparation à la traduction de la documentation, il est important de prendre en compte le nommage des images pour différentes langues. Depuis l’internationalisation de la documentation, il est nécessaire de proposer à l'utilisateur de la documentation des images dans sa propre langue. Il convient de ne pas utiliser la langue native pour le nommage et la description de l'image. Il est préférable d'ajouter les deux lettres du code langue à la fin du nom et de la description de votre fichier avant de charger l'image.

Les traducteurs de la documentation Joomla! sont invités à lire : Traduction des images. Les traducteurs y trouveront des informations détaillées se rapportant à la traduction des images. Voici les exemples de base :

<jver>-<admin>-<view>-<language code>.<extension('png' | 'jpg' | 'jpeg' | 'gif')>

En reprenant quelques exemples ci-dessus :

j3x_admin_content_article_manager_articles_es.png

Une capture d'écran d'une vue du module de connexion en front-end pour un Joomla! 3.x, peut être nommée comme ceci :

j3x_site_protostar_log_in_module_fr.png