Blob Blame History Raw
$Id$
This file records noteworthy changes of CentOS Artwork Repository.

  Copyright (C) 2003-2011 The CentOS Project.

  Copying and distribution of this file, with or without modification, are
  permitted in any medium without royalty provided the copyright notice and
  this notice are preserved.

-------------------------------------------------------------------------------
(2011)

    - The `trunk/Translation' directory structure is removed. The
      `trunk/Scripts/Bash/Functions/Locale/Config' directory structure
      is used instead to store locale information. 
      
    - The production of both documentation manuals and images is
      updated to handle information in different languages by means of
      `xml2po' and `gettext' locale procedures. 
      
      Basically, we create one XML file with the information of the
      file we want to have translations for (e.g., in the case of
      documentation manuals we use DocBook, but in the case of images
      very simple XML files are used instead with very simple
      structures just to cover image translatios needs).  The XML file
      contains the pattern information in English language.  Later,
      using `xml2po' program we produce POT and PO files that end up
      in translated XML files.  Finally, we use the appropriate
      commands and the XML files to produce different outputs files
      (e.g., PDF, HTML, PNG, etc.) in different languages.

      In the very specific case of documentation files, we use Texinfo
      as first source of documenting and use `--docbook' option of
      makeinfo to produce the DocBook XML file we pass to `xml2po' to
      produce translated contents of the documentation we've written
      on using Texinfo. Sadly, `--docbook' output on Texinfo 4.8 seems
      to be incomplete (e.g., when a chapter is created the title tag
      is not set inside. Instead the <para> tag is used instead which
      make commands like 'docbook2pdf' to fail). I'm pretty sure this
      will be fixed in the feature, so I keep planing relaying in the
      fact that Texinfo will produce '--docbook' output correctly.

      In the very specific case of image files, we use SVG structure
      as first source of image translation. SVG files are XML based so
      `xml2po' can be applied to them, build pot and po files and
      finally create a temporal SVG instance with language-specific
      transaltions.

        centos-art locale --edit=Identity/Themes/Distro/Anaconda/Progress

      In the very specific case of plain-text files, we cannot use
      gettext directly (we need to mark translatable strings first).
      So, in order to translate plain-text files, we set translation
      markers inside plain-text files and use Bash scripts to relate
      both translation markers with the replacement string. The
      replacement string is passed to gettext, as we usually do, to
      retrive language-specific information at rendition time.

        centos-art locale --edit

    - Documentation design models were moved to
      `trunk/Scripts/Bash/Functions/Manuals/Config' in order to make
      them reusable by other manuals. For example, if you need to
      create a new manual inside CentOS Artwork Repository, execute
      the following command:

        centos-art manual --create-manual='ManualName'

      The above command will use the Default manual design model
      (i.e., `trunk/Scripts/Bash/Functions/Manuals/Config), which is
      texinfo-based and will prepare the manual directory structure
      under trunk/Manuals directory structure.

-------------------------------------------------------------------------------
(2010)

    - Inside centos-art.sh script, functionalities start to get
      identified and separated one from 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.

    - The directory structure is optimized to implements the corporate
      identity concepts and the centos-art.sh script.  The CentOS
      Artwork Repository directory structure places the organizational
      convenctions that centos-art.sh script needs to do what we
      expect from it to do.

    - The following functionalities start to take form as part of
      centos-art.sh script:

      `trunk/Scripts/Bash/Functions/Render/render.sh'  
        
            To produce translated images using Inkscape and Sed
            replacement commands.

      `trunk/Scripts/Bash/Functions/Manual/manual.sh'  
        
            To produce documentation using Texinfo.  Almost all
            LaTeX-based documents were moved to Texinfo format and
            handled by manual functionality. 
     
      `trunk/Scripts/Bash/Functions/Locale/locale.sh'  
        
            To translate centos-art.sh command-line interface messages
            using gettext.

      `trunk/Scripts/Functions/Shell/shell.sh'    
        
            To perform massive actions inside shell scripts. For
            example, update top-commentaries massively.
    
      `trunk/Scripts/Functions/Svg/svg.sh'
        
            To perform massive actions inside SVG files.

      `trunk/Scripts/Functions/Html/html.sh'
        
            To perform massive actions inside HTML files.

      `trunk/Scripts/Functions/Path/path.sh'
        
            To automate manipulation of files, branches, and tags. 

      `trunk/Scripts/Functions/About/about.sh'
        
            To print license, authors, history, copying, etc.

-------------------------------------------------------------------------------
(2009)

- The rendering script starts to evolve into centos-art.sh script, a
  command-line interface to manipulate the CentOS Artwork Repository.

- Corporate identity concepts taken from Wikipedia and related books
  are introduced as development reference. The main goal of
  centos-art.sh turns to: automate production of a monolithic
  corporate visual identity structure based on CentOS Mission and
  CentOS Release Schema. 

- Alain Reguera Delgado is out of Internet for an undefined amount of
  time, but continues developing CentOS Artwork Repository and its
  automation tool (i.e., the centos-art.sh script) off-line.

- Documentation begins to take form in LaTeX format.

-------------------------------------------------------------------------------
(2008)

    - The CentOS Artwork Repository started at CentOS Developers
      mailing list.

    - Alain Reguera Delgado shares ideas in a thread about Anaconda
      progress slide images and the possibility of automating their
      construction.

    - Ralph Angenendt rises up his hand asking: Do you have something
      to show?

    - Alain Reguera Delgado posts 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
      CentOS Community---.

    - Karanbirn Sighn considers the idea intresting and provides the
      infrastructure to support the effort as the CentOS Artwork SIG.

        https://projects.centos.org/svn/artwork/
        https://projects.centos.org/trac/artwork/

    - Alain Reguera Delagdo uploads the rendering script to CentOS
      Artwork Repository.

    - Ralph Angenendt documents the rendering script.

    - With the rendering script and its documentation available,
      translators start to download working copies of CentOS Artwork
      Repository to produce slide images in their own languages.