diff --git a/Documentation/Models/Docbook/Tcar-ug/Repository/History/2012.docbook b/Documentation/Models/Docbook/Tcar-ug/Repository/History/2012.docbook index c995f5f..4ce3b23 100644 --- a/Documentation/Models/Docbook/Tcar-ug/Repository/History/2012.docbook +++ b/Documentation/Models/Docbook/Tcar-ug/Repository/History/2012.docbook @@ -251,46 +251,54 @@ The CentOS Logo is made of two different components known as - The CentOS Symbol and The CentOS Type. Presently, to produce - these components, we create one SVG image for each PNG image - we want to produce, store it in trunk/Identity/Models/Brands/ - directory structure and run the command: centos-art render - trunk/Identity/Images/Brands + The CentOS Symbol and The CentOS Type. Presently (at the end + of September), to produce these components, we create one + SVG image for each PNG image we want to + produce, store it in trunk/Identity/Models/Brands/Logos + directory structure and run the command: + + + centos-art render trunk/Identity/Images/Brands/Logos + - This model works and scales well in situations where final - images aren't reused among themselves. However, when you need - to reuse images among themselves, a better solution is - required. The goal here would be: don't create SVG images - for PNG images you can build based on other PNG images. + This model works and scales well in situations when there + isn't a need to reuse final images among themselves. However, + when you need to reuse images among themselves, a better + solution is required. The goal here would be: don't create + SVG images for PNG images you can build + based on other PNG images. - This might be achieved by one of the following ways: + This might be achieved through one of the following ways: - Create a new specific functionality to achieved the goal - because the render specific functionality uses SVG files as - reference to build images (i.e., one SVG image produces one - PNG image). + Create a new specific functionality to achieved the goal. + Needed because the + specific functionality uses SVG files as + reference to build images (i.e., one SVG + image produces one PNG image). - Modify render functionality to work in two modes. The first - mode uses render-able source files in SVG or Docbook format as - reference to build PNG images and documentation in different - formats, respectively. The second mode uses a configuration - file named images.conf inside the design - models directory you want to produce images for as reference - to build PNG images. In this second case, the configuration - file specifies how final PNG images will be produced (e.g., by - appending or overlapping them one another). + Modify functionality to + work in different modes based on file type or file extension. + The first mode would use SVG files as + reference to build PNG images (just as it was doing so far). + The second mode would use a configuration file named + render.conf as reference inside the + design models directory you want to produce images for so as + to build the related PNG images. In this second case, the + configuration file specifies how final PNG images will be + produced (e.g., by appending or overlapping them one another). @@ -300,51 +308,57 @@ - centos-art render trunk/Identity/Models/Brands/Logos + centos-art render trunk/Identity/Images/Brands/Logos - This command should evaluate whether to render images either - using SVG rendition mode or configuration-based rendition - mode. When there are render-able source files (e.g., SVG, - Docbook,) inside the design model directory structure the - rendition will be run from source files (i.e,. build a list - of SVG/Docbook files and create final content based on them). - When there isn't render-able source files inside design models - directory, and only then, centos-art.sh will look for - images.conf configuration file and, if it exists, create - images based on its content. In case the configuration file - doesn't exist, no rendition will take place. - - - - For example if the - trunk/Identity/Models/Brands/Logos/images.conf configuration - file exists and has the following content: + This command should evaluate which type of rendition will be + done, based on whether the source file is a scalable vector + graphic (SVG) or a configuration file. To + make this decision, the centos-art.sh + script looks for SVG files first, and + configuration files later. When SVG files + are found, the centos-art.sh script uses a + list of SVG files and process them one by + one excluding any related configuration file that could exist. + On the other hand, if no SVG file is found + inside the related design model directory structure, the + centos-art.sh script will use the + configuration file with the name + render.conf to create images as specified + inside it. When neither a SVG or a + configuration file is found inside the design model directory + structure, the centos-art.sh script + finishes its execution without any error message. For + example, if no SVG file is found inside + trunk/Identity/Models/Brands/Logos/ + directory and the + trunk/Identity/Models/Brands/Logos/images.conf + configuration file exists therein with the following content: [centos.png] - -models = "trunk/Identity/Models/Brands/Symbols/centos-40x50mm.svgz trunk/Identity/Models/Brands/Types/centos-x50mm.svgz" +models = "trunk/Identity/Models/Brands/Symbols/centos-symbol-forlogos.svgz trunk/Identity/Models/Brands/Types/centos.svgz" formats = "xpm jpg" heights = "48 78" fgcolor = "000000 ffffff" -bgcolor = "ffffff:0" +bgcolor = "ffffff-0" command = "/usr/bin/convert +append" [centos-artwork.png] - -models = "trunk/Identity/Models/Brands/Symbols/centos-40x50mm.svgz trunk/Identity/Models/Brands/Types/centos-x50mm.svgz trunk/Identity/Models/Brands/Types/artwork-x50mm.svgz" +models = "trunk/Identity/Models/Brands/Symbols/centos-symbol-forlogos.svgz trunk/Identity/Models/Brands/Types/centos.svgz trunk/Identity/Models/Brands/Types/artwork.svgz" formats = "xpm jpg" heights = "48 78" fgcolor = "000000 ffffff" -bgcolor = "ffffff:0" -command = "/usr/bin/convert +appdend" +bgcolor = "ffffff-0" +command = "/usr/bin/convert +append" - The centos-art.sh script should produce the following files: + The centos-art.sh script should produce the + following image files: @@ -375,11 +389,42 @@ trunk/Identity/Images/Brands/Logos/ffffff/ffffff-0/78/centos-artwork.xmp - The final images output location inside the repository is - determined using the design model directory provided as - argument. Basically, by changing the path string from Models - to Images and adding foreground color, background color, - height value and image name to it. + The final location for storing images output inside the + repository is determined by using the design model directory + provided as argument. Basically, the + centos-art.sh script changes the path + components from Models to Images and adds foreground color, + background color, height value and image name to it to + differentiate rendered images. + + + + In case you need to restrict the amount of files you want to + produce including their formats, heights, colors and commands, + you need to modify the content of the related + render.conf configuration file. There is + not any command-line option available for such tasks. The most + + command-line options can do for you is when there are more + than one configuration file inside the same design model + directory and you need to specify which one of them will be + used as reference. In such case you can use the + option. + + + + When images are produced through configuration files, the + centos-art.sh script takes the order + provided in the list of design models to build the list of + images you will work with through the command specified. For + example, the order in which images will be appended or + overlapped. + + + + Localization of logo images will not be and must not be + supported in any way. That would bring disastrous confusion in + the area of visual recognition.