Adding images and screenshots
Revision Information
- Revision id: 20321
- Created:
- Creator: Michael Verdi
- Comment: Saving work in progress
- Reviewed: No
- Ready for localization: No
Revision Source
Revision Content
A picture is worth a thousand words, and can go a long way in helping people understand what is being said in an article. A screenshot is an image (i.e. snapshot) of your computer screen or portion of the screen. On the Firefox Support Knowledge Base, we don't want people to be shy about adding screenshots.
Table of Contents
Creating Windows screenshots
These instructions use the Windows 7 built-in print screen command and the Paint program.
- First, turn on the default Windows 7 Aero theme and make your desktop background white:
- Right-click on your desktop and choose
- Under Aero Themes, select Windows 7.
- Then click the Desktop Background link at the bottom of the window and choose a solid white background.
- Right-click on your desktop and choose
- Next, set up the situation you want to screenshot. When you've got it how you want, press on your keyboard.
- Go to the menu and open up the Paint program.
- Once Paint is open, click
- Now let's crop the image to just the relevant part:
- Make sure you have the rectangular selection method selected
- Then use that rectangular selection to draw a box around the area that you want to include...
... and then click .
- Make sure you have the rectangular selection method selected
- Use red callouts to highlight things (like what people should click on) in the screenshot.
- When you are done cropping and highlighting, scale down large images to less than 650 pixels wide so they will fit on the page properly.
- Finally, save your image as a PNG so you can upload it to the media gallery.
Creating Mac screenshots
These instructions are for Mac OS 10.7 Lion and the Preview application.
- First, control-click on your desktop, choose
- Next, set up the situation you want to screenshot. When you've got it how you want, press on your keyboard and a screenshot will placed on your desktop.
- Go to your desktop, double-click the screenshot and it will open with the Preview application.
- Now let's crop the image to just the relevant part:
- Use the rectangular selection to draw a box around the area that you want to include...
- ... and then go to the
- Use red callouts to highlight things (like what people should click on) in the screenshot.
- When you are done cropping and highlighting, scale down large images to less than 650 pixels wide so they will fit on the page properly.
- Finally, save your image as a PNG so you can upload it to the media gallery.
Creating Linux screenshots
On Ubuntu Linux, once you have got the screen presented the way you want for the screenshot, click the Print Screen or Prnt Scrn key will also work.
menu, go to the folder, and select . In other cases, using theScreenshots and file size
We do a couple of things to limit how much data has to be downloaded when you visit a Knowledge Base article:
- We automatically compress all image uploads so that each file is small.
- We only load the images for the selected platform. So if you are viewing an article with Windows, we only load the Windows screenshots. If you then change the Article is for: setting in the sidebar to another platform (like Mac OS X), we'll then load the screenshots for that platform.
Screenshots and localization
Knowledge Base articles are written to work without screenshots. Screenshots are a great bonus that make it easier to understand an article but they are not a required part of the article. Obviously, localized screenshots are ideal but if that's not possible, it's perfectly appropriate to remove the English screenshots.
Adding screenshots to articles
Upload the image to the Media Gallery, then use the markup [[Image:xxx]] when you edit the article to add the screenshot, where xxx is the name you gave the image you uploaded.
Using screenshots for different versions of Firefox
How to use "For" tags explains how to show different screenshots for different versions of Firefox.
If the differences in screenshots from one Firefox version to another do not have anything to do with the content of the article, you can continue to show the screenshots from an older Firefox version. For example, a Firefox screenshot of the Options window - Privacy Panel may be missing a Sync icon in Firefox 3.6 but it can still be shown for Firefox 4 if the article has nothing to do with the Sync panel. Similarly, a screenshot of the Settings for privacy, browsing history and do-not-track created in Firefox 4, which does not contain the "Tracking" option, is fine to show for Firefox 5 if the the article has nothing to do with the tracking feature.
Use your best judgement. If it seems like the image for the previous Firefox version will help and not be confusing, then use it.
Other screenshot tools you might find helpful
Windows
- SnagIt (30 day free trial)
- Microsoft Paint (built into Windows)
- Irfanview (Free)
- Paint .NET (Free)
- XNView (Free)
- Gadwin PrintScreen (Free)
Mac
- XNView (Free)
Linux
- XNView (Free)