File: Adding_Images.xml

package info (click to toggle)
publican 4.3.2-3
  • links: PTS, VCS
  • area: main
  • in suites: bookworm, bullseye, buster
  • size: 18,280 kB
  • sloc: perl: 13,081; xml: 11,558; makefile: 169; sh: 29; python: 29
file content (45 lines) | stat: -rw-r--r-- 2,841 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
<?xml version='1.0' encoding='utf-8' ?>
<!DOCTYPE section [
<!ENTITY % BOOK_ENTITIES SYSTEM "Users_Guide.ent">
%BOOK_ENTITIES;
<!ENTITY % sgml.features "IGNORE">
<!ENTITY % xml.features "INCLUDE">
<!ENTITY % DOCBOOK_ENTS PUBLIC "-//OASIS//ENTITIES DocBook Character Entities V4.5//EN" "/usr/share/xml/docbook/schema/dtd/4.5/dbcentx.mod">
%DOCBOOK_ENTS;
]>
<section conformance="120" version="5.0" xml:id="sect-Publican-Users_Guide-Adding_images" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
	<info>
		<title>Adding images</title>

	</info>
	 <para>
		Store images in the <filename>images</filename> subdirectory in the directory that holds your XML files. Use <computeroutput>./images/<replaceable>image-name</replaceable></computeroutput> to insert images into a book. The following is an example that inserts the <filename>testimage.png</filename> image:
	</para>
	 
<programlisting language="XML">&lt;mediaobject&gt;
&lt;imageobject&gt;
	&lt;imagedata fileref="./images/testimage.png" /&gt;
&lt;/imageobject&gt;
&lt;textobject&gt;&lt;phrase&gt;alternate text goes here&lt;/phrase&gt;&lt;/textobject&gt;
&lt;/mediaobject&gt;</programlisting>
	 <para>
		Ensure that you supply a <tag>&lt;textobject&gt;</tag> so that your content remains accessible to people with visual impairments. In certain jurisdictions, you might have a legal responsibility to provide this accessibility — for example, if you or your organization must comply with Section 508 of the United States <citetitle>Rehabilitation Act of 1973</citetitle>.<footnote> <para>
			Refer to <link xlink:href="http://www.section508.gov/" xmlns:xlink="http://www.w3.org/1999/xlink">http://www.section508.gov/</link>
		</para>
		 </footnote>
	</para>
	 <para>
		If your book contains images that need to be localized — for example, screenshots of a user interface in a language other than the original language of your book — place these images in the <filename>images</filename> subdirectories for each language directory. Make sure that the image file in the translated language has the same name as the image file in the original language. When you build the book in the translated language, <application>Publican</application> uses the file from the <filename>images/</filename> subdirectory of the translated language instead of the file from the <filename>images/</filename> subdirectory of the original language.
	</para>
	 <important>
		<info>
			<title>Image file locations</title>

		</info>
		 <para>
			<application>Publican</application> only uses images in the <filename>images</filename> subdirectory of your XML directory and corresponding images in the <filename>images</filename> subdirectories of your translated languages. Images stored in other directories directories do not work.
		</para>

	</important>
</section>