diff --git a/Manuals/en/Html/Repository/repository.html b/Manuals/en/Html/Repository/repository.html index 2cd9a7a..565e5a9 100644 --- a/Manuals/en/Html/Repository/repository.html +++ b/Manuals/en/Html/Repository/repository.html @@ -60,7 +60,7 @@ ul.toc {list-style: none} - +
[Top] [Contents][Index][Index] [ ? ]

CentOS Artwork Repository

@@ -86,9 +86,9 @@ Documentation License. 3. trunk   -Index   +Index   -List of Figures   +List of Figures   @@ -99,7 +99,7 @@ Documentation License. - +
[Top] [Contents][Index][Index] [ ? ]

diff --git a/Manuals/en/Html/Repository/repository_1.html b/Manuals/en/Html/Repository/repository_1.html index c805b42..6246d9e 100644 --- a/Manuals/en/Html/Repository/repository_1.html +++ b/Manuals/en/Html/Repository/repository_1.html @@ -68,7 +68,7 @@ ul.toc {list-style: none}   [Top] [Contents] -[Index] +[Index] [ ? ] diff --git a/Manuals/en/Html/Repository/repository_10.html b/Manuals/en/Html/Repository/repository_10.html index 80ad3a3..d400bd1 100644 --- a/Manuals/en/Html/Repository/repository_10.html +++ b/Manuals/en/Html/Repository/repository_10.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -110,7 +110,7 @@ to HTML design models.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_11.html b/Manuals/en/Html/Repository/repository_11.html index f8553a3..ede9906 100644 --- a/Manuals/en/Html/Repository/repository_11.html +++ b/Manuals/en/Html/Repository/repository_11.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -111,7 +111,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_12.html b/Manuals/en/Html/Repository/repository_12.html index 5508561..32ae15b 100644 --- a/Manuals/en/Html/Repository/repository_12.html +++ b/Manuals/en/Html/Repository/repository_12.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -115,7 +115,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_13.html b/Manuals/en/Html/Repository/repository_13.html index 79b4f3e..0a13a67 100644 --- a/Manuals/en/Html/Repository/repository_13.html +++ b/Manuals/en/Html/Repository/repository_13.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -111,7 +111,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_14.html b/Manuals/en/Html/Repository/repository_14.html index 06b4200..0bde784 100644 --- a/Manuals/en/Html/Repository/repository_14.html +++ b/Manuals/en/Html/Repository/repository_14.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -443,7 +443,7 @@ CentOS [base] and CentOS [updates] repositories.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_15.html b/Manuals/en/Html/Repository/repository_15.html index de2f75e..5633157 100644 --- a/Manuals/en/Html/Repository/repository_15.html +++ b/Manuals/en/Html/Repository/repository_15.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -111,7 +111,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_16.html b/Manuals/en/Html/Repository/repository_16.html index 496ecb6..58218e8 100644 --- a/Manuals/en/Html/Repository/repository_16.html +++ b/Manuals/en/Html/Repository/repository_16.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -103,7 +103,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_17.html b/Manuals/en/Html/Repository/repository_17.html index 5f645d0..107815d 100644 --- a/Manuals/en/Html/Repository/repository_17.html +++ b/Manuals/en/Html/Repository/repository_17.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -108,7 +108,7 @@ final CentOS themes. CentOS themes can be tagged as "Default" or 3.15 trunk/Identity/Themes/Models   -3.55 trunk/Translations/Identity/Themes   +3.55 trunk/Translations/Identity/Themes   @@ -119,7 +119,7 @@ final CentOS themes. CentOS themes can be tagged as "Default" or   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_18.html b/Manuals/en/Html/Repository/repository_18.html index 0460b9f..4fd11a8 100644 --- a/Manuals/en/Html/Repository/repository_18.html +++ b/Manuals/en/Html/Repository/repository_18.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -117,7 +117,7 @@ a directory to the list. By default you have the `See section   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_19.html b/Manuals/en/Html/Repository/repository_19.html index 06f2430..61623fe 100644 --- a/Manuals/en/Html/Repository/repository_19.html +++ b/Manuals/en/Html/Repository/repository_19.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -115,7 +115,7 @@ themes are maintained by CentOS Community.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_2.html b/Manuals/en/Html/Repository/repository_2.html index 9eb63d2..88d13dc 100644 --- a/Manuals/en/Html/Repository/repository_2.html +++ b/Manuals/en/Html/Repository/repository_2.html @@ -68,7 +68,7 @@ ul.toc {list-style: none}   [Top] [Contents] -[Index] +[Index] [ ? ] diff --git a/Manuals/en/Html/Repository/repository_20.html b/Manuals/en/Html/Repository/repository_20.html index 60ae6bf..124531d 100644 --- a/Manuals/en/Html/Repository/repository_20.html +++ b/Manuals/en/Html/Repository/repository_20.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -116,7 +116,7 @@ described in See section Theme Motifs.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_21.html b/Manuals/en/Html/Repository/repository_21.html index f21fe48..6e77490 100644 --- a/Manuals/en/Html/Repository/repository_21.html +++ b/Manuals/en/Html/Repository/repository_21.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -175,7 +175,7 @@ the CentOS brand will exonerate user form visual isolation.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_22.html b/Manuals/en/Html/Repository/repository_22.html index 530a2d6..426a287 100644 --- a/Manuals/en/Html/Repository/repository_22.html +++ b/Manuals/en/Html/Repository/repository_22.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -103,7 +103,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_23.html b/Manuals/en/Html/Repository/repository_23.html index ae2aa48..bd70a3a 100644 --- a/Manuals/en/Html/Repository/repository_23.html +++ b/Manuals/en/Html/Repository/repository_23.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -116,7 +116,7 @@ examples of promotion designs.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_24.html b/Manuals/en/Html/Repository/repository_24.html index eab7667..bf26359 100644 --- a/Manuals/en/Html/Repository/repository_24.html +++ b/Manuals/en/Html/Repository/repository_24.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -115,7 +115,7 @@ HTML standards should be consider here.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_25.html b/Manuals/en/Html/Repository/repository_25.html index cd5be78..c159916 100644 --- a/Manuals/en/Html/Repository/repository_25.html +++ b/Manuals/en/Html/Repository/repository_25.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -199,7 +199,7 @@ works are released under   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_26.html b/Manuals/en/Html/Repository/repository_26.html index 7b5ca43..2db71a8 100644 --- a/Manuals/en/Html/Repository/repository_26.html +++ b/Manuals/en/Html/Repository/repository_26.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -207,7 +207,7 @@ can contain subdirectories to help you organize the design process. 3.26 trunk/Identity/Themes/Motifs/Modern/Backgrounds/Xcf   -3.56 trunk/Translations/Identity/Themes/Backgrounds   +3.56 trunk/Translations/Identity/Themes/Backgrounds   @@ -219,7 +219,7 @@ can contain subdirectories to help you organize the design process.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_27.html b/Manuals/en/Html/Repository/repository_27.html index 389e918..198a0b1 100644 --- a/Manuals/en/Html/Repository/repository_27.html +++ b/Manuals/en/Html/Repository/repository_27.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -108,7 +108,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_28.html b/Manuals/en/Html/Repository/repository_28.html index 196e7b7..9c4fa38 100644 --- a/Manuals/en/Html/Repository/repository_28.html +++ b/Manuals/en/Html/Repository/repository_28.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -107,7 +107,7 @@ command line interface.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_29.html b/Manuals/en/Html/Repository/repository_29.html index 79a7a7c..a40faac 100644 --- a/Manuals/en/Html/Repository/repository_29.html +++ b/Manuals/en/Html/Repository/repository_29.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -116,7 +116,7 @@ based on them. In this last case you need the `Xcf/' directory.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_3.html b/Manuals/en/Html/Repository/repository_3.html index 0312d52..59146a9 100644 --- a/Manuals/en/Html/Repository/repository_3.html +++ b/Manuals/en/Html/Repository/repository_3.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -145,53 +145,53 @@ ul.toc {list-style: none} 3.34 trunk/Scripts/Bash   -3.35 trunk/Scripts/Bash/Functions   +3.35 trunk/Scripts/Bash/Functions   -3.36 trunk/Scripts/Bash/Functions/Help   +3.36 trunk/Scripts/Bash/Functions/Help   -3.37 trunk/Scripts/Bash/Functions/Html   +3.37 trunk/Scripts/Bash/Functions/Html   -3.38 trunk/Scripts/Bash/Functions/Locale   +3.38 trunk/Scripts/Bash/Functions/Locale   -3.39 trunk/Scripts/Bash/Functions/Path   +3.39 trunk/Scripts/Bash/Functions/Path   -3.40 trunk/Scripts/Bash/Functions/Render   +3.40 trunk/Scripts/Bash/Functions/Render   -3.41 trunk/Scripts/Bash/Functions/Render/Config   +3.41 trunk/Scripts/Bash/Functions/Render/Config   -3.42 trunk/Scripts/Bash/Functions/Shell   +3.42 trunk/Scripts/Bash/Functions/Shell   -3.43 trunk/Scripts/Bash/Functions/Svg   +3.43 trunk/Scripts/Bash/Functions/Svg   -3.44 trunk/Scripts/Bash/Functions/Verify   +3.44 trunk/Scripts/Bash/Functions/Verify   -3.45 trunk/Scripts/Bash/Locale   +3.45 trunk/Scripts/Bash/Locale   -3.46 trunk/Scripts/Perl   +3.46 trunk/Scripts/Perl   -3.47 trunk/Scripts/Python   +3.47 trunk/Scripts/Python   -3.48 trunk/Translations   +3.48 trunk/Translations   -3.49 trunk/Translations/Identity   +3.49 trunk/Translations/Identity   -3.50 trunk/Translations/Identity/Brands   +3.50 trunk/Translations/Identity/Brands   -3.51 trunk/Translations/Identity/Brands/Tpl   +3.51 trunk/Translations/Identity/Brands/Tpl   -3.52 trunk/Translations/Identity/Fonts   +3.52 trunk/Translations/Identity/Fonts   -3.53 trunk/Translations/Identity/Models   +3.53 trunk/Translations/Identity/Models   -3.54 trunk/Translations/Identity/Release   +3.54 trunk/Translations/Identity/Release   -3.55 trunk/Translations/Identity/Themes   +3.55 trunk/Translations/Identity/Themes   -3.56 trunk/Translations/Identity/Themes/Backgrounds   +3.56 trunk/Translations/Identity/Themes/Backgrounds   -3.57 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress   +3.57 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress   -3.58 trunk/Translations/Identity/Widgets   +3.58 trunk/Translations/Identity/Widgets   @@ -202,7 +202,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_30.html b/Manuals/en/Html/Repository/repository_30.html index bee1808..976da11 100644 --- a/Manuals/en/Html/Repository/repository_30.html +++ b/Manuals/en/Html/Repository/repository_30.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -93,7 +93,7 @@ ul.toc {list-style: none}

To render Anaconda progress slide images using the Modern's artistic motif design, the Default theme model, and available translation files -(see section trunk/Translations/Identity/Themes/Distro/Anaconda/Progress); +(see section trunk/Translations/Identity/Themes/Distro/Anaconda/Progress); use the following commands:

- +
 
cd /home/centos/artwork/trunk/Identity/Themes/Motifs/Modern/Distro/Anaconda/Progress/
@@ -144,7 +144,7 @@ centos-art render --identity
  [ << ] [ Up ][ >> ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_31.html b/Manuals/en/Html/Repository/repository_31.html index b5b720c..4d0f780 100644 --- a/Manuals/en/Html/Repository/repository_31.html +++ b/Manuals/en/Html/Repository/repository_31.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -108,7 +108,7 @@ limitations. Theme palettes contain theme's unique color information.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_32.html b/Manuals/en/Html/Repository/repository_32.html index b60d26f..b03a123 100644 --- a/Manuals/en/Html/Repository/repository_32.html +++ b/Manuals/en/Html/Repository/repository_32.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -103,7 +103,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_33.html b/Manuals/en/Html/Repository/repository_33.html index 63568a2..adee3f3 100644 --- a/Manuals/en/Html/Repository/repository_33.html +++ b/Manuals/en/Html/Repository/repository_33.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -414,7 +414,7 @@ the following `syslinux.hex' file:   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_34.html b/Manuals/en/Html/Repository/repository_34.html index ead12ff..6a3df65 100644 --- a/Manuals/en/Html/Repository/repository_34.html +++ b/Manuals/en/Html/Repository/repository_34.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -103,7 +103,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_35.html b/Manuals/en/Html/Repository/repository_35.html index cce92c6..2b466f5 100644 --- a/Manuals/en/Html/Repository/repository_35.html +++ b/Manuals/en/Html/Repository/repository_35.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -154,7 +154,7 @@ repository):   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_36.html b/Manuals/en/Html/Repository/repository_36.html index 8ca71fa..bda5cf4 100644 --- a/Manuals/en/Html/Repository/repository_36.html +++ b/Manuals/en/Html/Repository/repository_36.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -114,7 +114,7 @@ programming language.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_37.html b/Manuals/en/Html/Repository/repository_37.html index 0f080c8..ea7edf0 100644 --- a/Manuals/en/Html/Repository/repository_37.html +++ b/Manuals/en/Html/Repository/repository_37.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -79,49 +79,78 @@ ul.toc {list-style: none}

3.34.1 Goals

-

