fe851c Update render_doCopy.sh:

Authored and Committed by areguera 13 years ago
    Update render_doCopy.sh:
    
        - Remove long comment from top. The comment information is handled
          in the `render' functionality documentation manual now.
    
    
        
Scripts/Bash/Functions/Render/render_doCopy.sh CHANGED
@@ -8,160 +8,6 @@
8
8
# design images, pre-rendition configuration scripts, and related
9
9
# translations files).
10
10
#
11
- # When we duplicate directories, inside `trunk/Identity' directory
12
- # structure, there are two organizational designs we need to be aware
13
- # of:
14
- #
15
- # Organization 1: Design models (`Tpl/') and design images (`Img/')
16
- # directories share a common parent directory under `trunk/Identity'
17
- # directory structure.
18
- #
19
- # trunk/Identity/Widgets
20
- # |-- Tpl
21
- # | `-- file.svg
22
- # `-- Img
23
- # `-- file.png
24
- #
25
- # trunk/Translations/Identity/Widgets
26
- # trunk/Scripts/Bash/Functions/Render/Config/Identity/Widgets
27
- #
28
- # Organization 2: Design models and design images don't share a
29
- # common parent directory. Instead, design models and design images
30
- # are stored separately on their own directory structures under
31
- # `trunk/Identity'.
32
- #
33
- # trunk/Identity/Themes/Models/Default/Distro/
34
- # `-- Anaconda
35
- # `-- Header
36
- # `-- anaconda_header.svg
37
- #
38
- # trunk/Identity/Themes/Motifs/TreeFlower/Distro/
39
- # `-- Anaconda
40
- # `-- Header
41
- # `-- anaconda_header.png
42
- #
43
- # trunk/Translations/Identity/Themes/Distro/Anaconda/Header/
44
- # trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes/Distro/Anaconda/Header/
45
- #
46
- # The "Organization 2" emerged from "Organization 1" to satisfy a
47
- # need that "Organization 1" cannot satisfy: The design models
48
- # cannot be reused in "Organization 1" but in "Organization 2" they
49
- # can be reused indeed.
50
- #
51
- # Another consideration to have, when we duplicate directory
52
- # structures, is the source location used to perform the duplication
53
- # action. The source location is relevant to determine the required
54
- # information inside directory structures (parallel directories) that
55
- # need to be copied too (otherwise we may end up with orphan directory
56
- # structures unable to be rendered, due the absence of required
57
- # information).
58
- #
59
- # In order for a renderable directory structure to be valid, the new
60
- # directory structure copied should match the following conditions:
61
- #
62
- # 1. To have a unique directory structure under
63
- # `trunk/Identity', organized by any one of the above
64
- # organizational designs above.
65
- #
66
- # 2. To have a unique directory structure under
67
- # `trunk/Translations' to store translation files.
68
- #
69
- # 3. To have a unique directory structure under
70
- # `trunk/Scripts/Bash/Functions/Render/Config' to set
71
- # pre-rendition configuration script.
72
- #
73
- # As convenction, the render_doCopy function uses `trunk/Identity'
74
- # directory structure as source location. Once the `trunk/Identity'
75
- # directory structure has been specified and verified, the related
76
- # path information is built from it and copied automatically to the
77
- # new location specified by FLAG_TO variable.
78
- #
79
- # Organization 1:
80
- #
81
- # Command:
82
- # - centos-art render --copy=trunk/Identity/Widgets --to=trunk/Identity/NewDirName
83
- #
84
- # Sources:
85
- # - trunk/Identity/Widgets
86
- # - trunk/Translations/Identity/Widgets
87
- # - trunk/Scripts/Bash/Functions/Render/Config/Identity/Widgets
88
- #
89
- # Targets:
90
- # - trunk/Identity/NewDirName
91
- # - trunk/Translations/Identity/NewDirName
92
- # - trunk/Scripts/Bash/Functions/Render/Config/Identity/NewDirName
93
- #
94
- # Organization 2:
95
- #
96
- # Command:
97
- # - centos-art render --copy=trunk/Identity/Themes/Motifs/TreeFlower \
98
- # --to=trunk/Identity/Themes/Motifs/NewDirName
99
- #
100
- # Sources:
101
- # - trunk/Identity/Themes/Motifs/TreeFlower
102
- # - trunk/Translations/Identity/Themes
103
- # - trunk/Translations/Identity/Themes/Motifs/TreeFlower
104
- # - trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes
105
- # - trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes/Motifs/TreeFlower
106
- #
107
- # Targets:
108
- # - trunk/Identity/Themes/Motifs/NewDirName
109
- # - trunk/Translations/Identity/Themes
110
- # - trunk/Translations/Identity/Themes/Motifs/NewDirName
111
- # - trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes
112
- # - trunk/Scripts/Bash/Functions/Render/Config/Identity/Themes/Motifs/NewDirName
113
- #
114
- # Notice that design models are not included in source or target
115
- # locations. This is intentional. In "Organization 2", design models
116
- # live by their own, they just exist, they are there, available for
117
- # any artistic motif to use. By default `Themes/Models/Default' design
118
- # model directory structure is used, but other design models
119
- # directory structures (under Themes/Models/) can be created and
120
- # used changing the value of THEMEMODEL variable inside the
121
- # pre-rendition configuration script of the artistic motif source
122
- # location you want to produce.
123
- #
124
- # Notice, also, how translations and pre-rendition configuration
125
- # scripts may both be equal in source and target. This is because
126
- # such structures are common to all artistic motifs (the default
127
- # values to use when no specific values are provided).
128
- #
129
- # - Common directory structures are not copied or deleted. We cannot
130
- # copy a directory structure to itself.
131
- #
132
- # - Common directory structures represent the default value to use
133
- # when no specific translations and/or pre-rendition configuration
134
- # script are provided inside source location.
135
- #
136
- # - Specific directory structures, if present, are both copiable and
137
- # removable. This is, when you perform a copy or delete action
138
- # from source, that source specific auxiliar directories are
139
- # transfered in the copy action to a new location (that specified
140
- # by FLAG_TO variable).
141
- #
142
- # - When translations and/or pre-rendition configuration scripts are
143
- # found inside the source directory structure, the centos-art.sh
144
- # script loads common auxiliar directories first and later
145
- # specific auxiliar directories. This way, identity rendition of
146
- # source locations can be customized idividually over the base of
147
- # common default values.
148
- #
149
- # - Specific auxiliar directories are optional.
150
- #
151
- # - Common auxiliar directories should be present always. This, in
152
- # order to provide the information required by render
153
- # functionality (i.e., to make it functional).
154
- #
155
- # Notice that, the duplication process is done from `trunk/Identity'
156
- # on, not the oposite. If you try to duplicate a translation structure
157
- # (or similar auxiliar directory structures like pre-rendition
158
- # configuration scripts), the `trunk/Identity' for that translation is
159
- # not created. This limitation is impossed by the fact that many
160
- # `trunk/Identity' directory structures may reuse/share the same
161
- # translation directory structure. We cannot delete one translation
162
- # (or similar) directory structures while a related `trunk/Identity/'
163
- # directory structure is still in need of it.
164
- #
165
11
# Copyright (C) 2009-2011 Alain Reguera Delgado
166
12
#
167
13
# This program is free software; you can redistribute it and/or