If you have MadCap Flare installed on your computer and you are generating files for both online and printed output, chances are good that you require different image settings (e.g., gray scale, resolution) for those outputs. In the past, the easiest way to accomplish this task was to create one set of images for the online output and another set for the printed output. However, there is another alternative if you use Capture to create the images for that project. You can single-source your images, producing only one set of images for all outputs. You can specify that the online images should have one group of settings, while the printed images have another group of settings. You can also specify that images that use custom mediums—which might be used for print- or web-based output—have a different group of settings.
Let's say you create a Flare project and you are using Capture to produce images for it. You want to generate two different outputs from that Flare project. Let's say the first output is an online Help system to be placed on a website, and the other output is a PDF document, which you will send to a printer.
When you edit the image properties in Capture, you select a medium from the Medium drop-down to specify the image settings (you may elect not to change any of the default settings). When you select the Web (Default) medium type, you can change the Screen Size or Scale settings to affect how the image will appear on the monitor in your web output. When you select the Print medium type, you can set the image's Print DPI. You can also manually enter print dimensions in the Print Size fields or change the image's Scale.
Note: Although some settings—like Print DPI—are irrelevant for certain medium types, you may want to fill them in regardless of the medium type you choose, just in case you need to use a medium for another type of output.
If you also have custom mediums available in your Flare project, you can choose these options from the Medium drop-down as well. The settings you define for a custom medium can different for those you define for a Print or Web (Default) medium, so you can make changes specific to a medium's layout.
In Flare, you insert the Capture image. When you generate output for the website (e.g., WebHelp), Flare displays the settings you specified for the Web (Default) medium. When you generate the PDF output from the project, Flare displays the settings for the Print medium. When you generate the custom output, Flare displays the settings for the custom medium. However, if the custom medium is unavailable (or if it is disabled in Capture), Flare will use the Web (Default) or Print settings.
This requires a combination of tasks in MadCap Capture, followed by tasks in Flare.
madcap capture tasks
(Optional) One option you have is to use a profile to specify your single-source settings before you capture the image. In the Profiles Editor, use the Format tab and select the Web (Default) medium to enter the appropriate settings for the image when it is displayed in online output. Select the Print medium to enter the appropriate settings for the image when it is used in outputs intended for printed distribution (Adobe FrameMaker, Adobe PDF, Microsoft Word, Microsoft XPS, XHTML). Select a custom medium to enter the appropriate settings for the image when it is displayed in outputs that use a specific custom Flare medium. If necessary, select Enable Format to enable the medium. See About Profiles.
Note: You can enable settings for different mediums (i.e., other than the Web (Default) medium) only if the image in question already exists in a MadCap Flare project.
Capture the image.
Note: You also have the option of initiating the capture from Flare. See Flare's online Help for more information.
(Optional) Another option you have is to specify your single-source settings for each image after you capture them. To do this, double-click the image. In the File Properties dialog, use the Format tab and select the Web (Default) medium to enter the appropriate settings for the image when it is displayed in online output. Select Print medium to enter the appropriate settings for the image when it is used in outputs intended for printed distribution (Adobe FrameMaker, Adobe PDF, Microsoft Word, Microsoft XPS, XHTML). Select a custom medium to enter the appropriate settings for the image when it is displayed in outputs that use a specific custom Flare medium. If necessary, select Enable Format to enable the medium. See Setting Image Properties Using Mediums.
Note: Some settings are available in the File Properties dialog, but not in the Profiles Editor.
- Save the image in the appropriate location in the Flare project folder (usually, Content\Resources\Images).
madcap flare tasks
See Flare's online Help for details about each of the following steps.
- After completing the MadCap Capture tasks above, insert the image into the appropriate topic(s).
- Make sure you develop targets for online and printed outputs.
When you are finished with your project, build the targets.
View the output for the targets.
In the output, notice that the images for online outputs (DotNet Help, Eclipse Help, Microsoft HTML Help, HTML5, WebHelp, WebHelp AIR, WebHelp Mobile, WebHelp Plus) contain the online settings. Meanwhile, the images in the printed outputs (Adobe FrameMaker, Adobe PDF, Microsoft Word, Microsoft XPS, XHTML) contain the printed settings.
Note: Not only can you incorporate the single-source image into Flare, but you can save a standalone version of the image with the print settings applied to it. When you do this, a copy of the image is saved in a folder called "PrintVersions," next to the location where the original image was saved.
Note: If you use the Format tab's Print medium option in MadCap Capture to single-source your images, you may need to take into account the Print DPI (dots per inch) setting that you set for the image in Capture. If you specify a large DPI that is recommended for print output (e.g., 150 DPI), you may notice that the image shrinks when you generate print output. If necessary, you can resize the width and/or height of the image ahead of time in Capture or later in the Flare project to enlarge the image as necessary for the generated output. The DPI that you specify will be retained, and you will end up with the image dimensions that you need. When resizing images in Flare, you also have access to single-sourcing features (i.e., one group of size settings for online output and another group of settings for print output through the use of stylesheet mediums).