2
# AUTHOR <EMAIL@ADDRESS>, YEAR.
6
"Project-Id-Version: 0\n"
7
"POT-Creation-Date: 2009-08-03T00:24:46\n"
8
"PO-Revision-Date: 2009-08-03T00:24:46\n"
9
"Last-Translator: Automatically generated\n"
10
"Language-Team: None\n"
12
"Content-Type: application/x-publican; charset=UTF-8\n"
13
"Content-Transfer-Encoding: 8bit\n"
17
msgid "Conditional Tagging"
22
msgid "In some cases you may need to maintain multiple versions of a book; for example, a HOWTO guide for product FOO can have an upstream version and an enterprise version, with very subtle differences between them."
27
msgid "Publican makes it easy to manage differences between multiple versions of a book by allowing you to simply use one source for all versions. <firstterm>Conditional tagging</firstterm> allows you to make sure that version-specific content only appears in the correct version; i.e. "conditionalizing content"."
32
msgid "To conditionalize content in a book, use the tag attribute <command>condition</command>. For example, let's say the book <citetitle>How To Use Product Foo</citetitle> has an "upstream", "enterprise", and "beta" version:"
37
msgid "To build a specific version (thereby capturing all content conditionalized for that version), use <command>make</command> parameter <command>CONDITION="<replaceable>version</replaceable>" <replaceable>format</replaceable></command>. Using the same example for the book <citetitle>How To Use Product Foo</citetitle>, you can build the "upstream" version of the book in pdf using:"
42
msgid "This will capture all tags that use <command>condition="upstream"</command> and build <citetitle>How To Use Product Foo</citetitle> in PDF format."
52
msgid "You can conditionalize content as per the <command>BRAND</command> setting. To do so, add the following line to <filename>Makefile</filename>:"
57
msgid "In this manner, <command>make CONDITION="brand1" pdf-en-US</command> will build the book in PDF <emphasis>and</emphasis> capture all tags that use the <command>condition="brand1"</command> attribute."
62
msgid "Further, if an <command><xref></command> points to content that is not going to be included in the build due to conditional tagging, the build will fail. For example, <command>make CONDITION="upstream" pdf-en-US</command> will fail if the book has the tag <command><xref linkend="betasection"</command> pointing to <command><section id="betasection" CONDITION="beta"></command>."