The `trunk/Scripts/Bash' directory exists to organize the -"trunk" development line of centos-art.sh automation -script. The centos-art.sh script standardizes frequent -tasks inside your working copy of CentOS Artwork Repository. +

The `trunk/Scripts/Bash' directory exists to organize the trunk +development line of `centos-art.sh' automation script. The +`centos-art.sh' script standardizes frequent tasks inside your +working copy of CentOS Artwork Repository.

3.34.2 Description

-

The best way to understand centos-art.sh automation script -is studying its source code. The centos-art.sh script is -splited in several configuration and function files which are loaded -when the centos-art.sh script is executed. This section -describes the order in which centos-art.sh loads its -configuration and function files. +

The best way to understand `centos-art.sh' automation script is +studying its source code. The `centos-art.sh' script is splited +in several configuration and function files which are loaded when the +`centos-art.sh' script is executed. This section describes the +order in which `centos-art.sh' loads its configuration and +function files.

When you type the centos-art command in your terminal, the operating system trys to execute that command. In order to execute the command, the operating system needs to know where it is, so the operating system uses the PATH environment variable to look for that command's location. If your system was prepared to use CentOS -Artwork Repository correctly (see usage section above), you should -have a symbolic link inside `~/bin/' directory that points to the -centos-art.sh script file. As `~/bin/' directory is, by -default, inside PATH environment variable, the execution of -centos-art command runs the `centos-art.sh' script. +Artwork Repository correctly (see section trunk/Scripts/Bash/Functions/Verify), you should have a symbolic link inside `~/bin/' +directory that points to the `centos-art.sh' script file. As +`~/bin/' directory is, by default, inside PATH environment +variable, the execution of centos-art command runs the +`centos-art.sh' script.

-

When centos-art.sh script is executed, the first it does is -execute the `trunk/Scripts/Bash/initFunctions.sh' file to -initialize gettext variables and all function scripts inside -`trunk/Scripts/Bash/Functions' directory. +

When `centos-art.sh' script is executed, the first it does is +executing the `trunk/Scripts/Bash/initFunctions.sh' script to +initialize global variables (e.g., gettext's variables) and +global function scripts. Global function scripts are located inside +`trunk/Scripts/Bash/Functions' directory and their file names +begin with `cli'. Global function scripts provide common +functionalities that can be used anywhere inside `centos-art.sh' +script execution environment.

-

Once gettext variables and all function scripts have been -initialized, the centos-art.sh script initializes its -environment variables using the cli_getVariables function. -At this point the centos-art.sh script calls the -cli_getActions function from cli_getVariables -function's bottom. +

Once global variables and function scripts have been loaded, +`centos-art.sh' script executes the cli global function +from `cli.sh' function script to retrive command-line arguments +and define some default values that may be used later by specific +function scripts (see section trunk/Scripts/Bash/Functions).

-

The cli_getActions function defines which actions the -centos-art.sh script is able to perform. Inside -cli_getActions function, actions are defined combining -positional arguments and function calls. +

As convenction, the `centos-art.sh' command-line arguments have +the following format: +

+
centos-art arg1 --arg2=val2 --arg3=val3
+
+

In the above example, `centos-art' is the command you use to +invoke `centos-art.sh' script. The `arg1' represents the +action you want to do (e.g., `verify', `render', +`locale', `help', etc.). The remaining arguments are +modifiers to `arg1'. The `--arg2' definition is +required. The `--arg3' is optional. For example, if you want +to render all anaconda progress slides, for all major releases of +CentOS distribution, for all languages availabe using TreeFlower motif +as background, you use the following command: +

+
centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress
+
+

Now, if you only want to render anaconda progress +`01-welcome.png' slide, for CentOS distribution major release 5, +in English language, you need to add the third argument as follows: +

+
centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress --filter=5/en/01-welcome
+
+

Once command-line arguments have been retrived, the +`centos-art.sh' script loads specific functions using the +`cli_getActions.sh' function script. For example, if you run the +command centos-art render --entry, the `centos-art.sh' +script will look for `trunk/Scripts/Bash/Functions/Render' +directory and will load the `render.sh' function script from it; +this, in order to achive the rendering task as it defines. 

+------------------------------------------------------------------+
@@ -133,7 +162,7 @@ positional arguments and function calls.
     +---v---------------------------------v---+
     .   | initFunctions.sh                |   .
     .   +---------------------------------+   .
-    .   | cli_getVariables $@             |   .
+    .   | cli $@                          |   .
     .   +---v-------------------------v---+   .
     .   .   | cli_getActions          |   .   .
     .   .   +---v-----------------v---+   .   .
@@ -145,106 +174,35 @@ positional arguments and function calls.
     .   ...................................   .
     ...........................................
-

Figure 3.5: The centos-art.sh initialization environment. +

Figure 3.5: The `centos-art.sh' initialization environment.

-

3.34.2.1 The identity matching list

- -

The identity matching list is used by identity rendering functions to -define the relation between translation files and identity design -templates. -

- - -

3.34.2.2 Adding new features

- -

To add new features inside centos-art.sh script, you need to -set positional arguments and function calls inside -cli_getActions function for the new function or functions -required by the new feature you want to add. -

- -

3.34.3 Usage

- - -

3.34.3.1 The centos-art `search' action

- -

This feature is not supported yet. +

The `centos-art.sh' script usage information is described inside +each specific function documentation (see section trunk/Scripts/Bash/Functions).

-
-
`centos-art search 'pattern''
-
-

Use this command to find directories and files that match exactly the -posix-regular expression set in `pattern' as in `^pattern$'. -

-
-
`centos-art search 'pattern1 pattern2 patternN''
-
-

Use this command to search repository entries that match pattern1 -or patter2 or patternN as in -`'^.*(pattern1|pattern2|patternN).*$''. -

-
-
`centos-art search 'path/to/dir1 path/to/dir2 path/to/dirN''
-
-

Use this command to search repository entries that match -`path/to/dir1' or `path/to/dir2', or -`path/to/dirN' as in -`^.*(path/to/dir1|path/to/dir2|path/to/dirN).*$''. -

-
- - - -

3.34.3.2 The centos-art `locale-art' action

- -

This feature is not supported yet. -

-
-
`centos-art locale-art 'path/to/dir' --edit'
-
`centos-art locale-art 'path/to/dir' --edit='filename''
-
`centos-art locale-art 'path/to/dir' --list'
-
`centos-art locale-art 'path/to/dir' --list='filename''
-
- - - -

3.34.3.3 The centos-art `license' action

-

This feature is supported through the following command: -

-
-
`centos-art license'
-

Use this command to see a brief description of centos-art -command its copyright and its license notes. -

-
- - - +

3.34.4 See also

- - +
3.35 trunk/Scripts/Bash/Functions   -
3.45 trunk/Scripts/Bash/Locale   -
3.33 trunk/Scripts  
3.45 trunk/Scripts/Bash/Locale   +
- - + + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_38.html b/Manuals/en/Html/Repository/repository_38.html index dfa04e5..482f739 100644 --- a/Manuals/en/Html/Repository/repository_38.html +++ b/Manuals/en/Html/Repository/repository_38.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.35 trunk/Scripts/Bash/Functions

- +

3.35.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.35.2 Description

    @@ -92,48 +92,50 @@ ul.toc {list-style: none}
- +

3.35.3 Usage

Usage of available functionalities is described in the following menu:

- - - - - - - - -
3.36 trunk/Scripts/Bash/Functions/Help   +
3.36 trunk/Scripts/Bash/Functions/Help  
3.37 trunk/Scripts/Bash/Functions/Html   +
3.37 trunk/Scripts/Bash/Functions/Html  
3.38 trunk/Scripts/Bash/Functions/Locale   +
3.38 trunk/Scripts/Bash/Functions/Locale  
3.39 trunk/Scripts/Bash/Functions/Path   +
3.39 trunk/Scripts/Bash/Functions/Path  
3.40 trunk/Scripts/Bash/Functions/Render   +
3.40 trunk/Scripts/Bash/Functions/Render  
3.41 trunk/Scripts/Bash/Functions/Render/Config   +
3.41 trunk/Scripts/Bash/Functions/Render/Config  
3.42 trunk/Scripts/Bash/Functions/Shell   +
3.42 trunk/Scripts/Bash/Functions/Shell  
3.43 trunk/Scripts/Bash/Functions/Svg   +
3.43 trunk/Scripts/Bash/Functions/Svg  
3.44 trunk/Scripts/Bash/Functions/Verify   +
3.44 trunk/Scripts/Bash/Functions/Verify  
- +

3.35.4 See also

+
3.34 trunk/Scripts/Bash  
3.45 trunk/Scripts/Bash/Locale   +
- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_39.html b/Manuals/en/Html/Repository/repository_39.html index 7e57834..4769703 100644 --- a/Manuals/en/Html/Repository/repository_39.html +++ b/Manuals/en/Html/Repository/repository_39.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.36 trunk/Scripts/Bash/Functions/Help

- +

3.36.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.36.2 Description

    @@ -92,7 +92,7 @@ ul.toc {list-style: none}
- +

3.36.3 Usage

    @@ -100,18 +100,18 @@ ul.toc {list-style: none}
- +

3.36.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_4.html b/Manuals/en/Html/Repository/repository_4.html index 74a4531..1bfeec4 100644 --- a/Manuals/en/Html/Repository/repository_4.html +++ b/Manuals/en/Html/Repository/repository_4.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -506,7 +506,7 @@ script.

3.1.6 See also

-
3.48 trunk/Translations   +
3.48 trunk/Translations  
@@ -527,7 +527,7 @@ links).   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_40.html b/Manuals/en/Html/Repository/repository_40.html index 777a505..7bfe706 100644 --- a/Manuals/en/Html/Repository/repository_40.html +++ b/Manuals/en/Html/Repository/repository_40.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.37 trunk/Scripts/Bash/Functions/Html

- +

3.37.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.37.2 Description

    @@ -92,7 +92,7 @@ ul.toc {list-style: none}
- +

3.37.3 Usage

    @@ -100,18 +100,18 @@ ul.toc {list-style: none}
- +

3.37.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_41.html b/Manuals/en/Html/Repository/repository_41.html index c9d3b6e..a2fc3cb 100644 --- a/Manuals/en/Html/Repository/repository_41.html +++ b/Manuals/en/Html/Repository/repository_41.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.38 trunk/Scripts/Bash/Functions/Locale

- +

3.38.1 Goals

    @@ -84,34 +84,99 @@ ul.toc {list-style: none}
- +

3.38.2 Description

+

This command looks for `.sh' files inside Bash directory and +extracts translatable strings from files, using xgettext +command, in order to create a portable object template +(`centos-art.sh.pot') file for them. +

+

With the `centos-art.sh.pot' file up to date, the +centos-art command removes the temporal list of files sotred +inside `/tmp' directory and checks the current language of your +user's session to create a portable object file for it, in the +location `$CLI_LANG/$CLI_LANG.po'. +

+

The CLI_LANG variable discribes the locale language used to +output messages inside centos-art command. The locale +language used inside centos-art command is taken from the +LANG environment variable. The CLI_LANG variable has the +`LL_CC' format, where `LL' is a language code from the +ISO-639 standard, and `CC' a country code from the ISO-3166 +standard. +

+

The LANG environment variable is set when you do log in to your +system. If you are using a graphical session, change language to your +native language and do login. That would set and exoprt the LANG +environment variable to the correct value. On the other side, if you +are using a text session edit your `~/.bash_profile' file to set +and export the LANG environment variable to your native locale +as defines the locale -a command output; do logout, and do +login again. +

+

At this point, the LANG environment variable has the appropriate +value you need, in order to translate centos-art.sh messages +to your native language (the one set in LANG environment +variable). +

+

With the `$CLI_LANG/$CLI_LANG.po' file up to date, the +centos-art opens it for you to update translation strings. +The centos-art command uses the value of EDITOR +environment variable to determine your favorite text editor. If no +value is defined on EDITOR, the `/usr/bin/vim' text editor +is used as default. +

+

When you finish PO file's edition and quit text editor, the +centos-art command creates the related machine object in the +location `$CLI_LANG/LC_MESSAGES/$TEXTDOMAIN.mo'. +

+

At this point, all translations you made in the PO file should be +available to your language when runing centos-art.sh script. +

+

In order to make the centos-art.sh internationalization, the +centos-art.sh script was modified as described in the +gettext info documentation (info gettext). You +can find such modifications in the following files: +

+
    +
  • `trunk/Scripts/Bash/initFunctions.sh' +
  • `trunk/Scripts/Bash/Functions/Help/cli_localeMessages.sh' +
  • `trunk/Scripts/Bash/Functions/Help/cli_localeMessagesStatus.sh' +
+
  • ...
- +

3.38.3 Usage

-
    -
  • ... -
+
+
`centos-art locale --edit'
+

Use this command to translate command-line interface output messages +in the current system locale you are using (as specified in LANG +environment variable). +

