Changeset 3348
- Timestamp:
- May 16, 2007, 2:36:19 PM (16 years ago)
- Location:
- trunk/doc/src/docbook
- Files:
-
- 2 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/doc/src/docbook/developerdoc/write_docbook_doc.xml
r3306 r3348 897 897 <imageobject> 898 898 <imagedata 899 contentwidth="7cm"900 width=" 7cm"899 scalefit="1" 900 width="100%" 901 901 fileref="figures/menuchoice.png" format="PNG" 902 902 /> … … 932 932 Images and figures are normally implemented like the following example. The 933 933 image-file must be located in 934 <filename class="directory">doc/src/docbook/figures</filename> 935 ,otherwise the image won't be visible in the generated output files.934 <filename class="directory">doc/src/docbook/figures</filename>, 935 otherwise the image won't be visible in the generated output files. 936 936 </para> 937 937 <warning> 938 938 <para> 939 Images in the pdf-output are, unlike images in html-output, not scaled and can 940 therefore be out of proportion in the document. Avoid this by e.g. setting the 941 attributes 942 <sgmltag class="attribute">contentwidth</sgmltag> 943 and 944 <sgmltag class="attribute">width</sgmltag> 945 in 946 <sgmltag>imagedata</sgmltag> 947 to appropriate values. 939 When using images in docbook you will always have problems with scaling. 940 Since we are generating output for both HTML and PDF it is even worse. 941 What we have found to work is this: 942 943 <itemizedlist> 944 <listitem> 945 <para> 946 Scaling in HTML has been disabled. The images will always be the 947 same size as they actually are. Please, don't make the screenshots 948 too wide! 949 </para> 950 </listitem> 951 952 <listitem> 953 <para> 954 For small images, less than the width of the PDF page, 955 do not specify scaling factors or widths. We have configured PDF to 956 use 96dpi instead of 72dpi, so the images will appear almost 957 exactly as they do in the HTML version. 958 </para> 959 </listitem> 960 961 <listitem> 962 <para> 963 Images that are wider than the PDF page will be clipped. To 964 prevent this you must add the following attributes to the 965 <sgmltag class="starttag">imagedata</sgmltag> tag: 966 <code>scalefit="1" width="100%"</code> 967 </para> 968 </listitem> 969 970 <listitem> 971 <para> 972 If you still need to scale the image differently in the PDF use 973 the <sgmltag>width</sgmltag> and <sgmltag>depth</sgmltag> 974 attributes. 975 </para> 976 </listitem> 977 </itemizedlist> 948 978 </para> 949 979 </warning> … … 951 981 <title>Screen-shot in the documentation</title> 952 982 <para> 953 <xref linkend="w rite_docbook_doc.figures.menuchoice" />983 <xref linkend="webclient.figures.homepage" /> 954 984 is implemented with the following code 955 985 </para> 956 986 <programlisting> 957 987 <figure id="write_docbook_doc.figures.menuchoice"> 958 <title>Menu choice</title>959 960 961 962 963 contentwidth="7cm" 964 width="7cm" 965 fileref="figures/menuchoice.png" format="PNG"966 967 968 969 988 <title>The home page</title> 989 <screenshot> 990 <mediaobject> 991 <imageobject> 992 <imagedata 993 scalefit="1" 994 width="100%" 995 fileref="figures/homapage.png" format="PNG" 996 /> 997 </imageobject> 998 </mediaobject> 999 </screenshot> 970 1000 </figure> 971 1001 </programlisting> -
trunk/doc/src/docbook/userdoc/webclient.xml
r3346 r3348 107 107 <mediaobject> 108 108 <imageobject><imagedata fileref="figures/homepage.png" format="PNG" 109 scalefit="1" width="100%" contentdepth="100%"/></imageobject>109 scalefit="1" width="100%"/></imageobject> 110 110 </mediaobject> 111 111 </screenshot> … … 204 204 <inlinemediaobject> 205 205 <imageobject><imagedata fileref="figures/refresh.gif" format="GIF" align="left" 206 scalefit="1" width="100%" contentwidth="100%"/></imageobject>206 /></imageobject> 207 207 </inlinemediaobject> 208 208 Refresh page … … 1012 1012 <imageobject> 1013 1013 <imagedata fileref="figures/set_permissions.png" format="PNG" 1014 scalefit="1" width="100%" contentdepth="100%"/>1014 scalefit="1" width="100%" /> 1015 1015 </imageobject> 1016 1016 </mediaobject> … … 1193 1193 <mediaobject> 1194 1194 <imageobject><imagedata fileref="figures/listpage.png" format="PNG" 1195 scalefit="1" width="100%" contentdepth="100%"/></imageobject>1195 scalefit="1" width="100%" /></imageobject> 1196 1196 </mediaobject> 1197 1197 </screenshot> … … 1369 1369 <mediaobject> 1370 1370 <imageobject> 1371 <imagedata contentwidth="10cm" width="10cm"fileref="figures/configure_columns.png" format="PNG"/>1371 <imagedata fileref="figures/configure_columns.png" format="PNG"/> 1372 1372 </imageobject> 1373 1373 </mediaobject> … … 1571 1571 <screenshot> 1572 1572 <mediaobject> 1573 <imageobject><imagedata contentwidth="10cm" width="10cm"fileref="figures/save_preset.png" format="PNG" /></imageobject>1573 <imageobject><imagedata fileref="figures/save_preset.png" format="PNG" /></imageobject> 1574 1574 </mediaobject> 1575 1575 </screenshot> … … 1641 1641 <screenshot> 1642 1642 <mediaobject> 1643 <imageobject><imagedata contentwidth="7cm" width="7cm"fileref="figures/manage_presets.png" format="PNG" /></imageobject>1643 <imageobject><imagedata fileref="figures/manage_presets.png" format="PNG" /></imageobject> 1644 1644 </mediaobject> 1645 1645 </screenshot>
Note: See TracChangeset
for help on using the changeset viewer.