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
|
<?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="119" version="5.0" xml:id="sect-Publican-Users_Guide-Adding_files" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<info>
<title>Adding files</title>
</info>
<para>
<application>Publican</application> allows you to include arbitrary files together with your documents. These files are included in RPM packages that you build with <application>Publican</application> and are installed on users' systems alongside the document itself. For example, you might want to include multimedia files of tutorials that complement the document, or sample files of source code or other materials that allow users to work through the examples or tutorials in a document.
</para>
<para>
To ship arbitrary files with a document, create a directory named <filename>files</filename> in the language directory for the original language (e.g. <literal>en-US</literal>) of the book (e.g. <filename>My_Book</filename>).
</para>
<para>
In the directory <filename>My_Book</filename>:
</para>
<screen><prompt>$</prompt> <command>mkdir en-US/files</command></screen>
<para>
Copy the files to the directory <filename>files</filename>:
</para>
<screen><prompt>$</prompt> <command>cp arbitrary_files en-US/files</command></screen>
</section>
|
