From 9389f91a7fb0c2cbfe4220002785abc5937a8be1 Mon Sep 17 00:00:00 2001 From: Alain Reguera Delgado Date: Apr 02 2011 15:34:09 +0000 Subject: Update repository documentation manual. --- diff --git a/Identity/Manual/Directories/trunk/Identity/Locales/Identity.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity.texi new file mode 100755 index 0000000..fb39647 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity.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/Brands.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands.texi new file mode 100755 index 0000000..fb39647 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands.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/Brands/Tpl.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands/Tpl.texi new file mode 100755 index 0000000..fb39647 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Brands/Tpl.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/Fonts.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Fonts.texi new file mode 100755 index 0000000..fb39647 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Fonts.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/Models.texi b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Models.texi new file mode 100755 index 0000000..fb39647 --- /dev/null +++ b/Identity/Manual/Directories/trunk/Identity/Locales/Identity/Models.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/repository.css b/Identity/Manual/repository.css index 3729c68..e0a60f3 100755 --- a/Identity/Manual/repository.css +++ b/Identity/Manual/repository.css @@ -39,3 +39,9 @@ div#content table tr td, div#content table tr th { border:none; } + +/* Texi2html specific definitions. +----------------------------------*/ +div#content pre.example { + padding: 0.5em 1em; +} diff --git a/Identity/Manual/repository.info.bz2 b/Identity/Manual/repository.info.bz2 index c12942c..6267462 100644 Binary files a/Identity/Manual/repository.info.bz2 and b/Identity/Manual/repository.info.bz2 differ diff --git a/Identity/Manual/repository.pdf b/Identity/Manual/repository.pdf index 91780cd..5afac2d 100644 Binary files a/Identity/Manual/repository.pdf and b/Identity/Manual/repository.pdf differ diff --git a/Identity/Manual/repository.txt.bz2 b/Identity/Manual/repository.txt.bz2 index 61c073b..9a05f5f 100644 Binary files a/Identity/Manual/repository.txt.bz2 and b/Identity/Manual/repository.txt.bz2 differ diff --git a/Identity/Manual/repository.xhtml.tar.bz2 b/Identity/Manual/repository.xhtml.tar.bz2 index e96c741..21aa9ab 100644 Binary files a/Identity/Manual/repository.xhtml.tar.bz2 and b/Identity/Manual/repository.xhtml.tar.bz2 differ diff --git a/Identity/Manual/repository.xml b/Identity/Manual/repository.xml index 5609f43..5cdd775 100644 --- a/Identity/Manual/repository.xml +++ b/Identity/Manual/repository.xml @@ -333,11 +333,6 @@ manual_deleteCrossReferences.sh manual_searchIndex.sh - Directories trunk Identity Colors - Directories trunk Identity Colors - - - Directories trunk Identity Fonts Directories trunk Identity Fonts @@ -348,53 +343,8 @@ manual_deleteCrossReferences.sh manual_searchIndex.sh - Directories trunk Identity Locales Identity - Directories trunk Identity Locales Identity - - - - Directories trunk Identity Locales Identity Brands - Directories trunk Identity Locales Identity Brands - - - - Directories trunk Identity Locales Identity Brands Tpl - Directories trunk Identity Locales Identity Brands Tpl - - - - Directories trunk Identity Locales Identity Fonts - Directories trunk Identity Locales Identity Fonts - - - - Directories trunk Identity Locales Identity Models - Directories trunk Identity Locales Identity Models - - - - Directories trunk Identity Locales Identity Release - Directories trunk Identity Locales Identity Release - - - - Directories trunk Identity Locales Identity Themes - Directories trunk Identity Locales Identity Themes - - - - Directories trunk Identity Locales Identity Themes Backgrounds - Directories trunk Identity Locales Identity Themes Backgrounds - - - - Directories trunk Identity Locales Identity Themes Distro Anaconda Progress - Directories trunk Identity Locales Identity Themes Distro Anaconda Progress - - - - Directories trunk Identity Locales Identity Widgets - Directories trunk Identity Locales Identity Widgets + Directories trunk Identity Palettes + Directories trunk Identity Palettes @@ -408,11 +358,6 @@ manual_deleteCrossReferences.sh manual_searchIndex.sh - Directories trunk Identity Themes Models Alternative - Directories trunk Identity Themes Models Alternative - - - Directories trunk Identity Themes Models Default Directories trunk Identity Themes Models Default @@ -543,11 +488,6 @@ manual_deleteCrossReferences.sh manual_searchIndex.sh - Directories trunk Identity Widgets - Directories trunk Identity Widgets - - - Directories trunk Scripts Directories trunk Scripts @@ -798,7 +738,7 @@ manual_deleteCrossReferences.sh manual_searchIndex.sh The CentOS Colors The CentOS Fonts provides the color information used along The CentOS Project visual manifestations. - See Directories trunk Identity Colors, for more information. + See Directories trunk Identity Palettes, for more information. @@ -875,7 +815,7 @@ centos-art render trunk/Identity/Path/To/Dir Directories trunk Identity Brands - Directories trunk Identity Colors + Directories trunk Identity Fonts Directories trunk Identity Directories
@@ -907,54 +847,9 @@ centos-art render trunk/Identity/Path/To/Dir
- Directories trunk Identity Colors - Directories trunk Identity Fonts - Directories trunk Identity Brands - Directories -
- The <file>trunk/Identity/Colors</file> Directory - Directories trunk Identity Colors - - Goals - - - - ... - - - - - - Description - - - - ... - - - - - - Usage - - - - ... - - - - - - See also - - - -
-
- Directories trunk Identity Fonts Directories trunk Identity Locales - Directories trunk Identity Colors + Directories trunk Identity Brands Directories
The <file>trunk/Identity/Fonts</file> Directory @@ -1004,7 +899,7 @@ centos-art render trunk/Identity/Path/To/Dir Directories trunk Identity Locales - Directories trunk Identity Locales Identity + Directories trunk Identity Palettes Directories trunk Identity Fonts Directories
@@ -1027,467 +922,13 @@ centos-art render trunk/Identity/Path/To/Dir
- Directories trunk Identity Locales Identity - Directories trunk Identity Locales Identity Brands - Directories trunk Identity Locales - Directories -
- The <file>trunk/Identity/Locales/Identity</file> Directory - Directories trunk Identity Locales Identity - - Goals - - - - ... - - - - - - Description - - - - ... - - - - - - Usage - - - - ... - - - - - - See also - - - - - - - - - Directories trunk Identity - Directories trunk Identity - - - - -
-
- - Directories trunk Identity Locales Identity Brands - Directories trunk Identity Locales Identity Brands Tpl - Directories trunk Identity Locales Identity - Directories -
- The <file>trunk/Identity/Locales/Identity/Brands</file> Directory - Directories trunk Identity Locales Identity Brands - - Goals - - - - Organize brands' translation files. - - - - - - Description - Translation files, inside trunk/Translations/Identity/Brands translation entry, don't use default rendering translation functionality, they use the following translation pre-rendering configuration file instead: - - Inside trunk/Translations/Identity/Brands translation entry, translation files are symbolic links pointing to the common template translation structure, inside the translation template (Tpl/) directory. - Inside 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 (Tpl/) directory structure applies to each single design template available. - For example, if the brands' translation template (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 centos-art script considers translation symbolic links as translation files. - Translation file names, inside brands' translation template (Tpl) directory have special meaning: - - - Conventional file names - Translation brands file names Convenctional file names look like blue.sed, 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. - - - - Numeric file names - Translation brands file names Numeric file names look like 300.sed, 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 width defined by the number part of the translation file name. The image height is automatically scaled based on the previous 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. - - - - Translation markers - Inside trunk/Translations/Identity/Brands/, translation files combine the following translation markers: - - - #000000 - - Specify which color to use when rendering brand images. - - Note As translation files inside trunk/Translations/Identity/Brands are symbolic links that point to template translation files, translation markers are defined inside template translation files. - - - -
-
-
- - - Usage - How to render brands' translation files To render brands' translation files, use the following command: - - - - - See also - - - - Directories trunk Identity Brands - Directories trunk Identity Brands - - - - -
-
- - Directories trunk Identity Locales Identity Brands Tpl - Directories trunk Identity Locales Identity Fonts - Directories trunk Identity Locales Identity Brands - Directories -
- The <file>trunk/Identity/Locales/Identity/Brands/Tpl</file> Directory - Directories trunk Identity Locales Identity Brands Tpl - - Goals - - - - Description - - - - Usage - - - - See also - - - -
-
- - Directories trunk Identity Locales Identity Fonts - Directories trunk Identity Locales Identity Models - Directories trunk Identity Locales Identity Brands Tpl - Directories -
- The <file>trunk/Identity/Locales/Identity/Fonts</file> Directory - Directories trunk Identity Locales Identity Fonts - - Goals - This section exists to organize fonts translation files. - - - - Description - Translation files, inside trunk/Translations/Fonts, have the following structure: - - Inside 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. - - Important Do not create translation files for font-families not used somewhere inside CentOS visual identity. The identity of font entry (see Directories trunk Identity Fonts) is used as reference when someone needs to know which font-families are allowed to use inside CentOS visual identity. - - - - Translation Markers - Inside trunk/Translations/Identity/Fonts, translation files combine the following translation markers: - - - font-family:Denmark - - Specify which font family to use when rendering font preview images. - - - - font-weight:normal - - Specify which font weight to use when rendering font preview images. - - - - font-style:normal - - Specify which font style to use when rendering font preview images. - - -
-
-
- - - Usage - How to render fonts' translation files Inside trunk/Translations/Fonts you use your favorite text editor to create translation files. Inside trunk/Translations/Fonts there is not translation template directory (Tpl/), nor translation rendering using centos-art script. For example, to create the dejavu_lgc_sans-boldoblique.sed translation file using vim editor, type the following command: - - - - - See also - - - Directories trunk Identity Fonts - Directories trunk Identity Fonts - - - - -
-
- - Directories trunk Identity Locales Identity Models - Directories trunk Identity Locales Identity Release - Directories trunk Identity Locales Identity Fonts - Directories -
- The <file>trunk/Identity/Locales/Identity/Models</file> Directory - Directories trunk Identity Locales Identity Models - - Goals - - - - Description - - - - Usage - - - - See also - - - -
-
- - Directories trunk Identity Locales Identity Release - Directories trunk Identity Locales Identity Themes - Directories trunk Identity Locales Identity Models - Directories -
- The <file>trunk/Identity/Locales/Identity/Release</file> Directory - Directories trunk Identity Locales Identity Release - - Goals - - - - Description - - - - Usage - - - - See also - - - -
-
- - Directories trunk Identity Locales Identity Themes - Directories trunk Identity Locales Identity Themes Backgrounds - Directories trunk Identity Locales Identity Release - Directories -
- The <file>trunk/Identity/Locales/Identity/Themes</file> Directory - Directories trunk Identity Locales Identity Themes - - Goals - - - - Description - - - - Usage - - - - See also - - - -
-
- - Directories trunk Identity Locales Identity Themes Backgrounds - Directories trunk Identity Locales Identity Themes Distro Anaconda Progress - Directories trunk Identity Locales Identity Themes - Directories -
- The <file>trunk/Identity/Locales/Identity/Themes/Backgrounds</file> Directory - Directories trunk Identity Locales Identity Themes Backgrounds - - Goals - - - - ... - - - - - - Description - - - - ... - - - - - - Usage - - - - ... - - - - - - See also - - - -
-
- - Directories trunk Identity Locales Identity Themes Distro Anaconda Progress - Directories trunk Identity Locales Identity Widgets - Directories trunk Identity Locales Identity Themes Backgrounds - Directories -
- The <file>trunk/Identity/Locales/Identity/Themes/Distro/Anaconda/Progress</file> Directory - Directories trunk Identity Locales Identity Themes Distro Anaconda Progress - - Goals - - - - Organize Anaconda progress translation templates. - - - Organize Anaconda progress translation files in several languages and major releases of CentOS distribution. - - - - - - Description - Use the following command to produce translation files based: - 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 - 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: - centos-art render --translation --filter='3,4,5' - The above commands will produce the following translation structure: - 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 - 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 trunk/Identity structure and render them. - - - - See Directories trunk Identity Themes Motifs Modern Distro Anaconda Progress. - - - - - - Usage - Translation rendering is described in trunk/Translations documentation entry (— Removed(pxref:trunk Translations) —). - - - - See also - -
-
- - Directories trunk Identity Locales Identity Widgets + Directories trunk Identity Palettes Directories trunk Identity Themes - Directories trunk Identity Locales Identity Themes Distro Anaconda Progress + Directories trunk Identity Locales Directories
- The <file>trunk/Identity/Locales/Identity/Widgets</file> Directory - Directories trunk Identity Locales Identity Widgets + The <file>trunk/Identity/Palettes</file> Directory + Directories trunk Identity Palettes Goals @@ -1521,7 +962,6 @@ vim /home/centos/artwork/trunk/Translations/Fonts/dejavu_lgc_sans-boldoblique.se See also -
@@ -1529,7 +969,7 @@ vim /home/centos/artwork/trunk/Translations/Fonts/dejavu_lgc_sans-boldoblique.se Directories trunk Identity Themes Directories trunk Identity Themes Models - Directories trunk Identity Locales Identity Widgets + Directories trunk Identity Palettes Directories
The <file>trunk/Identity/Themes</file> Directory @@ -1579,7 +1019,7 @@ vim /home/centos/artwork/trunk/Translations/Fonts/dejavu_lgc_sans-boldoblique.se Directories trunk Identity Themes Models - Directories trunk Identity Themes Models Alternative + Directories trunk Identity Themes Models Default Directories trunk Identity Themes Directories
@@ -1603,47 +1043,20 @@ vim /home/centos/artwork/trunk/Translations/Fonts/dejavu_lgc_sans-boldoblique.se Usage - Inside the framework location above, you find theme models organized by name. You can add your own theme models to the structure by adding a directory to the list. By default you have the `See Directories trunk Identity Themes Models DefaultDefault,' and `See Directories trunk Identity Themes Models AlternativeAlternative,' ready-to-use theme models. - - - - See also - - - -
-
- - Directories trunk Identity Themes Models Alternative - Directories trunk Identity Themes Models Default - Directories trunk Identity Themes Models - Directories -
- The <file>trunk/Identity/Themes/Models/Alternative</file> Directory - Directories trunk Identity Themes Models Alternative - - Goals - - - - ... - - - - - - Description - CentOS alternative theme models exist for people how want to use a different visual style on their installations of CentOS distribution. As the visual style is needed for a system already installed components like Anaconda are not required inside alternative themes. Inside alternative themes you find post-installation visual style only (i.e. Backgrounds, Display Managers, Grub, etc.). CentOS alternative themes are maintained by CentOS Community. - - - - Usage - - - - ... - - + + + Default Design Model + + Default Design Models for CentOS Themes provide the common structural information (e.g., image dimensions, translation markers, trademark position, etc.) the centos-art script uses to produce images when no other design model is specified. + + + + Alternative Design Models + + CentOS alternative theme models exist for people how want to use a different visual style on their installations of CentOS distribution. As the visual style is needed for a system already installed components like Anaconda are not required inside alternative themes. Inside alternative themes you find post-installation visual style only (i.e. Backgrounds, Display Managers, Grub, etc.). CentOS alternative themes are maintained by CentOS Community. + + +
@@ -1656,7 +1069,7 @@ vim /home/centos/artwork/trunk/Translations/Fonts/dejavu_lgc_sans-boldoblique.se Directories trunk Identity Themes Models Default Directories trunk Identity Themes Models Default Concept - Directories trunk Identity Themes Models Alternative + Directories trunk Identity Themes Models Directories
The <file>trunk/Identity/Themes/Models/Default</file> Directory @@ -3159,7 +2572,7 @@ trunk/Identity/Themes/Motifs/TreeFlower/Colors/syslinux.hex Directories trunk Identity Webenv - Directories trunk Identity Widgets + Directories trunk Scripts Directories trunk Identity Themes Motifs TreeFlower Backgrounds Directories
@@ -3421,42 +2834,9 @@ priority=10
- Directories trunk Identity Widgets - Directories trunk Scripts - Directories trunk Identity Webenv - Directories -
- The <file>trunk/Identity/Widgets</file> Directory - Directories trunk Identity Widgets - - Goals - - - - ... - - - - - - Description - - - - Usage - - - - See also - - - -
-
- Directories trunk Scripts Directories trunk Scripts Functions - Directories trunk Identity Widgets + Directories trunk Identity Webenv Directories
The <file>trunk/Scripts</file> Directory