From 5b74ef709d8accab9a41c7e0a97dd86ffc3a07ed Mon Sep 17 00:00:00 2001 From: Alain Reguera Delgado Date: Apr 02 2011 15:25:47 +0000 Subject: Update repository documentation manual. - Remove trunk/Identity/Locales/Identity and related documentation entries from repository documentation manual. These entries contain obsolete information. Sed translations are no longer used as described here. - At this moment content translation is rather straightforward and could be covered in trunk/Identity/Locales documentation entry. --- diff --git a/Identity/Manual/Directories/chapter-menu.texi b/Identity/Manual/Directories/chapter-menu.texi index 1c07d55..2f7530c 100644 --- a/Identity/Manual/Directories/chapter-menu.texi +++ b/Identity/Manual/Directories/chapter-menu.texi @@ -6,11 +6,6 @@ * Directories trunk Identity Brands:: * 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 Palettes:: * Directories trunk Identity Themes:: * Directories trunk Identity Themes Models:: diff --git a/Identity/Manual/Directories/chapter-nodes.texi b/Identity/Manual/Directories/chapter-nodes.texi index 03622b3..8aa3066 100644 --- a/Identity/Manual/Directories/chapter-nodes.texi +++ b/Identity/Manual/Directories/chapter-nodes.texi @@ -33,31 +33,6 @@ @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 Palettes @section The @file{trunk/Identity/Palettes} Directory @cindex Directories trunk Identity Palettes diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity.texi deleted file mode 100644 index beeb9a7..0000000 --- a/Identity/Manual/Directories/trunk/Identity/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/Identity/Locales/Identity/Brands.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands.texi deleted file mode 100644 index f1495d7..0000000 --- a/Identity/Manual/Directories/trunk/Identity/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/Identity/Locales/Identity/Brands/Tpl.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands/Tpl.texi deleted file mode 100644 index b53171e..0000000 --- a/Identity/Manual/Directories/trunk/Identity/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/Identity/Locales/Identity/Fonts.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Fonts.texi deleted file mode 100644 index b6b177a..0000000 --- a/Identity/Manual/Directories/trunk/Identity/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/Identity/Locales/Identity/Models.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Models.texi deleted file mode 100644 index b53171e..0000000 --- a/Identity/Manual/Directories/trunk/Identity/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/Identity/Locales/Identity/Themes/Distro/Anaconda/Progress.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes/Distro/Anaconda/Progress.texi deleted file mode 100755 index fb39647..0000000 --- a/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Themes/Distro/Anaconda/Progress.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