+
`centos-art locale --list'
+

Use this command to see the command-line interface locale report. +

+
- +

3.38.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_42.html b/Manuals/en/Html/Repository/repository_42.html index 7218340..55b02b2 100644 --- a/Manuals/en/Html/Repository/repository_42.html +++ b/Manuals/en/Html/Repository/repository_42.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.39 trunk/Scripts/Bash/Functions/Path

- +

3.39.1 Goals

This section exists to organize files related to centos-art.sh path @@ -85,7 +85,7 @@ file movements inside CentOS Artwork Repository. This helps to keep repository file system syncronized with documentation file system.

- +

3.39.2 Description

    @@ -93,7 +93,7 @@ repository file system syncronized with documentation file system.
- +

3.39.3 Usage

This feature is not supported yet. @@ -107,18 +107,18 @@ repository file system syncronized with documentation file system. - +

3.39.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_43.html b/Manuals/en/Html/Repository/repository_43.html index 3dadb6c..6da7b41 100644 --- a/Manuals/en/Html/Repository/repository_43.html +++ b/Manuals/en/Html/Repository/repository_43.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.40 trunk/Scripts/Bash/Functions/Render

- +

3.40.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.40.2 Description

    @@ -92,7 +92,7 @@ ul.toc {list-style: none}
- +

3.40.3 Usage

    @@ -100,22 +100,22 @@ ul.toc {list-style: none}
- +

3.40.4 See also

-
3.41 trunk/Scripts/Bash/Functions/Render/Config   +
3.41 trunk/Scripts/Bash/Functions/Render/Config  
- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_44.html b/Manuals/en/Html/Repository/repository_44.html index 9e7cb72..7881c31 100644 --- a/Manuals/en/Html/Repository/repository_44.html +++ b/Manuals/en/Html/Repository/repository_44.html @@ -56,34 +56,34 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.41 trunk/Scripts/Bash/Functions/Render/Config

- +

3.41.1 Goals

The `trunk/Scripts/Bash/Config' directory exists to oraganize pre-rendering configuration scripts.

- +

3.41.2 Description

Pre-rendering configuration scripts let you customize the way @@ -99,7 +99,7 @@ configuration entries are required for each identity entry, but not for translation entries.

- +

3.41.2.1 The `render.conf.sh' identity model

Inside CentOS Artwork Repository, we consider identity entries to all @@ -141,7 +141,7 @@ scripts using image-based and text-based post-rendering actions, respectively.

- +

3.41.2.2 The `render.conf.sh' translation model

Translation pre-rendering configuration scripts take precedence before @@ -150,7 +150,7 @@ actions are useful when default translation rendering action do not fit itself to translation entry rendering requirements.

- +

3.41.2.3 The `render.conf.sh' rendering actions

Inside both image-based and text-based identity pre-rendering @@ -210,7 +210,7 @@ file in the list of files to process has been rendered. The `LAST' action is optional. Possible values for `LAST' actions may be `groupByFormat', `renderGdmTgz', etc.

-
info

Note

See section trunk/Scripts/Bash/Functions/Render, to know more +

info

Note

See section trunk/Scripts/Bash/Functions/Render, to know more about possible values for `BASE', `POST' and `LAST' action definitions.

@@ -225,7 +225,7 @@ ACTIONS[1]='POST:renderFormats: xpm jpg tif' ACTIONS[2]='LAST:groupByformat: png xpm jpg tif' - +

3.41.3 Usage

Use the following commands to administer both identity and translation @@ -263,7 +263,7 @@ directory path under `trunk/Identity' or `trunk/Translations' structures only.

- +

3.41.4 See also

@@ -273,12 +273,12 @@ directory path under `trunk/Identity' or
- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_45.html b/Manuals/en/Html/Repository/repository_45.html index ccf32e0..76bc8dc 100644 --- a/Manuals/en/Html/Repository/repository_45.html +++ b/Manuals/en/Html/Repository/repository_45.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.42 trunk/Scripts/Bash/Functions/Shell

- +

3.42.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.42.2 Description

    @@ -92,7 +92,7 @@ ul.toc {list-style: none}
- +

3.42.3 Usage

    @@ -100,18 +100,18 @@ ul.toc {list-style: none}
- +

3.42.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_46.html b/Manuals/en/Html/Repository/repository_46.html index 087444f..eabd164 100644 --- a/Manuals/en/Html/Repository/repository_46.html +++ b/Manuals/en/Html/Repository/repository_46.html @@ -56,34 +56,34 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.43 trunk/Scripts/Bash/Functions/Svg

- +

3.43.1 Goals

This section exists to organize the "svg" functionality of centos-art.sh script.

- +

3.43.2 Description

The "svg" functionality of centos-art.sh script helps you to @@ -106,7 +106,7 @@ markers are used by "svg" functionalities to introduce dynamic information (e.g., dates, keywords based on path, etc.)

- +

3.43.3 Usage

@@ -123,18 +123,18 @@ file.
- +

3.43.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_47.html b/Manuals/en/Html/Repository/repository_47.html index 1ca6bce..950f69a 100644 --- a/Manuals/en/Html/Repository/repository_47.html +++ b/Manuals/en/Html/Repository/repository_47.html @@ -56,57 +56,57 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.44 trunk/Scripts/Bash/Functions/Verify

- +

3.44.1 Goals

This section exists to organize files related to `centos-art.sh' -script "verify" functionality. The "verify" functionality of -`centos-art.sh' script helps you to verify the workstation -configuration you are planning to use as host for your working copy of -CentOS Artwork Repository. +script `verify' functionality. The `verify' +functionality of `centos-art.sh' script helps you to verify the +workstation configuration you are planning to use as host for your +working copy of CentOS Artwork Repository.

- +

3.44.2 Description

The first time you download CentOS Artwork Repository you need to configure your workstation in order to use `centos-art.sh' script. These preliminar configurations are based mainly on auxiliar RPM packages installation, symbolic links creations, and environment -variables definitions. The "verify" functionality of +variables definitions. The `verify' functionality of `centos-art.sh' script guides you through this preliminar configuration process.

If this is the first time you run centos-art command, the -appropriate way to use its "verify" functionality is not using the -centos-art command directly, but the absolute path to +appropriate way to use its `verify' functionality is not using +the centos-art command directly, but the absolute path to centos-art.sh script instead (i.e., `~/artwork/trunk/Scripts/Bash/centos-art.sh'). This is necessary because centos-art symbolic link, under `~/bin/' directory, has not been created yet.

- +

3.44.2.1 Packages

Installation of auxiliar RPM packages provides the software required @@ -131,7 +131,7 @@ installation functionality. If your user isn't defined as a privileged user--at least to run yum commands-- inside `/etc/sudoers' configuration file, you will not be able to perform package installation tasks as set in `centos-art.sh' -script "verify" functionality. +script `verify' functionality.

Setting sudo privileges to users is an administrative task you have to do by yourself. If you don't have experience with sudo @@ -141,7 +141,7 @@ will be able to configure your users to have sudo privileges.

- +

3.44.2.2 Links

Creation of symbolic links helps us to alternate between different @@ -176,17 +176,17 @@ structure. As consequence of this configuration, automation scripts cannot be branched under `branches/Scripts' directory structure.

- +

3.44.2.3 Environment variables

Definition of environemnt variables helps us to set default values to our user session life. The user session environment variable defintion -takes place in the user's `~/.bash_profile' file. The "verify" -functionality of `centos-art.sh' script doesn't modify your -`~/.bash_profile' file. +takes place in the user's `~/.bash_profile' file. The +`verify' functionality of `centos-art.sh' script doesn't +modify your `~/.bash_profile' file.

-

The "verify" functionality of `centos-art.sh' script evaluates -the following environment variables: +

The `verify' functionality of `centos-art.sh' script +evaluates the following environment variables:

EDITOR
@@ -248,12 +248,12 @@ set in `initFunctions.sh' and shouldn't be changed.

Default locale information. This value is set when you start your session and can be changed using the "locale" functionality of -`centos-art.sh' script (see section trunk/Scripts/Bash/Functions/Locale, for more information). +`centos-art.sh' script (see section trunk/Scripts/Bash/Functions/Locale, for more information).

- +

3.44.3 Usage

@@ -306,24 +306,24 @@ provided at all.
- +

3.44.4 See also

-
3.34 trunk/Scripts/Bash  
3.35 trunk/Scripts/Bash/Functions   +
3.35 trunk/Scripts/Bash/Functions  
- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_48.html b/Manuals/en/Html/Repository/repository_48.html index df327d1..dca1cea 100644 --- a/Manuals/en/Html/Repository/repository_48.html +++ b/Manuals/en/Html/Repository/repository_48.html @@ -56,124 +56,56 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.45 trunk/Scripts/Bash/Locale

- +

3.45.1 Goals

-
    -
  • Organize `centos-art.sh' locale files. -
- - - -

3.45.2 Description

- -

This command looks for `.sh' files inside Bash directory and -extracts translatable strings from files, using xgettext -command, in order to create a portable object template -(`centos-art.sh.pot') file for them. -

-

With the `centos-art.sh.pot' file up to date, the -centos-art command removes the temporal list of files sotred -inside `/tmp' directory and checks the current language of your -user's session to create a portable object file for it, in the -location `$CLI_LANG/$CLI_LANG.po'. -

-

The CLI_LANG variable discribes the locale language used to -output messages inside centos-art command. The locale -language used inside centos-art command is taken from the -LANG environment variable. The CLI_LANG variable has the -`LL_CC' format, where `LL' is a language code from the -ISO-639 standard, and `CC' a country code from the ISO-3166 -standard. -

-

The LANG environment variable is set when you do log in to your -system. If you are using a graphical session, change language to your -native language and do login. That would set and exoprt the LANG -environment variable to the correct value. On the other side, if you -are using a text session edit your `~/.bash_profile' file to set -and export the LANG environment variable to your native locale -as defines the locale -a command output; do logout, and do -login again. -

-

At this point, the LANG environment variable has the appropriate -value you need, in order to translate centos-art.sh messages -to your native language (the one set in LANG environment -variable). -

-

With the `$CLI_LANG/$CLI_LANG.po' file up to date, the -centos-art opens it for you to update translation strings. -The centos-art command uses the value of EDITOR -environment variable to determine your favorite text editor. If no -value is defined on EDITOR, the `/usr/bin/vim' text editor -is used as default. -

-

When you finish PO file's edition and quit text editor, the -centos-art command creates the related machine object in the -location `$CLI_LANG/LC_MESSAGES/$TEXTDOMAIN.mo'. -

-

At this point, all translations you made in the PO file should be -available to your language when runing centos-art.sh script. +

This section exists to organize translation messages and templates +used by `centos-art.sh' script.

- -

3.45.2.1 Configuration files

+ +

3.45.2 Description

-

In order to make the centos-art.sh internationalization, the -centos-art.sh script was modified as described in the -gettext info documentation (info gettext). You -can find such modifications in the following files: +

Translated messages of `centos-art.sh' script are managed using +GNU gettext utilities. Most translation actions have been +automated through `centos-art.sh' script "locale" functionality +(see section trunk/Scripts/Bash/Functions/Locale).

-
    -
  • `trunk/Scripts/Bash/initFunctions.sh' -
  • `trunk/Scripts/Bash/Functions/Help/cli_localeMessages.sh' -
  • `trunk/Scripts/Bash/Functions/Help/cli_localeMessagesStatus.sh' -
- - +

3.45.3 Usage

+

The content of `trunk/Scripts/Bash/Locale' directory should not +be managed manually. Instead, use the "locale" functionality of +`centos-art.sh' script. See section trunk/Scripts/Bash/Functions/Locale, for more information on how to use `centos-art.sh' +"locale" functionality. +

- -

3.45.3.1 The centos-art `locale-cli' action

- -
-
`centos-art locale-cli --edit'
-

Use this command to translate command-line interface output messages -in the current system locale you are using (as specified in LANG -environment variable). -

-
`centos-art locale-cli --list'
-

Use this command to see the command-line interface locale report. -

-
- - - +

3.45.4 See also

- @@ -181,12 +113,12 @@ environment variable).
3.35 trunk/Scripts/Bash/Functions   +
3.35 trunk/Scripts/Bash/Functions  
3.33 trunk/Scripts  
- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_49.html b/Manuals/en/Html/Repository/repository_49.html index 9f61cdf..7ea5ed3 100644 --- a/Manuals/en/Html/Repository/repository_49.html +++ b/Manuals/en/Html/Repository/repository_49.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.46 trunk/Scripts/Perl

- +

3.46.1 Goals

    @@ -84,26 +84,26 @@ ul.toc {list-style: none}
- +

3.46.2 Description

- +

3.46.3 Usage

- +

3.46.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_5.html b/Manuals/en/Html/Repository/repository_5.html index e0c4e84..22b2d35 100644 --- a/Manuals/en/Html/Repository/repository_5.html +++ b/Manuals/en/Html/Repository/repository_5.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -103,7 +103,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_50.html b/Manuals/en/Html/Repository/repository_50.html index 0ef49be..385615d 100644 --- a/Manuals/en/Html/Repository/repository_50.html +++ b/Manuals/en/Html/Repository/repository_50.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.47 trunk/Scripts/Python

- +

3.47.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.47.2 Description

    @@ -92,7 +92,7 @@ ul.toc {list-style: none}
- +

3.47.3 Usage

    @@ -100,18 +100,18 @@ ul.toc {list-style: none}
- +

3.47.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_51.html b/Manuals/en/Html/Repository/repository_51.html index 4704d5a..7827603 100644 --- a/Manuals/en/Html/Repository/repository_51.html +++ b/Manuals/en/Html/Repository/repository_51.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.48 trunk/Translations

- +

3.48.1 Goals

