Difference between revisions of "Publishing and Linking Thumbnail Graphics"
| Line 3: | Line 3: | ||
It turned out that this capability was already there. It simply needed documenting, so here goes. The steps are straightforward, and assume that the committee has a large diagram that they wish to include by "thumbnail": | It turned out that this capability was already there. It simply needed documenting, so here goes. The steps are straightforward, and assume that the committee has a large diagram that they wish to include by "thumbnail": | ||
| + | ==Creating the thumbnail and Identifying the graphics== | ||
# Assuming that you are starting with a ''gif'' file, give it an arifact name in your domain. An example id in another domain might be "''REAL_NA000020.gif''". | # Assuming that you are starting with a ''gif'' file, give it an arifact name in your domain. An example id in another domain might be "''REAL_NA000020.gif''". | ||
# Use a graphics editor to create a "thumbnail". Any editor that reduces the number of pixels in the ''gif'' file will do. The author uses Visio. Starting with the large diagram: | # Use a graphics editor to create a "thumbnail". Any editor that reduces the number of pixels in the ''gif'' file will do. The author uses Visio. Starting with the large diagram: | ||
| Line 8: | Line 9: | ||
## select the Visio File...Save as capabilty; | ## select the Visio File...Save as capabilty; | ||
## select to output as ''gif''; | ## select to output as ''gif''; | ||
| − | ## select a name that is the same as assigned above, but with "''T-''" prepended, such as "''T-REAL_NA000020.gif | + | ## select a name that is the same as assigned above, but with "''T-''" prepended, such as "''T-REAL_NA000020.gif''" |
## Under "''Resolution''" on the final panel, select "''Screen''" which is 96 pixels/in. | ## Under "''Resolution''" on the final panel, select "''Screen''" which is 96 pixels/in. | ||
## save the thumbnail | ## save the thumbnail | ||
# Note that 300 pixels wide is what HL7 is using for RMIM designer graphics, but there is '''no hard and fast rule on width'''. They should not exceed 500 pixels, but anything smaller is OK. | # Note that 300 pixels wide is what HL7 is using for RMIM designer graphics, but there is '''no hard and fast rule on width'''. They should not exceed 500 pixels, but anything smaller is OK. | ||
| + | |||
| + | ==Using the thumbnail in PubDb== | ||
| + | In your PubDb document, the thumbnail is used as the attribute value of the "''source''" attribute in a ''<graphic/>'' element. Be sure to '''use the thumbnail identifier''' in this reference, such as "''T-REAL_NA000020.gif''". The value of the "''alt''" attribute of this element will not be rendered and can be left empty. | ||
| + | |||
| + | Note that the ''<graphic/>'' must be inside a paragraph ''<p/>'' element. You can either make this the only content of the paragraph, or add text. See the example provided for the impact of text upon the left-to-right positioning of the thumbnail. | ||
| + | |||
| + | ==Example== | ||
Revision as of 19:31, 1 November 2006
The Publishing Committee created an action item to create thumbnail-large diagram capability in publishing documents. This method is above and beyond the implementation of thumbnails for publishing RMIMs. This has been accomplished, and is documented here.
It turned out that this capability was already there. It simply needed documenting, so here goes. The steps are straightforward, and assume that the committee has a large diagram that they wish to include by "thumbnail":
Creating the thumbnail and Identifying the graphics
- Assuming that you are starting with a gif file, give it an arifact name in your domain. An example id in another domain might be "REAL_NA000020.gif".
- Use a graphics editor to create a "thumbnail". Any editor that reduces the number of pixels in the gif file will do. The author uses Visio. Starting with the large diagram:
- scale the diagram down to about 3-inches wide;
- select the Visio File...Save as capabilty;
- select to output as gif;
- select a name that is the same as assigned above, but with "T-" prepended, such as "T-REAL_NA000020.gif"
- Under "Resolution" on the final panel, select "Screen" which is 96 pixels/in.
- save the thumbnail
- Note that 300 pixels wide is what HL7 is using for RMIM designer graphics, but there is no hard and fast rule on width. They should not exceed 500 pixels, but anything smaller is OK.
Using the thumbnail in PubDb
In your PubDb document, the thumbnail is used as the attribute value of the "source" attribute in a <graphic/> element. Be sure to use the thumbnail identifier in this reference, such as "T-REAL_NA000020.gif". The value of the "alt" attribute of this element will not be rendered and can be left empty.
Note that the <graphic/> must be inside a paragraph
element. You can either make this the only content of the paragraph, or add text. See the example provided for the impact of text upon the left-to-right positioning of the thumbnail.
