Blame Automation/Manuals/centos-art.sh-render.asciidoc.pot

Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
"Project-Id-Version: PACKAGE VERSION\n"
Alain Reguera Delgado 65f472
"POT-Creation-Date: 2013-08-06 01:36-0400\n"
Alain Reguera Delgado 4e7926
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
Alain Reguera Delgado 4e7926
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
Alain Reguera Delgado 4e7926
"Language-Team: LANGUAGE <LL@li.org>\n"
Alain Reguera Delgado 4e7926
"MIME-Version: 1.0\n"
Alain Reguera Delgado 4e7926
"Content-Type: text/plain; charset=UTF-8\n"
Alain Reguera Delgado 4e7926
"Content-Transfer-Encoding: 8bit\n"
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "centos-art.sh-render"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "1"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Standardize production tasks based on configuration files."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "centos-art.sh render [OPTIONS] [DIRECTORY …]"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Description"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When you execute the <emphasis role=\"strong\">render</emphasis> "
Alain Reguera Delgado 4e7926
"module, it looks for configuration files inside the “DIRECTORY” "
Alain Reguera Delgado 4e7926
"specified in the command-line and processes them in the order they "
Alain Reguera Delgado 4e7926
"were found. When no “DIRECTORY” is specified to 
Alain Reguera Delgado 4e7926
"\"strong\">centos-art.sh</emphasis> script, the 
Alain Reguera Delgado 4e7926
"\"strong\">render</emphasis> module looks for configuration files "
Alain Reguera Delgado 4e7926
"inside the current directory it was executed from. If no "
Alain Reguera Delgado 4e7926
"configuration file is found, the <emphasis role=\"strong\">render</"
Alain Reguera Delgado 4e7926
"emphasis> module will end its execution with an error message."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Options"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"The <emphasis role=\"strong\">render</emphasis> module accepts the "
Alain Reguera Delgado 4e7926
"following options:"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "--help"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"This option shows the <emphasis role=\"strong\">render</emphasis> "
Alain Reguera Delgado 4e7926
"module's documentation (this page)."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "--version"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"This option shows the <emphasis role=\"strong\">render</emphasis> "
Alain Reguera Delgado 4e7926
"module's name and version."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "--filter=\"REGEX\""
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"This option reduces the number of section blocks inside "
Alain Reguera Delgado 4e7926
"configuration files the <emphasis role=\"strong\">render</emphasis> "
Alain Reguera Delgado 4e7926
"module will take for processing. “REGEX” is a regular expression "
Alain Reguera Delgado 4e7926
"pattern matching one or more section names inside the configuration "
Alain Reguera Delgado 4e7926
"files found under “DIRECTORY”."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Configuration Files"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"The configuration files are regular files with the <literal>.conf</"
Alain Reguera Delgado 4e7926
"literal> extension. The name of configuration files is frequently "
Alain Reguera Delgado 4e7926
"chosen for helping you to remember what the configuration files are "
Alain Reguera Delgado 4e7926
"for and, in some cases, for producing section blocks in specific "
Alain Reguera Delgado 4e7926
"order."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"The format used in configuration files use section blocks in the "
Alain Reguera Delgado 4e7926
"form <literal>[section-name]</literal>. Each section block ends "
Alain Reguera Delgado 4e7926
"when the next section block begins or at the end of the file. "
Alain Reguera Delgado 4e7926
"Section blocks contain one or more variable definitions in the form "
Alain Reguera Delgado 4e7926
"<literal>option = \"value\"</literal>. In the specific case of "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">render</emphasis> module, the "
Alain Reguera Delgado 4e7926
"<literal>section-name</literal> is an alphanumeric value and points "
Alain Reguera Delgado 4e7926
"to the final file or directory you want to save the processing "
Alain Reguera Delgado 4e7926
"results in. The configuration variables describe how to produce the "
Alain Reguera Delgado 4e7926
"file or directory specified as <literal>section-name</literal>. "
Alain Reguera Delgado 4e7926
"Name values in the <literal>section-name</literal> don't accept "
Alain Reguera Delgado 4e7926
"variables or any kind of expansion in it, but configuration values "
Alain Reguera Delgado 4e7926
"do. Commentaries are introduced by using the <literal>#</literal> "
Alain Reguera Delgado 4e7926
"character at the beginning of lines. Commentaries defined this way "
Alain Reguera Delgado 4e7926
"are excluded from processing so you can use them freely."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"The configuration files are processed from top to bottom. This is a "
Alain Reguera Delgado 4e7926
"very important aspect to consider in situations where you need to "
Alain Reguera Delgado 4e7926
"grantee specific priority for content production (e.g., you have "
Alain Reguera Delgado 4e7926
"several files in a configuration file and need to produce some of "
Alain Reguera Delgado 4e7926
"them before others). So, because configuration files are processed "
Alain Reguera Delgado 4e7926
"from top to bottom, section blocks set first in the configuration "
Alain Reguera Delgado 4e7926
"file are processed first and section blocks set later are processed "
Alain Reguera Delgado 4e7926
"later."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"The configuration files can be divided in separated configuration "
Alain Reguera Delgado 4e7926
"files to produce specific section blocks with a given priority. For "
Alain Reguera Delgado 4e7926
"example, if you have the file “render.conf”, you can divide its "
Alain Reguera Delgado 4e7926
"content in “render-1.conf”, “render-2.conf” to produce section "
Alain Reguera Delgado 4e7926
"blocks inside “render-1.conf” first and “render-2.conf” later. This "
Alain Reguera Delgado 4e7926
"sort of division might be very useful when the configuration file "
Alain Reguera Delgado 4e7926
"begins to grow, or you want to control the order in which specific "
Alain Reguera Delgado 4e7926
"groups of files are produced inside “DIRECTORY”."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Inside configuration files, configuration variables can take "
Alain Reguera Delgado 4e7926
"different meanings based on the section contexts. The context of a "
Alain Reguera Delgado 4e7926
"section block is defined by the <emphasis role=\"strong\">render-"
Alain Reguera Delgado 4e7926
"type</emphasis> variables."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "render-type"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable specifies the type of content rendition the "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">render</emphasis> module will perform. "
Alain Reguera Delgado 4e7926
"This variable can take one of the following values: “archive”, "
Alain Reguera Delgado 4e7926
"“asciidoc”, “compress”, “images”, “palette”, and “svg”. When this "
Alain Reguera Delgado 4e7926
"variable is not set, the <emphasis role=\"strong\">render</"
Alain Reguera Delgado 4e7926
"emphasis> module tries to determine the type of rendition based on "
Alain Reguera Delgado 4e7926
"the file extension of the first file passed through 
Alain Reguera Delgado 4e7926
"\"strong\">render-from</emphasis> variable. If no valid value is "
Alain Reguera Delgado 4e7926
"found there either, the <emphasis role=\"strong\">render</emphasis> "
Alain Reguera Delgado 4e7926
"module ends with an error message."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "render-from"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Required. This variable specifies the file name of the source file "
Alain Reguera Delgado 4e7926
"(design model) used to produce the final file specified in the "
Alain Reguera Delgado 4e7926
"section line. This option can receive absolute paths and relative "
Alain Reguera Delgado 4e7926
"paths. Absolute paths begin with a slash (“/”) character while "
Alain Reguera Delgado 4e7926
"relative paths begin with the dot slash (“./”) characters or no "
Alain Reguera Delgado 4e7926
"character at all. This variable can receive more than one value by "
Alain Reguera Delgado 4e7926
"using either path expansion in one variable definition, or several "
Alain Reguera Delgado 4e7926
"variables definitions."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Using Paths"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When you provide absolute paths inside configuration files, there "
Alain Reguera Delgado 4e7926
"isn't confusion about the location where the file is or should be. "
Alain Reguera Delgado 4e7926
"However, it introduces rigidity to directory structures inside the "
Alain Reguera Delgado 4e7926
"working copy when it is necessary to move directories from one "
Alain Reguera Delgado 4e7926
"place to another inside the working copy. To eliminate this "
Alain Reguera Delgado 4e7926
"mobility restrictions, relative paths can be used to create modular "
Alain Reguera Delgado 4e7926
"directory structures."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When you use relative paths inside configuration files, paths are "
Alain Reguera Delgado 4e7926
"relative to the location where the configuration file is stored in. "
Alain Reguera Delgado 4e7926
"This way it is possible to move whole directory structures without "
Alain Reguera Delgado 4e7926
"touching the configuration file and still have a render-able "
Alain Reguera Delgado 4e7926
"structures inside the working copy. However, relative paths get "
Alain Reguera Delgado 4e7926
"limited in situations where the production process needs files "
Alain Reguera Delgado 4e7926
"outside the directory where the configuration file is stored in. In "
Alain Reguera Delgado 4e7926
"such cases, a combination of relative and absolute paths is the "
Alain Reguera Delgado 4e7926
"solution to apply."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When we need to use absolute paths to several files in the same "
Alain Reguera Delgado 4e7926
"directory (e.g., we are combining them all to produce a new image) "
Alain Reguera Delgado 4e7926
"but outside the current directory the configuration file is stored "
Alain Reguera Delgado 4e7926
"in, it is possible to use a list of absolute paths one beside "
Alain Reguera Delgado 4e7926
"another separated by space or we can use path expansion which is "
Alain Reguera Delgado 4e7926
"shorter and easier to read. Path expansion is interpreted when you "
Alain Reguera Delgado 4e7926
"enclose a list of file names in curly brackets using comma as "
Alain Reguera Delgado 4e7926
"separator without spaces (e.g., <literal>/some/dir/{file1,file2,"
Alain Reguera Delgado 4e7926
"file3}</literal>). In order for path expansion to work correctly, "
Alain Reguera Delgado 4e7926
"all the file names you put inside the curly brackets' list must "
Alain Reguera Delgado 4e7926
"exist in the location specified first."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Using Environment Variables"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"The configuration files let you to use environment variables inside "
Alain Reguera Delgado 4e7926
"them. This might result very useful when you need to provide "
Alain Reguera Delgado 4e7926
"absolute paths based on variable information (e.g., the current "
Alain Reguera Delgado 4e7926
"locale information). Some of the most important environment "
Alain Reguera Delgado 4e7926
"variables used by <emphasis role=\"strong\">centos-art.sh</"
Alain Reguera Delgado 4e7926
"emphasis> script -and its configuration files- are described below:"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "TCAR_BASEDIR"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"This variable contains the absolute path to your repository's "
Alain Reguera Delgado 4e7926
"working copy. The value of this variable is defined as read-only "
Alain Reguera Delgado 4e7926
"inside <emphasis role=\"strong\">centos-art.sh</emphasis> script "
Alain Reguera Delgado 4e7926
"and cannot be modified later. As a matter of convenience, users "
Alain Reguera Delgado 4e7926
"make use of their “~/.bash_profile” file to define this variable "
Alain Reguera Delgado 4e7926
"there and, this way, skip the sometimes annoyance absolute path "
Alain Reguera Delgado 4e7926
"questioning the <emphasis role=\"strong\">centos-art.sh</emphasis> "
Alain Reguera Delgado 4e7926
"script does in order to know the absolute path of the working copy "
Alain Reguera Delgado 4e7926
"it is going to work with."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Whenever you set absolute paths inside configuration files to refer "
Alain Reguera Delgado 4e7926
"locations inside your working copy, it is necessary that you use "
Alain Reguera Delgado 4e7926
"the <literal>TCAR_BASEDIR</literal> environment variable in front "
Alain Reguera Delgado 4e7926
"of each path definition you set. <literal>TCAR_SCRIPT_LANG_LL</"
Alain Reguera Delgado 4e7926
"literal>:: This variable contains the language part of the current "
Alain Reguera Delgado 4e7926
"locale information. For instance, if the current locale is “en_US."
Alain Reguera Delgado 4e7926
"UTF-8”, the value of this variable would be “en”. "
Alain Reguera Delgado 4e7926
"<literal>TCAR_SCRIPT_LANG_CC</literal>:: This variable contains the "
Alain Reguera Delgado 4e7926
"country part of the current locale information. For instance, if "
Alain Reguera Delgado 4e7926
"the current locale is “en_US.UTF-8”, the value of this variable "
Alain Reguera Delgado 4e7926
"would be “US”. <literal>TCAR_SCRIPT_LANG_LC</literal>:: This "
Alain Reguera Delgado 4e7926
"variable contains the current locale information in ll_CC format (e."
Alain Reguera Delgado 4e7926
"g., es_ES). <literal>LANG</literal>:: This variable contains the "
Alain Reguera Delgado 4e7926
"environment's current locale information."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Rendering Archives"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">render-type</emphasis> variable "
Alain Reguera Delgado 4e7926
"is set to <literal>archive</literal>, the 
Alain Reguera Delgado 4e7926
"\">render</emphasis> module takes the list of files set through "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">render-from</emphasis> variable and "
Alain Reguera Delgado 4e7926
"applies the value of <emphasis role=\"strong\">command</emphasis> "
Alain Reguera Delgado 4e7926
"to them all in order to produce the final file specified in the "
Alain Reguera Delgado 4e7926
"section line. When the command variable is not specified, the "
Alain Reguera Delgado 4e7926
"<literal>/bin/tar --remove-files -czf</literal> command is used as "
Alain Reguera Delgado 4e7926
"default."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Rendering Image Files"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">render-type</emphasis> variable "
Alain Reguera Delgado 4e7926
"is set to <literal>svg</literal>, the section block is interpreted "
Alain Reguera Delgado 4e7926
"for rendering image files. When rendering image files, the "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">render-from</emphasis> variable must "
Alain Reguera Delgado 4e7926
"point to a SVG files (either compressed or uncompressed). The "
Alain Reguera Delgado 4e7926
"following following complementary variables are also accepted:"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "render-flow"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable specifies the rendition flow to follow when "
Alain Reguera Delgado 4e7926
"transforming SVG files into PNG images. This variable can take "
Alain Reguera Delgado 4e7926
"either <literal>base</literal> or <literal>extended</literal> as "
Alain Reguera Delgado 4e7926
"value. The <literal>base</literal> rendition flow takes one SVG "
Alain Reguera Delgado 4e7926
"file and produces just one PNG image for it. The <literal>extended</"
Alain Reguera Delgado 4e7926
"literal> value applies the <literal>base</literal> rendition flow "
Alain Reguera Delgado 4e7926
"and then transform the final PNG image to different heights, "
Alain Reguera Delgado 4e7926
"formats, foreground colors and background colors. By default, when "
Alain Reguera Delgado 4e7926
"this variable is not set, the <literal>base</literal> rendition "
Alain Reguera Delgado 4e7926
"flow is used."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "export-id"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable specifies the export id you want to use as "
Alain Reguera Delgado 4e7926
"reference to produce PNG images from SVG files. The export-id is an "
Alain Reguera Delgado 4e7926
"attribute you specified as unique value to an objects inside the "
Alain Reguera Delgado 4e7926
"SVG file in order to export that object only but not the rest in "
Alain Reguera Delgado 4e7926
"the SVG file. If this variable is not provided or it is empty, the "
Alain Reguera Delgado 4e7926
"drawing area of the SVG file is used as reference to produce the "
Alain Reguera Delgado 4e7926
"final PNG image."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "heights"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable is available only for <literal>extended</"
Alain Reguera Delgado 4e7926
"literal> rendition flow and specifies the different image heights "
Alain Reguera Delgado 4e7926
"you want to create copies of the final PNG image. The values "
Alain Reguera Delgado 4e7926
"specified in this variable are separated by white space and should "
Alain Reguera Delgado 4e7926
"be understandable by ImageMagick tool set. When this variable is "
Alain Reguera Delgado 4e7926
"not provided, the <emphasis role=\"strong\">render</emphasis> "
Alain Reguera Delgado 4e7926
"module will create copies of final PNG image for several standard "
Alain Reguera Delgado 4e7926
"heights."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "formats"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable is available only for <literal>extended</"
Alain Reguera Delgado 4e7926
"literal> rendition flow and specifies the different image formats "
Alain Reguera Delgado 4e7926
"you want to create copies of the final PNG image. The values "
Alain Reguera Delgado 4e7926
"specified in this variable are separated by white space and should "
Alain Reguera Delgado 4e7926
"be supported by ImageMagick tool set. When this variable is not "
Alain Reguera Delgado 4e7926
"provided or set in the configuration file, the 
Alain Reguera Delgado 4e7926
"\"strong\">render</emphasis> module will create copies of final PNG "
Alain Reguera Delgado 4e7926
"image for several standard formats."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"To see the list of possible image formats supported by ImageMagick "
Alain Reguera Delgado 4e7926
"tool set, run the following command: 
Alain Reguera Delgado 4e7926
"\"><literal>identify -list format</literal></emphasis>."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "fgcolors"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable is available only for <literal>extended</"
Alain Reguera Delgado 4e7926
"literal> rendition flow and specifies the different foreground "
Alain Reguera Delgado 4e7926
"colors you want to create copies of the final PNG image. To do "
Alain Reguera Delgado 4e7926
"this, the image you want to copy should be rendered with black "
Alain Reguera Delgado 4e7926
"color (000000) so the color replacement can be performed. The "
Alain Reguera Delgado 4e7926
"values specified in this variable are separated by white space and "
Alain Reguera Delgado 4e7926
"should be understandable by ImageMagick tool set. When this "
Alain Reguera Delgado 4e7926
"variable is not provided the black foreground (<literal>000000</"
Alain Reguera Delgado 4e7926
"literal>) is used."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "bgcolors"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable is available only for <literal>extended</"
Alain Reguera Delgado 4e7926
"literal> rendition flow and specifies the different background "
Alain Reguera Delgado 4e7926
"colors you want to create copies of the final PNG image. This "
Alain Reguera Delgado 4e7926
"variable uses Inkscape's <emphasis>--export-background</emphasis> "
Alain Reguera Delgado 4e7926
"and <emphasis>--export-background-opacity</emphasis> options to "
Alain Reguera Delgado 4e7926
"control the background information of final PNG images. Possible "
Alain Reguera Delgado 4e7926
"values to this variable take the form <literal>XXXXXX-X</literal>, "
Alain Reguera Delgado 4e7926
"where the first six <literal>X</literal> represent a color in "
Alain Reguera Delgado 4e7926
"hexadecimal format and the final <literal>X</literal> might be 1 or "
Alain Reguera Delgado 4e7926
"0. 1 for full opacity and 0 for full transparency. Intermediate "
Alain Reguera Delgado 4e7926
"values between 0 and 1 (e.g., 0.55) can be given to control the "
Alain Reguera Delgado 4e7926
"background opacity. When this variable is not provided, white "
Alain Reguera Delgado 4e7926
"background full transparency (<literal>ffffff-0</literal>) is used "
Alain Reguera Delgado 4e7926
"as default value."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "command"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable specifies the command used to modify the "
Alain Reguera Delgado 4e7926
"production of final images. During the rendition process, images "
Alain Reguera Delgado 4e7926
"are produced inside a temporal directory, and later moved to its "
Alain Reguera Delgado 4e7926
"final location using the command specified as value in this "
Alain Reguera Delgado 4e7926
"variable. When this variable is not specified, it can take one of "
Alain Reguera Delgado 4e7926
"two values based on the amount of files passed through 
Alain Reguera Delgado 4e7926
"role=\"strong\">render-from</emphasis> variable. When just one file "
Alain Reguera Delgado 4e7926
"is passed through the <emphasis role=\"strong\">render-from</"
Alain Reguera Delgado 4e7926
"emphasis> variable, the default value for this variable is "
Alain Reguera Delgado 4e7926
"<literal>/bin/cp</literal>, but when there are reference to more "
Alain Reguera Delgado 4e7926
"than one file, the value of this option is <literal>/usr/bin/"
Alain Reguera Delgado 4e7926
"convert +append</literal> which combines all images into the final "
Alain Reguera Delgado 4e7926
"images."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "comment"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable contains a sentence describing the image "
Alain Reguera Delgado 4e7926
"you are creating. This information is written in the "
Alain Reguera Delgado 4e7926
"<literal>comment</literal> field of PNG images. When this variable "
Alain Reguera Delgado 4e7926
"is empty, no comment information will be written to the final PNG "
Alain Reguera Delgado 4e7926
"image files."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "brand"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Optional. This variable describes the branding information applied "
Alain Reguera Delgado 4e7926
"to final images. The value of this variable has the form "
Alain Reguera Delgado 4e7926
"<literal>FILENAME:GEOMETRY</literal>, where <literal>FILENAME</"
Alain Reguera Delgado 4e7926
"literal> is the absolute path to the PNG image you want to apply as "
Alain Reguera Delgado 4e7926
"brand and, <literal>GEOMETRY</literal> takes the form "
Alain Reguera Delgado 4e7926
"<literal>xHEIGHT+X+Y</literal>. In order to apply brand information "
Alain Reguera Delgado 4e7926
"to final images correctly, the brand images files you want to apply "
Alain Reguera Delgado 4e7926
"must be available. In case they don't exist the 
Alain Reguera Delgado 4e7926
"\"strong\">render</emphasis> module ends its execution with an "
Alain Reguera Delgado 4e7926
"error message."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Rendering Image Files From Other Image Files"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"To render image files from other image files, the 
Alain Reguera Delgado 4e7926
"\"strong\">render-type</emphasis> variable must be set to “images” "
Alain Reguera Delgado 4e7926
"and one or more image files must be provided in the 
Alain Reguera Delgado 4e7926
"\"strong\">render-from</emphasis> variable. When the 
Alain Reguera Delgado 4e7926
"\"strong\">render</emphasis> module finds a section block with this "
Alain Reguera Delgado 4e7926
"characteristics, it applies the value of 
Alain Reguera Delgado 4e7926
"\">command</emphasis> variable to all files found in 
Alain Reguera Delgado 4e7926
"\"strong\">render-from</emphasis> variable to produce the final "
Alain Reguera Delgado 4e7926
"file specified in the section name."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">command</emphasis> variable is "
Alain Reguera Delgado 4e7926
"not specified, the “/usr/bin/convert -append” command is used as "
Alain Reguera Delgado 4e7926
"default. This command takes all the images passed through 
Alain Reguera Delgado 4e7926
"role=\"strong\">render-from</emphasis> and appends them from top to "
Alain Reguera Delgado 4e7926
"bottom and saves the result in the file you specified in the "
Alain Reguera Delgado 4e7926
"section name. When you render files this way, the order in which "
Alain Reguera Delgado 4e7926
"you define source files through <emphasis role=\"strong\">render-"
Alain Reguera Delgado 4e7926
"from</emphasis> may affect the final result based in the 
Alain Reguera Delgado 4e7926
"role=\"strong\">command</emphasis> you provided."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"The “images” rendition type provides an interface for external "
Alain Reguera Delgado 4e7926
"image manipulation programs, like ImageMagick and NetPbm. You can "
Alain Reguera Delgado 4e7926
"use these programs to manipulate images in great detail through the "
Alain Reguera Delgado 4e7926
"command-line."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Rendering Images With Reduced Number Of Colors"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">render-type</emphasis> variable "
Alain Reguera Delgado 4e7926
"is set to <literal>palette</literal>, the section block where this "
Alain Reguera Delgado 4e7926
"variable was defined is interpreted for producing images with a "
Alain Reguera Delgado 4e7926
"reduced number of colors. In these cases, the 
Alain Reguera Delgado 4e7926
"\"strong\">render-from</emphasis> variable must point to an image "
Alain Reguera Delgado 4e7926
"file. The following complementary variables are also accepted:"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "palette-gpl"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Required. This variable addresses the palette of colors that will "
Alain Reguera Delgado 4e7926
"be use for reducing colors. Generally, the palette of color file "
Alain Reguera Delgado 4e7926
"ends with the <literal>.gpl</literal> extension and is stored in "
Alain Reguera Delgado 4e7926
"the same directory of the configuration file. This file can be "
Alain Reguera Delgado 4e7926
"produced by GIMP and provides an optimized set of colors for the "
Alain Reguera Delgado 4e7926
"specific image you provided in the <emphasis role=\"strong\">render-"
Alain Reguera Delgado 4e7926
"from</emphasis> variable."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"To find the optimized set of colors, you need to open the image "
Alain Reguera Delgado 4e7926
"specified in <emphasis role=\"strong\">render-from</emphasis> in "
Alain Reguera Delgado 4e7926
"GIMP, reduce its colors to the desired number using GIMP's Indexed "
Alain Reguera Delgado 4e7926
"feature and, then, create a new palette by importing it from the "
Alain Reguera Delgado 4e7926
"indexed image file. Once you have the palette this way, you need to "
Alain Reguera Delgado 4e7926
"edit it using the Palettes dialog to add the hexadecimal value of "
Alain Reguera Delgado 4e7926
"each color in the palette to the comment field, so you have a "
Alain Reguera Delgado 4e7926
"palette file similar to the following:"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
#, no-wrap
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"GIMP Palette\n"
Alain Reguera Delgado 4e7926
"Name: Syslinux-Default\n"
Alain Reguera Delgado 4e7926
"Columns: 16\n"
Alain Reguera Delgado 4e7926
"#\n"
Alain Reguera Delgado 4e7926
" 32  76 141 204c8d\n"
Alain Reguera Delgado 4e7926
" 37  82 146 255292\n"
Alain Reguera Delgado 4e7926
" 52  94 153 345e99\n"
Alain Reguera Delgado 4e7926
" 73 110 162 496ea2\n"
Alain Reguera Delgado 4e7926
" 91 124 172 5b7cac\n"
Alain Reguera Delgado 4e7926
"108 136 180 6c88b4\n"
Alain Reguera Delgado 4e7926
"120 146 186 7892ba\n"
Alain Reguera Delgado 4e7926
"131 158 193 839ec1\n"
Alain Reguera Delgado 4e7926
"255 255 255 ffffff\n"
Alain Reguera Delgado 4e7926
"146 170 200 92aac8\n"
Alain Reguera Delgado 4e7926
"162 182 209 a2b6d1\n"
Alain Reguera Delgado 4e7926
"183 199 219 b7c7db\n"
Alain Reguera Delgado 4e7926
"204 216 230 ccd8e6\n"
Alain Reguera Delgado 4e7926
"221 229 238 dde5ee\n"
Alain Reguera Delgado 4e7926
"235 241 245 ebf1f5\n"
Alain Reguera Delgado 4e7926
"246 251 254 f6fbfe"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Now that the palette has been created, you can set a path to "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">palette-gpl</emphasis> variable. Even you "
Alain Reguera Delgado 4e7926
"can set path of <emphasis role=\"strong\">palette-gpl</emphasis> "
Alain Reguera Delgado 4e7926
"from GIMP's palettes directory (<literal>~/.gimp-x.x/palettes/</"
Alain Reguera Delgado 4e7926
"literal>), it is much more preferable that you copy the palette "
Alain Reguera Delgado 4e7926
"file from that location to the configuration file's DIRECTORY "
Alain Reguera Delgado 4e7926
"inside the repository and put it under version control, so others "
Alain Reguera Delgado 4e7926
"can take benefit of it. The palette file is an integral part of "
Alain Reguera Delgado 4e7926
"color specific image reduction so it must be near the configuration "
Alain Reguera Delgado 4e7926
"file you use for such actions."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Rendering Documentation Files"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"To render documentation files, the <emphasis role=\"strong\">render-"
Alain Reguera Delgado 4e7926
"type</emphasis> variable must be set to “asciidoc” and the "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">render-from</emphasis> variable must "
Alain Reguera Delgado 4e7926
"point to an Asciidoc file. When the 
Alain Reguera Delgado 4e7926
"\">render</emphasis> module finds this information in a section "
Alain Reguera Delgado 4e7926
"block, it takes the asciidoc file as source and transforms it into "
Alain Reguera Delgado 4e7926
"a docbook file using the <emphasis role=\"strong\">asciidoc</"
Alain Reguera Delgado 4e7926
"emphasis> program. The docbook file is created temporarily for "
Alain Reguera Delgado 4e7926
"further format transformations and removed later, once the final "
Alain Reguera Delgado 4e7926
"format has been rendered."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">render</emphasis> module creates "
Alain Reguera Delgado 4e7926
"the intermediate docbook file, it considers the current locale "
Alain Reguera Delgado 4e7926
"information of your environment (e.g., by reading the LANG "
Alain Reguera Delgado 4e7926
"environment variable). In case the current locale information is "
Alain Reguera Delgado 4e7926
"different to English (e.g., the value of LANG environment variable "
Alain Reguera Delgado 4e7926
"doesn't begin with the “en” characters), the docbook file will be "
Alain Reguera Delgado 4e7926
"localized based on the translation file specified in the 
Alain Reguera Delgado 4e7926
"role=\"strong\">locale-from</emphasis> variable, before applying "
Alain Reguera Delgado 4e7926
"further format transformations to it. This way, further format "
Alain Reguera Delgado 4e7926
"transformations from the temporarily docbook file will end up being "
Alain Reguera Delgado 4e7926
"localized as well. If the <emphasis role=\"strong\">locale-from</"
Alain Reguera Delgado 4e7926
"emphasis> variable is not present in the section block, the "
Alain Reguera Delgado 4e7926
"intermediate docbook file won't be localized which make the final "
Alain Reguera Delgado 4e7926
"result to be not localized either."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When you set the <emphasis role=\"strong\">render-type</emphasis> "
Alain Reguera Delgado 4e7926
"variable to “asciidoc”, the section blocks need to have the "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">render-flow</emphasis> variable set to "
Alain Reguera Delgado 4e7926
"“article”, “book” or “manpage”. This information defines the way "
Alain Reguera Delgado 4e7926
"the intermediate docbook file is produced from the asciidoc file "
Alain Reguera Delgado 4e7926
"and, by extension, the possible final results, too."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When <emphasis role=\"strong\">render-flow</emphasis> variable is "
Alain Reguera Delgado 4e7926
"set to “article” or “book”, it is possible to produce final files "
Alain Reguera Delgado 4e7926
"in “xhtml” format but not in “manpage” format. This is because man "
Alain Reguera Delgado 4e7926
"pages require a specific document structure that both articles and "
Alain Reguera Delgado 4e7926
"books don't need to have. When producing articles and books in "
Alain Reguera Delgado 4e7926
"XHTML format, you can use the <emphasis role=\"strong\">render-"
Alain Reguera Delgado 4e7926
"page</emphasis> variable to control whether to produce the entire "
Alain Reguera Delgado 4e7926
"book or article in just one file (“single”) or in separate files "
Alain Reguera Delgado 4e7926
"linked one another (“chunks”)."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When <emphasis role=\"strong\">render-flow</emphasis> variable is "
Alain Reguera Delgado 4e7926
"set to “manpage” it is possible to set the 
Alain Reguera Delgado 4e7926
"\">formats</emphasis> variable to either “manpage” or “xhtml” in "
Alain Reguera Delgado 4e7926
"order to render the docbook file as man page or XHTML format, "
Alain Reguera Delgado 4e7926
"respectively. you are producing man pages to a language different "
Alain Reguera Delgado 4e7926
"to English, these required in order for 
Alain Reguera Delgado 4e7926
"\">man</emphasis> command to find the man pages in different "
Alain Reguera Delgado 4e7926
"locales. The value of the man's volume section can be set using the "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">mansect</emphasis> variable. If this "
Alain Reguera Delgado 4e7926
"variable is not set, the value of man's volume section will be 1."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When <emphasis role=\"strong\">render-flow</emphasis> variable is "
Alain Reguera Delgado 4e7926
"not set, the “article” value is used as default value."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">formats</emphasis> variable has "
Alain Reguera Delgado 4e7926
"the “xhtml” value, you need to set the 
Alain Reguera Delgado 4e7926
"\">images-from</emphasis> and <emphasis role=\"strong\">styles-"
Alain Reguera Delgado 4e7926
"from</emphasis> variables inside the related section block, no "
Alain Reguera Delgado 4e7926
"matter what the value of <emphasis role=\"strong\">render-flow</"
Alain Reguera Delgado 4e7926
"emphasis> would be. The value of <emphasis role=\"strong\">images-"
Alain Reguera Delgado 4e7926
"from</emphasis> and <emphasis role=\"strong\">styles-from</"
Alain Reguera Delgado 4e7926
"emphasis> variables must point to a directory, inside the working "
Alain Reguera Delgado 4e7926
"copy, containing the share images and CSS files used by XHTML "
Alain Reguera Delgado 4e7926
"documents, respectively. If none of these two variables are set the "
Alain Reguera Delgado 4e7926
"directories them."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">formats</emphasis> variable is "
Alain Reguera Delgado 4e7926
"not set, the “xhtml” value is used as default value."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Rendering Localized Images"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"To produce localized content, you need to set the 
Alain Reguera Delgado 4e7926
"\"strong\">locale-from</emphasis> variable in the section block you "
Alain Reguera Delgado 4e7926
"want to provide translations and point its value to the translation "
Alain Reguera Delgado 4e7926
"file where string translations will take place. Then, you need to "
Alain Reguera Delgado 4e7926
"check the value of LANG environment variable to be sure it has the "
Alain Reguera Delgado 4e7926
"locale information you want to translate messages for."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"If the LANG environment variable has the value you expect, run the "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">locale</emphasis> module on the "
Alain Reguera Delgado 4e7926
"“DIRECTORY” you want to locale content. This read the source files "
Alain Reguera Delgado 4e7926
"you specified in <emphasis role=\"strong\">render-from</emphasis> "
Alain Reguera Delgado 4e7926
"variable and would create the translation files (a.k.a., portable "
Alain Reguera Delgado 4e7926
"objects) you need to edit to provide the string translations from "
Alain Reguera Delgado 4e7926
"one language to another. Verify the translation file exist and edit "
Alain Reguera Delgado 4e7926
"it to provide the strings translations. Once the strings have been "
Alain Reguera Delgado 4e7926
"translated, execute the <emphasis role=\"strong\">render</emphasis> "
Alain Reguera Delgado 4e7926
"module on the “DIRECTORY”."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">render</emphasis> module finds "
Alain Reguera Delgado 4e7926
"the <emphasis role=\"strong\">locale-from</emphasis> variable in a "
Alain Reguera Delgado 4e7926
"section block, it uses the <emphasis role=\"strong\">xml2po</"
Alain Reguera Delgado 4e7926
"emphasis> program to create a localized instance of each source "
Alain Reguera Delgado 4e7926
"file it finds in <emphasis role=\"strong\">render-from</emphasis> "
Alain Reguera Delgado 4e7926
"variable. Then, using the source files' localized instances, it "
Alain Reguera Delgado 4e7926
"produces the final files based on <emphasis role=\"strong\">render-"
Alain Reguera Delgado 4e7926
"type</emphasis> variable's value."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Examples"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Here are some practical configuration examples you can use as "
Alain Reguera Delgado 4e7926
"reference to create your own configuration files."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
#, no-wrap
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"[Xhtml-single]\n"
Alain Reguera Delgado 4e7926
"render-type     = \"asciidoc\"\n"
Alain Reguera Delgado 4e7926
"render-flow     = \"article\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"corporate.asciidoc\"\n"
Alain Reguera Delgado 4e7926
"locale-from     = \"${TCAR_SCRIPT_LANG_LC}/messages.po\"\n"
Alain Reguera Delgado 4e7926
"images-from     = \"${TCAR_BASEDIR}/Artworks/Icons/Webenv\"\n"
Alain Reguera Delgado 4e7926
"styles-from     = \"${TCAR_BASEDIR}/Artworks/Webenv/Docbook/1.69.1/Css\"\n"
Alain Reguera Delgado 4e7926
"formats         = \"xhtml\"\n"
Alain Reguera Delgado 4e7926
"render-page     = \"single\""
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">render</emphasis> module reads "
Alain Reguera Delgado 4e7926
"this configuration file, it initiates the <literal>asscidoc</"
Alain Reguera Delgado 4e7926
"literal> module which in turn initiates the <literal>xhtml</"
Alain Reguera Delgado 4e7926
"literal> module for transforming the <literal>corporate.asciidoc</"
Alain Reguera Delgado 4e7926
"literal> file into <literal>corporate.docbook</literal> file using "
Alain Reguera Delgado 4e7926
"<literal>article</literal> as document type and result, the "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">render</emphasis> module produces the "
Alain Reguera Delgado 4e7926
"directory of the configuration file as base directory."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
#, no-wrap
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"[centos-artwork.png]\n"
Alain Reguera Delgado 4e7926
"render-from = \"${TCAR_BASEDIR}/Artworks/Brands/Types/Webenv/centos.org/{centos,artwork}.svgz\"\n"
Alain Reguera Delgado 4e7926
"formats     = \"xpm pdf jpg tif\"\n"
Alain Reguera Delgado 4e7926
"heights     = \"16 20 22 24 32 36 38 40 48 64 72 78 96 112 124 128 148 164 196 200 512\"\n"
Alain Reguera Delgado 4e7926
"fgcolors    = \"000000 ffffff\"\n"
Alain Reguera Delgado 4e7926
"bgcolors    = \"ffffff-0\"\n"
Alain Reguera Delgado 4e7926
"command     = \"/usr/bin/convert +append\""
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">render</emphasis> module reads "
Alain Reguera Delgado 4e7926
"this configuration file, it takes the <literal>centos.svgz</"
Alain Reguera Delgado 4e7926
"literal> and <literal>artwork.svgz</literal> files as source to "
Alain Reguera Delgado 4e7926
"produce the <literal>centos.png</literal> and <literal>artwork.png</"
Alain Reguera Delgado 4e7926
"literal> files considering the first value in the list of heights, "
Alain Reguera Delgado 4e7926
"background, foreground colors specified in the configuration file. "
Alain Reguera Delgado 4e7926
"Then, it combines the results horizontally to create the "
Alain Reguera Delgado 4e7926
"<literal>centos-artwork.png</literal> file. Later, the "
Alain Reguera Delgado 4e7926
"<literal>centos-artwork.png</literal> file is converted to produce "
Alain Reguera Delgado 4e7926
"one image file for each image format specified in the configuration "
Alain Reguera Delgado 4e7926
"file. At this point, all the process repeats again but for the next "
Alain Reguera Delgado 4e7926
"height and color values in the list."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
#, no-wrap
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"[syslinux-splash.png]\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Syslinux/syslinux-splash.svgz\"\n"
Alain Reguera Delgado 4e7926
"brand           = \"${TCAR_BASEDIR}/Artworks/Brands/Types/Default/Images/ffffff/ffffff-0/48/centos.png:x48+20+232\"\n"
Alain Reguera Delgado 4e7926
"brand           = \"${TCAR_BASEDIR}/Artworks/Brands/Types/Numbers/Images/ffffff/ffffff-0/96/5.png:x96+300+184\"\n"
Alain Reguera Delgado 4e7926
"\n"
Alain Reguera Delgado 4e7926
"[syslinux-splash.lss]\n"
Alain Reguera Delgado 4e7926
"render-from     = \"syslinux-splash.png\"\n"
Alain Reguera Delgado 4e7926
"render-type     = \"palette\"\n"
Alain Reguera Delgado 4e7926
"palette-gpl     = \"colors.gpl\""
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When the <emphasis role=\"strong\">render</emphasis> module reads "
Alain Reguera Delgado 4e7926
"this configuration file,"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
#, no-wrap
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"[screenshot.png]\n"
Alain Reguera Delgado 4e7926
"render-type     = \"svg\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/screenshot.svgz\"\n"
Alain Reguera Delgado 4e7926
"render-flow     = \"base\"\n"
Alain Reguera Delgado 4e7926
"brand           = \"${TCAR_BASEDIR}/Artworks/Brands/Symbols/Default/Images/ffffff/ffffff-0/16/centos.png:x16+5+5\"\n"
Alain Reguera Delgado 4e7926
"\n"
Alain Reguera Delgado 4e7926
"[800x600.tar.gz]\n"
Alain Reguera Delgado 4e7926
"render-type     = \"archive\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Motifs/${MOTIF}/Backgrounds/Images/800x600-final.png:background.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/GdmGreeterTheme.desktop\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/GdmGreeterTheme.xml\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/icon-language.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/icon-reboot.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/icon-session.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/icon-shutdown.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"screenshot.png\"\n"
Alain Reguera Delgado 4e7926
"command         = \"/bin/tar -czf\"\n"
Alain Reguera Delgado 4e7926
"\n"
Alain Reguera Delgado 4e7926
"[1360x768.tar.gz]\n"
Alain Reguera Delgado 4e7926
"render-type     = \"archive\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Motifs/${MOTIF}/Backgrounds/Images/1360x768-final.png:background.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/GdmGreeterTheme.desktop\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/GdmGreeterTheme.xml\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/icon-language.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/icon-reboot.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/icon-session.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"${TCAR_BASEDIR}/Artworks/Themes/Models/Distro/5/Gdm/icon-shutdown.png\"\n"
Alain Reguera Delgado 4e7926
"render-from     = \"screenshot.png\"\n"
Alain Reguera Delgado 4e7926
"command         = \"/bin/tar --remove-files -czf\""
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Bugs"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"The <emphasis role=\"strong\">render</emphasis> module has some "
Alain Reguera Delgado 4e7926
"issues I would like you to be aware of. Mainly, to see if you could "
Alain Reguera Delgado 4e7926
"help me find better solutions for them ;)"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"The process implemented to reduce image colors through GIMP's "
Alain Reguera Delgado 4e7926
"palettes involves too much user intervention compared with "
Alain Reguera Delgado 4e7926
"ImageMagick's --colors option that reduces image colors instantly "
Alain Reguera Delgado 4e7926
"without user intervention. Nevertheless, the procedure of reducing "
Alain Reguera Delgado 4e7926
"color through GIMP's palettes provides more quality to final images "
Alain Reguera Delgado 4e7926
"than ImageMagic's --colors option does. Also, using GIMP's palettes "
Alain Reguera Delgado 4e7926
"let us create LSS images from PNG images using the same exact "
Alain Reguera Delgado 4e7926
"information we used to reduce colors on PNG images. This is very "
Alain Reguera Delgado 4e7926
"important in order to have the same result in both image types. "
Alain Reguera Delgado 4e7926
"Because of these reasons I prefer GIMP's palettes procedure against "
Alain Reguera Delgado 4e7926
"others methods like it is the case of ImageMagick's for producing "
Alain Reguera Delgado 4e7926
"images with reduced number of colors."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Rendering PDF Files From Localized Docbook Files"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Even it is possible to produce PDF files from Docbook files using "
Alain Reguera Delgado 4e7926
"current applications inside CentOS-5, there are some production "
Alain Reguera Delgado 4e7926
"issues when we use localized docbook files as source to produce "
Alain Reguera Delgado 4e7926
"localized PDF files that made me not to implement them as part of "
Alain Reguera Delgado 4e7926
"<emphasis role=\"strong\">centos-art.sh</emphasis> script by now."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"When using the XML(DocBook)->XML(FO)->PDF transformation "
Alain Reguera Delgado 4e7926
"chain, the result produced by <emphasis>docbook-style-xsl-1.69.1-"
Alain Reguera Delgado 4e7926
"5.1</emphasis> and <emphasis>passivetex-1.25-5.1.1</emphasis> "
Alain Reguera Delgado 4e7926
"doesn't render heading boxes very well on page's top and page's "
Alain Reguera Delgado 4e7926
"bottom. The text put inside these boxes seem to have not enough "
Alain Reguera Delgado 4e7926
"space in their respective areas."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Tried using <emphasis>dblatex-0.2.8-2.el5</emphasis> but didn't "
Alain Reguera Delgado 4e7926
"work for localized docbook files (i.e., those who has the "
Alain Reguera Delgado 4e7926
"<literal>lang=\"lang\"</literal> string in their root element). If "
Alain Reguera Delgado 4e7926
"you just remove the language specification string it just work. We "
Alain Reguera Delgado 4e7926
"need the language specification in order for internal document "
Alain Reguera Delgado 4e7926
"strings like <literal>Abstract</literal> and <literal>Table of "
Alain Reguera Delgado 4e7926
"contents</literal> to be automatically translated. When the "
Alain Reguera Delgado 4e7926
"language specific attribute is present in the root element, dblatex "
Alain Reguera Delgado 4e7926
"outputs the following:"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
#, no-wrap
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Build the listings...\n"
Alain Reguera Delgado 4e7926
"XSLT stylesheets DocBook -  LaTeX 2e (0.2.8)\n"
Alain Reguera Delgado 4e7926
"===================================================\n"
Alain Reguera Delgado 4e7926
"Processing Revision History\n"
Alain Reguera Delgado 4e7926
"Build 2912-corporate.docbook.pdf\n"
Alain Reguera Delgado 4e7926
"This is pdfeTeX, Version 3.141592-1.21a-2.2 (Web2C 7.5.4)\n"
Alain Reguera Delgado 4e7926
"entering extended mode\n"
Alain Reguera Delgado 4e7926
"pdflatex failed\n"
Alain Reguera Delgado 4e7926
"/usr/share/texmf/tex/latex/dblatex/docbook.sty:160: No counter 'chapter' defined.\n"
Alain Reguera Delgado 4e7926
"/usr/share/texmf/tex/latex/dblatex/docbook.sty:160: leading text: \\newfloat{example}{htb}{loe}[chapter]\n"
Alain Reguera Delgado 4e7926
"/usr/share/texmf/tex/latex/dblatex/docbook.sty:164: No counter 'chapter' defined.\n"
Alain Reguera Delgado 4e7926
"/usr/share/texmf/tex/latex/dblatex/docbook.sty:164: leading text: \\newfloat{dbequation}{htb}{loe}[chapter]\n"
Alain Reguera Delgado 4e7926
"2912-corporate.docbook_tmp.tex:62: Illegal parameter number in definition of \\@the@H@page.\n"
Alain Reguera Delgado 4e7926
"2912-corporate.docbook_tmp.tex:62: leading text: \\maketitle\n"
Alain Reguera Delgado 4e7926
"2912-corporate.docbook_tmp.tex:62: Illegal parameter number in definition of \\@the@H@page.\n"
Alain Reguera Delgado 4e7926
"2912-corporate.docbook_tmp.tex:62: leading text: \\maketitle\n"
Alain Reguera Delgado 4e7926
"2912-corporate.docbook_tmp.tex:62: Illegal parameter number in definition of \\@the@H@page.\n"
Alain Reguera Delgado 4e7926
"2912-corporate.docbook_tmp.tex:62: leading text: \\maketitle\n"
Alain Reguera Delgado 4e7926
"Error: pdflatex compilation failed"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Reporting Bugs"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Report bugs on the <emphasis role=\"strong\">automation</emphasis> "
Alain Reguera Delgado 4e7926
"category of <emphasis role=\"strong\">centos-artwork</emphasis> "
Alain Reguera Delgado 4e7926
"project at the <ulink url=\"https://centos.org.cu/bugs/\">The "
Alain Reguera Delgado 4e7926
"CentOS Bugs</ulink> website."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Author"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"Written by <ulink url=\"mailto:al@centos.org.cu\">Alain Reguera "
Alain Reguera Delgado 4e7926
"Delgado</ulink>, 2009-2013"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Copyright"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid "Copyright © 2009-2013 The CentOS Project"
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"This program is free software; you can redistribute it and/or "
Alain Reguera Delgado 4e7926
"modify it under the terms of the GNU General Public License as "
Alain Reguera Delgado 4e7926
"published by the Free Software Foundation; either version 2 of the "
Alain Reguera Delgado 4e7926
"License, or (at your option) any later version."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"This program is distributed in the hope that it will be useful, but "
Alain Reguera Delgado 4e7926
"WITHOUT ANY WARRANTY; without even the implied warranty of "
Alain Reguera Delgado 4e7926
"MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU "
Alain Reguera Delgado 4e7926
"General Public License for more details."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
msgid ""
Alain Reguera Delgado 4e7926
"You should have received a copy of the GNU General Public License "
Alain Reguera Delgado 4e7926
"along with this program; if not, write to the Free Software "
Alain Reguera Delgado 4e7926
"Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA."
Alain Reguera Delgado 4e7926
msgstr ""
Alain Reguera Delgado 4e7926
Alain Reguera Delgado 4e7926
#. Put one translator per line, in the form of NAME <EMAIL>, YEAR1, YEAR2.
Alain Reguera Delgado 4e7926
msgid "translator-credits"
Alain Reguera Delgado 4e7926
msgstr ""