The `trunk/Translations' directory exists to: @@ -87,7 +87,7 @@ ul.toc {list-style: none} - +

3.48.2 Description

When you create artwork for CentOS distribution you find that some @@ -127,7 +127,7 @@ entries" to organize artworks' "translation files" and artworks' "translation templates".

- +

3.48.2.1 Translation Entries

Translation entries exists for each artwork you want to produce. @@ -208,7 +208,7 @@ artworks look and feel (the identity entries), and translators in artworks translations (the translation entries).

- +

3.48.2.2 Translation Markers

@@ -256,7 +256,7 @@ markers well defined makes possible that translators and graphic designers can work together but independently one another.

- +

3.48.2.3 Translation Files

Translation files are text files with sed's commands inside, @@ -324,7 +324,7 @@ command with the release number you want to produce translation files for in the `--filter='release-number'' argument.

- +

3.48.2.4 Template Translation Files

Template translation files are translation files stored inside @@ -493,7 +493,7 @@ the REPLACEMENT of `=TITLE=' translation marker replacement command.

- +

3.48.2.5 Common Translation Files

Common translation files contain common translations or no @@ -518,7 +518,7 @@ the following: `-- firstboot-left.sed <-- common translation file. - +

3.48.2.6 Specific Translation Files

Specific translation files contain specific translations for their @@ -542,7 +542,7 @@ script. `-- firstboot-left.sed - +

3.48.2.7 Translation Rendering

When rendering translations, the centos-art script checks @@ -555,7 +555,7 @@ case the centos-art script outputs a message and quits script execution.

- +

3.48.2.8 Translation (Pre-)Rendering Configuration Scripts

When the centos-art script finds a translation template @@ -644,7 +644,7 @@ above translation pre-rendering configuration directory, is `render.conf.sh'.

- +

3.48.2.9 Translation Rendering Default Functionality

In the other hand, if the translation pre-rendering configuration file @@ -673,7 +673,7 @@ translation marker section - +

3.48.3 Usage

@@ -698,19 +698,19 @@ distribution you want to render translations for.
- +

3.48.4 See also

- - - - - @@ -718,12 +718,12 @@ distribution you want to render translations for.
3.50 trunk/Translations/Identity/Brands   +
3.50 trunk/Translations/Identity/Brands  
3.52 trunk/Translations/Identity/Fonts   +
3.52 trunk/Translations/Identity/Fonts  
3.53 trunk/Translations/Identity/Models   +
3.53 trunk/Translations/Identity/Models  
3.54 trunk/Translations/Identity/Release   +
3.54 trunk/Translations/Identity/Release  
3.55 trunk/Translations/Identity/Themes   +
3.55 trunk/Translations/Identity/Themes  
3.1 trunk/Identity  
- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_52.html b/Manuals/en/Html/Repository/repository_52.html index f338dab..3d0ca1d 100644 --- a/Manuals/en/Html/Repository/repository_52.html +++ b/Manuals/en/Html/Repository/repository_52.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.49 trunk/Translations/Identity

- +

3.49.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.49.2 Description

    @@ -92,7 +92,7 @@ ul.toc {list-style: none}
- +

3.49.3 Usage

    @@ -100,21 +100,21 @@ ul.toc {list-style: none}
- +

3.49.4 See also

- - - - - - @@ -122,12 +122,12 @@ ul.toc {list-style: none}
3.50 trunk/Translations/Identity/Brands   +
3.50 trunk/Translations/Identity/Brands  
3.52 trunk/Translations/Identity/Fonts   +
3.52 trunk/Translations/Identity/Fonts  
3.53 trunk/Translations/Identity/Models   +
3.53 trunk/Translations/Identity/Models  
3.54 trunk/Translations/Identity/Release   +
3.54 trunk/Translations/Identity/Release  
3.55 trunk/Translations/Identity/Themes   +
3.55 trunk/Translations/Identity/Themes  
3.58 trunk/Translations/Identity/Widgets   +
3.58 trunk/Translations/Identity/Widgets  
3.1 trunk/Identity  
- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_53.html b/Manuals/en/Html/Repository/repository_53.html index d6c078a..aa66c77 100644 --- a/Manuals/en/Html/Repository/repository_53.html +++ b/Manuals/en/Html/Repository/repository_53.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.50 trunk/Translations/Identity/Brands

- +

3.50.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.50.2 Description

Translation files, inside `trunk/Translations/Identity/Brands' @@ -118,7 +118,7 @@ translation files. (`Tpl') directory have special meaning:

- +

3.50.2.1 Conventional file names

Convenctional file names look like `blue.sed', `2c-a.sed', @@ -128,7 +128,7 @@ name. The image dimensions use the same dimensions that design template has.

- +

3.50.2.2 Numeric file names

Numeric file names look like `300.sed', `200.sed', etc. @@ -152,7 +152,7 @@ shorter PNG images using numeric translation files as described above.

- +

3.50.2.3 Translation markers

Inside `trunk/Translations/Identity/Brands/', translation files @@ -172,7 +172,7 @@ inside template translation files. - +

3.50.3 Usage

To render brands' translation files, use the following command: @@ -180,11 +180,11 @@ inside template translation files. 

centos-art render --translation=/home/centos/artwork/trunk/Translations/Identity/Brands
- +

3.50.4 See also

- @@ -192,12 +192,12 @@ inside template translation files.
3.51 trunk/Translations/Identity/Brands/Tpl   +
3.51 trunk/Translations/Identity/Brands/Tpl  
3.2 trunk/Identity/Brands  
- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_54.html b/Manuals/en/Html/Repository/repository_54.html index 148e742..6fd584c 100644 --- a/Manuals/en/Html/Repository/repository_54.html +++ b/Manuals/en/Html/Repository/repository_54.html @@ -56,50 +56,50 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.51 trunk/Translations/Identity/Brands/Tpl

- +

3.51.1 Goals

- +

3.51.2 Description

- +

3.51.3 Usage

- +

3.51.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_55.html b/Manuals/en/Html/Repository/repository_55.html index b7f3d30..16b874e 100644 --- a/Manuals/en/Html/Repository/repository_55.html +++ b/Manuals/en/Html/Repository/repository_55.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.52 trunk/Translations/Identity/Fonts

- +

3.52.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.52.2 Description

Translation files, inside `trunk/Translations/Fonts', have the @@ -111,7 +111,7 @@ visual identity.

- +

3.52.2.1 Translation Markers

Inside `trunk/Translations/Identity/Fonts', translation files @@ -130,7 +130,7 @@ combine the following translation markers: - +

3.52.3 Usage

Inside `trunk/Translations/Fonts' you use your favorite text @@ -144,7 +144,7 @@ directory (`Tpl/'), nor translation rendering using 

vim /home/centos/artwork/trunk/Translations/Fonts/dejavu_lgc_sans-boldoblique.sed
- +

3.52.4 See also

