$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.