diff --git a/Identity/Manual/Directories/chapter-menu.texi b/Identity/Manual/Directories/chapter-menu.texi index 61ede63..b242a25 100644 --- a/Identity/Manual/Directories/chapter-menu.texi +++ b/Identity/Manual/Directories/chapter-menu.texi @@ -6,6 +6,17 @@ * Directories trunk Identity Brands:: * Directories trunk Identity Colors:: * Directories trunk Identity Fonts:: +* Directories trunk Identity Locales:: +* Directories trunk Identity Locales Identity:: +* Directories trunk Identity Locales Identity Brands:: +* Directories trunk Identity Locales Identity Brands Tpl:: +* Directories trunk Identity Locales Identity Fonts:: +* Directories trunk Identity Locales Identity Models:: +* Directories trunk Identity Locales Identity Release:: +* Directories trunk Identity Locales Identity Themes:: +* Directories trunk Identity Locales Identity Themes Backgrounds:: +* Directories trunk Identity Locales Identity Themes Distro Anaconda Progress:: +* Directories trunk Identity Locales Identity Widgets:: * Directories trunk Identity Themes:: * Directories trunk Identity Themes Models:: * Directories trunk Identity Themes Models Alternative:: @@ -36,17 +47,6 @@ * Directories trunk Identity Themes Motifs TreeFlower Backgrounds:: * Directories trunk Identity Webenv:: * Directories trunk Identity Widgets:: -* Directories trunk Locales:: -* Directories trunk Locales Identity:: -* Directories trunk Locales Identity Brands:: -* Directories trunk Locales Identity Brands Tpl:: -* Directories trunk Locales Identity Fonts:: -* Directories trunk Locales Identity Models:: -* Directories trunk Locales Identity Release:: -* Directories trunk Locales Identity Themes:: -* Directories trunk Locales Identity Themes Backgrounds:: -* Directories trunk Locales Identity Themes Distro Anaconda Progress:: -* Directories trunk Locales Identity Widgets:: * Directories trunk Manual:: * Directories trunk Scripts:: * Directories trunk Scripts Functions:: diff --git a/Identity/Manual/Directories/chapter-nodes.texi b/Identity/Manual/Directories/chapter-nodes.texi index a75aebc..2553a95 100644 --- a/Identity/Manual/Directories/chapter-nodes.texi +++ b/Identity/Manual/Directories/chapter-nodes.texi @@ -33,6 +33,61 @@ @cindex Directories trunk Identity Fonts @include Directories/trunk/Identity/Fonts.texi +@node Directories trunk Identity Locales +@section The @file{trunk/Identity/Locales} Directory +@cindex Directories trunk Identity Locales +@include Directories/trunk/Identity/Locales.texi + +@node Directories trunk Identity Locales Identity +@section The @file{trunk/Identity/Locales/Identity} Directory +@cindex Directories trunk Identity Locales Identity +@include Directories/trunk/Identity/Locales/Identity.texi + +@node Directories trunk Identity Locales Identity Brands +@section The @file{trunk/Identity/Locales/Identity/Brands} Directory +@cindex Directories trunk Identity Locales Identity Brands +@include Directories/trunk/Identity/Locales/Identity/Brands.texi + +@node Directories trunk Identity Locales Identity Brands Tpl +@section The @file{trunk/Identity/Locales/Identity/Brands/Tpl} Directory +@cindex Directories trunk Identity Locales Identity Brands Tpl +@include Directories/trunk/Identity/Locales/Identity/Brands/Tpl.texi + +@node Directories trunk Identity Locales Identity Fonts +@section The @file{trunk/Identity/Locales/Identity/Fonts} Directory +@cindex Directories trunk Identity Locales Identity Fonts +@include Directories/trunk/Identity/Locales/Identity/Fonts.texi + +@node Directories trunk Identity Locales Identity Models +@section The @file{trunk/Identity/Locales/Identity/Models} Directory +@cindex Directories trunk Identity Locales Identity Models +@include Directories/trunk/Identity/Locales/Identity/Models.texi + +@node Directories trunk Identity Locales Identity Release +@section The @file{trunk/Identity/Locales/Identity/Release} Directory +@cindex Directories trunk Identity Locales Identity Release +@include Directories/trunk/Identity/Locales/Identity/Release.texi + +@node Directories trunk Identity Locales Identity Themes +@section The @file{trunk/Identity/Locales/Identity/Themes} Directory +@cindex Directories trunk Identity Locales Identity Themes +@include Directories/trunk/Identity/Locales/Identity/Themes.texi + +@node Directories trunk Identity Locales Identity Themes Backgrounds +@section The @file{trunk/Identity/Locales/Identity/Themes/Backgrounds} Directory +@cindex Directories trunk Identity Locales Identity Themes Backgrounds +@include Directories/trunk/Identity/Locales/Identity/Themes/Backgrounds.texi + +@node Directories trunk Identity Locales Identity Themes Distro Anaconda Progress +@section The @file{trunk/Identity/Locales/Identity/Themes/Distro/Anaconda/Progress} Directory +@cindex Directories trunk Identity Locales Identity Themes Distro Anaconda Progress +@include Directories/trunk/Identity/Locales/Identity/Themes/Distro/Anaconda/Progress.texi + +@node Directories trunk Identity Locales Identity Widgets +@section The @file{trunk/Identity/Locales/Identity/Widgets} Directory +@cindex Directories trunk Identity Locales Identity Widgets +@include Directories/trunk/Identity/Locales/Identity/Widgets.texi + @node Directories trunk Identity Themes @section The @file{trunk/Identity/Themes} Directory @cindex Directories trunk Identity Themes @@ -183,61 +238,6 @@ @cindex Directories trunk Identity Widgets @include Directories/trunk/Identity/Widgets.texi -@node Directories trunk Locales -@section The @file{trunk/Locales} Directory -@cindex Directories trunk Locales -@include Directories/trunk/Locales.texi - -@node Directories trunk Locales Identity -@section The @file{trunk/Locales/Identity} Directory -@cindex Directories trunk Locales Identity -@include Directories/trunk/Locales/Identity.texi - -@node Directories trunk Locales Identity Brands -@section The @file{trunk/Locales/Identity/Brands} Directory -@cindex Directories trunk Locales Identity Brands -@include Directories/trunk/Locales/Identity/Brands.texi - -@node Directories trunk Locales Identity Brands Tpl -@section The @file{trunk/Locales/Identity/Brands/Tpl} Directory -@cindex Directories trunk Locales Identity Brands Tpl -@include Directories/trunk/Locales/Identity/Brands/Tpl.texi - -@node Directories trunk Locales Identity Fonts -@section The @file{trunk/Locales/Identity/Fonts} Directory -@cindex Directories trunk Locales Identity Fonts -@include Directories/trunk/Locales/Identity/Fonts.texi - -@node Directories trunk Locales Identity Models -@section The @file{trunk/Locales/Identity/Models} Directory -@cindex Directories trunk Locales Identity Models -@include Directories/trunk/Locales/Identity/Models.texi - -@node Directories trunk Locales Identity Release -@section The @file{trunk/Locales/Identity/Release} Directory -@cindex Directories trunk Locales Identity Release -@include Directories/trunk/Locales/Identity/Release.texi - -@node Directories trunk Locales Identity Themes -@section The @file{trunk/Locales/Identity/Themes} Directory -@cindex Directories trunk Locales Identity Themes -@include Directories/trunk/Locales/Identity/Themes.texi - -@node Directories trunk Locales Identity Themes Backgrounds -@section The @file{trunk/Locales/Identity/Themes/Backgrounds} Directory -@cindex Directories trunk Locales Identity Themes Backgrounds -@include Directories/trunk/Locales/Identity/Themes/Backgrounds.texi - -@node Directories trunk Locales Identity Themes Distro Anaconda Progress -@section The @file{trunk/Locales/Identity/Themes/Distro/Anaconda/Progress} Directory -@cindex Directories trunk Locales Identity Themes Distro Anaconda Progress -@include Directories/trunk/Locales/Identity/Themes/Distro/Anaconda/Progress.texi - -@node Directories trunk Locales Identity Widgets -@section The @file{trunk/Locales/Identity/Widgets} Directory -@cindex Directories trunk Locales Identity Widgets -@include Directories/trunk/Locales/Identity/Widgets.texi - @node Directories trunk Manual @section The @file{trunk/Manual} Directory @cindex Directories trunk Manual diff --git a/Identity/Manual/Directories/trunk.texi b/Identity/Manual/Directories/trunk.texi index 55c79de..e59912b 100644 --- a/Identity/Manual/Directories/trunk.texi +++ b/Identity/Manual/Directories/trunk.texi @@ -44,7 +44,7 @@ is perfect to consolidate @emph{The CentOS Translation SIG}. If you love translating, you'll find lot of messages waiting for you to translate here. -@xref{Directories trunk Locales}, for more information. +@xref{Directories trunk Identity Locales}, for more information. @end table @subsection Usage diff --git a/Identity/Manual/Directories/trunk/Identity/Locales.texi b/Identity/Manual/Directories/trunk/Identity/Locales.texi new file mode 100644 index 0000000..7e5457c --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales.texi @@ -0,0 +1,56 @@ +The @file{trunk/Locales} directory exists to store the translation +messages used to produce content in different languages. + +Translation messages are organized using the directory structure of +the component being translated. For example, if we want to provide +translation messages for @file{trunk/Manuals/Repository}, then the +@file{trunk/Locales/Manuals/Repository} directory needs to be created. + +Once the locale directory exists for the component we want to provide +translation messages for, it is necessary to create the translation +files where translation messages are. The translation files follows +the concepts of @command{xml2po} and GNU @command{gettext} tools. + +The basic translation process is as follow: first, translatable +strings are extracted from files and a portable object template (.pot) +is created or updated with the information. Using the portable object +template, a portable object (.po) is created or updated for translator +to locale the messages retrived. Finally, a machine object (.mo) is +created from portable object to sotore the translated messages. + +Inside the repository there are two ways to retrive translatable +strings from files. The first one is through @command{xml2po} command +and the second through @command{xgettext} command. The @command{xml2po} +is used to retrive translatable strings from XML files (e.g., Scalable +Vector Graphics, DocBook, etc.) and the @command{xgettext} command is +used to retrive translatable strings from shell scripts files (e.g., +the files that make the @command{centos-art.sh} command-line +interface). + +When translatable strings are retrived from XML files, using the +@command{xml2po} command, there is no need to create the machine +object as we do when translatable strings ar retrived from shell +files, using the @command{xgettext} command. The @command{xml2po} +produces a temporal machine object in order to create a translated XML +file. Once the translated XML file has been created the machine object +is no longer needed. On the other hand, the machine object produced by +the @command{xgettext} command is required by the system in order for +the show shell script localized messages. + +Another difference between @command{xml2po} and @command{xgettext} we +need to be aware of is the directory structure used to store machine +objects. In @command{xml2po}, the machine object is created in the +current working directory as @file{.xml2po.mo} and can be safetly +removed once the translated XML file has been created. In the case of +@command{xgettext}, the machine object needs to be stored in the +@file{$TEXTDOMAIN/$LOCALE/LL_MESSAGES/$TEXTDOMAIN.mo} file in order +for the system to interpret it and should not be removed since it is +the file that contain the translation messages themselves. + +Automation of localization tasks is achived through the @code{locale} +functionality of command-line interface. + +@menu +* Directories trunk Scripts Functions Locale:: +@end menu + diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity.texi new file mode 100644 index 0000000..beeb9a7 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity.texi @@ -0,0 +1,29 @@ +@subsection Goals + +@itemize +@item ... +@end itemize + +@subsection Description + +@itemize +@item ... +@end itemize + +@subsection Usage + +@itemize +@item ... +@end itemize + +@subsection See also + +@menu +@comment --- Removed(* Directories trunk Translations Identity Brands::) --- +@comment --- Removed(* Directories trunk Translations Identity Fonts::) --- +@comment --- Removed(* Directories trunk Translations Identity Models::) --- +@comment --- Removed(* Directories trunk Translations Identity Release::) --- +@comment --- Removed(* Directories trunk Translations Identity Themes::) --- +@comment --- Removed(* Directories trunk Translations Identity Widgets::) --- +* Directories trunk Identity:: +@end menu diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands.texi new file mode 100644 index 0000000..f1495d7 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands.texi @@ -0,0 +1,105 @@ +@subsection Goals + +@itemize +@item Organize brands' translation files. +@end itemize + +@subsection Description + +Translation files, inside @file{trunk/Translations/Identity/Brands} +translation entry, don't use default rendering translation +functionality, they use the following translation pre-rendering +configuration file instead: + +@verbatim +/home/centos/artwork/trunk/Translation/Identity/Brands/render.conf.sh +@end verbatim + +Inside @file{trunk/Translations/Identity/Brands} translation entry, +translation files are symbolic links pointing to the common template +translation structure, inside the translation template (@samp{Tpl/}) +directory. + +Inside @file{trunk/Translations/Identity/Brands} translation entry, +translation files are created using identity design templates as +reference. The translation pre-rendering script creates a translation +structure where the translation template (@samp{Tpl/}) directory +structure applies to each single design template available. + +For example, if the brands' translation template (@samp{Tpl/}) +directory has 30 translation files, and there are 20 design templates; +the brands' translation pre-rendering script creates a translation +structure of symbolic links where the 30 translation files apply the +20 design templates one by one, producing 600 translation symbolic +links as result. At this point, when rendering identity, the +@command{centos-art} script considers translation symbolic links as +translation files. + +Translation file names, inside brands' translation template +(@samp{Tpl}) directory have special meaning: + +@subsubsection Conventional file names +@cindex Translation brands file names + +Convenctional file names look like @file{blue.sed}, @file{2c-a.sed}, +etc. Replacement commands inside translation file are applied to +design templates and translation file names are used as final image +name. The image dimensions use the same dimensions that design +template has. + +@subsubsection Numeric file names +@cindex Translation brands file names + +Numeric file names look like @file{300.sed}, @file{200.sed}, etc. +Replacements commands inside translation files are applied to design +templates, and translation file names are used as final image name. +The final image is saved using an specific @samp{width} defined by the +number part of the translation file name. The image @samp{height} is +automatically scaled based on the previous @samp{width} definition to +maintain the designing ratio. + +For example, if your design template has 400x200 pixels of dimension, +and you apply a translation file named `300.sed' to it, the final +image you get as result will have 300x100 pixels of dimension. The +same is true if you use higher numbers like `1024.sed', `2048.sed', +etc. In these cases you have bigger images proportionally. + +As we are using scalable vector graphics to design identity templates, +the image size you produce is not limitted in size. You can use one +design template produced in 400x200 pixels to produce larger or +shorter PNG images using numeric translation files as described +above. + +@subsubsection Translation markers + +Inside @file{trunk/Translations/Identity/Brands/}, translation files +combine the following translation markers: + +@table @samp +@item #000000 + +Specify which color to use when rendering brand images. + +@quotation +@strong{Note} As translation files inside +@file{trunk/Translations/Identity/Brands} are symbolic links that +point to template translation files, translation markers are defined +inside template translation files. +@end quotation +@end table + +@subsection Usage +@cindex How to render brands' translation files + +To render brands' translation files, use the following command: + +@verbatim +centos-art render --translation=/home/centos/artwork/trunk/Translations/Identity/Brands +@end verbatim + +@subsection See also + +@menu +@comment --- Removed(* Directories trunk Translations Identity Brands Tpl::) --- +* Directories trunk Identity Brands:: +@end menu diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands/Tpl.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands/Tpl.texi new file mode 100644 index 0000000..b53171e --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands/Tpl.texi @@ -0,0 +1,10 @@ +@subsection Goals + +@subsection Description + +@subsection Usage + +@subsection See also + +@menu +@end menu diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Fonts.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Fonts.texi new file mode 100644 index 0000000..b6b177a --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Fonts.texi @@ -0,0 +1,62 @@ +@subsection Goals + +This section exists to organize fonts translation files. +@subsection Description + +Translation files, inside @file{trunk/Translations/Fonts}, have the +following structure: + +@verbatim +s!font-family:Denmark!font-family:DejaVu LGC Sans! +s!font-weight:normal!font-weight:bold! +s!font-style:normal!font-style:italic! +@end verbatim + +Inside @file{trunk/Translations/Fonts}, there is one translation file +for each font preview image you want to produce. This way, we create +one translation file for each font-family we use somewhere inside +CentOS visual identity. + +@quotation +@strong{Important} Do not create translation files for +font-families not used somewhere inside CentOS visual identity. The +identity of font entry (@pxref{Directories trunk Identity Fonts}) is used as +reference when someone needs to know which font-families are allowed +to use inside CentOS visual identity. +@end quotation + +@subsubsection Translation Markers + +Inside @file{trunk/Translations/Identity/Fonts}, translation files +combine the following translation markers: + +@table @samp +@item font-family:Denmark +Specify which font family to use when rendering font preview images. +@item font-weight:normal +Specify which font weight to use when rendering font preview images. +@item font-style:normal +Specify which font style to use when rendering font preview images. +@end table + +@subsection Usage +@cindex How to render fonts' translation files + +Inside @file{trunk/Translations/Fonts} you use your favorite text +editor to create translation files. Inside +@file{trunk/Translations/Fonts} there is not translation template +directory (@file{Tpl/}), nor translation rendering using +@command{centos-art} script. For example, to create the +@file{dejavu_lgc_sans-boldoblique.sed} translation file using +@command{vim} editor, type the following command: + +@verbatim +vim /home/centos/artwork/trunk/Translations/Fonts/dejavu_lgc_sans-boldoblique.sed +@end verbatim + +@subsection See also + +@menu +* Directories trunk Identity Fonts:: +@end menu + diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Models.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Models.texi new file mode 100644 index 0000000..b53171e --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Models.texi @@ -0,0 +1,10 @@ +@subsection Goals + +@subsection Description + +@subsection Usage + +@subsection See also + +@menu +@end menu diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Release.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Release.texi new file mode 100644 index 0000000..b53171e --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Release.texi @@ -0,0 +1,10 @@ +@subsection Goals + +@subsection Description + +@subsection Usage + +@subsection See also + +@menu +@end menu diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes.texi new file mode 100644 index 0000000..b53171e --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes.texi @@ -0,0 +1,10 @@ +@subsection Goals + +@subsection Description + +@subsection Usage + +@subsection See also + +@menu +@end menu diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes/Backgrounds.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes/Backgrounds.texi new file mode 100644 index 0000000..fb39647 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes/Backgrounds.texi @@ -0,0 +1,22 @@ +@subsection Goals + +@itemize +@item ... +@end itemize + +@subsection Description + +@itemize +@item ... +@end itemize + +@subsection Usage + +@itemize +@item ... +@end itemize + +@subsection See also + +@menu +@end menu diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes/Distro/Anaconda/Progress.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes/Distro/Anaconda/Progress.texi new file mode 100644 index 0000000..8555b63 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes/Distro/Anaconda/Progress.texi @@ -0,0 +1,94 @@ +@subsection Goals + +@itemize +@item Organize Anaconda progress translation templates. +@item Organize Anaconda progress translation files in several +languages and major releases of CentOS distribution. +@end itemize + +@subsection Description + +Use the following command to produce translation files based: + +@example +trunk/Translations/Identity/Themes/Distro/Anaconda/Progress +`-- Tpl + |-- en + | |-- 01-welcome.sed + | |-- 02-donate.sed + | `-- 03-yum.sed + `-- es + |-- 01-welcome.sed + |-- 02-donate.sed + `-- 03-yum.sed +@end example + +In order to produce the slide images in PNG format we need to have the +translation files first. So we use the following commands to create +translation files for CentOS 3, 4, and 5 major releases: + +@example +centos-art render --translation --filter='3,4,5' +@end example + +The above commands will produce the following translation structure: + +@example +trunk/Translations/Identity/Themes/Distro/Anaconda/Progress +|-- 3 +| |-- en +| | |-- 01-welcome.sed +| | |-- 02-donate.sed +| | `-- 03-yum.sed +| `-- es +| |-- 01-welcome.sed +| |-- 02-donate.sed +| `-- 03-yum.sed +|-- 4 +| |-- en +| | |-- 01-welcome.sed +| | |-- 02-donate.sed +| | `-- 03-yum.sed +| `-- es +| |-- 01-welcome.sed +| |-- 02-donate.sed +| `-- 03-yum.sed +|-- 5 +| |-- en +| | |-- 01-welcome.sed +| | |-- 02-donate.sed +| | `-- 03-yum.sed +| `-- es +| |-- 01-welcome.sed +| |-- 02-donate.sed +| `-- 03-yum.sed +`-- Tpl + |-- en + | |-- 01-welcome.sed + | |-- 02-donate.sed + | `-- 03-yum.sed + `-- es + |-- 01-welcome.sed + |-- 02-donate.sed + `-- 03-yum.sed +@end example + +At this point we have all the translation files we need to produce +Anaconda progress welcome, donate and yum slides images; in English +and Spanish languages; for CentOS 3, CentOS 4, and CentOS 5. That is, +a sum of 18 images around. + +Now, with translation files in place, let's move to +@file{trunk/Identity} structure and render them. + +@itemize +@item @xref{Directories trunk Identity Themes Motifs Modern Distro Anaconda Progress}. +@end itemize + +@subsection Usage + +Translation rendering is described in @samp{trunk/Translations} +documentation entry (--- @strong{Removed}(pxref:trunk Translations) ---). + + +@subsection See also diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Widgets.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Widgets.texi new file mode 100644 index 0000000..e699d83 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Widgets.texi @@ -0,0 +1,23 @@ +@subsection Goals + +@itemize +@item ... +@end itemize + +@subsection Description + +@itemize +@item ... +@end itemize + +@subsection Usage + +@itemize +@item ... +@end itemize + +@subsection See also + +@menu +@comment --- Removed(* Directories trunk Translations Identity Widgets::) --- +@end menu diff --git a/Identity/Manual/Directories/trunk/Locales.texi b/Identity/Manual/Directories/trunk/Locales.texi deleted file mode 100644 index 7e5457c..0000000 --- a/Identity/Manual/Directories/trunk/Locales.texi +++ /dev/null @@ -1,56 +0,0 @@ -The @file{trunk/Locales} directory exists to store the translation -messages used to produce content in different languages. - -Translation messages are organized using the directory structure of -the component being translated. For example, if we want to provide -translation messages for @file{trunk/Manuals/Repository}, then the -@file{trunk/Locales/Manuals/Repository} directory needs to be created. - -Once the locale directory exists for the component we want to provide -translation messages for, it is necessary to create the translation -files where translation messages are. The translation files follows -the concepts of @command{xml2po} and GNU @command{gettext} tools. - -The basic translation process is as follow: first, translatable -strings are extracted from files and a portable object template (.pot) -is created or updated with the information. Using the portable object -template, a portable object (.po) is created or updated for translator -to locale the messages retrived. Finally, a machine object (.mo) is -created from portable object to sotore the translated messages. - -Inside the repository there are two ways to retrive translatable -strings from files. The first one is through @command{xml2po} command -and the second through @command{xgettext} command. The @command{xml2po} -is used to retrive translatable strings from XML files (e.g., Scalable -Vector Graphics, DocBook, etc.) and the @command{xgettext} command is -used to retrive translatable strings from shell scripts files (e.g., -the files that make the @command{centos-art.sh} command-line -interface). - -When translatable strings are retrived from XML files, using the -@command{xml2po} command, there is no need to create the machine -object as we do when translatable strings ar retrived from shell -files, using the @command{xgettext} command. The @command{xml2po} -produces a temporal machine object in order to create a translated XML -file. Once the translated XML file has been created the machine object -is no longer needed. On the other hand, the machine object produced by -the @command{xgettext} command is required by the system in order for -the show shell script localized messages. - -Another difference between @command{xml2po} and @command{xgettext} we -need to be aware of is the directory structure used to store machine -objects. In @command{xml2po}, the machine object is created in the -current working directory as @file{.xml2po.mo} and can be safetly -removed once the translated XML file has been created. In the case of -@command{xgettext}, the machine object needs to be stored in the -@file{$TEXTDOMAIN/$LOCALE/LL_MESSAGES/$TEXTDOMAIN.mo} file in order -for the system to interpret it and should not be removed since it is -the file that contain the translation messages themselves. - -Automation of localization tasks is achived through the @code{locale} -functionality of command-line interface. - -@menu -* Directories trunk Scripts Functions Locale:: -@end menu - diff --git a/Identity/Manual/Directories/trunk/Locales/Identity.texi b/Identity/Manual/Directories/trunk/Locales/Identity.texi deleted file mode 100644 index beeb9a7..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity.texi +++ /dev/null @@ -1,29 +0,0 @@ -@subsection Goals - -@itemize -@item ... -@end itemize - -@subsection Description - -@itemize -@item ... -@end itemize - -@subsection Usage - -@itemize -@item ... -@end itemize - -@subsection See also - -@menu -@comment --- Removed(* Directories trunk Translations Identity Brands::) --- -@comment --- Removed(* Directories trunk Translations Identity Fonts::) --- -@comment --- Removed(* Directories trunk Translations Identity Models::) --- -@comment --- Removed(* Directories trunk Translations Identity Release::) --- -@comment --- Removed(* Directories trunk Translations Identity Themes::) --- -@comment --- Removed(* Directories trunk Translations Identity Widgets::) --- -* Directories trunk Identity:: -@end menu diff --git a/Identity/Manual/Directories/trunk/Locales/Identity/Brands.texi b/Identity/Manual/Directories/trunk/Locales/Identity/Brands.texi deleted file mode 100644 index f1495d7..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity/Brands.texi +++ /dev/null @@ -1,105 +0,0 @@ -@subsection Goals - -@itemize -@item Organize brands' translation files. -@end itemize - -@subsection Description - -Translation files, inside @file{trunk/Translations/Identity/Brands} -translation entry, don't use default rendering translation -functionality, they use the following translation pre-rendering -configuration file instead: - -@verbatim -/home/centos/artwork/trunk/Translation/Identity/Brands/render.conf.sh -@end verbatim - -Inside @file{trunk/Translations/Identity/Brands} translation entry, -translation files are symbolic links pointing to the common template -translation structure, inside the translation template (@samp{Tpl/}) -directory. - -Inside @file{trunk/Translations/Identity/Brands} translation entry, -translation files are created using identity design templates as -reference. The translation pre-rendering script creates a translation -structure where the translation template (@samp{Tpl/}) directory -structure applies to each single design template available. - -For example, if the brands' translation template (@samp{Tpl/}) -directory has 30 translation files, and there are 20 design templates; -the brands' translation pre-rendering script creates a translation -structure of symbolic links where the 30 translation files apply the -20 design templates one by one, producing 600 translation symbolic -links as result. At this point, when rendering identity, the -@command{centos-art} script considers translation symbolic links as -translation files. - -Translation file names, inside brands' translation template -(@samp{Tpl}) directory have special meaning: - -@subsubsection Conventional file names -@cindex Translation brands file names - -Convenctional file names look like @file{blue.sed}, @file{2c-a.sed}, -etc. Replacement commands inside translation file are applied to -design templates and translation file names are used as final image -name. The image dimensions use the same dimensions that design -template has. - -@subsubsection Numeric file names -@cindex Translation brands file names - -Numeric file names look like @file{300.sed}, @file{200.sed}, etc. -Replacements commands inside translation files are applied to design -templates, and translation file names are used as final image name. -The final image is saved using an specific @samp{width} defined by the -number part of the translation file name. The image @samp{height} is -automatically scaled based on the previous @samp{width} definition to -maintain the designing ratio. - -For example, if your design template has 400x200 pixels of dimension, -and you apply a translation file named `300.sed' to it, the final -image you get as result will have 300x100 pixels of dimension. The -same is true if you use higher numbers like `1024.sed', `2048.sed', -etc. In these cases you have bigger images proportionally. - -As we are using scalable vector graphics to design identity templates, -the image size you produce is not limitted in size. You can use one -design template produced in 400x200 pixels to produce larger or -shorter PNG images using numeric translation files as described -above. - -@subsubsection Translation markers - -Inside @file{trunk/Translations/Identity/Brands/}, translation files -combine the following translation markers: - -@table @samp -@item #000000 - -Specify which color to use when rendering brand images. - -@quotation -@strong{Note} As translation files inside -@file{trunk/Translations/Identity/Brands} are symbolic links that -point to template translation files, translation markers are defined -inside template translation files. -@end quotation -@end table - -@subsection Usage -@cindex How to render brands' translation files - -To render brands' translation files, use the following command: - -@verbatim -centos-art render --translation=/home/centos/artwork/trunk/Translations/Identity/Brands -@end verbatim - -@subsection See also - -@menu -@comment --- Removed(* Directories trunk Translations Identity Brands Tpl::) --- -* Directories trunk Identity Brands:: -@end menu diff --git a/Identity/Manual/Directories/trunk/Locales/Identity/Brands/Tpl.texi b/Identity/Manual/Directories/trunk/Locales/Identity/Brands/Tpl.texi deleted file mode 100644 index b53171e..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity/Brands/Tpl.texi +++ /dev/null @@ -1,10 +0,0 @@ -@subsection Goals - -@subsection Description - -@subsection Usage - -@subsection See also - -@menu -@end menu diff --git a/Identity/Manual/Directories/trunk/Locales/Identity/Fonts.texi b/Identity/Manual/Directories/trunk/Locales/Identity/Fonts.texi deleted file mode 100644 index b6b177a..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity/Fonts.texi +++ /dev/null @@ -1,62 +0,0 @@ -@subsection Goals - -This section exists to organize fonts translation files. -@subsection Description - -Translation files, inside @file{trunk/Translations/Fonts}, have the -following structure: - -@verbatim -s!font-family:Denmark!font-family:DejaVu LGC Sans! -s!font-weight:normal!font-weight:bold! -s!font-style:normal!font-style:italic! -@end verbatim - -Inside @file{trunk/Translations/Fonts}, there is one translation file -for each font preview image you want to produce. This way, we create -one translation file for each font-family we use somewhere inside -CentOS visual identity. - -@quotation -@strong{Important} Do not create translation files for -font-families not used somewhere inside CentOS visual identity. The -identity of font entry (@pxref{Directories trunk Identity Fonts}) is used as -reference when someone needs to know which font-families are allowed -to use inside CentOS visual identity. -@end quotation - -@subsubsection Translation Markers - -Inside @file{trunk/Translations/Identity/Fonts}, translation files -combine the following translation markers: - -@table @samp -@item font-family:Denmark -Specify which font family to use when rendering font preview images. -@item font-weight:normal -Specify which font weight to use when rendering font preview images. -@item font-style:normal -Specify which font style to use when rendering font preview images. -@end table - -@subsection Usage -@cindex How to render fonts' translation files - -Inside @file{trunk/Translations/Fonts} you use your favorite text -editor to create translation files. Inside -@file{trunk/Translations/Fonts} there is not translation template -directory (@file{Tpl/}), nor translation rendering using -@command{centos-art} script. For example, to create the -@file{dejavu_lgc_sans-boldoblique.sed} translation file using -@command{vim} editor, type the following command: - -@verbatim -vim /home/centos/artwork/trunk/Translations/Fonts/dejavu_lgc_sans-boldoblique.sed -@end verbatim - -@subsection See also - -@menu -* Directories trunk Identity Fonts:: -@end menu - diff --git a/Identity/Manual/Directories/trunk/Locales/Identity/Models.texi b/Identity/Manual/Directories/trunk/Locales/Identity/Models.texi deleted file mode 100644 index b53171e..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity/Models.texi +++ /dev/null @@ -1,10 +0,0 @@ -@subsection Goals - -@subsection Description - -@subsection Usage - -@subsection See also - -@menu -@end menu diff --git a/Identity/Manual/Directories/trunk/Locales/Identity/Release.texi b/Identity/Manual/Directories/trunk/Locales/Identity/Release.texi deleted file mode 100644 index b53171e..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity/Release.texi +++ /dev/null @@ -1,10 +0,0 @@ -@subsection Goals - -@subsection Description - -@subsection Usage - -@subsection See also - -@menu -@end menu diff --git a/Identity/Manual/Directories/trunk/Locales/Identity/Themes.texi b/Identity/Manual/Directories/trunk/Locales/Identity/Themes.texi deleted file mode 100644 index b53171e..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity/Themes.texi +++ /dev/null @@ -1,10 +0,0 @@ -@subsection Goals - -@subsection Description - -@subsection Usage - -@subsection See also - -@menu -@end menu diff --git a/Identity/Manual/Directories/trunk/Locales/Identity/Themes/Backgrounds.texi b/Identity/Manual/Directories/trunk/Locales/Identity/Themes/Backgrounds.texi deleted file mode 100644 index fb39647..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity/Themes/Backgrounds.texi +++ /dev/null @@ -1,22 +0,0 @@ -@subsection Goals - -@itemize -@item ... -@end itemize - -@subsection Description - -@itemize -@item ... -@end itemize - -@subsection Usage - -@itemize -@item ... -@end itemize - -@subsection See also - -@menu -@end menu diff --git a/Identity/Manual/Directories/trunk/Locales/Identity/Themes/Distro/Anaconda/Progress.texi b/Identity/Manual/Directories/trunk/Locales/Identity/Themes/Distro/Anaconda/Progress.texi deleted file mode 100644 index 8555b63..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity/Themes/Distro/Anaconda/Progress.texi +++ /dev/null @@ -1,94 +0,0 @@ -@subsection Goals - -@itemize -@item Organize Anaconda progress translation templates. -@item Organize Anaconda progress translation files in several -languages and major releases of CentOS distribution. -@end itemize - -@subsection Description - -Use the following command to produce translation files based: - -@example -trunk/Translations/Identity/Themes/Distro/Anaconda/Progress -`-- Tpl - |-- en - | |-- 01-welcome.sed - | |-- 02-donate.sed - | `-- 03-yum.sed - `-- es - |-- 01-welcome.sed - |-- 02-donate.sed - `-- 03-yum.sed -@end example - -In order to produce the slide images in PNG format we need to have the -translation files first. So we use the following commands to create -translation files for CentOS 3, 4, and 5 major releases: - -@example -centos-art render --translation --filter='3,4,5' -@end example - -The above commands will produce the following translation structure: - -@example -trunk/Translations/Identity/Themes/Distro/Anaconda/Progress -|-- 3 -| |-- en -| | |-- 01-welcome.sed -| | |-- 02-donate.sed -| | `-- 03-yum.sed -| `-- es -| |-- 01-welcome.sed -| |-- 02-donate.sed -| `-- 03-yum.sed -|-- 4 -| |-- en -| | |-- 01-welcome.sed -| | |-- 02-donate.sed -| | `-- 03-yum.sed -| `-- es -| |-- 01-welcome.sed -| |-- 02-donate.sed -| `-- 03-yum.sed -|-- 5 -| |-- en -| | |-- 01-welcome.sed -| | |-- 02-donate.sed -| | `-- 03-yum.sed -| `-- es -| |-- 01-welcome.sed -| |-- 02-donate.sed -| `-- 03-yum.sed -`-- Tpl - |-- en - | |-- 01-welcome.sed - | |-- 02-donate.sed - | `-- 03-yum.sed - `-- es - |-- 01-welcome.sed - |-- 02-donate.sed - `-- 03-yum.sed -@end example - -At this point we have all the translation files we need to produce -Anaconda progress welcome, donate and yum slides images; in English -and Spanish languages; for CentOS 3, CentOS 4, and CentOS 5. That is, -a sum of 18 images around. - -Now, with translation files in place, let's move to -@file{trunk/Identity} structure and render them. - -@itemize -@item @xref{Directories trunk Identity Themes Motifs Modern Distro Anaconda Progress}. -@end itemize - -@subsection Usage - -Translation rendering is described in @samp{trunk/Translations} -documentation entry (--- @strong{Removed}(pxref:trunk Translations) ---). - - -@subsection See also diff --git a/Identity/Manual/Directories/trunk/Locales/Identity/Widgets.texi b/Identity/Manual/Directories/trunk/Locales/Identity/Widgets.texi deleted file mode 100644 index e699d83..0000000 --- a/Identity/Manual/Directories/trunk/Locales/Identity/Widgets.texi +++ /dev/null @@ -1,23 +0,0 @@ -@subsection Goals - -@itemize -@item ... -@end itemize - -@subsection Description - -@itemize -@item ... -@end itemize - -@subsection Usage - -@itemize -@item ... -@end itemize - -@subsection See also - -@menu -@comment --- Removed(* Directories trunk Translations Identity Widgets::) --- -@end menu