From c3390924fbb3732045184b594c35fbb645e81815 Mon Sep 17 00:00:00 2001 From: Alain Reguera Delgado Date: Mar 22 2011 21:26:42 +0000 Subject: Update introduction chapter inside documentation manual: - Add copying.texi, history.texi and authors.texi files. Information in this files was taken from `about' functionality. Since the copying, history and authors information is now inside the documentation manual, the `about' functionality is near to be no longer used. --- diff --git a/Manual/Introduction/authors.texi b/Manual/Introduction/authors.texi new file mode 100755 index 0000000..1214c67 --- /dev/null +++ b/Manual/Introduction/authors.texi @@ -0,0 +1,9 @@ +This section records authoring information of CentOS Artwork +Repository, in alphabetical order. + +@verbatim +Ralph Angenendt +Marcus Moeller +Alain Reguera Delgado , 2009, 2010, 2011 +Karanbirn Singh +@end verbatim diff --git a/Manual/Introduction/chapter-menu.texi b/Manual/Introduction/chapter-menu.texi index 6036345..e60794c 100644 --- a/Manual/Introduction/chapter-menu.texi +++ b/Manual/Introduction/chapter-menu.texi @@ -1,4 +1,7 @@ @menu +* History:: +* Authors:: +* Copying Conditions:: * Convenctions:: -* Feedback:: +* Feedback:: @end menu diff --git a/Manual/Introduction/chapter-nodes.texi b/Manual/Introduction/chapter-nodes.texi index 184f00c..f143dcf 100644 --- a/Manual/Introduction/chapter-nodes.texi +++ b/Manual/Introduction/chapter-nodes.texi @@ -1,3 +1,18 @@ +@node History +@section History +@cindex History +@include Introduction/history.texi + +@node Authors +@section Authors +@cindex Authors +@include Introduction/authors.texi + +@node Copying Conditions +@section Copying Conditions +@cindex Copying conditions +@include Introduction/copying.texi + @node Convenctions @section Document Convenctions @cindex Document convenctions diff --git a/Manual/Introduction/convenctions.texi b/Manual/Introduction/convenctions.texi index 025f8c0..9db0d4b 100644 --- a/Manual/Introduction/convenctions.texi +++ b/Manual/Introduction/convenctions.texi @@ -1,7 +1,20 @@ -In this manual the word @emph{we}, as personal pronoun, is used to -repesent @emph{The CentOS Artwork SIG}, the group of persons building +In this manual the personal pronoun @emph{we} is used to repesent +@emph{The CentOS Artwork SIG}. This is, the group of persons building the CentOS Artwork Repository. +In this manual the phrase ``CentOS Artwork Repository'' is used to +refer the very specific organization of files we use to store The +CentOS Project corporate visual identity. It is the source location +The CentOS Community uses to retrive The CentOS Project branded images +used to build different visual manifestations like The CentOS +Distribution, The CentOS Webs and The CentOS Stationery. + +In this manual the word ``@command{centos-art}'' is used to refer the +command-line interface of @command{centos-art.sh} script. The +@command{centos-art.sh} script is the the automation tool we use to +realize most of the frequent tasks inside the CentOS Artwork +Repository. + In this manual, certain words are represented in different fonts, typefaces, sizes, and weights. This highlighting is systematic; different words are represented in the same style to indicate their diff --git a/Manual/Introduction/copying.texi b/Manual/Introduction/copying.texi new file mode 100755 index 0000000..cc2a72e --- /dev/null +++ b/Manual/Introduction/copying.texi @@ -0,0 +1,55 @@ +Inside the CentOS Artwork Repository you can find content branded by +The CentOS Project and content not branded at all. Contents branded by +The CentOS Project contain either The CentOS Trademark, The CentOS +Logo or The CentOS Symbol. Content branded by The CentOS Project +cannot be redistributed without previous conversation with The CentOS +Project. However, you can study and modify both content branded by +The CentOS Project and content not branded at all in the sake of +proposing improvements to The CentOS Project corporate visual +identity. + +If you are using the CentOS Artwork Repository for producing your own +corporate visual identity, you should remove all The CentOS Trademarks +from your contents and rename the repository to something other than +CentOS Artwork Repository. + +The CentOS Artwork Repository organizes files in a very specific way +to implement The CentOS Project corporate visual identity. This very +specific organization of files is part of @command{centos-art.sh} +script, a bash script that automates most of the frequent tasks inside +the repository. + +@subsection The @command{centos-art.sh} script + +The @command{centos-art.sh} script and the organization of files it +needs to work are not in the public domain; they are copyrighted and +there are restrictions on their distribution, but these restrictions +are designed to permit everything that a good cooperating citizen +would want to do. What is not allowed is to try to prevent others +from further sharing any version of this program that they might get +from you. + +Specifically, we want to make sure that you have the right to give +away copies of @command{centos-art.sh} script, that you receive source +code or else can get it if you want it, that you can change this +program or use pieces of it in new free programs, and that you know +you can do these things. + +To make sure that everyone has such rights, we have to forbid you to +deprive anyone else of these rights. For example, if you distribute +copies of the @command{centos-art.sh} script, you must give the +recipients all the rights that you have. You must make sure that +they, too, receive or can get the source code. And you must tell them +their rights. + +Also, for our own protection, we must make certain that everyone finds +out that there is no warranty for the @command{centos-art.sh} script. +If this program is modified by someone else and passed on, we want +their recipients to know that what they have is not what we +distributed, so that any problems introduced by others will not +reflect on our reputation. + +The precise conditions of the license for the @command{centos-art.sh} +script are found in the General Public Licenses that accompany it. +This manual specifically is covered by the GNU Free Documentation +License. diff --git a/Manual/Introduction/history.texi b/Manual/Introduction/history.texi new file mode 100755 index 0000000..61a957b --- /dev/null +++ b/Manual/Introduction/history.texi @@ -0,0 +1,129 @@ +This section records noteworthy changes of CentOS Artwork Repository. + +@subheading 2008 + +The CentOS Artwork Repository started at CentOS Developers mailing +list (@email{centos-devel@@centos.org}) during a discussion about how +to automate the slide images of Anaconda. In such discussion, Ralph +Angenendt rose up his hand to ask: Do you have something to show? + +To answer the question, Alain Reguera Delgado posted a bash script to +produce slide images in different languages ---together with the +proposition of creating a Subversion centralized repository where +translations and image production could be distributed inside The +CentOS Community---. + +Karanbirn Sighn considered the idea intresting and provides the +infrastructure to support the effort. This way both the CentOS Artwork +SIG and the CentOS Artwork Repository were created. + +@itemize +@item @url{https://projects.centos.org/svn/artwork/} +@item @url{https://projects.centos.org/trac/artwork/} +@end itemize + +Once the CentOS Artwork Repository was available, Alain Reguera +Delagdo uploaded the bash script for rendering Anaconda slides and +Ralph Angenendt documented the script very well. + +Once the rendition script and its documentation were available online, +translators started to download working copies of CentOS Artwork +Repository to produce slide images in their own languages. + +@subheading 2009 + +The rendition script is designed to take one SVG file, apply one SED +file with replacement command inside to produce one SVG translated +instance that is used to produce one translated PNG image by means of +Inkscape program. The rendition script was named @command{render.sh} +and it is copied to each directory structure that requires such +process to produce images. + +Furthermore, functionalies are centralized in a common placed and +linked from different directory structures. There is no need to have +the same code in different directory structures if can have it in just +one place and then create links to it. + +Start to implement concepts about corporate identity. As referece it +is used Wikipedia (@url{http://en.wikipedia.org/Corporate_identity}) +and the book @emph{Corporate Identity} by Wally Olins (1989). The main +goal of @command{render.sh} becomes to: automate production of a +monolithic corporate visual identity structure based on The CentOS +Mission and The CentOS Release Schema. + +Around March, Alain Reguera Delgado is out of Internet for an +undefined amount of time, but continues developing the idea of CentOS +Artwork Repository and the rendition script off-line. + +Most of the work I propose from this time on is my own responsability. +I keep myself thinking to be part of the CentOS Artwork SIG and in +that sake, I use the personal pronoun @emph{we} to refer what I do as +part of the group hoping someday to share this work with you again and +improve it together. + +The CentOS Artwork Repository documentation starts to take form in +@LaTeX{} format. + +@subheading 2010 + +The @command{render.sh} is removed from the repository directory +structures and the @command{centos-art.sh} script is used instead. The +@command{centos-art.sh} is created to be a command-line interface that +automate most frequent tasks inside the repository and can be called +anywhere inside the repository or outside it; whenever it points to a +directory structure inside the repository. At the very first moments +of using @command{centos-art.sh} command-line, it used to have the +following using form: + +@verbatim +centos-art function --action=path/to/dir +@end verbatim + +Inside the rendition script, functionalities started to get identified +and separated one another. For example, when images are rendered, +there is no need to load manual functionality. There are now common +functionalities and specific functionalities. Common functionalities +are loaded when the script is initiated and are available to specific +functionalities. + +Start using @command{getopt} to handle command-line options. + +The repository directory structure is optimized to continue +implementing corporate identity concepts and the @command{centos-art} +command-line. + +@subheading 2011 + +The `trunk/Translation' directory structure is removed. The +`trunk/Locales' directory structure is used instead to store locale +information. + +The `.sed' translation files are no longer used, scalable vector +graphics are used instead. Translation messages take place by means +of xml2po and gettext. With xml2po translatable strings are retrived +from `.svg' files and stored inside gettext `.pot' and `.po' files for +translators to edit. Finally, xml2po is used again to build the +temporal design model translated instance which the final `.png' image +is built from. + +Inside @command{centos-art.sh}, update command-line arguments and +options parsing. Keep using @command{getopt} to parse options passed +in the command-line, but change the way @command{centos-art.sh} is +called from. The following form is used: + +@verbatim +centos-art function path/to/dir --options +@end verbatim + +Start using verbs to name the @command{centos-art.sh} functionalities. + +Organize @command{centos-art.sh} functionalities in ``administrative'' +functions and ``productive'' functions. Administrative functions +cover actions like: copying, deleting and renaming directory +structures. Also, preparing your workstation for using +@command{centos-art} command-line, make backups of the distribution +theme currently installed, installing themes created inside The +CentOS Artwork repository and restoring themes from backup. On the +other hand, productive functions cover actions like: content +rendition, content localization, content documentation and content +maintainance.