From d8d967b2bfc0f64170dd6436d99173c69eecbe5a Mon Sep 17 00:00:00 2001 From: Alain Reguera Delgado Date: May 02 2011 03:44:30 +0000 Subject: Update repository documentation manual. --- diff --git a/Manual/Directories/trunk/Scripts/Functions/Render.texi b/Manual/Directories/trunk/Scripts/Functions/Render.texi index 31238fa..946c864 100644 --- a/Manual/Directories/trunk/Scripts/Functions/Render.texi +++ b/Manual/Directories/trunk/Scripts/Functions/Render.texi @@ -1,12 +1,12 @@ -@subheading NAME +@subheading Name -This section describes the @code{render} functionality of -@command{centos-art.sh} script and general examples about content -rendition inside a working copy of CentOS Artwork Repository. +The @strong{@code{render}} functionlity is part of +@command{centos-art.sh} script and standardizes rendition tasks inside +the working copy of CentOS Artwork Repository. -@subheading SYNOPSIS +@subheading Synopsis -@command{centos-art render [] path/to/dir} +@command{centos-art} @code{@strong{render}} @code{[OPTION] path/to/dir} The @file{path/to/dir} parameter refers the path information related to the directory structure inside the working copy of CentOS Artwork @@ -20,11 +20,83 @@ producing theme components. Sometimes, you can also combine the use of @file{path/to/dir} with the @option{--filter} option to have a finer control over the files you produce. -@subheading DESCRIPTION +The @code{render} functionality of @command{centos-art.sh} script +accepts the following options: + +@table @option +@item --quiet + +Supress all output messages, including confirmation question. Use this +option with care. + +@item --filter="REGEX" + +Reduce the list of files to process using @samp{REGEX} as pattern. + +@item --answer-yes + +Assume `yes' to all confirmation questions. + +@item --dont-commit-changes + +Supress all commit and update actions realized over files already +processed, before and after the action itself had took place in the +working copy. + +@item --releasever="STRING" + +Produce content for the release version specified in @samp{STRING}. +This option is generaly used in direct rendition, where design models +aren't organized using release versions and architectures as +reference. + +@item --basearch="STRING" + +Produce content for the architecture specified in @samp{STRING}. This +option is generaly used in direct rendition, where design models aren't +organized using release versions and architectures as reference. + +@item --convert="STRING" + +Uses post-rendition to convert output produced by base-rendition to +any image format specified in @samp{STRING}. This option is an +interface for the @command{convert} command of ImageMagick tool set, +so it is applicable to images output only. + +@item --rotate="STRING" + +Uses post-rendition to rotate output produced by base-rendition to any +angle specified in @samp{STRING}. This option is an interface for the +@command{convert} command of ImageMagick tool set, so it is +applicable to images output only. + +@item --resize="STRING" + +Uses post-rendition to resize the base-rendition output to any angle +specified in @samp{STRING}. This option is an interface for the +@command{convert} command of ImageMagick tool set, so it is applicable +to images output only. + +@item --group-by="STRING" + +Group base output files inside directories. Directories used to stored +base output files are named using the file extension of base output +files. For example: if the base output file is a @file{.png} file, it +is moved inside a @file{Png/} directory; if the current file is a +@file{.jpg} file, it is stored inside a @file{Jpg/} directory, and so +on. + +Directories used to group files are created in the same location that +base output files would normaly do. + +@item --theme-model="STRING" +Specify, in the @samp{STRING}, the name of the theme model you want to +use to produce theme motifs. By default, if this option is not passed, +the @samp{Default} theme model is used as reference to produce theme +motifs. +@end table -The @code{render} functionlity of @command{centos-art.sh} script -standardizes rendition tasks inside the working copy of CentOS Artwork -Repository. +@subheading Description Inside the working copy of CentOS Artwork Repository, rendition tasks take place inside renderable directories. Inside the @code{render} @@ -186,95 +258,35 @@ of the input file. Translation messages are stored under functionality of @command{centos-art.sh} script (@pxref{Directories trunk Scripts Functions Locale}). -@subheading OPTIONS - -The @code{render} functionality of @command{centos-art.sh} script -accepts the following optios: - -@table @option -@item --quiet - -Supress all output messages, including confirmation question. Use this -option with care. - -@item --filter="REGEX" - -Reduce the list of files to process using @samp{REGEX} as pattern. - -@item --answer-yes - -Assume `yes' to all confirmation questions. - -@item --dont-commit-changes - -Supress all commit and update actions realized over files already -processed, before and after the action itself had took place in the -working copy. - -@item --releasever="STRING" - -Produce content for the release version specified in @samp{STRING}. -This option is generaly used in direct rendition, where design models -aren't organized using release versions and architectures as -reference. - -@item --basearch="STRING" - -Produce content for the architecture specified in @samp{STRING}. This -option is generaly used in direct rendition, where design models aren't -organized using release versions and architectures as reference. - -@item --convert="STRING" - -Uses post-rendition to convert output produced by base-rendition to -any image format specified in @samp{STRING}. This option is an -interface for the @command{convert} command of ImageMagick tool set, -so it is applicable to images output only. - -@item --rotate="STRING" +@subheading Examples -Uses post-rendition to rotate output produced by base-rendition to any -angle specified in @samp{STRING}. This option is an interface for the -@command{convert} command of ImageMagick tool set, so it is -applicable to images output only. +@verbatim +centos-art render trunk/Identity/Images/Brands +@end verbatim -@item --resize="STRING" - -Uses post-rendition to resize the base-rendition output to any angle -specified in @samp{STRING}. This option is an interface for the -@command{convert} command of ImageMagick tool set, so it is applicable -to images output only. +@verbatim +centos-art render trunk/Identity/Images/Brands --filter="symbol" +@end verbatim -@item --group-by="STRING" +@verbatim +centos-art render trunk/Identity/Images/Themes/Flame/2 +@end verbatim -Group base output files inside directories. Directories used to stored -base output files are named using the file extension of base output -files. For example: if the base output file is a @file{.png} file, it -is moved inside a @file{Png/} directory; if the current file is a -@file{.jpg} file, it is stored inside a @file{Jpg/} directory, and so -on. +@subheading Author -Directories used to group files are created in the same location that -base output files would normaly do. +Written by Alain Reguera Delgado. -@item --theme-model="STRING" -Specify, in the @samp{STRING}, the name of the theme model you want to -use to produce theme motifs. By default, if this option is not passed, -the @samp{Default} theme model is used as reference to produce theme -motifs. -@end table +@subheading Reporting bugs -@subsubheading Examples +Report bugs to @email{centos-artwork@@centos.org} mailing list. -@table @command -@item centos-art render trunk/Identity/Images/Brands -@item centos-art render trunk/Identity/Images/Brands --filter="symbol" -@item centos-art render trunk/Identity/Images/Themes/Flame/2 -@end table +@subheading Copyright -@subheading AUTHOR +Copyright @copyright{} 2009, 2010, 2011 The CentOS Project. -Copyright @copyright{} 2009, 2010, 2011 Alain Reguera Delgado. +This is free software. You may redistribute copies of it under the +terms of the GNU General Public License (@pxref{GNU General Public +License}). There is NO WARRANTY, to the extent permitted by law. @subheading See also diff --git a/Manual/Introduction/repo-convenctions.texi b/Manual/Introduction/repo-convenctions.texi index ccab922..a12d499 100644 --- a/Manual/Introduction/repo-convenctions.texi +++ b/Manual/Introduction/repo-convenctions.texi @@ -145,14 +145,14 @@ generally produced as rastered images. The result produced from combining one design model with one artistic motif is what we know as a @emph{theme}. Inside themes directory -structure (@pxref{Directories trunk Identity Themes}), you can find +structure (@pxref{Directories trunk Identity Images Themes}), you can find several design models and several artistic motifs independently one another that can be albitrarily combined through @emph{theme rendition}, a flexible way to produce images for different visual manifestations in very specific visual styles. Inside themes directory structure, theme rendition is performed in -@file{trunk/Identity/Themes/Motifs} directory structure, the required -design models are taken from @file{trunk/Identity/Themes/Models} +@file{trunk/Identity/Images/Themes} directory structure, the required +design models are taken from @file{trunk/Identity/Models/Themes} directory structure and the action itself is controlled by the @code{render} functionality of @command{centos-art.sh} script. @@ -368,15 +368,15 @@ design models and version @file{3} of @file{Flame} artistic motif: -----+---------------+------------------------------------------------------+------+----------- Path | Suffix | Identifier |Prefix| Type -----+---------------+------------------------------------------------------+------+----------- - A | |trunk/Identity/Themes/Models/Default/Distro/5/Anaconda| | Directory + A | |trunk/Identity/Models/Themes/Default/Distro/5/Anaconda| | Directory -----+---------------+------------------------------------------------------+------+----------- - B | trunk/Manual/|trunk/Identity/Themes/Models/Default/Distro/5/Anaconda|.texi | File + B | trunk/Manual/|trunk/Identity/Models/Themes/Default/Distro/5/Anaconda|.texi | File -----+---------------+------------------------------------------------------+------+----------- - C | trunk/Locales/|trunk/Identity/Themes/Models/Default/Distro/5/Anaconda| | Directory + C | trunk/Locales/|trunk/Identity/Models/Themes/Default/Distro/5/Anaconda| | Directory -----+---------------+------------------------------------------------------+------+----------- - D | |trunk/Identity/Themes/Motifs/Flame/3/Distro/5/Anaconda| | Directory + D | |trunk/Identity/Images/Themes/Flame/3/Distro/5/Anaconda| | Directory -----+---------------+------------------------------------------------------+------+----------- - E | trunk/Locales/|trunk/Identity/Themes/Motifs/Flame/3/Distro/5/Anaconda|.texi | File + E | trunk/Locales/|trunk/Identity/Images/Themes/Flame/3/Distro/5/Anaconda|.texi | File -----+---------------+------------------------------------------------------+------+----------- A = Master path. @@ -507,14 +507,14 @@ idea that justifies its existence. To build a directory structure, you need to define the conceptual idea first and later create the directory. There are some locations inside the repository that already define some concepts you probably want to -reuse. For example, @file{trunk/Identity/Themes/Motifs} to store theme -artistic motifs, @file{trunk/Identity/Themes/Models} to store theme +reuse. For example, @file{trunk/Identity/Images/Themes} to store theme +artistic motifs, @file{trunk/Identity/Models/Themes} to store theme design models, @file{trunk/Manual} to store documentation files, @file{trunk/Locales} to store translation messages, @file{trunk/Scripts} to store automation scripts and so on. To illustrate this desition process let's consider the -@file{trunk/Identity/Themes/Motifs/TreeFlower/3} directory structure +@file{trunk/Identity/Images/Themes/TreeFlower/3} directory structure as example. This directory can be read as: the theme development line of version @file{3} of @file{TreeFlower} artistic motif. Additional, we can identify that artistic motifs are part of themes as well as @@ -527,9 +527,9 @@ in the list of commands bellow. centos-art help --read turnk centos-art help --read turnk/Identity centos-art help --read turnk/Identity/Themes -centos-art help --read turnk/Identity/Themes/Motifs -centos-art help --read turnk/Identity/Themes/Motifs/TreeFlower -centos-art help --read turnk/Identity/Themes/Motifs/TreeFlower/3 +centos-art help --read turnk/Identity/Images/Themes +centos-art help --read turnk/Identity/Images/Themes/TreeFlower +centos-art help --read turnk/Identity/Images/Themes/TreeFlower/3 @end verbatim The concepts behind other location can be found in the same way diff --git a/Manual/repository.info.bz2 b/Manual/repository.info.bz2 index d7c7288..64d7844 100644 Binary files a/Manual/repository.info.bz2 and b/Manual/repository.info.bz2 differ diff --git a/Manual/repository.pdf b/Manual/repository.pdf index 0499be7..2e08d92 100644 Binary files a/Manual/repository.pdf and b/Manual/repository.pdf differ diff --git a/Manual/repository.txt.bz2 b/Manual/repository.txt.bz2 index c5b6113..ac8ccc9 100644 Binary files a/Manual/repository.txt.bz2 and b/Manual/repository.txt.bz2 differ diff --git a/Manual/repository.xhtml.tar.bz2 b/Manual/repository.xhtml.tar.bz2 index d4e42b3..ac18233 100644 Binary files a/Manual/repository.xhtml.tar.bz2 and b/Manual/repository.xhtml.tar.bz2 differ diff --git a/Manual/repository.xml b/Manual/repository.xml index a0dfd80..163529f 100644 --- a/Manual/repository.xml +++ b/Manual/repository.xml @@ -388,7 +388,7 @@ manual_deleteCrossReferences.sh manual_searchIndex.sh The CentOS Project Corporate Visual Identity is made of different visual manifestations (e.g., Distributions, Web sites, Stationery, etc.). Visual manifestations implement the corporate identity concepts by mean of images. To produce these images, we decompose image production in design models and artistic motifs. Design models provide the structural information of images (i.e., dimension, position of common elements in the visible area, translation markers, etc.) and they are generally produced as scalable vector graphics to take advantage of SVG standard, an XML-based standard. Artistic motifs provide the visual style (i.e., the background information, the look and feel) some design models need to complete the final image produced by automation scripts. Artistic motifs are generally produced as rastered images. - The result produced from combining one design model with one artistic motif is what we know as a theme. Inside themes directory structure (see Directories trunk Identity Themes), you can find several design models and several artistic motifs independently one another that can be albitrarily combined through theme rendition, a flexible way to produce images for different visual manifestations in very specific visual styles. Inside themes directory structure, theme rendition is performed in trunk/Identity/Themes/Motifs directory structure, the required design models are taken from trunk/Identity/Themes/Models directory structure and the action itself is controlled by the render functionality of centos-art.sh script. + The result produced from combining one design model with one artistic motif is what we know as a theme. Inside themes directory structure (see Directories trunk Identity Images Themes), you can find several design models and several artistic motifs independently one another that can be albitrarily combined through theme rendition, a flexible way to produce images for different visual manifestations in very specific visual styles. Inside themes directory structure, theme rendition is performed in trunk/Identity/Images/Themes directory structure, the required design models are taken from trunk/Identity/Models/Themes directory structure and the action itself is controlled by the render functionality of centos-art.sh script. In addition to theme rendition you can find direct rendition, too. Direct rendition is another way of image production where there is no artistic motif at all but design models only. Direct rendition is very useful to produce simple content that doesn't need specific background information. Some of these contents are brands, icons and illustrations. Direct rendition is performed in trunk/Identity/Images, the required design models are taken from trunk/Identity/Models directory structure and the action itself is controlled by the render functionality of centos-art.sh script. See Directories trunk Identity, for more information about The CentOS Corporate Identity and how graphic design fits on it. @@ -470,15 +470,15 @@ Path | Suffix | Identifier |Prefix| Type -----+---------------+------------------------------------------------------+------+----------- Path | Suffix | Identifier |Prefix| Type -----+---------------+------------------------------------------------------+------+----------- - A | |trunk/Identity/Themes/Models/Default/Distro/5/Anaconda| | Directory + A | |trunk/Identity/Models/Themes/Default/Distro/5/Anaconda| | Directory -----+---------------+------------------------------------------------------+------+----------- - B | trunk/Manual/|trunk/Identity/Themes/Models/Default/Distro/5/Anaconda|.texi | File + B | trunk/Manual/|trunk/Identity/Models/Themes/Default/Distro/5/Anaconda|.texi | File -----+---------------+------------------------------------------------------+------+----------- - C | trunk/Locales/|trunk/Identity/Themes/Models/Default/Distro/5/Anaconda| | Directory + C | trunk/Locales/|trunk/Identity/Models/Themes/Default/Distro/5/Anaconda| | Directory -----+---------------+------------------------------------------------------+------+----------- - D | |trunk/Identity/Themes/Motifs/Flame/3/Distro/5/Anaconda| | Directory + D | |trunk/Identity/Images/Themes/Flame/3/Distro/5/Anaconda| | Directory -----+---------------+------------------------------------------------------+------+----------- - E | trunk/Locales/|trunk/Identity/Themes/Motifs/Flame/3/Distro/5/Anaconda|.texi | File + E | trunk/Locales/|trunk/Identity/Images/Themes/Flame/3/Distro/5/Anaconda|.texi | File -----+---------------+------------------------------------------------------+------+----------- A = Master path. @@ -515,15 +515,15 @@ Path | Suffix | Identifier |Pre Extending repository organization Occasionly, you may find that new components of The CentOS Project Corporate Identity need to be added to the repository in order to work them out. If that is the case, the first question we need to ask ourselves, before start to create directories blindly all over, is: What is the right place to store it? The best place to find answers is in The CentOS Community (see page http://wiki.centos.org/GettingHelp), but going there with hands empty is not good idea. It may give the impression you don't really care about. Instead, consider the following suggestions to find your own comprehension in order to make your own propositions based on it. When extending respository structure it is very useful to bear in mind The CentOS Project Corporate Identity Structure (see Directories trunk Identity) The CentOS Mission and The CentOS Release Schema. The rest is just matter of choosing appropriate names. It is also worth to know that each directory in the repository responds to a conceptual idea that justifies its existence. - To build a directory structure, you need to define the conceptual idea first and later create the directory. There are some locations inside the repository that already define some concepts you probably want to reuse. For example, trunk/Identity/Themes/Motifs to store theme artistic motifs, trunk/Identity/Themes/Models to store theme design models, trunk/Manual to store documentation files, trunk/Locales to store translation messages, trunk/Scripts to store automation scripts and so on. - To illustrate this desition process let's consider the trunk/Identity/Themes/Motifs/TreeFlower/3 directory structure as example. This directory can be read as: the theme development line of version 3 of TreeFlower artistic motif. Additional, we can identify that artistic motifs are part of themes as well as themes are part of The CentOS Project Corporate Identity. These concepts are better described independently in each documentation entry related to the directory structure as it is respectively shown in the list of commands bellow. + To build a directory structure, you need to define the conceptual idea first and later create the directory. There are some locations inside the repository that already define some concepts you probably want to reuse. For example, trunk/Identity/Images/Themes to store theme artistic motifs, trunk/Identity/Models/Themes to store theme design models, trunk/Manual to store documentation files, trunk/Locales to store translation messages, trunk/Scripts to store automation scripts and so on. + To illustrate this desition process let's consider the trunk/Identity/Images/Themes/TreeFlower/3 directory structure as example. This directory can be read as: the theme development line of version 3 of TreeFlower artistic motif. Additional, we can identify that artistic motifs are part of themes as well as themes are part of The CentOS Project Corporate Identity. These concepts are better described independently in each documentation entry related to the directory structure as it is respectively shown in the list of commands bellow. The concepts behind other location can be found in the same way described above, just change the path information used above to the one you are trying to know concepts for. @@ -585,128 +585,128 @@ centos-art help --read turnk/Identity/Themes/Motifs/TreeFlower/3 - Directories trunk Identity Models - Directories trunk Identity Models + Directories trunk Identity Images Themes + Directories trunk Identity Images Themes - Directories trunk Identity Models Brands - Directories trunk Identity Models Brands + Directories trunk Identity Images Themes Motifs + Directories trunk Identity Images Themes Motifs - Directories trunk Identity Palettes - Directories trunk Identity Palettes + Directories trunk Identity Images Themes Motifs Flame + Directories trunk Identity Images Themes Motifs Flame - Directories trunk Identity Patterns - Directories trunk Identity Patterns + Directories trunk Identity Images Themes Motifs Modern + Directories trunk Identity Images Themes Motifs Modern - Directories trunk Identity Themes - Directories trunk Identity Themes + Directories trunk Identity Images Themes Motifs Pipes + Directories trunk Identity Images Themes Motifs Pipes - Directories trunk Identity Themes Models - Directories trunk Identity Themes Models + Directories trunk Identity Images Themes Motifs TreeFlower + Directories trunk Identity Images Themes Motifs TreeFlower - Directories trunk Identity Themes Models Default - Directories trunk Identity Themes Models Default + Directories trunk Identity Models + Directories trunk Identity Models - Directories trunk Identity Themes Models Default Concept - Directories trunk Identity Themes Models Default Concept + Directories trunk Identity Models Brands + Directories trunk Identity Models Brands - Directories trunk Identity Themes Models Default Distro - Directories trunk Identity Themes Models Default Distro + Directories trunk Identity Models Themes + Directories trunk Identity Models Themes - Directories trunk Identity Themes Models Default Distro 5 - Directories trunk Identity Themes Models Default Distro 5 + Directories trunk Identity Models Themes Default + Directories trunk Identity Models Themes Default - Directories trunk Identity Themes Models Default Distro 5 Anaconda - Directories trunk Identity Themes Models Default Distro 5 Anaconda + Directories trunk Identity Models Themes Default Concept + Directories trunk Identity Models Themes Default Concept - Directories trunk Identity Themes Models Default Distro 5 Firstboot - Directories trunk Identity Themes Models Default Distro 5 Firstboot + Directories trunk Identity Models Themes Default Distro + Directories trunk Identity Models Themes Default Distro - Directories trunk Identity Themes Models Default Distro 5 Gdm - Directories trunk Identity Themes Models Default Distro 5 Gdm + Directories trunk Identity Models Themes Default Distro 5 + Directories trunk Identity Models Themes Default Distro 5 - Directories trunk Identity Themes Models Default Distro 5 Grub - Directories trunk Identity Themes Models Default Distro 5 Grub + Directories trunk Identity Models Themes Default Distro 5 Anaconda + Directories trunk Identity Models Themes Default Distro 5 Anaconda - Directories trunk Identity Themes Models Default Distro 5 Gsplash - Directories trunk Identity Themes Models Default Distro 5 Gsplash + Directories trunk Identity Models Themes Default Distro 5 Firstboot + Directories trunk Identity Models Themes Default Distro 5 Firstboot - Directories trunk Identity Themes Models Default Distro 5 Kdm - Directories trunk Identity Themes Models Default Distro 5 Kdm + Directories trunk Identity Models Themes Default Distro 5 Gdm + Directories trunk Identity Models Themes Default Distro 5 Gdm - Directories trunk Identity Themes Models Default Distro 5 Ksplash - Directories trunk Identity Themes Models Default Distro 5 Ksplash + Directories trunk Identity Models Themes Default Distro 5 Grub + Directories trunk Identity Models Themes Default Distro 5 Grub - Directories trunk Identity Themes Models Default Distro 5 Rhgb - Directories trunk Identity Themes Models Default Distro 5 Rhgb + Directories trunk Identity Models Themes Default Distro 5 Gsplash + Directories trunk Identity Models Themes Default Distro 5 Gsplash - Directories trunk Identity Themes Models Default Distro 5 Syslinux - Directories trunk Identity Themes Models Default Distro 5 Syslinux + Directories trunk Identity Models Themes Default Distro 5 Kdm + Directories trunk Identity Models Themes Default Distro 5 Kdm - Directories trunk Identity Themes Models Default Posters - Directories trunk Identity Themes Models Default Posters + Directories trunk Identity Models Themes Default Distro 5 Ksplash + Directories trunk Identity Models Themes Default Distro 5 Ksplash - Directories trunk Identity Themes Motifs - Directories trunk Identity Themes Motifs + Directories trunk Identity Models Themes Default Distro 5 Rhgb + Directories trunk Identity Models Themes Default Distro 5 Rhgb - Directories trunk Identity Themes Motifs Flame - Directories trunk Identity Themes Motifs Flame + Directories trunk Identity Models Themes Default Distro 5 Syslinux + Directories trunk Identity Models Themes Default Distro 5 Syslinux - Directories trunk Identity Themes Motifs Modern - Directories trunk Identity Themes Motifs Modern + Directories trunk Identity Models Themes Default Posters + Directories trunk Identity Models Themes Default Posters - Directories trunk Identity Themes Motifs Pipes - Directories trunk Identity Themes Motifs Pipes + Directories trunk Identity Palettes + Directories trunk Identity Palettes - Directories trunk Identity Themes Motifs TreeFlower - Directories trunk Identity Themes Motifs TreeFlower + Directories trunk Identity Patterns + Directories trunk Identity Patterns @@ -885,7 +885,7 @@ centos-art help --read turnk/Identity/Themes/Motifs/TreeFlower/3 The CentOS Distribution - The CentOS Distribution visual manifestation exists to cover all actions related to artwork production and rebranding required by the The CentOS Distribution (see Directories trunk Identity Themes Models Default Distro) in order to comply with its upstream redistribution guidelines. + The CentOS Distribution visual manifestation exists to cover all actions related to artwork production and rebranding required by the The CentOS Distribution (— Removed(pxref:Directories trunk Identity Images Themes Models Default Distro) —) in order to comply with its upstream redistribution guidelines. The CentOS Distribution is made of software packages. Inside the distribution there are packages that make a remarkable use of images and there are packages that don't use images at all. The CentOS Distribution visual manifestation gets focused on software packages that do use images in a remarkable way (e.g., anaconda, grub, syslinux, gdm, kdm) and that way, through images, implements the corporate design in The CentOS Distribution (i.e., the operating system). @@ -985,7 +985,7 @@ centos-art help --read turnk/Identity/Themes/Motifs/TreeFlower/3 Themes This work line provides theme design models and theme artistic motifs for The CentOS Project. If you are interested in creating brand new visual styles for The CentOS Project this is the place for you. - See Directories trunk Identity Themes, for more information. + See Directories trunk Identity Images Themes, for more information. @@ -1016,7 +1016,7 @@ centos-art help --read turnk/Identity/Themes/Motifs/TreeFlower/3 Directories trunk Identity Images - Directories trunk Identity Models + Directories trunk Identity Images Themes Directories trunk Identity Fonts Directories
@@ -1129,90 +1129,227 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes See also - - + + + + ... + +
- Directories trunk Identity Models - Directories trunk Identity Models Brands + Directories trunk Identity Images Themes + Directories trunk Identity Images Themes Motifs Directories trunk Identity Images Directories
- The <file>trunk/Identity/Models</file> Directory - Directories trunk Identity Models + The <file>trunk/Identity/Images/Themes</file> Directory + Directories trunk Identity Images Themes Goals - - - - ... - - + The trunk/Identity/Themes/ directory exists to organize production of CentOS themes. Description + Initially, we start working themes on their trunk development line (e.g., trunk/Identity/Images/Themes/TreeFlower/), here we organize information that cannot be produced automatically (i.e., background images, concepts, color information, screenshots, etc.). + Later, when theme trunk development line is considered “ready” for implementation (e.g., all required backgrounds have been designed), we create a branch for it (e.g., branches/Identity/Images/Themes/TreeFlower/1/). Once the branch has been created, we forget that branch and continue working the trunk development line while others (e.g., an artwork quality assurance team) test the new branch for tunning it up. + Once the branch has been tunned up, and considered “ready” for release, it is freezed under tags/ directory (e.g., tags/Identity/Images/Themes/TreeFower/1.0/) for packagers, webmasters, promoters, and anyone who needs images from that CentOS theme the tag was created for. + Both branches and tags, inside CentOS Artwork Repository, use numerical values to identify themselves under the same location. Branches start at one (i.e., 1) and increment one unit for each branch created from the same trunk development line. Tags start at zero (i.e., 0) and increment one unit for each tag created from the same branch development line. + + Convenction Do not freeze trunk development lines using tags directly. If you think you need to freeze a trunk development line, create a branch for it and then freeze that branch instead. + + The trunk development line may introduce problems we cannot see immediatly. Certainly, the high changable nature of trunk development line complicates finding and fixing such problems. On the other hand, the branched development lines provide a more predictable area where only fixes/corrections to current content are commited up to repository. + If others find and fix bugs inside the branched development line, we could merge such changes/experiences back to trunk development line (not visversa) in order for future branches, created from trunk, to benefit. + Time intervals used to create branches and tags may vary, just as different needs may arrive. For example, consider the release schema of CentOS distribution: one major release every 2 years, security updates every 6 months, support for 7 years long. Each time a CentOS distribution is released, specially if it is a major release, there is a theme need in order to cover CentOS distribution artwork requirements. At this point, is where CentOS Artwork Repository comes up to scene. + Before releasing a new major release of CentOS distribution we create a branch for one of several theme development lines available inside the CentOS Artwork Repository, perform quality assurance on it, and later, freeze that branch using tags. Once a the theme branch has been frozen (under tags/ directory), CentOS Packagers (the persons whom build CentOS distribution) can use that frozen branch as source location to fulfill CentOS distribution artwork needs. The same applies to CentOS Webmasters (the persons whom build CentOS websites), and any other visual manifestation required by the project. + Usage + In this location themes are organized in “Models” —to store common information— and “Motifs”—to store unique information. At rendering time, both motifs and models are combined to produce the final CentOS themes. CentOS themes can be tagged as “Default” or “Alternative”. CentOS themes are maintained by CentOS community. - ... + See Directories trunk Identity Models Themes. - - Usage - - - &dots; + Removed(xref:Directories trunk Identity Images Themes Motifs) —. See also - ... + Directories trunk Identity. + + + Directories trunk.
- Directories trunk Identity Models Brands - Directories trunk Identity Palettes - Directories trunk Identity Models + Directories trunk Identity Images Themes Motifs + Directories trunk Identity Images Themes Motifs Flame + Directories trunk Identity Images Themes Directories
- The <file>trunk/Identity/Models/Brands</file> Directory - Directories trunk Identity Models Brands + The <file>trunk/Identity/Images/Themes/Motifs</file> Directory + Directories trunk Identity Images Themes Motifs Goals - This section describes The CentOS Brand design models. + The trunk/Identity/Images/Themes directory exists to: + + + + Organize CentOS themes' artistic motifs. + + Description - The CentOS Brand provides the one unique name or trademark that connects the producer with their products. In this case, the producer is The CentOS Project and the products are The CentOS Project visual manifestations. - The CentOS Brand is the main visual representation of the CentOS project so the typography used in it must be the same always, no matter where it be shown. It also has to be clear enough to dismiss any confussion between similar typefaces (e.g., the number one (1) sometimes is confuesed with the letter el (l) or letter ai (i)). - As convenction, the word CentOS uses Denmark typography as base, both for the word CentOS and the phrase Community Enterprise Operating System. The phrase size of CentOS logo is half the size in poits the word CentOS has and it below CentOS word and aligned with it on the left. The distance between CentOS word and phrase Community Enterprise Operating System have the size in points the phrase has. - - When the CentOS release brand is built, use Denmark typography for the release number. The release number size is two times larger (in height) than default CentOS word. The separation between release number and CentOS word is twice the size in points of separation between CentOS word and phrase Community Enterprise Operating System. - Another component inside CentOS logo is the trademark symbol (TM). This symbol specifies that the CentOS logo must be consider a product brand, even it is not a registered one. The trademark symbol uses DejaVu LGC Sans Regular typography. The trademark symbol is aligned right-top on the outter side of CentOS word. The trademark symbol must not exceed haf the distance, in points, between CentOS word and the release number on its right. - It would be very convenient for the CentOS Project and its community to to make a registered trademark (®) of CentOS logo. To make a register trademark of CentOS Logo prevents legal complications in the market place of brands. It grants the consistency, through time, of CentOS project corporate visual identity. - - Note The information about trademarks and corporate identity is my personal interpretation of http://en.wikipedia.org/Corporate_identity and http://en.wikipedia.org/Trademark description. If you have practical experiences with these affairs, please serve yourself to improve this section with your reasons. - + The artistic motif of theme is a graphic design component that provides the visual style of themes, it is used as pattern to connect all visual manifestations inside one unique theme. + Artistic motifs are based on conceptual ideas. Conceptual ideas bring the motivation, they are fuel for the engines of human imagination. Good conceptual ideas may produce good motivation to produce almost anything, and art works don't escape from it. + + + TreeFlower + + CentOS like trees, has roots, trunk, branches, leaves and flowers. Day by day they work together in freedom, ruled by the laws of nature and open standards, to show the beauty of its existence. + + + + Modern + + Modern, squares and circles flowing up. + + +
+ If you have new conceptual ideas for CentOS, then you can say that you want to create a new artistic motif for CentOS. To create a new artistic motif you need to create a directory under Identity/Images/Themes/ using a name coherent with your conceptual idea. That name will be the name of your artistic motif. If possible, when creating new conceptual ideas for CentOS, think about what CentOS means for you, what does it makes you feel, take your time, think deep, and share; you can improve the idea as time goes on. + Once you have defined a name for your theme, you need to create the motif structure of your theme. The motif structure is the basic direcotry structure you'll use to work your ideas. Here is where you organize your graphic design projects. + To add a new motif structure to CentOS Artwork Repository, you need to use the centos-art command line in the Identity/Images/Themes/ directory as described below: + centos-art add --motif=ThemeName + The previous command will create the basic structure of themes for you. The basic structure produced by centos-art command is illustrated in the following figure: + trunk/Identity/Images/Themes/$ThemeName/ +|-- Backgrounds +| |-- Img +| `-- Tpl +|-- Info +| |-- Img +| `-- Tpl +|-- Palettes +`-- Screenshots Usage + When designing artistic motifs for CentOS, consider the following recommendations: + + + + Give a unique (case-sensitive) name to your Motif. This name is used as value wherever theme variable ($THEME) or translation marker (=THEME=) is. Optionally, you can add a description about inspiration and concepts behind your work. + + + Use the location trunk/Identity/Images/Themes/$THEME/ to store your work. If it doesn't exist create it. Note that this require you to have previous commit access in CentOS Artwork Repository. + + + The CentOS Project is using the blue color (#204c8d) as base color for its corporate visual identity. Use such base corporate color information as much as possible in your artistic motif designs. + + + Try to make your design fit one of the theme models. + + + Feel free to make your art enterprise-level and beautiful. + + + Add the following information on your artwork (both in a visible design area and document metadata): + + + + The name (or logo) of your artistic motif. + + + The copyright sentence: Copyright (C) YEAR YOURNAME + + + The license under which the work is released. All CentOS Art works are released under http://creativecommons.org/licenses/by-sa/3.0/Creative Common Share-Alike License 3.0 (http://creativecommons.org/licenses/by-sa/3.0/). + + + + See also + + Directories trunk Identity Images Themes + Directories trunk Identity Images Themes + + + + Directories trunk Identity + Directories trunk Identity + + + + Directories trunk + Directories trunk + + + The Backgrounds/ directory is used to organize artistic motif background images and the projects used to build those images. + Background images are linked (using the import feature of Inkscape) inside almost all theme art works. This structure let you make centralized changes on the visual identity and propagate them quickly to other areas. + In this configuration you design background images for different screen resolutions based on the theme artistic motif. + You may create different artistic motifs propositions based on the same conceptual idea. The conceptual idea is what defines a theme. Artistic motifs are interpretations of that idea. + Inside this directory artistic motifs are organized by name (e.g., TreeFlower, Modern, etc.). + Each artistic motif directory represents just one unique artistic motif. + The artistic motif is graphic design used as common pattern to connect all visual manifestations inside one unique theme. The artistic motif is based on a conceptual idea. Artistic motifs provide visual style to themes. + Designing artistic motifs is for anyone interested in creating beautiful themes for CentOS. When building a theme for CentOS, the first design you need to define is the artistic motif. + Inside CentOS Artwork Repository, theme visual styles (a.k.a., artistic motifs) and theme visual structures (a.k.a., design models) are two different working lines. When you design an artistic motif for CentOS you concentrate on its visual style, and eventualy, use the centos-art command line interface to render the visual style, you are currently producing, against an already-made theme model in order to produce the final result. Final images are stored under Motifs/ directory using the model name, and the model directory structure as reference. + The artistic motif base structure is used by centos-art to produce images automatically. This section describes each directory of CentOS artistic motif base structure. + The Backgrounds/ directory is probably the core component, inside Motifs/ directory structure. Inside Backgrounds/ directory you produce background images used by almost all theme models (e.g., Distribution, Websites, Promotion, etc.). The Backgrounds/ directory can contain subdirectories to help you organize the design process.
- Directories trunk Identity Palettes - Directories trunk Identity Patterns - Directories trunk Identity Models Brands + Directories trunk Identity Images Themes Motifs Flame + Directories trunk Identity Images Themes Motifs Modern + Directories trunk Identity Images Themes Motifs Directories
- The <file>trunk/Identity/Palettes</file> Directory - Directories trunk Identity Palettes + The <file>trunk/Identity/Images/Themes/Motifs/Flame</file> Directory + Directories trunk Identity Images Themes Motifs Flame Goals + This section describes the Flame artistic motif. This section may be useful for anyone interested in reproducing the Flame artistic motif, or in creating new artistic motifs for The CentOS Project corporate visual identity. + Description + The Flame artistic motif was built using the flame filter of Gimp 2.2 in CentOS 5.5. + The flame filter of Gimp can produce stunning, randomly generated fractal patterns. The flame filter of Gimp gives us a great oportunity to reduce the time used to produce new artistic motifs, because of its “randomly generated” nature. Once the artistic motif be created, it is propagated through all visual manifestations of CentOS Project corporate visual identity using the centos-art.sh script (see Directories trunk Scripts) inside the CentOS Artwork Repository. + To set the time intervals between each new visual style production, we could reuse the CentOS distribution major release schema. I.e., we could produce a new visual style, every two years, based on a new “randomly generated” flame pattern, and publish the whole corporate visual identity (i.e., distribution stuff, promotion stuff, websites stuff, etc.) with the new major release of CentOS distribution all together at once. + Producing a new visual style is not one day's task. Once we have defined the artistic motif, we need to propagate it through all visual manifestations of The CentOS Project corporate visual identity. When we say that we could produce one new visual style every two years we really mean: to work two years long in order to propagate a new visual style to all visual manifestations of The CentOS Project corporate visual identity. + Obviously, in order to propagate one visual style to all different visual manifestations of The CentOS Project corporate visual identity, we need first to know which the visual manifestations are. To define which visual manifestations are inside The CentOS Project corporate visual identity is one of the goals the CentOS Artwork Repository and this documentation manual are both aimed to satisfy. + Once we define which the visual manifestation are, it is possible to define how to produce them, and this way, organize the automation process. Such automation process is one of the goals of centos-art.sh script. + With the combination of both CentOS Artwork Repository and centos-art.sh scripts we define work lines where translators, programmers, and graphic designers work together to distribute and reduce the amount of time employed to produce The CentOS Project monolithic corporate identity. + From a monolithic corporate visual identity point of view, notice that we are producing a new visual style for the same theme (i.e., Flame). It would be another flame design but still a flame design. This idea is very important to be aware of, because we are somehow “refreshing” the theme, not changing it at all. + This way, as we are “refreshing” the theme, we still keep oursleves inside the monolithic conception we are trying to be attached to (i.e., one unique name, and one unique visual style for all visual manifestations). + Producing artistic motifs is a creative process that may consume long time, specially for people without experienced knowledge on graphic design land. Using “randomly generated” conception to produce artistic motifs could be, practically, a way for anyone to follow in order to produce maintainable artistic motifs in few steps. + Due to the “randomly generated” nature of Flame filter, we find that Flame pattern is not always the same when we use Flame filter interface. + Using the same pattern design for each visual manifestation is essential in order to maintain the visual connection among all visual manifestations inside the same theme. Occasionally, we may introduce pattern variations in opacity, size, or even position but never change the pattern design itself, nor the color information used by images considered part of the same theme. + + Important When we design background images, which are considered part of the same theme, it is essential to use the same design pattern always. This is what makes theme images to be visually connected among themeselves, and so, the reason we use to define the word “theme” as: a set of images visually connected among themeselves. + + In order for us to reproduce the same flame pattern always, Flame filter interface provides the Save and Open options. The Save option brings up a file save dialog that allows you to save the current Flame settings for the plug-in, so that you can recreate them later. The Open option brings up a file selector that allows you to open a previously saved Flame settings file. + The Flame settings we used in our example are saved in the file named 800x600.xcf-flame.def, inside the Backgrounds/Xcf directory structure. + See also - ... + Removed(xref:Directories trunk Identity Images Themes Motifs) —. + + + See Directories trunk Identity Images Themes. + + + See Directories trunk Identity. + + + See Directories trunk. +
+
+ + Directories trunk Identity Images Themes Motifs Modern + Directories trunk Identity Images Themes Motifs Pipes + Directories trunk Identity Images Themes Motifs Flame + Directories +
+ The <file>trunk/Identity/Images/Themes/Motifs/Modern</file> Directory + Directories trunk Identity Images Themes Motifs Modern + Goals Description @@ -1233,13 +1370,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Patterns - Directories trunk Identity Themes - Directories trunk Identity Palettes + Directories trunk Identity Images Themes Motifs Pipes + Directories trunk Identity Images Themes Motifs TreeFlower + Directories trunk Identity Images Themes Motifs Modern Directories
- The <file>trunk/Identity/Patterns</file> Directory - Directories trunk Identity Patterns + The <file>trunk/Identity/Images/Themes/Motifs/Pipes</file> Directory + Directories trunk Identity Images Themes Motifs Pipes Goals @@ -1267,58 +1404,94 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes - Directories trunk Identity Themes Models - Directories trunk Identity Patterns + Directories trunk Identity Images Themes Motifs TreeFlower + Directories trunk Identity Models + Directories trunk Identity Images Themes Motifs Pipes Directories
- The <file>trunk/Identity/Themes</file> Directory - Directories trunk Identity Themes + The <file>trunk/Identity/Images/Themes/Motifs/TreeFlower</file> Directory + Directories trunk Identity Images Themes Motifs TreeFlower Goals - The trunk/Identity/Themes/ directory exists to organize production of CentOS themes. Description - Initially, we start working themes on their trunk development line (e.g., trunk/Identity/Themes/Motifs/TreeFlower/), here we organize information that cannot be produced automatically (i.e., background images, concepts, color information, screenshots, etc.). - Later, when theme trunk development line is considered “ready” for implementation (e.g., all required backgrounds have been designed), we create a branch for it (e.g., branches/Identity/Themes/Motifs/TreeFlower/1/). Once the branch has been created, we forget that branch and continue working the trunk development line while others (e.g., an artwork quality assurance team) test the new branch for tunning it up. - Once the branch has been tunned up, and considered “ready” for release, it is freezed under tags/ directory (e.g., tags/Identity/Themes/Motifs/TreeFower/1.0/) for packagers, webmasters, promoters, and anyone who needs images from that CentOS theme the tag was created for. - Both branches and tags, inside CentOS Artwork Repository, use numerical values to identify themselves under the same location. Branches start at one (i.e., 1) and increment one unit for each branch created from the same trunk development line. Tags start at zero (i.e., 0) and increment one unit for each tag created from the same branch development line. - - Convenction Do not freeze trunk development lines using tags directly. If you think you need to freeze a trunk development line, create a branch for it and then freeze that branch instead. - - The trunk development line may introduce problems we cannot see immediatly. Certainly, the high changable nature of trunk development line complicates finding and fixing such problems. On the other hand, the branched development lines provide a more predictable area where only fixes/corrections to current content are commited up to repository. - If others find and fix bugs inside the branched development line, we could merge such changes/experiences back to trunk development line (not visversa) in order for future branches, created from trunk, to benefit. - Time intervals used to create branches and tags may vary, just as different needs may arrive. For example, consider the release schema of CentOS distribution: one major release every 2 years, security updates every 6 months, support for 7 years long. Each time a CentOS distribution is released, specially if it is a major release, there is a theme need in order to cover CentOS distribution artwork requirements. At this point, is where CentOS Artwork Repository comes up to scene. - Before releasing a new major release of CentOS distribution we create a branch for one of several theme development lines available inside the CentOS Artwork Repository, perform quality assurance on it, and later, freeze that branch using tags. Once a the theme branch has been frozen (under tags/ directory), CentOS Packagers (the persons whom build CentOS distribution) can use that frozen branch as source location to fulfill CentOS distribution artwork needs. The same applies to CentOS Webmasters (the persons whom build CentOS websites), and any other visual manifestation required by the project. Usage - In this location themes are organized in “Models” —to store common information— and “Motifs”—to store unique information. At rendering time, both motifs and models are combined to produce the final CentOS themes. CentOS themes can be tagged as “Default” or “Alternative”. CentOS themes are maintained by CentOS community. + See also + + +
+
+ + Directories trunk Identity Models + Directories trunk Identity Models Brands + Directories trunk Identity Images Themes Motifs TreeFlower + Directories +
+ The <file>trunk/Identity/Models</file> Directory + Directories trunk Identity Models + Goals - See Directories trunk Identity Themes Models. + ... + + Description + + - See Directories trunk Identity Themes Motifs. + ... - See also + Usage - Directories trunk Identity. + &dots; + + See also + + - Directories trunk. + ...
- Directories trunk Identity Themes Models - Directories trunk Identity Themes Models Default - Directories trunk Identity Themes + Directories trunk Identity Models Brands + Directories trunk Identity Models Themes + Directories trunk Identity Models + Directories +
+ The <file>trunk/Identity/Models/Brands</file> Directory + Directories trunk Identity Models Brands + Goals + This section describes The CentOS Brand design models. + Description + The CentOS Brand provides the one unique name or trademark that connects the producer with their products. In this case, the producer is The CentOS Project and the products are The CentOS Project visual manifestations. + The CentOS Brand is the main visual representation of the CentOS project so the typography used in it must be the same always, no matter where it be shown. It also has to be clear enough to dismiss any confussion between similar typefaces (e.g., the number one (1) sometimes is confuesed with the letter el (l) or letter ai (i)). + As convenction, the word CentOS uses Denmark typography as base, both for the word CentOS and the phrase Community Enterprise Operating System. The phrase size of CentOS logo is half the size in poits the word CentOS has and it below CentOS word and aligned with it on the left. The distance between CentOS word and phrase Community Enterprise Operating System have the size in points the phrase has. + + When the CentOS release brand is built, use Denmark typography for the release number. The release number size is two times larger (in height) than default CentOS word. The separation between release number and CentOS word is twice the size in points of separation between CentOS word and phrase Community Enterprise Operating System. + Another component inside CentOS logo is the trademark symbol (TM). This symbol specifies that the CentOS logo must be consider a product brand, even it is not a registered one. The trademark symbol uses DejaVu LGC Sans Regular typography. The trademark symbol is aligned right-top on the outter side of CentOS word. The trademark symbol must not exceed haf the distance, in points, between CentOS word and the release number on its right. + It would be very convenient for the CentOS Project and its community to to make a registered trademark (®) of CentOS logo. To make a register trademark of CentOS Logo prevents legal complications in the market place of brands. It grants the consistency, through time, of CentOS project corporate visual identity. + + Note The information about trademarks and corporate identity is my personal interpretation of http://en.wikipedia.org/Corporate_identity and http://en.wikipedia.org/Trademark description. If you have practical experiences with these affairs, please serve yourself to improve this section with your reasons. + + Usage + See also + + +
+
+ + Directories trunk Identity Models Themes + Directories trunk Identity Models Themes Default + Directories trunk Identity Models Brands Directories
- The <file>trunk/Identity/Themes/Models</file> Directory - Directories trunk Identity Themes Models + The <file>trunk/Identity/Models/Themes</file> Directory + Directories trunk Identity Models Themes Goals This section describes design models from The CentOS Themes. Description @@ -1332,14 +1505,14 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes - See Directories trunk Identity Themes Models Default. + Removed(xref:Directories trunk Identity Models Themes Default) —. See also - Directories trunk Identity Themes. + Directories trunk Identity Images Themes. Directories trunk Identity. @@ -1351,13 +1524,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default - Directories trunk Identity Themes Models Default Concept - Directories trunk Identity Themes Models + Directories trunk Identity Models Themes Default + Directories trunk Identity Models Themes Default Concept + Directories trunk Identity Models Themes Directories
- The <file>trunk/Identity/Themes/Models/Default</file> Directory - Directories trunk Identity Themes Models Default + The <file>trunk/Identity/Models/Themes/Default</file> Directory + Directories trunk Identity Models Themes Default Goals This section describes the default design model of The CentOS Themes. Description @@ -1375,7 +1548,7 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes How to remark the visual resemblance? - Use a common artistic motifs as background for all CentOS Distribution images. See Directories trunk Identity Themes Motifs, for more information. + Use a common artistic motifs as background for all CentOS Distribution images. — Removed(xref:Directories trunk Identity Images Themes Motifs) —, for more information. @@ -1392,35 +1565,35 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes - See Directories trunk Identity Themes Models Default Distro. + Removed(xref:Directories trunk Identity Models Themes Default Distro) —. - See Directories trunk Identity Themes Models Default Concept. + Removed(xref:Directories trunk Identity Models Themes Default Concept) —. See also - Directories trunk Identity Themes + Directories trunk Identity Images Themes - Directories trunk Identity Themes Models + Directories trunk Identity Models Themes - Directories trunk Identity Themes Motifs + Removed(ref:Directories trunk Identity Images Themes Motifs) —
- Directories trunk Identity Themes Models Default Concept - Directories trunk Identity Themes Models Default Distro - Directories trunk Identity Themes Models Default + Directories trunk Identity Models Themes Default Concept + Directories trunk Identity Models Themes Default Distro + Directories trunk Identity Models Themes Default Directories
- The <file>trunk/Identity/Themes/Models/Default/Concept</file> Directory - Directories trunk Identity Themes Models Default Concept + The <file>trunk/Identity/Models/Themes/Default/Concept</file> Directory + Directories trunk Identity Models Themes Default Concept Goals @@ -1448,13 +1621,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro - Directories trunk Identity Themes Models Default Distro 5 - Directories trunk Identity Themes Models Default Concept + Directories trunk Identity Models Themes Default Distro + Directories trunk Identity Models Themes Default Distro 5 + Directories trunk Identity Models Themes Default Concept Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro</file> Directory - Directories trunk Identity Themes Models Default Distro + The <file>trunk/Identity/Models/Themes/Default/Distro</file> Directory + Directories trunk Identity Models Themes Default Distro Goals This section organizes default design models for different major releases of CentOS Distribution. Description @@ -1476,20 +1649,20 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes - See Directories trunk Identity Themes Models Default Distro 5. + Removed(xref:Directories trunk Identity Models Themes Default Distro 5) —. See also - Directories trunk Identity Themes Models Default. + Removed(ref:Directories trunk Identity Models Themes Default) —. - Directories trunk Identity Themes Models. + Directories trunk Identity Models Themes. - Directories trunk Identity Themes. + Directories trunk Identity Images Themes. Directories trunk Identity. @@ -1501,13 +1674,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 - Directories trunk Identity Themes Models Default Distro 5 Anaconda - Directories trunk Identity Themes Models Default Distro + Directories trunk Identity Models Themes Default Distro 5 + Directories trunk Identity Models Themes Default Distro 5 Anaconda + Directories trunk Identity Models Themes Default Distro Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5</file> Directory - Directories trunk Identity Themes Models Default Distro 5 + The <file>trunk/Identity/Models/Themes/Default/Distro/5</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Goals @@ -1526,44 +1699,44 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes - See Directories trunk Identity Themes Models Default Distro 5 Syslinux. + Removed(xref:Directories trunk Identity Models Themes Default Distro 5 Syslinux) —. - See Directories trunk Identity Themes Models Default Distro 5 Anaconda. + Removed(xref:Directories trunk Identity Models Themes Default Distro 5 Anaconda) —. - See Directories trunk Identity Themes Models Default Distro 5 Rhgb. + Removed(xref:Directories trunk Identity Models Themes Default Distro 5 Rhgb) —. - See Directories trunk Identity Themes Models Default Distro 5 Gdm. + Removed(xref:Directories trunk Identity Models Themes Default Distro 5 Gdm) —. - See Directories trunk Identity Themes Models Default Distro 5 Kdm. + Removed(xref:Directories trunk Identity Models Themes Default Distro 5 Kdm) —. - See Directories trunk Identity Themes Models Default Distro 5 Grub. + Removed(xref:Directories trunk Identity Models Themes Default Distro 5 Grub) —. - See Directories trunk Identity Themes Models Default Distro 5 Gsplash. + Removed(xref:Directories trunk Identity Models Themes Default Distro 5 Gsplash) —. - See Directories trunk Identity Themes Models Default Distro 5 Ksplash. + Removed(xref:Directories trunk Identity Models Themes Default Distro 5 Ksplash) —. See also - Directories trunk Identity Themes Models Default Distro. + Removed(ref:Directories trunk Identity Models Themes Default Distro) —. - Directories trunk Identity Themes Models Default. + Removed(ref:Directories trunk Identity Models Themes Default) —. - Directories trunk Identity Themes Models. + Directories trunk Identity Models Themes. - Directories trunk Identity Themes. + Directories trunk Identity Images Themes. Directories trunk Identity. @@ -1575,13 +1748,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 Anaconda - Directories trunk Identity Themes Models Default Distro 5 Firstboot - Directories trunk Identity Themes Models Default Distro 5 + Directories trunk Identity Models Themes Default Distro 5 Anaconda + Directories trunk Identity Models Themes Default Distro 5 Firstboot + Directories trunk Identity Models Themes Default Distro 5 Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5/Anaconda</file> Directory - Directories trunk Identity Themes Models Default Distro 5 Anaconda + The <file>trunk/Identity/Models/Themes/Default/Distro/5/Anaconda</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Anaconda Goals @@ -1597,13 +1770,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 Firstboot - Directories trunk Identity Themes Models Default Distro 5 Gdm - Directories trunk Identity Themes Models Default Distro 5 Anaconda + Directories trunk Identity Models Themes Default Distro 5 Firstboot + Directories trunk Identity Models Themes Default Distro 5 Gdm + Directories trunk Identity Models Themes Default Distro 5 Anaconda Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5/Firstboot</file> Directory - Directories trunk Identity Themes Models Default Distro 5 Firstboot + The <file>trunk/Identity/Models/Themes/Default/Distro/5/Firstboot</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Firstboot Goals @@ -1631,13 +1804,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 Gdm - Directories trunk Identity Themes Models Default Distro 5 Grub - Directories trunk Identity Themes Models Default Distro 5 Firstboot + Directories trunk Identity Models Themes Default Distro 5 Gdm + Directories trunk Identity Models Themes Default Distro 5 Grub + Directories trunk Identity Models Themes Default Distro 5 Firstboot Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5/Gdm</file> Directory - Directories trunk Identity Themes Models Default Distro 5 Gdm + The <file>trunk/Identity/Models/Themes/Default/Distro/5/Gdm</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Gdm Goals @@ -1665,13 +1838,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 Grub - Directories trunk Identity Themes Models Default Distro 5 Gsplash - Directories trunk Identity Themes Models Default Distro 5 Gdm + Directories trunk Identity Models Themes Default Distro 5 Grub + Directories trunk Identity Models Themes Default Distro 5 Gsplash + Directories trunk Identity Models Themes Default Distro 5 Gdm Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5/Grub</file> Directory - Directories trunk Identity Themes Models Default Distro 5 Grub + The <file>trunk/Identity/Models/Themes/Default/Distro/5/Grub</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Grub Goals @@ -1699,13 +1872,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 Gsplash - Directories trunk Identity Themes Models Default Distro 5 Kdm - Directories trunk Identity Themes Models Default Distro 5 Grub + Directories trunk Identity Models Themes Default Distro 5 Gsplash + Directories trunk Identity Models Themes Default Distro 5 Kdm + Directories trunk Identity Models Themes Default Distro 5 Grub Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5/Gsplash</file> Directory - Directories trunk Identity Themes Models Default Distro 5 Gsplash + The <file>trunk/Identity/Models/Themes/Default/Distro/5/Gsplash</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Gsplash Goals @@ -1733,13 +1906,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 Kdm - Directories trunk Identity Themes Models Default Distro 5 Ksplash - Directories trunk Identity Themes Models Default Distro 5 Gsplash + Directories trunk Identity Models Themes Default Distro 5 Kdm + Directories trunk Identity Models Themes Default Distro 5 Ksplash + Directories trunk Identity Models Themes Default Distro 5 Gsplash Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5/Kdm</file> Directory - Directories trunk Identity Themes Models Default Distro 5 Kdm + The <file>trunk/Identity/Models/Themes/Default/Distro/5/Kdm</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Kdm Goals @@ -1767,13 +1940,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 Ksplash - Directories trunk Identity Themes Models Default Distro 5 Rhgb - Directories trunk Identity Themes Models Default Distro 5 Kdm + Directories trunk Identity Models Themes Default Distro 5 Ksplash + Directories trunk Identity Models Themes Default Distro 5 Rhgb + Directories trunk Identity Models Themes Default Distro 5 Kdm Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5/Ksplash</file> Directory - Directories trunk Identity Themes Models Default Distro 5 Ksplash + The <file>trunk/Identity/Models/Themes/Default/Distro/5/Ksplash</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Ksplash Goals @@ -1801,13 +1974,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 Rhgb - Directories trunk Identity Themes Models Default Distro 5 Syslinux - Directories trunk Identity Themes Models Default Distro 5 Ksplash + Directories trunk Identity Models Themes Default Distro 5 Rhgb + Directories trunk Identity Models Themes Default Distro 5 Syslinux + Directories trunk Identity Models Themes Default Distro 5 Ksplash Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5/Rhgb</file> Directory - Directories trunk Identity Themes Models Default Distro 5 Rhgb + The <file>trunk/Identity/Models/Themes/Default/Distro/5/Rhgb</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Rhgb Goals @@ -1835,13 +2008,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Distro 5 Syslinux - Directories trunk Identity Themes Models Default Posters - Directories trunk Identity Themes Models Default Distro 5 Rhgb + Directories trunk Identity Models Themes Default Distro 5 Syslinux + Directories trunk Identity Models Themes Default Posters + Directories trunk Identity Models Themes Default Distro 5 Rhgb Directories
- The <file>trunk/Identity/Themes/Models/Default/Distro/5/Syslinux</file> Directory - Directories trunk Identity Themes Models Default Distro 5 Syslinux + The <file>trunk/Identity/Models/Themes/Default/Distro/5/Syslinux</file> Directory + Directories trunk Identity Models Themes Default Distro 5 Syslinux Goals @@ -1873,13 +2046,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Models Default Posters - Directories trunk Identity Themes Motifs - Directories trunk Identity Themes Models Default Distro 5 Syslinux + Directories trunk Identity Models Themes Default Posters + Directories trunk Identity Palettes + Directories trunk Identity Models Themes Default Distro 5 Syslinux Directories
- The <file>trunk/Identity/Themes/Models/Default/Posters</file> Directory - Directories trunk Identity Themes Models Default Posters + The <file>trunk/Identity/Models/Themes/Default/Posters</file> Directory + Directories trunk Identity Models Themes Default Posters Goals @@ -1907,173 +2080,20 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Motifs - Directories trunk Identity Themes Motifs Flame - Directories trunk Identity Themes Models Default Posters - Directories -
- The <file>trunk/Identity/Themes/Motifs</file> Directory - Directories trunk Identity Themes Motifs - Goals - The trunk/Identity/Themes/Motifs directory exists to: - - - - Organize CentOS themes' artistic motifs. - - - Description - The artistic motif of theme is a graphic design component that provides the visual style of themes, it is used as pattern to connect all visual manifestations inside one unique theme. - Artistic motifs are based on conceptual ideas. Conceptual ideas bring the motivation, they are fuel for the engines of human imagination. Good conceptual ideas may produce good motivation to produce almost anything, and art works don't escape from it. - - - TreeFlower - - CentOS like trees, has roots, trunk, branches, leaves and flowers. Day by day they work together in freedom, ruled by the laws of nature and open standards, to show the beauty of its existence. - - - - Modern - - Modern, squares and circles flowing up. - - -
- If you have new conceptual ideas for CentOS, then you can say that you want to create a new artistic motif for CentOS. To create a new artistic motif you need to create a directory under Identity/Themes/Motifs/ using a name coherent with your conceptual idea. That name will be the name of your artistic motif. If possible, when creating new conceptual ideas for CentOS, think about what CentOS means for you, what does it makes you feel, take your time, think deep, and share; you can improve the idea as time goes on. - Once you have defined a name for your theme, you need to create the motif structure of your theme. The motif structure is the basic direcotry structure you'll use to work your ideas. Here is where you organize your graphic design projects. - To add a new motif structure to CentOS Artwork Repository, you need to use the centos-art command line in the Identity/Themes/Motifs/ directory as described below: - centos-art add --motif=ThemeName - The previous command will create the basic structure of themes for you. The basic structure produced by centos-art command is illustrated in the following figure: - trunk/Identity/Themes/Motifs/$ThemeName/ -|-- Backgrounds -| |-- Img -| `-- Tpl -|-- Info -| |-- Img -| `-- Tpl -|-- Palettes -`-- Screenshots - Usage - When designing artistic motifs for CentOS, consider the following recommendations: - - - - Give a unique (case-sensitive) name to your Motif. This name is used as value wherever theme variable ($THEME) or translation marker (=THEME=) is. Optionally, you can add a description about inspiration and concepts behind your work. - - - Use the location trunk/Identity/Themes/Motifs/$THEME/ to store your work. If it doesn't exist create it. Note that this require you to have previous commit access in CentOS Artwork Repository. - - - The CentOS Project is using the blue color (#204c8d) as base color for its corporate visual identity. Use such base corporate color information as much as possible in your artistic motif designs. - - - Try to make your design fit one of the theme models. - - - Feel free to make your art enterprise-level and beautiful. - - - Add the following information on your artwork (both in a visible design area and document metadata): - - - - The name (or logo) of your artistic motif. - - - The copyright sentence: Copyright (C) YEAR YOURNAME - - - The license under which the work is released. All CentOS Art works are released under http://creativecommons.org/licenses/by-sa/3.0/Creative Common Share-Alike License 3.0 (http://creativecommons.org/licenses/by-sa/3.0/). - - - - - See also - - - Directories trunk Identity Themes - Directories trunk Identity Themes - - - - Directories trunk Identity - Directories trunk Identity - - - - Directories trunk - Directories trunk - - - - The Backgrounds/ directory is used to organize artistic motif background images and the projects used to build those images. - Background images are linked (using the import feature of Inkscape) inside almost all theme art works. This structure let you make centralized changes on the visual identity and propagate them quickly to other areas. - In this configuration you design background images for different screen resolutions based on the theme artistic motif. - You may create different artistic motifs propositions based on the same conceptual idea. The conceptual idea is what defines a theme. Artistic motifs are interpretations of that idea. - Inside this directory artistic motifs are organized by name (e.g., TreeFlower, Modern, etc.). - Each artistic motif directory represents just one unique artistic motif. - The artistic motif is graphic design used as common pattern to connect all visual manifestations inside one unique theme. The artistic motif is based on a conceptual idea. Artistic motifs provide visual style to themes. - Designing artistic motifs is for anyone interested in creating beautiful themes for CentOS. When building a theme for CentOS, the first design you need to define is the artistic motif. - Inside CentOS Artwork Repository, theme visual styles (a.k.a., artistic motifs) and theme visual structures (a.k.a., design models) are two different working lines. When you design an artistic motif for CentOS you concentrate on its visual style, and eventualy, use the centos-art command line interface to render the visual style, you are currently producing, against an already-made theme model in order to produce the final result. Final images are stored under Motifs/ directory using the model name, and the model directory structure as reference. - The artistic motif base structure is used by centos-art to produce images automatically. This section describes each directory of CentOS artistic motif base structure. - The Backgrounds/ directory is probably the core component, inside Motifs/ directory structure. Inside Backgrounds/ directory you produce background images used by almost all theme models (e.g., Distribution, Websites, Promotion, etc.). The Backgrounds/ directory can contain subdirectories to help you organize the design process. -
-
- - Directories trunk Identity Themes Motifs Flame - Directories trunk Identity Themes Motifs Modern - Directories trunk Identity Themes Motifs + Directories trunk Identity Palettes + Directories trunk Identity Patterns + Directories trunk Identity Models Themes Default Posters Directories
- The <file>trunk/Identity/Themes/Motifs/Flame</file> Directory - Directories trunk Identity Themes Motifs Flame + The <file>trunk/Identity/Palettes</file> Directory + Directories trunk Identity Palettes Goals - This section describes the Flame artistic motif. This section may be useful for anyone interested in reproducing the Flame artistic motif, or in creating new artistic motifs for The CentOS Project corporate visual identity. - Description - The Flame artistic motif was built using the flame filter of Gimp 2.2 in CentOS 5.5. - The flame filter of Gimp can produce stunning, randomly generated fractal patterns. The flame filter of Gimp gives us a great oportunity to reduce the time used to produce new artistic motifs, because of its “randomly generated” nature. Once the artistic motif be created, it is propagated through all visual manifestations of CentOS Project corporate visual identity using the centos-art.sh script (see Directories trunk Scripts) inside the CentOS Artwork Repository. - To set the time intervals between each new visual style production, we could reuse the CentOS distribution major release schema. I.e., we could produce a new visual style, every two years, based on a new “randomly generated” flame pattern, and publish the whole corporate visual identity (i.e., distribution stuff, promotion stuff, websites stuff, etc.) with the new major release of CentOS distribution all together at once. - Producing a new visual style is not one day's task. Once we have defined the artistic motif, we need to propagate it through all visual manifestations of The CentOS Project corporate visual identity. When we say that we could produce one new visual style every two years we really mean: to work two years long in order to propagate a new visual style to all visual manifestations of The CentOS Project corporate visual identity. - Obviously, in order to propagate one visual style to all different visual manifestations of The CentOS Project corporate visual identity, we need first to know which the visual manifestations are. To define which visual manifestations are inside The CentOS Project corporate visual identity is one of the goals the CentOS Artwork Repository and this documentation manual are both aimed to satisfy. - Once we define which the visual manifestation are, it is possible to define how to produce them, and this way, organize the automation process. Such automation process is one of the goals of centos-art.sh script. - With the combination of both CentOS Artwork Repository and centos-art.sh scripts we define work lines where translators, programmers, and graphic designers work together to distribute and reduce the amount of time employed to produce The CentOS Project monolithic corporate identity. - From a monolithic corporate visual identity point of view, notice that we are producing a new visual style for the same theme (i.e., Flame). It would be another flame design but still a flame design. This idea is very important to be aware of, because we are somehow “refreshing” the theme, not changing it at all. - This way, as we are “refreshing” the theme, we still keep oursleves inside the monolithic conception we are trying to be attached to (i.e., one unique name, and one unique visual style for all visual manifestations). - Producing artistic motifs is a creative process that may consume long time, specially for people without experienced knowledge on graphic design land. Using “randomly generated” conception to produce artistic motifs could be, practically, a way for anyone to follow in order to produce maintainable artistic motifs in few steps. - Due to the “randomly generated” nature of Flame filter, we find that Flame pattern is not always the same when we use Flame filter interface. - Using the same pattern design for each visual manifestation is essential in order to maintain the visual connection among all visual manifestations inside the same theme. Occasionally, we may introduce pattern variations in opacity, size, or even position but never change the pattern design itself, nor the color information used by images considered part of the same theme. - - Important When we design background images, which are considered part of the same theme, it is essential to use the same design pattern always. This is what makes theme images to be visually connected among themeselves, and so, the reason we use to define the word “theme” as: a set of images visually connected among themeselves. - - In order for us to reproduce the same flame pattern always, Flame filter interface provides the Save and Open options. The Save option brings up a file save dialog that allows you to save the current Flame settings for the plug-in, so that you can recreate them later. The Open option brings up a file selector that allows you to open a previously saved Flame settings file. - The Flame settings we used in our example are saved in the file named 800x600.xcf-flame.def, inside the Backgrounds/Xcf directory structure. - See also - See Directories trunk Identity Themes Motifs. - - - See Directories trunk Identity Themes. - - - See Directories trunk Identity. - - - See Directories trunk. + ... -
-
- - Directories trunk Identity Themes Motifs Modern - Directories trunk Identity Themes Motifs Pipes - Directories trunk Identity Themes Motifs Flame - Directories -
- The <file>trunk/Identity/Themes/Motifs/Modern</file> Directory - Directories trunk Identity Themes Motifs Modern - Goals Description @@ -2094,13 +2114,13 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Motifs Pipes - Directories trunk Identity Themes Motifs TreeFlower - Directories trunk Identity Themes Motifs Modern + Directories trunk Identity Patterns + Directories trunk Identity Webenv + Directories trunk Identity Palettes Directories
- The <file>trunk/Identity/Themes/Motifs/Pipes</file> Directory - Directories trunk Identity Themes Motifs Pipes + The <file>trunk/Identity/Patterns</file> Directory + Directories trunk Identity Patterns Goals @@ -2128,25 +2148,9 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes
- Directories trunk Identity Themes Motifs TreeFlower - Directories trunk Identity Webenv - Directories trunk Identity Themes Motifs Pipes - Directories -
- The <file>trunk/Identity/Themes/Motifs/TreeFlower</file> Directory - Directories trunk Identity Themes Motifs TreeFlower - Goals - Description - Usage - See also - - -
-
- Directories trunk Identity Webenv Directories trunk Locales - Directories trunk Identity Themes Motifs TreeFlower + Directories trunk Identity Patterns Directories
The <file>trunk/Identity/Webenv</file> Directory @@ -2188,7 +2192,7 @@ trunk/Identity/Themes/Motifs/THEMENAME/THEMEVERSION/Brushes Webenv header background @@ -2204,14 +2208,14 @@ trunk/Identity/Themes/Models/Default/Promo/Web/CSS/stylesheet.css Producing visual style The visual style of CentOS web environment is defined in the following files: As graphic designer you use 1024x250.xcf file to produce 1024x250-bg.png file. Later, inside 1024x250.svg file, you use the 1024x250-bg.png file as background layer to draw your vectorial design. When you consider you artwork ready, use the centos-art.sh script, as described below, to produce the visual style controller images of CentOS web environment. Once you have rendered required image files, changing the visual style of CentOS web environment is a matter of replacing old image files with new ones, inside webenv repository file system structure. The visual style changes will take effect the next time customization line of CentOS web applications be packaged, uploded, and installed from [webenv] or [webenv-test] repositories. Navigation @@ -2983,56 +2987,13 @@ centos-art.sh prepare [OPTIONS]
The <file>trunk/Scripts/Functions/Render</file> Directory Directories trunk Scripts Functions Render - Goals - This section describes the render functionality of centos-art.sh script and general examples about content rendition inside a working copy of CentOS Artwork Repository. - Description - The render functionlity of centos-art.sh script standardizes rendition tasks inside the working copy of CentOS Artwork Repository. - Inside the working copy of CentOS Artwork Repository, rendition tasks take place inside renderable directories. Inside the render functionality of centos-art.sh script, you can control rendition tasks through different flows of rendition named base-rendition, post-rendition, last-rendition and directory-specific rendition. - Renderable directories - In order for a directory structure to be considered renderable, it should have one directory structure for input files and one directory structure for output files. Optionally, a third directory structure might be available for storing translation files. - Renderable directories are very tied to the way content is produced inside the working copy of CentOS Artwork Repository. Presently, content is produced through the following organizations: - - - Direct rendition - - In direct rendition, there is one directory structure for input files (trunk/Identity/Models) and one directory structure for output files (e.g., trunk/Identity/Images). Optionally, a third directory structure is available to store the input related translation files (e.g., trunk/Locales/Identity/Models). - In direct rendition, when the render functionality of centos-art.sh script is executed, it uses the input directory structure to build a list of files to process, which is used as reference to determine the location of the translation file and the location of the output file, as well. - - - - Theme-specific rendition - - In theme-specific rendition, there is one directory structure to store input files trunk/Identity/Themes/Models, one directory structure to store translation files (trunk/Locales/Identity/Themes/Models/), one directory structure to store artistic motifs (trunk/Identity/Themes/Motifs) and one directory structure to store output files (trunk/Identity/Themes/Motifs). - In theme-specific rendition, when the render functionality of centos-art.sh script is executed, it uses the input directory structure to build a list of files to process, which is used as reference to determine the location of the translation file and the location of the output file, as well. - In contrast with direct rendition, when we use theme-specific rendition, it is possible to combine both design models and artistic motifs to produce output in an arbitrary way. This configuration is specially interesting because it is possible to create different artistic motifs and one unique design model in order to produce one unique theme structure with different visual styles. Or the opposite, to create different theme structures and apply one unique visual style to produce different visual styles with the same theme structure. Or even push a bit farther and experiment with arbitrary combinations among them all. - - -
- In both direct and theme-specific rendition, if the location where the output file should be stored doesn't exist, the render functionality of centos-art.sh script will create it for you. - In both direct and theme-specific rendition, if the input related translation file doesn't exist, the render functionality of centos-art.sh script will produce the output in the same language of its input file. - The base-rendition flow - The base-rendition flow is the first rendition flow of all rendition flows available and takes place immediatly after executing the render functionality of centos-art.sh script. - The base-rendition consist on producing different output formats in different languages from one single input format. This is, one input file produces one output file. Inside the render functionality of centos-art.sh script, the input format is always an XML file (e.g., SVG, XHTML, Docbook) and the output format depends on the input file provided. - For example, when the input format is a SVG file, the base output is a PNG file; when the input format is XHTML the base output is an XHTML file; when the input format is a Docbook file the base output is an XHTML file. - The post-rendition flow - The post-rendition flow takes place after base-rendition and is applied to create modified copies of the file produced by base-rendition in the same directory structure. - For example, when the input format is a SVG file and the output is a PNG file, we can use post-rendition to extend the base output to other image formats. In fact, it is possible to do anything permitted by the ImageMagick and Netpbm programs (e.g., resize, rotate, reduce color, etc.) over the base output. - The last-rendition flow - The last-rendition flow takes place after post-rendition and is applied to all files produced as result of both base-rendition and post-rendition flows in the same directory structure, just before passing to process a different directory structure. - For example, consider the Preview.png image of Ksplash which is made of three different images. In order to build the Preview.png image, we need to create the three images the Preview.png image is made of first (e.g., through base-rendition) and then, combine them all together into one new image, the Preview.png image in this case. - Another example of using last-rendition flow is that related to GDM and KDM tar.gz file construction. Each tar.gz file is made of several files that need to be put together in order to make them installable. In the very specific case of GDM and KDM some of the required files are retrived from design models directory structure and others from artistic motifs directory structure after had been produced through base-rendition. In this case, the action of grouping files and packing them is realized through last-rendition action. This couldn't be possible through post-rendition because we need to wait to have two images first (produced through base-rendition) before we could grouping them all into the tar.gz package. - The directory-specific rendition flow - The directory-specific rendition flow isn't a rendition flow by itself but a combination of rendition flows that are applied to specific directories at rendition time. - Inside the working copy of CentOS Artwork Repository there are some directories structures that exist to achieve specific tasks every time they are produced. The directory-specific rendition flow provides a way for the render functionality of centos-art.sh script to know what actions to apply to what directory structure when producing them. - The directory-specific rendition flow combines the base-rendition, post-rendition and last-rendition flows in specific ways and applies them to specific directory structures when they are detected. Using this configuration can speed up production of different components like Syslinux, Grub, Gdm, Kdm and Ksplash that require intermediate formats or even several independent files, in order for the final content to be created. - Translations - To translate output files, the render functionality of centos-art.sh script creates a translated instance of the input file and uses it then to create the base output file. The translated instance is created using the related translation messages of the input file. Translation messages are stored under trunk/Locales and are created using the locale functionality of centos-art.sh script (see Directories trunk Scripts Functions Locale). - Usage - centos-art render [OPTIONS] path/to/dir - Synopsis + Name + The render functionlity is part of centos-art.sh script and standardizes rendition tasks inside the working copy of CentOS Artwork Repository. + Synopsis + centos-art render [OPTION] path/to/dir The path/to/dir parameter refers the path information related to the directory structure inside the working copy of CentOS Artwork Repository you'r going to produce. This path information defines whether to perform direct or theme-specific rendition. You can use the path/to/dir information to control the amount of components you'll produce inside a specific renderable location. The more deep you go inside the path the more specific you are when producing theme components. Sometimes, you can also combine the use of path/to/dir with the option to have a finer control over the files you produce. - The render functionality of centos-art.sh script accepts the following optios: + The render functionality of centos-art.sh script accepts the following options: @@ -3102,14 +3063,64 @@ centos-art.sh prepare [OPTIONS]
- Examples + Description + Inside the working copy of CentOS Artwork Repository, rendition tasks take place inside renderable directories. Inside the render functionality of centos-art.sh script, you can control rendition tasks through different flows of rendition named base-rendition, post-rendition, last-rendition and directory-specific rendition. + Renderable directories + In order for a directory structure to be considered renderable, it should have one directory structure for input files and one directory structure for output files. Optionally, a third directory structure might be available for storing translation files. + Renderable directories are very tied to the way content is produced inside the working copy of CentOS Artwork Repository. Presently, content is produced through the following organizations: - centos-art render trunk/Identity/Images/Brands - centos-art render trunk/Identity/Images/Brands --filter="symbol" - centos-art render trunk/Identity/Themes/Motifs/Flame/2 + Direct rendition + + In direct rendition, there is one directory structure for input files (trunk/Identity/Models) and one directory structure for output files (e.g., trunk/Identity/Images). Optionally, a third directory structure is available to store the input related translation files (e.g., trunk/Locales/Identity/Models). + In direct rendition, when the render functionality of centos-art.sh script is executed, it uses the input directory structure to build a list of files to process, which is used as reference to determine the location of the translation file and the location of the output file, as well. + + + + Theme-specific rendition + + In theme-specific rendition, there is one directory structure to store input files trunk/Identity/Themes/Models, one directory structure to store translation files (trunk/Locales/Identity/Themes/Models/), one directory structure to store artistic motifs (trunk/Identity/Images/Themes) and one directory structure to store output files (trunk/Identity/Images/Themes). + In theme-specific rendition, when the render functionality of centos-art.sh script is executed, it uses the input directory structure to build a list of files to process, which is used as reference to determine the location of the translation file and the location of the output file, as well. + In contrast with direct rendition, when we use theme-specific rendition, it is possible to combine both design models and artistic motifs to produce output in an arbitrary way. This configuration is specially interesting because it is possible to create different artistic motifs and one unique design model in order to produce one unique theme structure with different visual styles. Or the opposite, to create different theme structures and apply one unique visual style to produce different visual styles with the same theme structure. Or even push a bit farther and experiment with arbitrary combinations among them all. +
+ In both direct and theme-specific rendition, if the location where the output file should be stored doesn't exist, the render functionality of centos-art.sh script will create it for you. + In both direct and theme-specific rendition, if the input related translation file doesn't exist, the render functionality of centos-art.sh script will produce the output in the same language of its input file. + The base-rendition flow + The base-rendition flow is the first rendition flow of all rendition flows available and takes place immediatly after executing the render functionality of centos-art.sh script. + The base-rendition consist on producing different output formats in different languages from one single input format. This is, one input file produces one output file. Inside the render functionality of centos-art.sh script, the input format is always an XML file (e.g., SVG, XHTML, Docbook) and the output format depends on the input file provided. + For example, when the input format is a SVG file, the base output is a PNG file; when the input format is XHTML the base output is an XHTML file; when the input format is a Docbook file the base output is an XHTML file. + The post-rendition flow + The post-rendition flow takes place after base-rendition and is applied to create modified copies of the file produced by base-rendition in the same directory structure. + For example, when the input format is a SVG file and the output is a PNG file, we can use post-rendition to extend the base output to other image formats. In fact, it is possible to do anything permitted by the ImageMagick and Netpbm programs (e.g., resize, rotate, reduce color, etc.) over the base output. + The last-rendition flow + The last-rendition flow takes place after post-rendition and is applied to all files produced as result of both base-rendition and post-rendition flows in the same directory structure, just before passing to process a different directory structure. + For example, consider the Preview.png image of Ksplash which is made of three different images. In order to build the Preview.png image, we need to create the three images the Preview.png image is made of first (e.g., through base-rendition) and then, combine them all together into one new image, the Preview.png image in this case. + Another example of using last-rendition flow is that related to GDM and KDM tar.gz file construction. Each tar.gz file is made of several files that need to be put together in order to make them installable. In the very specific case of GDM and KDM some of the required files are retrived from design models directory structure and others from artistic motifs directory structure after had been produced through base-rendition. In this case, the action of grouping files and packing them is realized through last-rendition action. This couldn't be possible through post-rendition because we need to wait to have two images first (produced through base-rendition) before we could grouping them all into the tar.gz package. + The directory-specific rendition flow + The directory-specific rendition flow isn't a rendition flow by itself but a combination of rendition flows that are applied to specific directories at rendition time. + Inside the working copy of CentOS Artwork Repository there are some directories structures that exist to achieve specific tasks every time they are produced. The directory-specific rendition flow provides a way for the render functionality of centos-art.sh script to know what actions to apply to what directory structure when producing them. + The directory-specific rendition flow combines the base-rendition, post-rendition and last-rendition flows in specific ways and applies them to specific directory structures when they are detected. Using this configuration can speed up production of different components like Syslinux, Grub, Gdm, Kdm and Ksplash that require intermediate formats or even several independent files, in order for the final content to be created. + Translations + To translate output files, the render functionality of centos-art.sh script creates a translated instance of the input file and uses it then to create the base output file. The translated instance is created using the related translation messages of the input file. Translation messages are stored under trunk/Locales and are created using the locale functionality of centos-art.sh script (see Directories trunk Scripts Functions Locale). + Examples + + + + Author + Written by Alain Reguera Delgado. + Reporting bugs + Report bugs to centos-artwork@centos.org mailing list. + Copyright + Copyright ©right; 2009, 2010, 2011 The CentOS Project. + This is free software. You may redistribute copies of it under the terms of the GNU General Public License (see GNU General Public License). There is NO WARRANTY, to the extent permitted by law. See also