@@ -155,12 +155,12 @@ directory (`Tpl/'), nor translation rendering using
- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_56.html b/Manuals/en/Html/Repository/repository_56.html index 7f06047..b9e8155 100644 --- a/Manuals/en/Html/Repository/repository_56.html +++ b/Manuals/en/Html/Repository/repository_56.html @@ -56,50 +56,50 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.53 trunk/Translations/Identity/Models

- +

3.53.1 Goals

- +

3.53.2 Description

- +

3.53.3 Usage

- +

3.53.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_57.html b/Manuals/en/Html/Repository/repository_57.html index cfb2afd..9598470 100644 --- a/Manuals/en/Html/Repository/repository_57.html +++ b/Manuals/en/Html/Repository/repository_57.html @@ -56,50 +56,50 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.54 trunk/Translations/Identity/Release

- +

3.54.1 Goals

- +

3.54.2 Description

- +

3.54.3 Usage

- +

3.54.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_58.html b/Manuals/en/Html/Repository/repository_58.html index 0975e21..6075f35 100644 --- a/Manuals/en/Html/Repository/repository_58.html +++ b/Manuals/en/Html/Repository/repository_58.html @@ -56,50 +56,50 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.55 trunk/Translations/Identity/Themes

- +

3.55.1 Goals

- +

3.55.2 Description

- +

3.55.3 Usage

- +

3.55.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_59.html b/Manuals/en/Html/Repository/repository_59.html index 0b1cdd7..a4b6daf 100644 --- a/Manuals/en/Html/Repository/repository_59.html +++ b/Manuals/en/Html/Repository/repository_59.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.56 trunk/Translations/Identity/Themes/Backgrounds

- +

3.56.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.56.2 Description

    @@ -92,7 +92,7 @@ ul.toc {list-style: none}
- +

3.56.3 Usage

    @@ -100,18 +100,18 @@ ul.toc {list-style: none}
- +

3.56.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_6.html b/Manuals/en/Html/Repository/repository_6.html index fac8b5b..551d4a4 100644 --- a/Manuals/en/Html/Repository/repository_6.html +++ b/Manuals/en/Html/Repository/repository_6.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -169,7 +169,7 @@ improve this section with your reasons.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_60.html b/Manuals/en/Html/Repository/repository_60.html index 6cbe597..e8b4e45 100644 --- a/Manuals/en/Html/Repository/repository_60.html +++ b/Manuals/en/Html/Repository/repository_60.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.57 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress

- +

3.57.1 Goals

    @@ -86,7 +86,7 @@ languages and major releases of CentOS distribution.
- +

3.57.2 Description

Use the following command to produce translation files based: @@ -161,25 +161,25 @@ a sum of 18 images around. - +

3.57.3 Usage

Translation rendering is described in `trunk/Translations' -documentation entry (see section trunk/Translations). +documentation entry (see section trunk/Translations).

- +

3.57.4 See also

- - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_61.html b/Manuals/en/Html/Repository/repository_61.html index cc33ea3..cf95d84 100644 --- a/Manuals/en/Html/Repository/repository_61.html +++ b/Manuals/en/Html/Repository/repository_61.html @@ -56,27 +56,27 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

3.58 trunk/Translations/Identity/Widgets

- +

3.58.1 Goals

    @@ -84,7 +84,7 @@ ul.toc {list-style: none}
- +

3.58.2 Description

    @@ -92,7 +92,7 @@ ul.toc {list-style: none}
- +

3.58.3 Usage

    @@ -100,11 +100,11 @@ ul.toc {list-style: none}
- +

3.58.4 See also

-
3.58 trunk/Translations/Identity/Widgets   +
3.58 trunk/Translations/Identity/Widgets  
@@ -113,12 +113,12 @@ ul.toc {list-style: none} - - + + - - + +
[ < ][ > ]
[ < ][ > ]   [ << ][ Up ][ >> ][ Up ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_62.html b/Manuals/en/Html/Repository/repository_62.html index 76c0493..36509da 100644 --- a/Manuals/en/Html/Repository/repository_62.html +++ b/Manuals/en/Html/Repository/repository_62.html @@ -56,65 +56,65 @@ ul.toc {list-style: none} - - + + - + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
- +

Index

- - +
Jump to:   B +
Jump to:   B   -C +C   -H +H   -S +S   -T +T  
- + - - + + - - - - + + + + - - + + - + - - - - - - - - - - - + + + + + + + + + + + @@ -150,52 +150,52 @@ ul.toc {list-style: none} - - - - - - - - - - - - - - - - - - - - - - - - + + + + + + + + + + + + + + + + + + + + + + + +
Index Entry Section
B
B
branches1. branches
C
Common translation files3.48.2.5 Common Translation Files
C
Common translation files3.48.2.5 Common Translation Files
H
How to render brands' translation files3.50.3 Usage
How to render fonts' translation files3.52.3 Usage
How to render translation files3.48.3 Usage
H
How to render brands' translation files3.50.3 Usage
How to render fonts' translation files3.52.3 Usage
How to render translation files3.48.3 Usage
S
Specific translation files3.48.2.6 Specific Translation Files
S
Specific translation files3.48.2.6 Specific Translation Files
T
T
tags2. tags
Template translation files3.48.2.4 Template Translation Files
Translation brands file names3.50.2.1 Conventional file names
Translation brands file names3.50.2.2 Numeric file names
Translation configuration scripts3.48.2.8 Translation (Pre-)Rendering Configuration Scripts
Translation entries3.48.2.1 Translation Entries
Translation files3.48.2.3 Translation Files
Translation markers3.48.2.2 Translation Markers
Translation paths3.48.2.1 Translation Entries
Translation pre-rendering configuration scripts3.48.2.8 Translation (Pre-)Rendering Configuration Scripts
Translation rendering3.48.2.7 Translation Rendering
Translation rendering default functionality3.48.2.9 Translation Rendering Default Functionality
Template translation files3.48.2.4 Template Translation Files
Translation brands file names3.50.2.1 Conventional file names
Translation brands file names3.50.2.2 Numeric file names
Translation configuration scripts3.48.2.8 Translation (Pre-)Rendering Configuration Scripts
Translation entries3.48.2.1 Translation Entries
Translation files3.48.2.3 Translation Files
Translation markers3.48.2.2 Translation Markers
Translation paths3.48.2.1 Translation Entries
Translation pre-rendering configuration scripts3.48.2.8 Translation (Pre-)Rendering Configuration Scripts
Translation rendering3.48.2.7 Translation Rendering
Translation rendering default functionality3.48.2.9 Translation Rendering Default Functionality
trunk3. trunk
trunk Identity3.1 trunk/Identity
trunk Identity Brands3.2 trunk/Identity/Brands
trunk Manuals3.32 trunk/Manuals
trunk Scripts3.33 trunk/Scripts
trunk Scripts Bash3.34 trunk/Scripts/Bash
trunk Scripts Bash Functions3.35 trunk/Scripts/Bash/Functions
trunk Scripts Bash Functions Help3.36 trunk/Scripts/Bash/Functions/Help
trunk Scripts Bash Functions Html3.37 trunk/Scripts/Bash/Functions/Html
trunk Scripts Bash Functions Locale3.38 trunk/Scripts/Bash/Functions/Locale
trunk Scripts Bash Functions Path3.39 trunk/Scripts/Bash/Functions/Path
trunk Scripts Bash Functions Render3.40 trunk/Scripts/Bash/Functions/Render
trunk Scripts Bash Functions Render Config3.41 trunk/Scripts/Bash/Functions/Render/Config
trunk Scripts Bash Functions Shell3.42 trunk/Scripts/Bash/Functions/Shell
trunk Scripts Bash Functions Svg3.43 trunk/Scripts/Bash/Functions/Svg
trunk Scripts Bash Functions Verify3.44 trunk/Scripts/Bash/Functions/Verify
trunk Scripts Bash Locale3.45 trunk/Scripts/Bash/Locale
trunk Scripts Perl3.46 trunk/Scripts/Perl
trunk Scripts Python3.47 trunk/Scripts/Python
trunk Translations3.48 trunk/Translations
trunk Translations Identity3.49 trunk/Translations/Identity
trunk Translations Identity Brands3.50 trunk/Translations/Identity/Brands
trunk Translations Identity Brands Tpl3.51 trunk/Translations/Identity/Brands/Tpl
trunk Translations Identity Fonts3.52 trunk/Translations/Identity/Fonts
trunk Translations Identity Models3.53 trunk/Translations/Identity/Models
trunk Translations Identity Release3.54 trunk/Translations/Identity/Release
trunk Translations Identity Themes3.55 trunk/Translations/Identity/Themes
trunk Translations Identity Themes Backgrounds3.56 trunk/Translations/Identity/Themes/Backgrounds
trunk Translations Identity Themes Distro Anaconda Progress3.57 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
trunk Translations Identity Widgets3.58 trunk/Translations/Identity/Widgets
trunk Scripts Bash Functions3.35 trunk/Scripts/Bash/Functions
trunk Scripts Bash Functions Help3.36 trunk/Scripts/Bash/Functions/Help
trunk Scripts Bash Functions Html3.37 trunk/Scripts/Bash/Functions/Html
trunk Scripts Bash Functions Locale3.38 trunk/Scripts/Bash/Functions/Locale
trunk Scripts Bash Functions Path3.39 trunk/Scripts/Bash/Functions/Path
trunk Scripts Bash Functions Render3.40 trunk/Scripts/Bash/Functions/Render
trunk Scripts Bash Functions Render Config3.41 trunk/Scripts/Bash/Functions/Render/Config
trunk Scripts Bash Functions Shell3.42 trunk/Scripts/Bash/Functions/Shell
trunk Scripts Bash Functions Svg3.43 trunk/Scripts/Bash/Functions/Svg
trunk Scripts Bash Functions Verify3.44 trunk/Scripts/Bash/Functions/Verify
trunk Scripts Bash Locale3.45 trunk/Scripts/Bash/Locale
trunk Scripts Perl3.46 trunk/Scripts/Perl
trunk Scripts Python3.47 trunk/Scripts/Python
trunk Translations3.48 trunk/Translations
trunk Translations Identity3.49 trunk/Translations/Identity
trunk Translations Identity Brands3.50 trunk/Translations/Identity/Brands
trunk Translations Identity Brands Tpl3.51 trunk/Translations/Identity/Brands/Tpl
trunk Translations Identity Fonts3.52 trunk/Translations/Identity/Fonts
trunk Translations Identity Models3.53 trunk/Translations/Identity/Models
trunk Translations Identity Release3.54 trunk/Translations/Identity/Release
trunk Translations Identity Themes3.55 trunk/Translations/Identity/Themes
trunk Translations Identity Themes Backgrounds3.56 trunk/Translations/Identity/Themes/Backgrounds
trunk Translations Identity Themes Distro Anaconda Progress3.57 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
trunk Translations Identity Widgets3.58 trunk/Translations/Identity/Widgets
- - + - +
Jump to:   B +
Jump to:   B   -C +C   -H +H   -S +S   -T +T  
- - + + - +
[ < ][ > ]
[ < ][ > ]   [ << ] [ Up ][ >> ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_63.html b/Manuals/en/Html/Repository/repository_63.html index c63df8e..8a9d91a 100644 --- a/Manuals/en/Html/Repository/repository_63.html +++ b/Manuals/en/Html/Repository/repository_63.html @@ -56,10 +56,10 @@ ul.toc {list-style: none} - + - + @@ -68,11 +68,11 @@ ul.toc {list-style: none} - +
[ < ]
[ < ] [ > ]   [ << ][ << ] [ Up ] [ >> ]     [Top] [Contents][Index][Index] [ ? ]
- +

List of Figures

Figure 3.1

The CentOS web customization design model. @@ -83,7 +83,7 @@ ul.toc {list-style: none}

Figure 3.4

The CentOS web navigation design model.

-
Figure 3.5

The centos-art.sh initialization environment. +

Figure 3.5

The `centos-art.sh' initialization environment.

Figure 3.6

The image rendering flow.

@@ -91,10 +91,10 @@ ul.toc {list-style: none} - + - +
[ < ]
[ < ] [ > ]   [ << ][ << ] [ Up ] [ >> ]
diff --git a/Manuals/en/Html/Repository/repository_7.html b/Manuals/en/Html/Repository/repository_7.html index 8d28f63..e500733 100644 --- a/Manuals/en/Html/Repository/repository_7.html +++ b/Manuals/en/Html/Repository/repository_7.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}
  [ << ] [ Up ][ >> ][ >> ]         [Top] [Contents][Index][Index] [ ? ]
@@ -103,7 +103,7 @@ ul.toc {list-style: none} 		  [ << ] [ Up ][ >> ][ >> ]

diff --git a/Manuals/en/Html/Repository/repository_8.html b/Manuals/en/Html/Repository/repository_8.html index 8a51b36..bbbc3a3 100644 --- a/Manuals/en/Html/Repository/repository_8.html +++ b/Manuals/en/Html/Repository/repository_8.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -103,7 +103,7 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_9.html b/Manuals/en/Html/Repository/repository_9.html index 9a244aa..3994799 100644 --- a/Manuals/en/Html/Repository/repository_9.html +++ b/Manuals/en/Html/Repository/repository_9.html @@ -61,14 +61,14 @@ ul.toc {list-style: none}   [ << ] [ Up ] -[ >> ] +[ >> ]         [Top] [Contents] -[Index] +[Index] [ ? ] @@ -114,7 +114,7 @@ to build artworks.   [ << ] [ Up ] -[ >> ] +[ >> ]

diff --git a/Manuals/en/Html/Repository/repository_abt.html b/Manuals/en/Html/Repository/repository_abt.html index f4ad654..bfb8164 100644 --- a/Manuals/en/Html/Repository/repository_abt.html +++ b/Manuals/en/Html/Repository/repository_abt.html @@ -59,7 +59,7 @@ ul.toc {list-style: none} - +
[Top] [Contents][Index][Index] [ ? ]

About This Document

@@ -167,7 +167,7 @@ ul.toc {list-style: none} - +
[Top] [Contents][Index][Index] [ ? ]

diff --git a/Manuals/en/Html/Repository/repository_fot.html b/Manuals/en/Html/Repository/repository_fot.html index d866c5c..c26366b 100644 --- a/Manuals/en/Html/Repository/repository_fot.html +++ b/Manuals/en/Html/Repository/repository_fot.html @@ -59,7 +59,7 @@ ul.toc {list-style: none} - +
[Top] [Contents][Index][Index] [ ? ]

Footnotes

@@ -79,7 +79,7 @@ CentOS release schema. - +
[Top] [Contents][Index][Index] [ ? ]

diff --git a/Manuals/en/Html/Repository/repository_toc.html b/Manuals/en/Html/Repository/repository_toc.html index 4ded3d4..4a35697 100644 --- a/Manuals/en/Html/Repository/repository_toc.html +++ b/Manuals/en/Html/Repository/repository_toc.html @@ -59,7 +59,7 @@ ul.toc {list-style: none} - +
[Top] [Contents][Index][Index] [ ? ]

Table of Contents

@@ -340,233 +340,218 @@ ul.toc {list-style: none}
  • 3.34 trunk/Scripts/Bash
    • -
  • 3.35 trunk/Scripts/Bash/Functions +
  • 3.35 trunk/Scripts/Bash/Functions
    • -
  • 3.36 trunk/Scripts/Bash/Functions/Help +
  • 3.36 trunk/Scripts/Bash/Functions/Help
    • -
  • 3.37 trunk/Scripts/Bash/Functions/Html +
  • 3.37 trunk/Scripts/Bash/Functions/Html
    • -
  • 3.38 trunk/Scripts/Bash/Functions/Locale +
  • 3.38 trunk/Scripts/Bash/Functions/Locale
    • -
  • 3.39 trunk/Scripts/Bash/Functions/Path +
  • 3.39 trunk/Scripts/Bash/Functions/Path
    • -
  • 3.40 trunk/Scripts/Bash/Functions/Render +
  • 3.40 trunk/Scripts/Bash/Functions/Render
    • -
  • 3.41 trunk/Scripts/Bash/Functions/Render/Config +
  • 3.41 trunk/Scripts/Bash/Functions/Render/Config
    • -
  • 3.42 trunk/Scripts/Bash/Functions/Shell +
  • 3.42 trunk/Scripts/Bash/Functions/Shell
    • -
  • 3.43 trunk/Scripts/Bash/Functions/Svg +
  • 3.43 trunk/Scripts/Bash/Functions/Svg
    • -
  • 3.44 trunk/Scripts/Bash/Functions/Verify +
  • 3.44 trunk/Scripts/Bash/Functions/Verify
    • -
  • 3.45 trunk/Scripts/Bash/Locale +
  • 3.45 trunk/Scripts/Bash/Locale
    • -
  • 3.46 trunk/Scripts/Perl +
  • 3.46 trunk/Scripts/Perl
    • -
  • 3.47 trunk/Scripts/Python +
  • 3.47 trunk/Scripts/Python
    • -
  • 3.48 trunk/Translations +
  • 3.48 trunk/Translations
    • -
  • 3.49 trunk/Translations/Identity +
  • 3.49 trunk/Translations/Identity
    • -
  • 3.50 trunk/Translations/Identity/Brands +
  • 3.50 trunk/Translations/Identity/Brands
    • -
  • 3.51 trunk/Translations/Identity/Brands/Tpl +
  • 3.51 trunk/Translations/Identity/Brands/Tpl
    • -
  • 3.52 trunk/Translations/Identity/Fonts +
  • 3.52 trunk/Translations/Identity/Fonts
    • -
  • 3.53 trunk/Translations/Identity/Models +
  • 3.53 trunk/Translations/Identity/Models
    • -
  • 3.54 trunk/Translations/Identity/Release +
  • 3.54 trunk/Translations/Identity/Release
    • -
  • 3.55 trunk/Translations/Identity/Themes +
  • 3.55 trunk/Translations/Identity/Themes
    • -
  • 3.56 trunk/Translations/Identity/Themes/Backgrounds +
  • 3.56 trunk/Translations/Identity/Themes/Backgrounds
    • -
  • 3.57 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress +
  • 3.57 trunk/Translations/Identity/Themes/Distro/Anaconda/Progress
    • -
  • 3.58 trunk/Translations/Identity/Widgets +
  • 3.58 trunk/Translations/Identity/Widgets
    • -
  • Index
    • -
  • List of Figures
    • +
  • Index
    • +
  • List of Figures
    • - +
    [Top] [Contents][Index][Index] [ ? ]

    diff --git a/Manuals/en/Info/Repository/repository.info.bz2 b/Manuals/en/Info/Repository/repository.info.bz2 index cb0843f..d07e693 100644 Binary files a/Manuals/en/Info/Repository/repository.info.bz2 and b/Manuals/en/Info/Repository/repository.info.bz2 differ diff --git a/Manuals/en/Plaintext/Repository/repository.txt b/Manuals/en/Plaintext/Repository/repository.txt index 4d6ff15..8c7fad4 100644 --- a/Manuals/en/Plaintext/Repository/repository.txt +++ b/Manuals/en/Plaintext/Repository/repository.txt @@ -199,12 +199,7 @@ CentOS Artwork Repository 3.34 trunk/Scripts/Bash 3.34.1 Goals 3.34.2 Description - 3.34.2.1 The identity matching list - 3.34.2.2 Adding new features 3.34.3 Usage - 3.34.3.1 The `centos-art' `search' action - 3.34.3.2 The `centos-art' `locale-art' action - 3.34.3.3 The `centos-art' `license' action 3.34.4 See also 3.35 trunk/Scripts/Bash/Functions 3.35.1 Goals @@ -265,9 +260,7 @@ CentOS Artwork Repository 3.45 trunk/Scripts/Bash/Locale 3.45.1 Goals 3.45.2 Description - 3.45.2.1 Configuration files 3.45.3 Usage - 3.45.3.1 The `centos-art' `locale-cli' action 3.45.4 See also 3.46 trunk/Scripts/Perl 3.46.1 Goals @@ -2435,7 +2428,7 @@ The `trunk/Scripts' directory exists to: 3.34.1 Goals ------------ -The `trunk/Scripts/Bash' directory exists to organize the "trunk" +The `trunk/Scripts/Bash' directory exists to organize the trunk development line of `centos-art.sh' automation script. The `centos-art.sh' script standardizes frequent tasks inside your working copy of CentOS Artwork Repository. @@ -2454,27 +2447,59 @@ operating system trys to execute that command. In order to execute the command, the operating system needs to know where it is, so the operating system uses the PATH environment variable to look for that command's location. If your system was prepared to use CentOS Artwork -Repository correctly (see usage section above), you should have a -symbolic link inside `~/bin/' directory that points to the -`centos-art.sh' script file. As `~/bin/' directory is, by default, +Repository correctly (*note trunk Scripts Bash Functions Verify::), you +should have a symbolic link inside `~/bin/' directory that points to +the `centos-art.sh' script file. As `~/bin/' directory is, by default, inside PATH environment variable, the execution of `centos-art' command runs the `centos-art.sh' script. When `centos-art.sh' script is executed, the first it does is -execute the `trunk/Scripts/Bash/initFunctions.sh' file to initialize -`gettext' variables and all function scripts inside -`trunk/Scripts/Bash/Functions' directory. +executing the `trunk/Scripts/Bash/initFunctions.sh' script to +initialize global variables (e.g., `gettext''s variables) and global +function scripts. Global function scripts are located inside +`trunk/Scripts/Bash/Functions' directory and their file names begin +with `cli'. Global function scripts provide common functionalities that +can be used anywhere inside `centos-art.sh' script execution +environment. + + Once global variables and function scripts have been loaded, +`centos-art.sh' script executes the `cli' global function from `cli.sh' +function script to retrive command-line arguments and define some +default values that may be used later by specific function scripts +(*note trunk Scripts Bash Functions::). + + As convenction, the `centos-art.sh' command-line arguments have the +following format: + + +centos-art arg1 --arg2=val2 --arg3=val3 + + In the above example, `centos-art' is the command you use to invoke +`centos-art.sh' script. The `arg1' represents the action you want to do +(e.g., `verify', `render', `locale', `help', etc.). The remaining +arguments are modifiers to `arg1'. The `--arg2' definition is required. +The `--arg3' is optional. For example, if you want to render all +anaconda progress slides, for all major releases of CentOS +distribution, for all languages availabe using TreeFlower motif as +background, you use the following command: + + +centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress + + Now, if you only want to render anaconda progress `01-welcome.png' +slide, for CentOS distribution major release 5, in English language, +you need to add the third argument as follows: + - Once `gettext' variables and all function scripts have been -initialized, the `centos-art.sh' script initializes its environment -variables using the `cli_getVariables' function. At this point the -`centos-art.sh' script calls the `cli_getActions' function from -`cli_getVariables' function's bottom. +centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress --filter=5/en/01-welcome - The `cli_getActions' function defines which actions the -`centos-art.sh' script is able to perform. Inside `cli_getActions' -function, actions are defined combining positional arguments and -function calls. + Once command-line arguments have been retrived, the `centos-art.sh' +script loads specific functions using the `cli_getActions.sh' function +script. For example, if you run the command `centos-art render +--entry', the `centos-art.sh' script will look for +`trunk/Scripts/Bash/Functions/Render' directory and will load the +`render.sh' function script from it; this, in order to achive the +rendering task as it defines. +------------------------------------------------------------------+ @@ -2486,7 +2511,7 @@ function calls. +---v---------------------------------v---+ . | initFunctions.sh | . . +---------------------------------+ . - . | cli_getVariables $@ | . + . | cli $@ | . . +---v-------------------------v---+ . . . | cli_getActions | . . . . +---v-----------------v---+ . . @@ -2500,64 +2525,11 @@ function calls. Figure 3.1: The `centos-art.sh' initialization environment. -3.34.2.1 The identity matching list -................................... - -The identity matching list is used by identity rendering functions to -define the relation between translation files and identity design -templates. - -3.34.2.2 Adding new features -............................ - -To add new features inside `centos-art.sh' script, you need to set -positional arguments and function calls inside `cli_getActions' -function for the new function or functions required by the new feature -you want to add. - 3.34.3 Usage ------------ -3.34.3.1 The `centos-art' `search' action -......................................... - -This feature is not supported yet. - -`centos-art search 'pattern'' - Use this command to find directories and files that match exactly - the posix-regular expression set in `pattern' as in `^pattern$'. - -`centos-art search 'pattern1 pattern2 patternN'' - Use this command to search repository entries that match pattern1 - _or_ patter2 _or_ patternN as in - `'^.*(pattern1|pattern2|patternN).*$''. - -`centos-art search 'path/to/dir1 path/to/dir2 path/to/dirN'' - Use this command to search repository entries that match - `path/to/dir1' _or_ `path/to/dir2', _or_ `path/to/dirN' as in - `^.*(path/to/dir1|path/to/dir2|path/to/dirN).*$''. - -3.34.3.2 The `centos-art' `locale-art' action -............................................. - -This feature is not supported yet. - -`centos-art locale-art 'path/to/dir' --edit' - -`centos-art locale-art 'path/to/dir' --edit='filename'' - -`centos-art locale-art 'path/to/dir' --list' - -`centos-art locale-art 'path/to/dir' --list='filename'' - -3.34.3.3 The `centos-art' `license' action -.......................................... - -This feature is supported through the following command: - -`centos-art license' - Use this command to see a brief description of `centos-art' - command its copyright and its license notes. +The `centos-art.sh' script usage information is described inside each +specific function documentation (*note trunk Scripts Bash Functions::). 3.34.4 See also --------------- @@ -2636,12 +2608,71 @@ Usage of available functionalities is described in the following menu: 3.38.2 Description ------------------ +This command looks for `.sh' files inside Bash directory and extracts +translatable strings from files, using `xgettext' command, in order to +create a portable object template (`centos-art.sh.pot') file for them. + + With the `centos-art.sh.pot' file up to date, the `centos-art' +command removes the temporal list of files sotred inside `/tmp' +directory and checks the current language of your user's session to +create a portable object file for it, in the location +`$CLI_LANG/$CLI_LANG.po'. + + The CLI_LANG variable discribes the locale language used to output +messages inside `centos-art' command. The locale language used inside +`centos-art' command is taken from the LANG environment variable. The +CLI_LANG variable has the `LL_CC' format, where `LL' is a language code +from the ISO-639 standard, and `CC' a country code from the ISO-3166 +standard. + + The LANG environment variable is set when you do log in to your +system. If you are using a graphical session, change language to your +native language and do login. That would set and exoprt the LANG +environment variable to the correct value. On the other side, if you +are using a text session edit your `~/.bash_profile' file to set and +export the LANG environment variable to your native locale as defines +the `locale -a' command output; do logout, and do login again. + + At this point, the LANG environment variable has the appropriate +value you need, in order to translate `centos-art.sh' messages to your +native language (the one set in LANG environment variable). + + With the `$CLI_LANG/$CLI_LANG.po' file up to date, the `centos-art' +opens it for you to update translation strings. The `centos-art' +command uses the value of EDITOR environment variable to determine your +favorite text editor. If no value is defined on EDITOR, the +`/usr/bin/vim' text editor is used as default. + + When you finish PO file's edition and quit text editor, the +`centos-art' command creates the related machine object in the location +`$CLI_LANG/LC_MESSAGES/$TEXTDOMAIN.mo'. + + At this point, all translations you made in the PO file should be +available to your language when runing `centos-art.sh' script. + + In order to make the `centos-art.sh' internationalization, the +`centos-art.sh' script was modified as described in the `gettext' info +documentation (`info gettext'). You can find such modifications in the +following files: + + * `trunk/Scripts/Bash/initFunctions.sh' + + * `trunk/Scripts/Bash/Functions/Help/cli_localeMessages.sh' + + * `trunk/Scripts/Bash/Functions/Help/cli_localeMessagesStatus.sh' + * ... 3.38.3 Usage ------------ - * ... +`centos-art locale --edit' + Use this command to translate command-line interface output + messages in the current system locale you are using (as specified + in LANG environment variable). + +`centos-art locale --list' + Use this command to see the command-line interface locale report. 3.38.4 See also --------------- @@ -2951,7 +2982,7 @@ are used by "svg" functionalities to introduce dynamic information ------------ This section exists to organize files related to `centos-art.sh' script -"verify" functionality. The "verify" functionality of `centos-art.sh' +`verify' functionality. The `verify' functionality of `centos-art.sh' script helps you to verify the workstation configuration you are planning to use as host for your working copy of CentOS Artwork Repository. @@ -2963,11 +2994,11 @@ The first time you download CentOS Artwork Repository you need to configure your workstation in order to use `centos-art.sh' script. These preliminar configurations are based mainly on auxiliar RPM packages installation, symbolic links creations, and environment -variables definitions. The "verify" functionality of `centos-art.sh' +variables definitions. The `verify' functionality of `centos-art.sh' script guides you through this preliminar configuration process. If this is the first time you run `centos-art' command, the -appropriate way to use its "verify" functionality is not using the +appropriate way to use its `verify' functionality is not using the `centos-art' command directly, but the absolute path to `centos-art.sh' script instead (i.e., `~/artwork/trunk/Scripts/Bash/centos-art.sh'). This is necessary because `centos-art' symbolic link, under `~/bin/' @@ -2995,7 +3026,7 @@ to request root privileges to execute `yum''s installation functionality. If your user isn't defined as a privileged user--at least to run `yum' commands-- inside `/etc/sudoers' configuration file, you will not be able to perform package installation tasks as set in -`centos-art.sh' script "verify" functionality. +`centos-art.sh' script `verify' functionality. Setting sudo privileges to users is an administrative task you have to do by yourself. If you don't have experience with `sudo' command, @@ -3042,11 +3073,11 @@ configuration, automation scripts cannot be branched under Definition of environemnt variables helps us to set default values to our user session life. The user session environment variable defintion -takes place in the user's `~/.bash_profile' file. The "verify" +takes place in the user's `~/.bash_profile' file. The `verify' functionality of `centos-art.sh' script doesn't modify your `~/.bash_profile' file. - The "verify" functionality of `centos-art.sh' script evaluates the + The `verify' functionality of `centos-art.sh' script evaluates the following environment variables: EDITOR @@ -3158,80 +3189,25 @@ LANG 3.45.1 Goals ------------ - * Organize `centos-art.sh' locale files. +This section exists to organize translation messages and templates used +by `centos-art.sh' script. 3.45.2 Description ------------------ -This command looks for `.sh' files inside Bash directory and extracts -translatable strings from files, using `xgettext' command, in order to -create a portable object template (`centos-art.sh.pot') file for them. - - With the `centos-art.sh.pot' file up to date, the `centos-art' -command removes the temporal list of files sotred inside `/tmp' -directory and checks the current language of your user's session to -create a portable object file for it, in the location -`$CLI_LANG/$CLI_LANG.po'. - - The CLI_LANG variable discribes the locale language used to output -messages inside `centos-art' command. The locale language used inside -`centos-art' command is taken from the LANG environment variable. The -CLI_LANG variable has the `LL_CC' format, where `LL' is a language code -from the ISO-639 standard, and `CC' a country code from the ISO-3166 -standard. - - The LANG environment variable is set when you do log in to your -system. If you are using a graphical session, change language to your -native language and do login. That would set and exoprt the LANG -environment variable to the correct value. On the other side, if you -are using a text session edit your `~/.bash_profile' file to set and -export the LANG environment variable to your native locale as defines -the `locale -a' command output; do logout, and do login again. - - At this point, the LANG environment variable has the appropriate -value you need, in order to translate `centos-art.sh' messages to your -native language (the one set in LANG environment variable). - - With the `$CLI_LANG/$CLI_LANG.po' file up to date, the `centos-art' -opens it for you to update translation strings. The `centos-art' -command uses the value of EDITOR environment variable to determine your -favorite text editor. If no value is defined on EDITOR, the -`/usr/bin/vim' text editor is used as default. - - When you finish PO file's edition and quit text editor, the -`centos-art' command creates the related machine object in the location -`$CLI_LANG/LC_MESSAGES/$TEXTDOMAIN.mo'. - - At this point, all translations you made in the PO file should be -available to your language when runing `centos-art.sh' script. - -3.45.2.1 Configuration files -............................ - -In order to make the `centos-art.sh' internationalization, the -`centos-art.sh' script was modified as described in the `gettext' info -documentation (`info gettext'). You can find such modifications in the -following files: - - * `trunk/Scripts/Bash/initFunctions.sh' - - * `trunk/Scripts/Bash/Functions/Help/cli_localeMessages.sh' - - * `trunk/Scripts/Bash/Functions/Help/cli_localeMessagesStatus.sh' +Translated messages of `centos-art.sh' script are managed using GNU +`gettext' utilities. Most translation actions have been automated +through `centos-art.sh' script "locale" functionality (*note trunk +Scripts Bash Functions Locale::). 3.45.3 Usage ------------ -3.45.3.1 The `centos-art' `locale-cli' action -............................................. - -`centos-art locale-cli --edit' - Use this command to translate command-line interface output - messages in the current system locale you are using (as specified - in LANG environment variable). - -`centos-art locale-cli --list' - Use this command to see the command-line interface locale report. +The content of `trunk/Scripts/Bash/Locale' directory should not be +managed manually. Instead, use the "locale" functionality of +`centos-art.sh' script. *Note trunk Scripts Bash Functions Locale::, +for more information on how to use `centos-art.sh' "locale" +functionality. 3.45.4 See also --------------- @@ -4258,90 +4234,90 @@ documentation entry (*note trunk Translations::). Index ***** -branches: See 1. (line 372) -Common translation files: See 3.48.2.5. (line 3683) -How to render brands' translation files: See 3.50.3. (line 3988) -How to render fonts' translation files: See 3.52.3. (line 4065) -How to render translation files: See 3.48.3. (line 3853) -Specific translation files: See 3.48.2.6. (line 3708) -tags: See 2. (line 375) -Template translation files: See 3.48.2.4. (line 3513) -Translation brands file names: See 3.50.2.1. (line 3945) -Translation configuration scripts: See 3.48.2.8. (line 3742) -Translation entries: See 3.48.2.1. (line 3329) -Translation files: See 3.48.2.3. (line 3445) -Translation markers: See 3.48.2.2. (line 3410) -Translation paths: See 3.48.2.1. (line 3329) +branches: See 1. (line 365) +Common translation files: See 3.48.2.5. (line 3659) +How to render brands' translation files: See 3.50.3. (line 3964) +How to render fonts' translation files: See 3.52.3. (line 4041) +How to render translation files: See 3.48.3. (line 3829) +Specific translation files: See 3.48.2.6. (line 3684) +tags: See 2. (line 368) +Template translation files: See 3.48.2.4. (line 3489) +Translation brands file names: See 3.50.2.1. (line 3921) +Translation configuration scripts: See 3.48.2.8. (line 3718) +Translation entries: See 3.48.2.1. (line 3305) +Translation files: See 3.48.2.3. (line 3421) +Translation markers: See 3.48.2.2. (line 3386) +Translation paths: See 3.48.2.1. (line 3305) Translation pre-rendering configuration scripts:See 3.48.2.8. - (line 3742) -Translation rendering: See 3.48.2.7. (line 3731) -Translation rendering default functionality: See 3.48.2.9. (line 3828) -trunk: See 3. (line 378) -trunk Identity: See 3.1. (line 381) -trunk Identity Brands: See 3.2. (line 801) -trunk Identity Fonts: See 3.3. (line 818) -trunk Identity Icons: See 3.4. (line 894) -trunk Identity Isolinux: See 3.5. (line 911) -trunk Identity Models: See 3.6. (line 928) -trunk Identity Models Css: See 3.7. (line 948) -trunk Identity Models Html: See 3.8. (line 970) -trunk Identity Models Img Promo Web: See 3.9. (line 991) -trunk Identity Models Tpl: See 3.10. (line 1012) -trunk Identity Models Tpl Promo Web: See 3.11. (line 1033) -trunk Identity Models Xcf: See 3.12. (line 1347) -trunk Identity Release: See 3.13. (line 1368) -trunk Identity Themes: See 3.14. (line 1385) -trunk Identity Themes Models: See 3.15. (line 1410) -trunk Identity Themes Models Alternative: See 3.16. (line 1443) -trunk Identity Themes Models Default: See 3.17. (line 1470) -trunk Identity Themes Models Default Distro: See 3.18. (line 1502) + (line 3718) +Translation rendering: See 3.48.2.7. (line 3707) +Translation rendering default functionality: See 3.48.2.9. (line 3804) +trunk: See 3. (line 371) +trunk Identity: See 3.1. (line 374) +trunk Identity Brands: See 3.2. (line 794) +trunk Identity Fonts: See 3.3. (line 811) +trunk Identity Icons: See 3.4. (line 887) +trunk Identity Isolinux: See 3.5. (line 904) +trunk Identity Models: See 3.6. (line 921) +trunk Identity Models Css: See 3.7. (line 941) +trunk Identity Models Html: See 3.8. (line 963) +trunk Identity Models Img Promo Web: See 3.9. (line 984) +trunk Identity Models Tpl: See 3.10. (line 1005) +trunk Identity Models Tpl Promo Web: See 3.11. (line 1026) +trunk Identity Models Xcf: See 3.12. (line 1340) +trunk Identity Release: See 3.13. (line 1361) +trunk Identity Themes: See 3.14. (line 1378) +trunk Identity Themes Models: See 3.15. (line 1403) +trunk Identity Themes Models Alternative: See 3.16. (line 1436) +trunk Identity Themes Models Default: See 3.17. (line 1463) +trunk Identity Themes Models Default Distro: See 3.18. (line 1495) trunk Identity Themes Models Default Distro Anaconda:See 3.19. - (line 1586) -trunk Identity Themes Models Default Promo: See 3.20. (line 1603) -trunk Identity Themes Models Default Web: See 3.21. (line 1629) -trunk Identity Themes Motifs: See 3.22. (line 1654) -trunk Identity Themes Motifs Modern Backgrounds:See 3.23. (line 1758) + (line 1579) +trunk Identity Themes Models Default Promo: See 3.20. (line 1596) +trunk Identity Themes Models Default Web: See 3.21. (line 1622) +trunk Identity Themes Motifs: See 3.22. (line 1647) +trunk Identity Themes Motifs Modern Backgrounds:See 3.23. (line 1751) trunk Identity Themes Motifs Modern Backgrounds Img:See 3.24. - (line 1880) + (line 1873) trunk Identity Themes Motifs Modern Backgrounds Tpl:See 3.25. - (line 1901) + (line 1894) trunk Identity Themes Motifs Modern Backgrounds Xcf:See 3.26. - (line 1922) + (line 1915) trunk Identity Themes Motifs Modern Distro Anaconda Progress:See 3.27. - (line 1949) -trunk Identity Themes Motifs Modern Palettes: See 3.28. (line 2005) -trunk Identity Themes Motifs TreeFlower: See 3.29. (line 2027) + (line 1942) +trunk Identity Themes Motifs Modern Palettes: See 3.28. (line 1998) +trunk Identity Themes Motifs TreeFlower: See 3.29. (line 2020) trunk Identity Themes Motifs TreeFlower Backgrounds:See 3.30. - (line 2044) -trunk Identity Widgets: See 3.31. (line 2340) -trunk Manuals: See 3.32. (line 2357) -trunk Scripts: See 3.33. (line 2411) -trunk Scripts Bash: See 3.34. (line 2435) -trunk Scripts Bash Functions: See 3.35. (line 2568) -trunk Scripts Bash Functions Help: See 3.36. (line 2589) -trunk Scripts Bash Functions Html: See 3.37. (line 2610) -trunk Scripts Bash Functions Locale: See 3.38. (line 2631) -trunk Scripts Bash Functions Path: See 3.39. (line 2652) -trunk Scripts Bash Functions Render: See 3.40. (line 2686) -trunk Scripts Bash Functions Render Config: See 3.41. (line 2707) -trunk Scripts Bash Functions Shell: See 3.42. (line 2885) -trunk Scripts Bash Functions Svg: See 3.43. (line 2906) -trunk Scripts Bash Functions Verify: See 3.44. (line 2950) -trunk Scripts Bash Locale: See 3.45. (line 3158) -trunk Scripts Perl: See 3.46. (line 3242) -trunk Scripts Python: See 3.47. (line 3259) -trunk Translations: See 3.48. (line 3280) -trunk Translations Identity: See 3.49. (line 3883) -trunk Translations Identity Brands: See 3.50. (line 3904) -trunk Translations Identity Brands Tpl: See 3.51. (line 3999) -trunk Translations Identity Fonts: See 3.52. (line 4014) -trunk Translations Identity Models: See 3.53. (line 4081) -trunk Translations Identity Release: See 3.54. (line 4096) -trunk Translations Identity Themes: See 3.55. (line 4111) -trunk Translations Identity Themes Backgrounds:See 3.56. (line 4126) + (line 2037) +trunk Identity Widgets: See 3.31. (line 2333) +trunk Manuals: See 3.32. (line 2350) +trunk Scripts: See 3.33. (line 2404) +trunk Scripts Bash: See 3.34. (line 2428) +trunk Scripts Bash Functions: See 3.35. (line 2540) +trunk Scripts Bash Functions Help: See 3.36. (line 2561) +trunk Scripts Bash Functions Html: See 3.37. (line 2582) +trunk Scripts Bash Functions Locale: See 3.38. (line 2603) +trunk Scripts Bash Functions Path: See 3.39. (line 2683) +trunk Scripts Bash Functions Render: See 3.40. (line 2717) +trunk Scripts Bash Functions Render Config: See 3.41. (line 2738) +trunk Scripts Bash Functions Shell: See 3.42. (line 2916) +trunk Scripts Bash Functions Svg: See 3.43. (line 2937) +trunk Scripts Bash Functions Verify: See 3.44. (line 2981) +trunk Scripts Bash Locale: See 3.45. (line 3189) +trunk Scripts Perl: See 3.46. (line 3218) +trunk Scripts Python: See 3.47. (line 3235) +trunk Translations: See 3.48. (line 3256) +trunk Translations Identity: See 3.49. (line 3859) +trunk Translations Identity Brands: See 3.50. (line 3880) +trunk Translations Identity Brands Tpl: See 3.51. (line 3975) +trunk Translations Identity Fonts: See 3.52. (line 3990) +trunk Translations Identity Models: See 3.53. (line 4057) +trunk Translations Identity Release: See 3.54. (line 4072) +trunk Translations Identity Themes: See 3.55. (line 4087) +trunk Translations Identity Themes Backgrounds:See 3.56. (line 4102) trunk Translations Identity Themes Distro Anaconda Progress:See 3.57. - (line 4147) -trunk Translations Identity Widgets: See 3.58. (line 4240) + (line 4123) +trunk Translations Identity Widgets: See 3.58. (line 4216) List of Figures *************** diff --git a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash.texi b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash.texi index 2aa4597..2eb550d 100644 --- a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash.texi +++ b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash.texi @@ -1,46 +1,82 @@ @subsection Goals -The @file{trunk/Scripts/Bash} directory exists to organize the -``trunk'' development line of @command{centos-art.sh} automation -script. The @command{centos-art.sh} script standardizes frequent -tasks inside your working copy of CentOS Artwork Repository. +The @file{trunk/Scripts/Bash} directory exists to organize the trunk +development line of @file{centos-art.sh} automation script. The +@file{centos-art.sh} script standardizes frequent tasks inside your +working copy of CentOS Artwork Repository. @subsection Description -The best way to understand @command{centos-art.sh} automation script -is studying its source code. The @command{centos-art.sh} script is -splited in several configuration and function files which are loaded -when the @command{centos-art.sh} script is executed. This section -describes the order in which @command{centos-art.sh} loads its -configuration and function files. +The best way to understand @file{centos-art.sh} automation script is +studying its source code. The @file{centos-art.sh} script is splited +in several configuration and function files which are loaded when the +@file{centos-art.sh} script is executed. This section describes the +order in which @file{centos-art.sh} loads its configuration and +function files. When you type the @command{centos-art} command in your terminal, the operating system trys to execute that command. In order to execute the command, the operating system needs to know where it is, so the operating system uses the @var{PATH} environment variable to look for that command's location. If your system was prepared to use CentOS -Artwork Repository correctly (see usage section above), you should -have a symbolic link inside @file{~/bin/} directory that points to the -@command{centos-art.sh} script file. As @file{~/bin/} directory is, by -default, inside @var{PATH} environment variable, the execution of -@command{centos-art} command runs the @file{centos-art.sh} script. - -When @command{centos-art.sh} script is executed, the first it does is -execute the @file{trunk/Scripts/Bash/initFunctions.sh} file to -initialize @command{gettext} variables and all function scripts inside -@file{trunk/Scripts/Bash/Functions} directory. - -Once @command{gettext} variables and all function scripts have been -initialized, the @command{centos-art.sh} script initializes its -environment variables using the @command{cli_getVariables} function. -At this point the @command{centos-art.sh} script calls the -@command{cli_getActions} function from @command{cli_getVariables} -function's bottom. - -The @command{cli_getActions} function defines which actions the -@command{centos-art.sh} script is able to perform. Inside -@command{cli_getActions} function, actions are defined combining -positional arguments and function calls. +Artwork Repository correctly (@pxref{trunk Scripts Bash Functions +Verify}), you should have a symbolic link inside @file{~/bin/} +directory that points to the @file{centos-art.sh} script file. As +@file{~/bin/} directory is, by default, inside @var{PATH} environment +variable, the execution of @command{centos-art} command runs the +@file{centos-art.sh} script. + +When @file{centos-art.sh} script is executed, the first it does is +executing the @file{trunk/Scripts/Bash/initFunctions.sh} script to +initialize global variables (e.g., @command{gettext}'s variables) and +global function scripts. Global function scripts are located inside +@file{trunk/Scripts/Bash/Functions} directory and their file names +begin with @samp{cli}. Global function scripts provide common +functionalities that can be used anywhere inside @file{centos-art.sh} +script execution environment. + +Once global variables and function scripts have been loaded, +@file{centos-art.sh} script executes the @command{cli} global function +from @file{cli.sh} function script to retrive command-line arguments +and define some default values that may be used later by specific +function scripts (@pxref{trunk Scripts Bash Functions}). + +As convenction, the @file{centos-art.sh} command-line arguments have +the following format: + +@verbatim +centos-art arg1 --arg2=val2 --arg3=val3 +@end verbatim + +In the above example, @samp{centos-art} is the command you use to +invoke @file{centos-art.sh} script. The @samp{arg1} represents the +action you want to do (e.g., @option{verify}, @option{render}, +@option{locale}, @option{help}, etc.). The remaining arguments are +modifiers to @option{arg1}. The @option{--arg2} definition is +required. The @option{--arg3} is optional. For example, if you want +to render all anaconda progress slides, for all major releases of +CentOS distribution, for all languages availabe using TreeFlower motif +as background, you use the following command: + +@verbatim +centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress +@end verbatim + +Now, if you only want to render anaconda progress +@file{01-welcome.png} slide, for CentOS distribution major release 5, +in English language, you need to add the third argument as follows: + +@verbatim +centos-art render --entry=trunk/Identity/Themes/Motifs/TreeFlower/Distro/Anaconda/Progress --filter=5/en/01-welcome +@end verbatim + +Once command-line arguments have been retrived, the +@file{centos-art.sh} script loads specific functions using the +@file{cli_getActions.sh} function script. For example, if you run the +command @command{centos-art render --entry}, the @file{centos-art.sh} +script will look for @file{trunk/Scripts/Bash/Functions/Render} +directory and will load the @file{render.sh} function script from it; +this, in order to achive the rendering task as it defines. @float Figure,fig:trunk/Scripts/Bash:Initialization @verbatim @@ -53,7 +89,7 @@ positional arguments and function calls. +---v---------------------------------v---+ . | initFunctions.sh | . . +---------------------------------+ . - . | cli_getVariables $@ | . + . | cli $@ | . . +---v-------------------------v---+ . . . | cli_getActions | . . . . +---v-----------------v---+ . . @@ -65,73 +101,18 @@ positional arguments and function calls. . ................................... . ........................................... @end verbatim -@caption{The @command{centos-art.sh} initialization environment.} +@caption{The @file{centos-art.sh} initialization environment.} @end float -@subsubsection The identity matching list - -The identity matching list is used by identity rendering functions to -define the relation between translation files and identity design -templates. - -@subsubsection Adding new features - -To add new features inside @command{centos-art.sh} script, you need to -set positional arguments and function calls inside -@command{cli_getActions} function for the new function or functions -required by the new feature you want to add. - @subsection Usage -@subsubsection The @command{centos-art} @samp{search} action - -This feature is not supported yet. - -@table @samp -@item centos-art search 'pattern' - -Use this command to find directories and files that match exactly the -posix-regular expression set in @samp{pattern} as in @samp{^pattern$}. - -@item centos-art search 'pattern1 pattern2 patternN' - -Use this command to search repository entries that match pattern1 -@emph{or} patter2 @emph{or} patternN as in -@samp{'^.*(pattern1|pattern2|patternN).*$'}. - -@item centos-art search 'path/to/dir1 path/to/dir2 path/to/dirN' - -Use this command to search repository entries that match -@samp{path/to/dir1} @emph{or} @samp{path/to/dir2}, @emph{or} -@samp{path/to/dirN} as in -@samp{^.*(path/to/dir1|path/to/dir2|path/to/dirN).*$'}. -@end table - -@subsubsection The @command{centos-art} @samp{locale-art} action - -This feature is not supported yet. - -@table @samp -@item centos-art locale-art 'path/to/dir' --edit -@item centos-art locale-art 'path/to/dir' --edit='filename' -@item centos-art locale-art 'path/to/dir' --list -@item centos-art locale-art 'path/to/dir' --list='filename' -@end table - -@subsubsection The @command{centos-art} @samp{license} action - -This feature is supported through the following command: - -@table @samp -@item centos-art license -Use this command to see a brief description of @command{centos-art} -command its copyright and its license notes. -@end table +The @file{centos-art.sh} script usage information is described inside +each specific function documentation (@pxref{trunk Scripts Bash +Functions}). @subsection See also @menu -* trunk Scripts Bash Functions:: -* trunk Scripts Bash Locale:: * trunk Scripts:: +* trunk Scripts Bash Locale:: @end menu diff --git a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions.texi b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions.texi index 5f2f529..0383ec8 100644 --- a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions.texi +++ b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions.texi @@ -29,4 +29,5 @@ Usage of available functionalities is described in the following menu: @menu * trunk Scripts Bash:: +* trunk Scripts Bash Locale:: @end menu diff --git a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Locale.texi b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Locale.texi index fb39647..33131a0 100644 --- a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Locale.texi +++ b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Locale.texi @@ -6,16 +6,79 @@ @subsection Description +This command looks for @samp{.sh} files inside Bash directory and +extracts translatable strings from files, using @command{xgettext} +command, in order to create a portable object template +(@file{centos-art.sh.pot}) file for them. + +With the @file{centos-art.sh.pot} file up to date, the +@command{centos-art} command removes the temporal list of files sotred +inside @file{/tmp} directory and checks the current language of your +user's session to create a portable object file for it, in the +location @file{$CLI_LANG/$CLI_LANG.po}. + +The @var{CLI_LANG} variable discribes the locale language used to +output messages inside @command{centos-art} command. The locale +language used inside @command{centos-art} command is taken from the +@var{LANG} environment variable. The @var{CLI_LANG} variable has the +@samp{LL_CC} format, where @samp{LL} is a language code from the +ISO-639 standard, and @samp{CC} a country code from the ISO-3166 +standard. + +The @var{LANG} environment variable is set when you do log in to your +system. If you are using a graphical session, change language to your +native language and do login. That would set and exoprt the @var{LANG} +environment variable to the correct value. On the other side, if you +are using a text session edit your @file{~/.bash_profile} file to set +and export the @var{LANG} environment variable to your native locale +as defines the @command{locale -a} command output; do logout, and do +login again. + +At this point, the @var{LANG} environment variable has the appropriate +value you need, in order to translate @command{centos-art.sh} messages +to your native language (the one set in @var{LANG} environment +variable). + +With the @file{$CLI_LANG/$CLI_LANG.po} file up to date, the +@command{centos-art} opens it for you to update translation strings. +The @command{centos-art} command uses the value of @var{EDITOR} +environment variable to determine your favorite text editor. If no +value is defined on @var{EDITOR}, the @file{/usr/bin/vim} text editor +is used as default. + +When you finish PO file's edition and quit text editor, the +@command{centos-art} command creates the related machine object in the +location @file{$CLI_LANG/LC_MESSAGES/$TEXTDOMAIN.mo}. + +At this point, all translations you made in the PO file should be +available to your language when runing @command{centos-art.sh} script. + +In order to make the @command{centos-art.sh} internationalization, the +@command{centos-art.sh} script was modified as described in the +@command{gettext} info documentation (@command{info gettext}). You +can find such modifications in the following files: + @itemize -@item ... +@item @file{trunk/Scripts/Bash/initFunctions.sh} +@item @file{trunk/Scripts/Bash/Functions/Help/cli_localeMessages.sh} +@item @file{trunk/Scripts/Bash/Functions/Help/cli_localeMessagesStatus.sh} @end itemize -@subsection Usage - @itemize @item ... @end itemize +@subsection Usage + +@table @samp +@item centos-art locale --edit +Use this command to translate command-line interface output messages +in the current system locale you are using (as specified in @var{LANG} +environment variable). +@item centos-art locale --list +Use this command to see the command-line interface locale report. +@end table + @subsection See also @menu diff --git a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Verify.texi b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Verify.texi index b0daba3..ad284ec 100644 --- a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Verify.texi +++ b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Functions/Verify.texi @@ -1,10 +1,10 @@ @subsection Goals This section exists to organize files related to @file{centos-art.sh} -script ``verify'' functionality. The ``verify'' functionality of -@file{centos-art.sh} script helps you to verify the workstation -configuration you are planning to use as host for your working copy of -CentOS Artwork Repository. +script @option{verify} functionality. The @option{verify} +functionality of @file{centos-art.sh} script helps you to verify the +workstation configuration you are planning to use as host for your +working copy of CentOS Artwork Repository. @subsection Description @@ -12,13 +12,13 @@ The first time you download CentOS Artwork Repository you need to configure your workstation in order to use @file{centos-art.sh} script. These preliminar configurations are based mainly on auxiliar RPM packages installation, symbolic links creations, and environment -variables definitions. The ``verify'' functionality of +variables definitions. The @option{verify} functionality of @file{centos-art.sh} script guides you through this preliminar configuration process. If this is the first time you run @command{centos-art} command, the -appropriate way to use its ``verify'' functionality is not using the -@command{centos-art} command directly, but the absolute path to +appropriate way to use its @option{verify} functionality is not using +the @command{centos-art} command directly, but the absolute path to @command{centos-art.sh} script instead (i.e., @file{~/artwork/trunk/Scripts/Bash/centos-art.sh}). This is necessary because @command{centos-art} symbolic link, under @file{~/bin/} @@ -49,7 +49,7 @@ installation functionality. If your user isn't defined as a privileged user---at least to run @command{yum} commands--- inside @file{/etc/sudoers} configuration file, you will not be able to perform package installation tasks as set in @file{centos-art.sh} -script ``verify'' functionality. +script @option{verify} functionality. Setting sudo privileges to users is an administrative task you have to do by yourself. If you don't have experience with @command{sudo} @@ -95,12 +95,12 @@ cannot be branched under @file{branches/Scripts} directory structure. Definition of environemnt variables helps us to set default values to our user session life. The user session environment variable defintion -takes place in the user's @file{~/.bash_profile} file. The ``verify'' -functionality of @file{centos-art.sh} script doesn't modify your -@file{~/.bash_profile} file. +takes place in the user's @file{~/.bash_profile} file. The +@option{verify} functionality of @file{centos-art.sh} script doesn't +modify your @file{~/.bash_profile} file. -The ``verify'' functionality of @file{centos-art.sh} script evaluates -the following environment variables: +The @option{verify} functionality of @file{centos-art.sh} script +evaluates the following environment variables: @table @var @item EDITOR diff --git a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Locale.texi b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Locale.texi index 4ba4588..ea50a2f 100644 --- a/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Locale.texi +++ b/Manuals/en/Texinfo/Repository/trunk/Scripts/Bash/Locale.texi @@ -1,83 +1,22 @@ @subsection Goals -@itemize -@item Organize @file{centos-art.sh} locale files. -@end itemize +This section exists to organize translation messages and templates +used by @file{centos-art.sh} script. @subsection Description -This command looks for @samp{.sh} files inside Bash directory and -extracts translatable strings from files, using @command{xgettext} -command, in order to create a portable object template -(@file{centos-art.sh.pot}) file for them. - -With the @file{centos-art.sh.pot} file up to date, the -@command{centos-art} command removes the temporal list of files sotred -inside @file{/tmp} directory and checks the current language of your -user's session to create a portable object file for it, in the -location @file{$CLI_LANG/$CLI_LANG.po}. - -The @var{CLI_LANG} variable discribes the locale language used to -output messages inside @command{centos-art} command. The locale -language used inside @command{centos-art} command is taken from the -@var{LANG} environment variable. The @var{CLI_LANG} variable has the -@samp{LL_CC} format, where @samp{LL} is a language code from the -ISO-639 standard, and @samp{CC} a country code from the ISO-3166 -standard. - -The @var{LANG} environment variable is set when you do log in to your -system. If you are using a graphical session, change language to your -native language and do login. That would set and exoprt the @var{LANG} -environment variable to the correct value. On the other side, if you -are using a text session edit your @file{~/.bash_profile} file to set -and export the @var{LANG} environment variable to your native locale -as defines the @command{locale -a} command output; do logout, and do -login again. - -At this point, the @var{LANG} environment variable has the appropriate -value you need, in order to translate @command{centos-art.sh} messages -to your native language (the one set in @var{LANG} environment -variable). - -With the @file{$CLI_LANG/$CLI_LANG.po} file up to date, the -@command{centos-art} opens it for you to update translation strings. -The @command{centos-art} command uses the value of @var{EDITOR} -environment variable to determine your favorite text editor. If no -value is defined on @var{EDITOR}, the @file{/usr/bin/vim} text editor -is used as default. - -When you finish PO file's edition and quit text editor, the -@command{centos-art} command creates the related machine object in the -location @file{$CLI_LANG/LC_MESSAGES/$TEXTDOMAIN.mo}. - -At this point, all translations you made in the PO file should be -available to your language when runing @command{centos-art.sh} script. - -@subsubsection Configuration files - -In order to make the @command{centos-art.sh} internationalization, the -@command{centos-art.sh} script was modified as described in the -@command{gettext} info documentation (@command{info gettext}). You -can find such modifications in the following files: - -@itemize -@item @file{trunk/Scripts/Bash/initFunctions.sh} -@item @file{trunk/Scripts/Bash/Functions/Help/cli_localeMessages.sh} -@item @file{trunk/Scripts/Bash/Functions/Help/cli_localeMessagesStatus.sh} -@end itemize +Translated messages of @file{centos-art.sh} script are managed using +GNU @command{gettext} utilities. Most translation actions have been +automated through @file{centos-art.sh} script ``locale'' functionality +(@pxref{trunk Scripts Bash Functions Locale}). @subsection Usage -@subsubsection The @command{centos-art} @samp{locale-cli} action - -@table @samp -@item centos-art locale-cli --edit -Use this command to translate command-line interface output messages -in the current system locale you are using (as specified in @var{LANG} -environment variable). -@item centos-art locale-cli --list -Use this command to see the command-line interface locale report. -@end table +The content of @file{trunk/Scripts/Bash/Locale} directory should not +be managed manually. Instead, use the ``locale'' functionality of +@file{centos-art.sh} script. @xref{trunk Scripts Bash Functions +Locale}, for more information on how to use @file{centos-art.sh} +``locale'' functionality. @subsection See also