Difference between revisions of "Image naming guidelines"
From Joomla! Documentation
m (→Joomla Image Names Examples: heading name change) |
m (version 5.x added) |
||
(30 intermediate revisions by 4 users not shown) | |||
Line 1: | Line 1: | ||
− | The image naming guidelines are to give documentation contributors a set guidelines about naming an uploaded image file | + | {{version|3.x,4.x,5.x}} |
+ | <noinclude><languages /></noinclude> | ||
+ | <translate> | ||
+ | <!--T:28--> | ||
+ | The image naming guidelines are to give documentation contributors a set of guidelines about naming an uploaded image file ''not used'' by Joomla [[Help screens]].</translate> | ||
− | + | <translate> | |
− | + | <!--T:53--> | |
+ | These guidelines are not absolute, but for informative purposes. They should only be used as a reference for helping contributors form a good image file name. | ||
+ | </translate> | ||
− | + | <translate> | |
− | + | <!--T:54--> | |
+ | Naming an image for use in Joomla documentation is not difficult once you understand how the images are processed and stored. Some of the benefits of Mediawiki's method of image storage are an</translate> | ||
+ | <translate> | ||
+ | <!--T:55--> | ||
+ | *image history, | ||
+ | </translate> | ||
+ | <translate> | ||
+ | <!--T:56--> | ||
+ | *extra image data, | ||
+ | </translate> | ||
+ | <translate> | ||
+ | <!--T:57--> | ||
+ | *and easy image updating. | ||
+ | </translate> | ||
+ | <translate> | ||
+ | ==Naming an Uploaded Image== <!--T:29--> | ||
+ | </translate> | ||
+ | <translate> | ||
+ | <!--T:58--> | ||
+ | The Mediawiki software allows uploaded images to be named by [[Help:Image_uploading|2 methods]]. | ||
+ | </translate> | ||
+ | <translate> | ||
+ | ===Uploading an image directly=== <!--T:59--> | ||
+ | </translate> | ||
+ | <translate> | ||
+ | <!--T:30--> | ||
+ | Image is not referenced in a page, but will be used. The default name of the image will be the "local" (name in your file system) but it may be changed before the actual upload.</translate> | ||
+ | <translate> | ||
+ | ===Clicking on a red link=== <!--T:60--> | ||
+ | </translate> | ||
+ | <translate> | ||
+ | <!--T:31--> | ||
+ | An image is referenced in a page already with an image link, such as</translate> | ||
+ | [[File:Name of the image-<translate><!--T:50--> en</translate>.png|none|border]] | ||
− | Of the two methods, the later method is the easiest method to use. | + | <translate> |
+ | <!--T:32--> | ||
+ | Of the two methods, the later method is the easiest method to use. | ||
− | ==Naming Pattern Suggestions== | + | ==Naming Pattern Suggestions== <!--T:33--> |
Image names should consist of an underscore or hyphenated separated list of descriptive words. Think of them as a summary description of the image. | Image names should consist of an underscore or hyphenated separated list of descriptive words. Think of them as a summary description of the image. | ||
− | ===Suggested Formats For Joomla Images=== | + | ===Suggested Formats For Joomla Images=== <!--T:34--> |
− | It would be very beneficial if the first part of any Joomla image refers to it's version. This allows someone to instantly know what version of Joomla is connected to the image. Example: < | + | It would be very beneficial if the first part of any Joomla image refers to it's version. This allows someone to instantly know what version of Joomla is connected to the image. Example: <tt>j3x</tt>. There is no need to insert the .(dot) in the version, please omit it. |
− | + | </translate> | |
<pre> | <pre> | ||
<jver>-<admin>-<view>.<extension('png' | 'jpg' | 'jpeg' | 'gif')> | <jver>-<admin>-<view>.<extension('png' | 'jpg' | 'jpeg' | 'gif')> | ||
</pre> | </pre> | ||
− | + | <translate> | |
− | ==== Joomla Image Examples ==== | + | ==== Joomla Image Examples ==== <!--T:35--> |
− | A screenshot of Joomla 3.x | + | A screenshot of Joomla 3.x administrator's view of the article manager could be written as:</translate> |
<pre> | <pre> | ||
j3x_admin_content_article_manager_articles.png | j3x_admin_content_article_manager_articles.png | ||
− | |||
</pre> | </pre> | ||
− | A screenshot of Joomla 3.x | + | <translate><!--T:36--> |
+ | A screenshot of Joomla 3.x site's (frontend) view of the log in module could be written as:</translate> | ||
<pre> | <pre> | ||
j3x_site_protostar_log_in_module.png | j3x_site_protostar_log_in_module.png | ||
− | |||
</pre> | </pre> | ||
+ | <translate> | ||
+ | ===Suggested Formats For non-Joomla Images=== <!--T:37--> | ||
+ | |||
+ | <!--T:38--> | ||
+ | Common sense and a descriptive summary should be the guide for non-Joomla images. Again, use the underscore _ or hyphen - to separate the summary. For images of people, please use the person's name. For images of software or website's, please include them within reason. | ||
+ | |||
+ | ====Non-Joomla Image Examples==== <!--T:39--> | ||
+ | |||
+ | <!--T:40--> | ||
+ | GitHub pull request, the Firefox Firebug tool, or these other examples could be written as:</translate> | ||
+ | <pre> | ||
+ | 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 | ||
+ | </pre> | ||
+ | <translate> | ||
+ | <!--T:41--> | ||
+ | They are short, descriptive, and inform the viewer looking at the image call what the image is quickly. | ||
− | === | + | ==Localisation of Image Names== <!--T:42--> |
+ | |||
+ | <!--T:43--> | ||
+ | In preparation for documentation localisation, how to address images of different languages needs to be addressed. As documentation becomes localised, it is necessary to let user's and the Documentation Working Group identify images in another language quickly. Please do not use a native language as a file name description. Instead, add a trailing two-letter language code to the end of your file description before you upload the image in the 'base' language description. | ||
+ | |||
+ | <!--T:44--> | ||
+ | Translators of Joomla! Documentation should read:</translate> [[S:MyLanguage/JDOC:Localising Images|<translate><!--T:45--> | ||
+ | Localising Images</translate>]]. <translate><!--T:52--> | ||
+ | Translators will find detailed information about translating images.</translate> | ||
+ | <translate> | ||
+ | <!--T:46--> | ||
+ | Here is the base examples: | ||
+ | </translate> | ||
+ | <pre> | ||
+ | <jver>-<admin>-<view>-<language code>.<extension('png' | 'jpg' | 'jpeg' | 'gif')> | ||
+ | </pre> | ||
+ | <translate> | ||
+ | <!--T:47--> | ||
+ | Taking some of the examples from above: | ||
+ | </translate> | ||
+ | <pre> | ||
+ | j3x_admin_content_article_manager_articles_es.png | ||
+ | </pre> | ||
+ | <translate> | ||
+ | <!--T:48--> | ||
+ | A screenshot of Joomla 3.x site's (frontend) view of the log in module could be written as:</translate> | ||
+ | <pre> | ||
+ | j3x_site_protostar_log_in_module_fr.png | ||
+ | </pre> | ||
<noinclude>[[Category:Documentation Wiki Information]]</noinclude> | <noinclude>[[Category:Documentation Wiki Information]]</noinclude> | ||
+ | <noinclude> | ||
+ | [[Category:Style guides|{{PAGENAME}}]] | ||
+ | </noinclude> |
Latest revision as of 11:58, 23 March 2024
The image naming guidelines are to give documentation contributors a set of guidelines about naming an uploaded image file not used by Joomla Help screens.
These guidelines are not absolute, but for informative purposes. They should only be used as a reference for helping contributors form a good image file name.
Naming an image for use in Joomla documentation is not difficult once you understand how the images are processed and stored. Some of the benefits of Mediawiki's method of image storage are an
- image history,
- extra image data,
- and easy image updating.
Naming an Uploaded Image[edit]
The Mediawiki software allows uploaded images to be named by 2 methods.
Uploading an image directly[edit]
Image is not referenced in a page, but will be used. The default name of the image will be the "local" (name in your file system) but it may be changed before the actual upload.
Clicking on a red link[edit]
An image is referenced in a page already with an image link, such as
Of the two methods, the later method is the easiest method to use.
Naming Pattern Suggestions[edit]
Image names should consist of an underscore or hyphenated separated list of descriptive words. Think of them as a summary description of the image.
Suggested Formats For Joomla Images[edit]
It would be very beneficial if the first part of any Joomla image refers to it's version. This allows someone to instantly know what version of Joomla is connected to the image. Example: j3x. There is no need to insert the .(dot) in the version, please omit it.
<jver>-<admin>-<view>.<extension('png' | 'jpg' | 'jpeg' | 'gif')>
Joomla Image Examples[edit]
A screenshot of Joomla 3.x administrator's view of the article manager could be written as:
j3x_admin_content_article_manager_articles.png
A screenshot of Joomla 3.x site's (frontend) view of the log in module could be written as:
j3x_site_protostar_log_in_module.png
Suggested Formats For non-Joomla Images[edit]
Common sense and a descriptive summary should be the guide for non-Joomla images. Again, use the underscore _ or hyphen - to separate the summary. For images of people, please use the person's name. For images of software or website's, please include them within reason.
Non-Joomla Image Examples[edit]
GitHub pull request, the Firefox Firebug tool, or these other examples could be written as:
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
They are short, descriptive, and inform the viewer looking at the image call what the image is quickly.
Localisation of Image Names[edit]
In preparation for documentation localisation, how to address images of different languages needs to be addressed. As documentation becomes localised, it is necessary to let user's and the Documentation Working Group identify images in another language quickly. Please do not use a native language as a file name description. Instead, add a trailing two-letter language code to the end of your file description before you upload the image in the 'base' language description.
Translators of Joomla! Documentation should read: Localising Images. Translators will find detailed information about translating images. Here is the base examples:
<jver>-<admin>-<view>-<language code>.<extension('png' | 'jpg' | 'jpeg' | 'gif')>
Taking some of the examples from above:
j3x_admin_content_article_manager_articles_es.png
A screenshot of Joomla 3.x site's (frontend) view of the log in module could be written as:
j3x_site_protostar_log_in_module_fr.png