├── .gitattributes ├── .gitignore ├── README.md ├── css ├── normalize.css ├── print.css ├── style.ar_MA.css ├── style.ca_CA.css ├── style.css ├── style.fa_FA.css ├── style.vi_VN.css └── style.zh_TW.css ├── files ├── big.psd ├── git-flow-commands.xml ├── graphs.psd ├── lines.psd ├── new_opener.psd ├── opener_for_graphs.psd └── sprites.sprweb ├── img ├── download.png ├── feature-publish.png ├── feature-pull.png ├── flow-sprites.png ├── git-flow-commands.png ├── git-flow.png ├── hotfix-end.png ├── hotfix-start.png ├── initialize.png ├── lines-big.png ├── lines-close.png ├── lines-open.png └── lines-small.png ├── index.an_AN.html ├── index.ar_MA.html ├── index.az_AZ.html ├── index.ca_CA.html ├── index.de_DE.html ├── index.el_GR.html ├── index.es_ES.html ├── index.fa_FA.html ├── index.fr_FR.html ├── index.hr_HR.html ├── index.html ├── index.hu_HU.html ├── index.id_ID.html ├── index.it_IT.html ├── index.ja_JP.html ├── index.ko_KR.html ├── index.lt_LT.html ├── index.nl_NL.html ├── index.pl_PL.html ├── index.pt_BR.html ├── index.ro_RO.html ├── index.ru_RU.html ├── index.tr_TR.html ├── index.uk_UA.html ├── index.vi_VN.html ├── index.zh_CN.html └── index.zh_TW.html /.gitattributes: -------------------------------------------------------------------------------- 1 | # Set the default behavior, in case people don't have core.autocrlf set. 2 | * text eol=lf 3 | 4 | # Denote all files that are truly binary and should not be modified. 5 | *.png binary 6 | *.psd binary 7 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | .idea/ 2 | # Text editor backup files 3 | *~ 4 | 5 | # Logs 6 | logs 7 | *.log 8 | npm-debug.log* 9 | yarn-debug.log* 10 | yarn-error.log* 11 | 12 | # Runtime data 13 | pids 14 | *.pid 15 | *.seed 16 | *.pid.lock 17 | 18 | # Directory for instrumented libs generated by jscoverage/JSCover 19 | lib-cov 20 | 21 | # Coverage directory used by tools like istanbul 22 | coverage 23 | 24 | # nyc test coverage 25 | .nyc_output 26 | 27 | # Grunt intermediate storage (http://gruntjs.com/creating-plugins#storing-task-files) 28 | .grunt 29 | 30 | # Bower dependency directory (https://bower.io/) 31 | bower_components 32 | 33 | # node-waf configuration 34 | .lock-wscript 35 | 36 | # Compiled binary addons (http://nodejs.org/api/addons.html) 37 | build/Release 38 | 39 | # Dependency directories 40 | node_modules/ 41 | jspm_packages/ 42 | 43 | # Typescript v1 declaration files 44 | typings/ 45 | 46 | # Optional npm cache directory 47 | .npm 48 | 49 | # Optional eslint cache 50 | .eslintcache 51 | 52 | # Optional REPL history 53 | .node_repl_history 54 | 55 | # Output of 'npm pack' 56 | *.tgz 57 | 58 | # Yarn Integrity file 59 | .yarn-integrity 60 | 61 | # dotenv environment variables file 62 | .env 63 | 64 | 65 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | git-flow-cheatsheet 2 | =================== 3 | 4 | A cheatsheet on the usage of git flow, visit http://danielkummer.github.io/git-flow-cheatsheet/ 5 | 6 | GIT FLOW 7 | ======== 8 | 9 | Git extensions to provide high-level repository operations for Vincent Driessen's branching model. [Read more](http://nvie.com/posts/a-successful-git-branching-model/) 10 | 11 | 12 | INIT: 13 | 14 | ``` 15 | $ git flow init 16 | ``` 17 | 18 | #### TRACK DEVELOP REMOTELY ON GITHUB: 19 | 20 | 21 | ``` 22 | $ git push origin develop 23 | ``` 24 | 25 | **FEATURES:** 26 | 27 | Use to develop new features starting from the develop branch. Merge back into 28 | develop branch waiting for a reasonable amount of features to be there before 29 | declaring it a release. 30 | 31 | ``` 32 | $ git flow feature 33 | $ git flow feature start 34 | $ git flow feature finish 35 | ``` 36 | 37 | ``` 38 | usage: git flow feature [list] [-v] 39 | git flow feature start [-F] [] 40 | git flow feature finish [-rFk] 41 | git flow feature publish 42 | git flow feature track 43 | git flow feature diff [] 44 | git flow feature rebase [-i] [] 45 | git flow feature checkout [] 46 | git flow feature pull [] 47 | ``` 48 | 49 | **RELEASES:** 50 | 51 | Use to group together latest development (features) add a few finishing touches 52 | if necessary and send to production. All last changes will merge back to master 53 | and develop so new features will start from current release. 54 | 55 | ``` 56 | $ git flow release 57 | $ git flow release start [] 58 | $ git flow release finish 59 | ``` 60 | ``` 61 | usage: git flow release [list] [-v] 62 | git flow release start [-F] 63 | git flow release finish [-Fsumpk] 64 | git flow release publish 65 | git flow release track 66 | ``` 67 | 68 | **HOTFIXES:** 69 | 70 | Similar to releases but the hotfix branch starts off master to avoid unvoluntary 71 | send to production of unwanted features that my be present in branches. The 72 | quick fix must be used when an important bug arises in production which must be 73 | fixed and can't wait for other features to be ready. It merges back to master 74 | and develop. 75 | 76 | ``` 77 | $ git flow hotfix 78 | $ git flow hotfix start [] 79 | $ git flow hotfix finish 80 | ``` 81 | ``` 82 | usage: git flow hotfix [list] [-v] 83 | git flow hotfix start [-F] [] 84 | git flow hotfix finish [-Fsumpk] 85 | ``` 86 | -------------------------------------------------------------------------------- /css/normalize.css: -------------------------------------------------------------------------------- 1 | /*! normalize.css 2012-07-07T09:50 UTC - http://github.com/necolas/normalize.css */ 2 | 3 | /* ========================================================================== 4 | HTML5 display definitions 5 | ========================================================================== */ 6 | 7 | /* 8 | * Corrects `block` display not defined in IE6/7/8/9 & FF3. 9 | */ 10 | 11 | article, 12 | aside, 13 | details, 14 | figcaption, 15 | figure, 16 | footer, 17 | header, 18 | hgroup, 19 | nav, 20 | section, 21 | summary { 22 | display: block; 23 | } 24 | 25 | /* 26 | * Corrects `inline-block` display not defined in IE6/7/8/9 & FF3. 27 | */ 28 | 29 | audio, 30 | canvas, 31 | video { 32 | display: inline-block; 33 | *display: inline; 34 | *zoom: 1; 35 | } 36 | 37 | /* 38 | * Prevents modern browsers from displaying `audio` without controls. 39 | * Remove excess height in iOS5 devices. 40 | */ 41 | 42 | audio:not([controls]) { 43 | display: none; 44 | height: 0; 45 | } 46 | 47 | /* 48 | * Addresses styling for `hidden` attribute not present in IE7/8/9, FF3, S4. 49 | * Known issue: no IE6 support. 50 | */ 51 | 52 | [hidden] { 53 | display: none; 54 | } 55 | 56 | /* ========================================================================== 57 | Base 58 | ========================================================================== */ 59 | 60 | /* 61 | * 1. Corrects text resizing oddly in IE6/7 when body `font-size` is set using 62 | * `em` units. 63 | * 2. Prevents iOS text size adjust after orientation change, without disabling 64 | * user zoom. 65 | */ 66 | 67 | html { 68 | font-size: 100%; /* 1 */ 69 | -webkit-text-size-adjust: 100%; /* 2 */ 70 | -ms-text-size-adjust: 100%; /* 2 */ 71 | } 72 | 73 | /* 74 | * Addresses `font-family` inconsistency between `textarea` and other form 75 | * elements. 76 | */ 77 | 78 | html, 79 | button, 80 | input, 81 | select, 82 | textarea { 83 | font-family: sans-serif; 84 | } 85 | 86 | /* 87 | * Addresses margins handled incorrectly in IE6/7. 88 | */ 89 | 90 | body { 91 | margin: 0; 92 | } 93 | 94 | /* ========================================================================== 95 | Links 96 | ========================================================================== */ 97 | 98 | /* 99 | * Addresses `outline` inconsistency between Chrome and other browsers. 100 | */ 101 | 102 | a:focus { 103 | outline: thin dotted; 104 | } 105 | 106 | /* 107 | * Improves readability when focused and also mouse hovered in all browsers. 108 | * people.opera.com/patrickl/experiments/keyboard/test 109 | */ 110 | 111 | a:active, 112 | a:hover { 113 | outline: 0; 114 | } 115 | 116 | /* ========================================================================== 117 | Typography 118 | ========================================================================== */ 119 | 120 | /* 121 | * Addresses font sizes and margins set differently in IE6/7. 122 | * Addresses font sizes within `section` and `article` in FF4+, Chrome, S5. 123 | */ 124 | 125 | h1 { 126 | font-size: 2em; 127 | margin: 0.67em 0; 128 | } 129 | 130 | h2 { 131 | font-size: 1.5em; 132 | margin: 0.83em 0; 133 | } 134 | 135 | h3 { 136 | font-size: 1.17em; 137 | margin: 1em 0; 138 | } 139 | 140 | h4 { 141 | font-size: 1em; 142 | margin: 1.33em 0; 143 | } 144 | 145 | h5 { 146 | font-size: 0.83em; 147 | margin: 1.67em 0; 148 | } 149 | 150 | h6 { 151 | font-size: 0.75em; 152 | margin: 2.33em 0; 153 | } 154 | 155 | /* 156 | * Addresses styling not present in IE7/8/9, S5, Chrome. 157 | */ 158 | 159 | abbr[title] { 160 | border-bottom: 1px dotted; 161 | } 162 | 163 | /* 164 | * Addresses style set to `bolder` in FF3+, S4/5, Chrome. 165 | */ 166 | 167 | b, 168 | strong { 169 | font-weight: bold; 170 | } 171 | 172 | blockquote { 173 | margin: 1em 40px; 174 | } 175 | 176 | /* 177 | * Addresses styling not present in S5, Chrome. 178 | */ 179 | 180 | dfn { 181 | font-style: italic; 182 | } 183 | 184 | /* 185 | * Addresses styling not present in IE6/7/8/9. 186 | */ 187 | 188 | mark { 189 | background: #ff0; 190 | color: #000; 191 | } 192 | 193 | /* 194 | * Addresses margins set differently in IE6/7. 195 | */ 196 | 197 | p, 198 | pre { 199 | margin: 1em 0; 200 | } 201 | 202 | /* 203 | * Corrects font family set oddly in IE6, S4/5, Chrome. 204 | * en.wikipedia.org/wiki/User:Davidgothberg/Test59 205 | */ 206 | 207 | code, 208 | kbd, 209 | pre, 210 | samp { 211 | font-family: monospace, serif; 212 | _font-family: 'courier new', monospace; 213 | font-size: 1em; 214 | } 215 | 216 | /* 217 | * Improves readability of pre-formatted text in all browsers. 218 | */ 219 | 220 | pre { 221 | white-space: pre; 222 | white-space: pre-wrap; 223 | word-wrap: break-word; 224 | } 225 | 226 | /* 227 | * Addresses CSS quotes not supported in IE6/7. 228 | */ 229 | 230 | q { 231 | quotes: none; 232 | } 233 | 234 | /* 235 | * Addresses `quotes` property not supported in S4. 236 | */ 237 | 238 | q:before, 239 | q:after { 240 | content: ''; 241 | content: none; 242 | } 243 | 244 | small { 245 | font-size: 75%; 246 | } 247 | 248 | /* 249 | * Prevents `sub` and `sup` affecting `line-height` in all browsers. 250 | * gist.github.com/413930 251 | */ 252 | 253 | sub, 254 | sup { 255 | font-size: 75%; 256 | line-height: 0; 257 | position: relative; 258 | vertical-align: baseline; 259 | } 260 | 261 | sup { 262 | top: -0.5em; 263 | } 264 | 265 | sub { 266 | bottom: -0.25em; 267 | } 268 | 269 | /* ========================================================================== 270 | Lists 271 | ========================================================================== */ 272 | 273 | /* 274 | * Addresses margins set differently in IE6/7. 275 | */ 276 | 277 | dl, 278 | menu, 279 | ol, 280 | ul { 281 | margin: 1em 0; 282 | } 283 | 284 | dd { 285 | margin: 0 0 0 40px; 286 | } 287 | 288 | /* 289 | * Addresses paddings set differently in IE6/7. 290 | */ 291 | 292 | menu, 293 | ol, 294 | ul { 295 | padding: 0 0 0 40px; 296 | } 297 | 298 | /* 299 | * Corrects list images handled incorrectly in IE7. 300 | */ 301 | 302 | nav ul, 303 | nav ol { 304 | list-style: none; 305 | list-style-image: none; 306 | } 307 | 308 | /* ========================================================================== 309 | Embedded content 310 | ========================================================================== */ 311 | 312 | /* 313 | * 1. Removes border when inside `a` element in IE6/7/8/9, FF3. 314 | * 2. Improves image quality when scaled in IE7. 315 | * code.flickr.com/blog/2008/11/12/on-ui-quality-the-little-things-client-side-image-resizing/ 316 | */ 317 | 318 | img { 319 | border: 0; /* 1 */ 320 | -ms-interpolation-mode: bicubic; /* 2 */ 321 | } 322 | 323 | /* 324 | * Corrects overflow displayed oddly in IE9. 325 | */ 326 | 327 | svg:not(:root) { 328 | overflow: hidden; 329 | } 330 | 331 | /* ========================================================================== 332 | Figures 333 | ========================================================================== */ 334 | 335 | /* 336 | * Addresses margin not present in IE6/7/8/9, S5, O11. 337 | */ 338 | 339 | figure { 340 | margin: 0; 341 | } 342 | 343 | /* ========================================================================== 344 | Forms 345 | ========================================================================== */ 346 | 347 | /* 348 | * Corrects margin displayed oddly in IE6/7. 349 | */ 350 | 351 | form { 352 | margin: 0; 353 | } 354 | 355 | /* 356 | * Define consistent border, margin, and padding. 357 | */ 358 | 359 | fieldset { 360 | border: 1px solid #c0c0c0; 361 | margin: 0 2px; 362 | padding: 0.35em 0.625em 0.75em; 363 | } 364 | 365 | /* 366 | * 1. Corrects color not being inherited in IE6/7/8/9. 367 | * 2. Corrects text not wrapping in FF3. 368 | * 3. Corrects alignment displayed oddly in IE6/7. 369 | */ 370 | 371 | legend { 372 | border: 0; /* 1 */ 373 | padding: 0; 374 | white-space: normal; /* 2 */ 375 | *margin-left: -7px; /* 3 */ 376 | } 377 | 378 | /* 379 | * 1. Corrects font size not being inherited in all browsers. 380 | * 2. Addresses margins set differently in IE6/7, FF3+, S5, Chrome. 381 | * 3. Improves appearance and consistency in all browsers. 382 | */ 383 | 384 | button, 385 | input, 386 | select, 387 | textarea { 388 | font-size: 100%; /* 1 */ 389 | margin: 0; /* 2 */ 390 | vertical-align: baseline; /* 3 */ 391 | *vertical-align: middle; /* 3 */ 392 | } 393 | 394 | /* 395 | * Addresses FF3/4 setting `line-height` on `input` using `!important` in the 396 | * UA stylesheet. 397 | */ 398 | 399 | button, 400 | input { 401 | line-height: normal; 402 | } 403 | 404 | /* 405 | * 1. Avoid the WebKit bug in Android 4.0.* where (2) destroys native `audio` 406 | * and `video` controls. 407 | * 2. Corrects inability to style clickable `input` types in iOS. 408 | * 3. Improves usability and consistency of cursor style between image-type 409 | * `input` and others. 410 | * 4. Removes inner spacing in IE7 without affecting normal text inputs. 411 | * Known issue: inner spacing remains in IE6. 412 | */ 413 | 414 | button, 415 | html input[type="button"], /* 1 */ 416 | input[type="reset"], 417 | input[type="submit"] { 418 | -webkit-appearance: button; /* 2 */ 419 | cursor: pointer; /* 3 */ 420 | *overflow: visible; /* 4 */ 421 | } 422 | 423 | /* 424 | * Re-set default cursor for disabled elements. 425 | */ 426 | 427 | button[disabled], 428 | input[disabled] { 429 | cursor: default; 430 | } 431 | 432 | /* 433 | * 1. Addresses box sizing set to content-box in IE8/9. 434 | * 2. Removes excess padding in IE8/9. 435 | * 3. Removes excess padding in IE7. 436 | * Known issue: excess padding remains in IE6. 437 | */ 438 | 439 | input[type="checkbox"], 440 | input[type="radio"] { 441 | box-sizing: border-box; /* 1 */ 442 | padding: 0; /* 2 */ 443 | *height: 13px; /* 3 */ 444 | *width: 13px; /* 3 */ 445 | } 446 | 447 | /* 448 | * 1. Addresses `appearance` set to `searchfield` in S5, Chrome. 449 | * 2. Addresses `box-sizing` set to `border-box` in S5, Chrome (include `-moz` 450 | * to future-proof). 451 | */ 452 | 453 | input[type="search"] { 454 | -webkit-appearance: textfield; /* 1 */ 455 | -moz-box-sizing: content-box; 456 | -webkit-box-sizing: content-box; /* 2 */ 457 | box-sizing: content-box; 458 | } 459 | 460 | /* 461 | * Removes inner padding and search cancel button in S5, Chrome on OS X. 462 | */ 463 | 464 | input[type="search"]::-webkit-search-cancel-button, 465 | input[type="search"]::-webkit-search-decoration { 466 | -webkit-appearance: none; 467 | } 468 | 469 | /* 470 | * Removes inner padding and border in FF3+. 471 | */ 472 | 473 | button::-moz-focus-inner, 474 | input::-moz-focus-inner { 475 | border: 0; 476 | padding: 0; 477 | } 478 | 479 | /* 480 | * 1. Removes default vertical scrollbar in IE6/7/8/9. 481 | * 2. Improves readability and alignment in all browsers. 482 | */ 483 | 484 | textarea { 485 | overflow: auto; /* 1 */ 486 | vertical-align: top; /* 2 */ 487 | } 488 | 489 | /* ========================================================================== 490 | Tables 491 | ========================================================================== */ 492 | 493 | /* 494 | * Remove most spacing between table cells. 495 | */ 496 | 497 | table { 498 | border-collapse: collapse; 499 | border-spacing: 0; 500 | } -------------------------------------------------------------------------------- /css/print.css: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/css/print.css -------------------------------------------------------------------------------- /css/style.ar_MA.css: -------------------------------------------------------------------------------- 1 | body { 2 | direction:rtl; 3 | } 4 | .col-2{ 5 | direction: ltr; 6 | } -------------------------------------------------------------------------------- /css/style.ca_CA.css: -------------------------------------------------------------------------------- 1 | .lines-big { 2 | height: 5030px; 3 | } 4 | -------------------------------------------------------------------------------- /css/style.css: -------------------------------------------------------------------------------- 1 | /*---------------------------------------- Text */ 2 | 3 | body { 4 | background-color: powderblue; 5 | font-family: Georgia, Times New Roman, Times, serif; 6 | font-weight: bold; 7 | font-size: 20px; 8 | text-align: center; 9 | padding: 0; 10 | margin: 0; 11 | } 12 | 13 | header { 14 | box-shadow: 0px 5px 7px #8db7bd; 15 | -webkit-box-shadow: 0px 5px 7px #8db7bd; 16 | -moz-box-shadow: 0px 5px 7px #8db7bd; 17 | /*height: 400px;*/ 18 | background-color: #8db7bd; 19 | border-bottom: 1px solid #698b91 20 | } 21 | 22 | footer { 23 | box-shadow: 0px -5px 7px #8db7bd; 24 | -webkit-box-shadow: 0px -5px 7px #8db7bd; 25 | -moz-box-shadow: 0px -5px 7px #8db7bd; 26 | background-color: #8db7bd; 27 | border-top: 1px solid #698b91; 28 | position: relative; 29 | } 30 | 31 | h1 { 32 | font-size: 100px; 33 | font-weight: normal; 34 | margin: 0; 35 | font-family: 'Sansita One', cursive; 36 | color: #3a7eff; 37 | text-shadow: 0 2px 1px #000; 38 | line-height: 1; 39 | } 40 | 41 | h2 { 42 | font-size: 60px; 43 | font-weight: normal; 44 | margin: 0; 45 | margin-bottom: 25px; 46 | text-shadow: 0 2px 1px #000; 47 | color: #FFB000; 48 | font-family: 'Sansita One', cursive; 49 | } 50 | 51 | h3 { 52 | font-size: 34px; 53 | font-weight: normal; 54 | margin: 0; 55 | color: #D92B00; 56 | text-shadow: 0 2px 1px #000; 57 | font-family: 'Sansita One', cursive; 58 | } 59 | 60 | p { 61 | margin: 20px auto; 62 | text-shadow: none; 63 | color: #222438; 64 | } 65 | 66 | h2 a { 67 | text-decoration: none; 68 | font-size: 60px; 69 | font-weight: normal; 70 | margin: 0; 71 | margin-bottom: 25px; 72 | text-shadow: 0 2px 1px #000; 73 | color: #FFB000; 74 | font-family: 'Sansita One', cursive; 75 | } 76 | 77 | h2 a:hover { 78 | text-decoration: none; 79 | } 80 | 81 | h2 a:visited { 82 | color: #FFB000; 83 | } 84 | 85 | a, a:visited { 86 | color: #D92B00; 87 | font-weight: bold; 88 | font-style: italic; 89 | } 90 | 91 | ul { 92 | list-style: none; 93 | margin-left: 0; 94 | padding-left: 1em; 95 | text-indent: -1em; 96 | text-shadow: none; 97 | line-height: 1.4; 98 | } 99 | 100 | ul li:before { 101 | content: "\2605\a0" 102 | } 103 | 104 | /** coding block */ 105 | blockquote { 106 | text-align: left; 107 | margin: 10px auto; 108 | background: #131420; 109 | border-bottom: 2px solid #30334F; 110 | border-right: 2px solid #30334F; 111 | border-radius: 10px; 112 | padding: 5px 20px; 113 | color: white; 114 | font-family: menlo, monospace; 115 | word-wrap: break-word; 116 | } 117 | 118 | code { 119 | display: inline-block; 120 | font-style: normal; 121 | padding-left: 5px; 122 | border-radius: 10px; 123 | color: white; 124 | padding: 5px 15px; 125 | 126 | background: #131420; 127 | text-shadow: none; 128 | font-size: 0.8em; 129 | } 130 | 131 | /*---------------------------------------- Images */ 132 | 133 | .initialize { 134 | background: url("../img/initialize.png") no-repeat scroll center center transparent; 135 | height: 244px; 136 | width: 100%; 137 | position: relative; 138 | z-index: 99; 139 | margin-left: 10px; 140 | } 141 | 142 | .lines-small { 143 | width: 300px; 144 | height: 150px; 145 | background-repeat: repeat-y; 146 | background: url("../img/lines-small.png"); 147 | position: relative; 148 | left: 11px; 149 | } 150 | 151 | .lines-small-end { 152 | width: 300px; 153 | height: 950px; 154 | background-repeat: repeat-y; 155 | background: url("../img/lines-small.png"); 156 | position: absolute; 157 | left: 361px; 158 | 159 | } 160 | 161 | .lines-big { 162 | width: 300px; 163 | height: 4853px; 164 | background-repeat: repeat-y; 165 | background: url("../img/lines-big.png"); 166 | position: absolute; 167 | left: 360px; 168 | 169 | } 170 | 171 | .lines-open { 172 | width: 300px; 173 | height: 52px; 174 | background: url("../img/lines-open.png"); 175 | position: relative; 176 | left: 11px; 177 | } 178 | 179 | .lines-close { 180 | width: 300px; 181 | height: 52px; 182 | background: url("../img/lines-close.png"); 183 | position: relative; 184 | left: 11px; 185 | } 186 | 187 | .hotfix-end, .hotfix-start, .release-end, .release-start, .feature-end, .feature-start { 188 | display: inline-block; 189 | background-repeat: no-repeat; 190 | background-image: url('../img/flow-sprites.png'); 191 | background-color: rgba(173, 215, 223, 0.8); 192 | border: 2px dashed #008098; 193 | border-radius: 25px; 194 | width: 300px; 195 | height: 222px; 196 | position: relative; 197 | z-index: 99; 198 | 199 | box-shadow: 5px 5px 7px #8db7bd; 200 | -webkit-box-shadow: 5px 5px 7px #8db7bd; 201 | -moz-box-shadow: 5px 5px 7px #8db7bd; 202 | 203 | } 204 | 205 | .feature-publish { 206 | display: inline-block; 207 | background-repeat: no-repeat; 208 | 209 | background-color: rgba(173, 215, 223, 0.8); 210 | border: 2px dashed #008098; 211 | border-radius: 25px; 212 | width: 300px; 213 | height: 120px; 214 | position: relative; 215 | 216 | box-shadow: 5px 5px 7px #8db7bd; 217 | -webkit-box-shadow: 5px 5px 7px #8db7bd; 218 | -moz-box-shadow: 5px 5px 7px #8db7bd; 219 | background-image: url('../img/feature-publish.png'); 220 | background-position: center; 221 | 222 | } 223 | 224 | .feature-pull { 225 | display: inline-block; 226 | background-repeat: no-repeat; 227 | 228 | background-color: rgba(173, 215, 223, 0.8); 229 | border: 2px dashed #008098; 230 | border-radius: 25px; 231 | width: 300px; 232 | height: 120px; 233 | position: relative; 234 | z-index: 99; 235 | margin-left: -21px; 236 | 237 | box-shadow: 5px 5px 7px #8db7bd; 238 | -webkit-box-shadow: 5px 5px 7px #8db7bd; 239 | -moz-box-shadow: 5px 5px 7px #8db7bd; 240 | background-image: url('../img/feature-pull.png'); 241 | background-position: center; 242 | 243 | } 244 | 245 | .hotfix-end { 246 | background-position: 0px 0px; 247 | } 248 | 249 | .hotfix-start { 250 | background-position: 0px -222px; 251 | } 252 | 253 | .release-end { 254 | background-position: 0px -444px; 255 | } 256 | 257 | .release-start { 258 | background-position: 0px -666px; 259 | } 260 | 261 | .feature-end { 262 | background-position: 0px -888px; 263 | } 264 | 265 | .feature-start { 266 | background-position: 0px -1110px; 267 | } 268 | 269 | /*---------------------------------------- BLOCKS */ 270 | 271 | .col-1 { 272 | float: left; 273 | width: 320px; 274 | } 275 | 276 | .col-2 { 277 | float: right; 278 | width: 320px; 279 | margin-left: 30px; 280 | } 281 | 282 | #main { 283 | margin: 0 auto; 284 | position: relative; 285 | width: 670px; 286 | } 287 | 288 | .scrollblock { 289 | width: 100%; 290 | padding-top: 50px; 291 | position: relative; 292 | clear: both; 293 | } 294 | 295 | .divider, .accent { 296 | color: #69697A; 297 | text-shadow: none; 298 | } 299 | 300 | #title { 301 | margin: auto; 302 | padding-top: 40px; 303 | width: 670px; 304 | position: relative; 305 | z-index: 99; 306 | } 307 | 308 | #author { 309 | width: 80%; 310 | top: 230px; 311 | font-size: 20px; 312 | text-align: center; 313 | font-style: italic; 314 | color: #D92B00; 315 | z-index: 100; 316 | } 317 | 318 | .twitter-share-button { 319 | position: relative; 320 | top: 8px; 321 | left: 4px; 322 | } 323 | 324 | #desc { 325 | top: 300px; 326 | width: 90%; 327 | text-align: center; 328 | } 329 | 330 | #translations { 331 | top: 340px; 332 | width: 80%; 333 | right: 5%; 334 | text-align: center; 335 | } 336 | 337 | #translations .active { 338 | text-decoration: none; 339 | cursor: default; 340 | color: #3a7eff; 341 | } 342 | 343 | #disqus_thread { 344 | width: 800px; 345 | text-align: left; 346 | margin-left: auto; 347 | margin-right: auto; 348 | } 349 | 350 | /*---------------------------------------- Github Banner */ 351 | #banner { 352 | height: 149px; 353 | width: 149px; 354 | overflow: hidden; 355 | padding: 0; 356 | margin: 0; 357 | position: absolute; 358 | right: 0; 359 | } 360 | 361 | #banner a { 362 | 363 | display: block; 364 | width: 190px; 365 | font-size: 14px; 366 | font-family: Frutiger, "Frutiger Linotype", Univers, Calibri, "Gill Sans", "Gill Sans MT", "Myriad Pro", Myriad, "DejaVu Sans Condensed", "Liberation Sans", "Nimbus Sans L", Tahoma, Geneva, "Helvetica Neue", Helvetica, Arial, sans serif; 367 | background-color: #333; 368 | color: #FFF; 369 | word-spacing: 2px; 370 | text-decoration: none; 371 | padding: 5px 15px 5px 25px; 372 | 373 | position: relative; 374 | left: 20px; 375 | top: -37px; 376 | text-align: center; 377 | 378 | -moz-transform-origin: 0 0; 379 | -moz-transform: rotate(45deg); 380 | -moz-box-shadow: 1px 1px 5px 1px #666; 381 | 382 | -webkit-transform-origin: 0 0; 383 | -webkit-transform: rotate(45deg); 384 | -webkit-box-shadow: 1px 1px 5px 1px #666; 385 | 386 | -ms-transform-origin: 0 0; 387 | -ms-transform: rotate(45deg); 388 | -ms-box-shadow: 1px 1px 5px 1px #666; 389 | 390 | transform-origin: 0 0; 391 | transform: rotate(45deg); 392 | box-shadow: 1px 1px 5px 1px #666; 393 | 394 | background-image: linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 395 | background-image: -o-linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 396 | background-image: -moz-linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 397 | background-image: -webkit-linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 398 | background-image: -ms-linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 399 | 400 | background-image: -webkit-gradient(linear, left bottom, left top, color-stop(0.03, #000000), color-stop(0.05, #666666), color-stop(0.07, #000000), color-stop(0.93, #000000), color-stop(0.95, #666666), color-stop(0.97, #000000)); 401 | 402 | } 403 | 404 | -------------------------------------------------------------------------------- /css/style.fa_FA.css: -------------------------------------------------------------------------------- 1 | body, h1, h2, h3, h4, h5, h6, span, a, blockquote { 2 | font-family: Vazirmatn,Calibri,sans serif !important; 3 | font-style: normal; 4 | } 5 | 6 | .rtl { 7 | direction: rtl !important; 8 | } 9 | 10 | p, h1, h2, h3, li, ul, span { 11 | direction: rtl !important; 12 | } 13 | 14 | #banner { 15 | left: 0; 16 | } 17 | 18 | #banner a { 19 | display: block; 20 | width: 190px; 21 | font-size: 14px; 22 | font-family: Frutiger, "Frutiger Linotype", Univers, Calibri, "Gill Sans", "Gill Sans MT", "Myriad Pro", Myriad, "DejaVu Sans Condensed", "Liberation Sans", "Nimbus Sans L", Vazirmatn, Geneva, "Helvetica Neue", Helvetica, Arial, sans serif; 23 | background-color: #333; 24 | color: #FFF; 25 | word-spacing: 2px; 26 | text-decoration: none; 27 | padding: 11px 14px 4px 44px; 28 | position: relative; 29 | left: -27px; 30 | top: 128px; 31 | text-align: left; 32 | -moz-transform-origin: 0 0; 33 | -moz-transform: rotate(-45deg); 34 | -moz-box-shadow: 1px 1px 5px 1px #666; 35 | -webkit-transform-origin: 0 0; 36 | -webkit-transform: rotate(-45deg); 37 | -webkit-box-shadow: 1px 1px 5px 1px #666; 38 | -ms-transform-origin: 0 0; 39 | -ms-transform: rotate(-45deg); 40 | -ms-box-shadow: 1px 1px 5px 1px #666; 41 | transform-origin: 0 0; 42 | transform: rotate(-45deg); 43 | box-shadow: 1px 1px 5px 1px #666; 44 | background-image: linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 45 | background-image: -o-linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 46 | background-image: -moz-linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 47 | background-image: -webkit-linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 48 | background-image: -ms-linear-gradient(bottom, #000000 3%, #666666 5%, #000000 7%, #000000 93%, #666666 95%, #000000 97%); 49 | background-image: -webkit-gradient(linear, left bottom, left top, color-stop(0.03, #000000), color-stop(0.05, #666666), color-stop(0.07, #000000), color-stop(0.93, #000000), color-stop(0.95, #666666), color-stop(0.97, #000000)); 50 | } 51 | -------------------------------------------------------------------------------- /css/style.vi_VN.css: -------------------------------------------------------------------------------- 1 | body { 2 | font-family: 'Lora', serif; 3 | } 4 | 5 | h1, h2, h3, 6 | h1 a, h2 a, h3 a { 7 | font-family: 'Baloo Paaji', cursive; 8 | } 9 | -------------------------------------------------------------------------------- /css/style.zh_TW.css: -------------------------------------------------------------------------------- 1 | h1, h2, h3 { 2 | font-family: 'Sansita One', 'Heiti TC', 'Microsoft YaHei', cursive 3 | } 4 | 5 | h1 a, h2 a, h3 a { 6 | font-family: 'Sansita One', 'Heiti TC', 'Microsoft YaHei', cursive 7 | } -------------------------------------------------------------------------------- /files/big.psd: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/files/big.psd -------------------------------------------------------------------------------- /files/git-flow-commands.xml: -------------------------------------------------------------------------------- 1 | -------------------------------------------------------------------------------- /files/graphs.psd: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/files/graphs.psd -------------------------------------------------------------------------------- /files/lines.psd: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/files/lines.psd -------------------------------------------------------------------------------- /files/new_opener.psd: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/files/new_opener.psd -------------------------------------------------------------------------------- /files/opener_for_graphs.psd: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/files/opener_for_graphs.psd -------------------------------------------------------------------------------- /img/download.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/download.png -------------------------------------------------------------------------------- /img/feature-publish.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/feature-publish.png -------------------------------------------------------------------------------- /img/feature-pull.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/feature-pull.png -------------------------------------------------------------------------------- /img/flow-sprites.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/flow-sprites.png -------------------------------------------------------------------------------- /img/git-flow-commands.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/git-flow-commands.png -------------------------------------------------------------------------------- /img/git-flow.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/git-flow.png -------------------------------------------------------------------------------- /img/hotfix-end.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/hotfix-end.png -------------------------------------------------------------------------------- /img/hotfix-start.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/hotfix-start.png -------------------------------------------------------------------------------- /img/initialize.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/initialize.png -------------------------------------------------------------------------------- /img/lines-big.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/lines-big.png -------------------------------------------------------------------------------- /img/lines-close.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/lines-close.png -------------------------------------------------------------------------------- /img/lines-open.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/lines-open.png -------------------------------------------------------------------------------- /img/lines-small.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/danielkummer/git-flow-cheatsheet/6217de3b55f3e7895513058f0bd6993923fc7e2b/img/lines-small.png -------------------------------------------------------------------------------- /index.an_AN.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | git-flow cheatsheet 7 | 8 | 9 | 10 | 11 | 12 | 13 | 27 | 28 | 29 | 30 |
31 | 32 |

git-flow cheatsheet

33 | 34 |

35 | creau por Daniel Kummer 36 | 37 | 46 |

47 |

ramificazions efiziens usando git-flow, por Vincent Driessen

48 |

traduzions: 49 | English - 50 | Castellano - 51 | Brazilian Portugues - 52 | 繁體中文(Traditional Chinese) - 53 | 简体中文(Simplified Chinese) - 54 | 日本語 - 55 | 한국어(Korean) - 56 | Français - 57 | Magyar(Hungarian) - 58 | Italiano - 59 | Nederlands - 60 | Русский (Russian) - 61 | Deutsch (German) - 62 | Català (Catalan) - 63 | Română (Romanian) - 64 | Ελληνικά (Greek) - 65 | Українська (Ukrainian) - 66 | Tiếng Việt (Vietnamese) - 67 | Polski - 68 | العربية - 69 | فارسی - 70 | Azərbaycanca (Azerbaijani) 71 | Bahasa Indonesia 72 | Aragonés 73 |

74 |
75 | 76 |
77 | 78 | 79 |
80 |

Sobre git-flow

81 | 82 |

83 | git-flow ye un conchunto d'estensions ta git que furnen comandos d'alto libel ta operar repositorios 84 | basaus en o modelo de ramificazions de Vincent 85 | Driessen. 86 | más 87 |

88 |

★ ★ ★

89 | 90 |

Ista fuella de referenzia esplica as operazions basicas de git-flow, os comandos e os suyos efeutos.

91 | 92 |

★ ★ ★

93 |
94 | 95 |
96 |

Consellos basicos

97 |
    98 |
  • Git flow furne una eszelén aduya en a linia de comandos e informazión. Lée con atenzión o que suzede...
    • 99 |
  • O clién ta OSX/Windows Sourcetree ye una eszelén GUI ta git e tiene suporte ta git-flow 100 |
    • 101 |
  • - Git-flow funziona basando-se en fusions de ramas (merge). No reorganiza (branch rebase) as ramas de carauteristicas (feature branches).
    • 102 |
103 |

★ ★ ★

104 |
105 | 106 | 107 |
108 |

Configuración

109 |
    110 |
  • Un prerequisito ye una instalazión de git en funzionamiento.
    • 111 |
  • Git flow funziona en macOS, Linux e Windows
    • 112 |
113 |

★ ★ ★

114 |
115 |

macOS

116 | Homebrew 117 |
118 | $ brew install git-flow-avh 119 |
120 | Macports 121 |
122 | $ port install git-flow-avh 123 |
124 |

Linux

125 |
126 | $ apt-get install git-flow 127 |
128 |

Windows (Cygwin)

129 |
130 | $ wget -q -O - --no-check-certificate 131 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash 132 |
133 |

Amenesterás wget e util-linux ta instalar git-flow.

134 |
135 |
136 |

137 | Ta instruzions d'instalazión detalladas, por favor, vesite a wiki de git flow 138 |

139 | install git-flow 140 |
141 |
142 | 143 |
144 |

Introduzión

145 |

Git flow ameneste estar inizializau ta poder alterar a configurazión d'o proyeuto.

146 |

★ ★ ★

147 |
148 |

Inizializazión

149 | 150 |

Encomenze a usar git-flow inizializando-lo dende dentro d'un repositorio git existén:

151 |
152 | git flow init 153 |
154 |

155 | Abrá de contestar cualques preguntas relazionadas con as convenzions de nombres ta las ramas.
156 | Se recomienda fer servir as valors predeterminadas. 157 |

158 | 159 |
160 |
161 |
162 |
163 |
164 |
165 |
166 |
167 | 168 | 169 |
170 |

carauteristicas

171 | 172 |
    173 |
  • Desembolicar carauteristicas ta futuras versions
    • 174 |
  • Ye tipico que nomás s'use en os repositorios ta desembolique
    • 175 |
176 |

★ ★ ★

177 | 178 |
179 |

Encomenzar una nueva carauteristica

180 |

O desembolique de nuevas carauteristicas parte d'a rama 'develop'.

181 |

Encomienze una nueva carauteristica fendo servir

182 |
183 | git flow feature start MYFEATURE 184 |
185 |

Ista azión creya una nueva rama derivada de 'develop' e cambea a ista, establindo-la como rama de treballo autual.

186 | 187 | 197 |
198 |
199 |
200 |
201 |
202 | 203 |
204 |
205 |

Rematar una carauteristica

206 | 207 |

208 | Remata o desembolique d'una carauteristica. 209 | Ista azión realiza lo siguién: 210 |

211 |
    212 |
  • Fusiona MYFEATURE en 'develop'
    • 213 |
  • Borra a rama MYFEATURE
    • 214 |
  • Cambea a la rama 'develop', establindo-la como rama de treballo autual
    • 215 |
216 | 217 |
218 | git flow feature finish MYFEATURE 219 |
220 |
221 |
222 |
223 |
224 |
225 | 226 |
227 |
228 |

Publicar una carauteristica

229 | 230 |

231 | Yes treballando de conchunta?
232 | Publica una carauteristica a un servidor remoto para que asinas pueda estar vista por atros. 233 |

234 | 235 |
236 | git flow feature publish MYFEATURE 237 |
238 |
239 |
240 |
241 |
242 |
243 | 244 |
245 |
246 |

Obtenendo carauteristicas publicadas

247 | 248 |

249 | Obten una carauteristica publicada por unatro. 250 |

251 | 252 |
253 | git flow feature pull origin MYFEATURE 254 |
255 | 256 |

257 | Puez mantener un seguimiento d'os suyos cambeos usando. 258 |

259 |
260 | git flow feature track MYFEATURE 261 |
262 | 263 |
264 |
265 |
266 |
267 |
268 | 269 | 270 |
271 |

Publicar una versión

272 | 273 |
    274 |
  • Para una versión ta produzión
    • 275 |
  • Permite apaños menors e a preparazión d'os metadatos ta la publicazión
    • 276 |
277 |

★ ★ ★

278 |
279 |

Encomenzar una publicazión

280 | 281 |

Ta encomenzar una publicazión, usa o comando git flow release. creyará 282 | una rama de publicazión derivada d'a rama 'develop'. 283 |

284 |
285 | git flow release start RELEASE [BASE] 286 |
287 |

Opzionalmén, puedes usar [BASE] indicando o codigo sha-1 d'o cambeo dende o cual encomenzar a versión de 288 | publicazión. O cambeo ha d'estar parte d'a rama 'develop'.

289 |

★ ★ ★

290 |

Ye apropiau publicar remotamén a rama de publicazión dimpués de creyar-la ta permitir que atros desembolicadors invíen cambeos ta ista versión. Fe-lo de forma similar a publicar carauteristicas:

291 |
292 | git flow release publish RELEASE 293 |
294 |

295 | (Puedes establir o seguimiento d'os cambeos d'a publicazión remota utilizando o siguién comando) 296 |

297 |

298 | git flow release track RELEASE 299 |
300 |
301 |
302 |
303 |
304 |
305 | 306 |
307 |
308 |

Concluyir una publicazión

309 | 310 |

Dar tancadura a una publicazión ye un gran trango. Realiza varias azions:

311 |
    312 |
  • Fusiona a rama d'a publicazión con a rama 'master'
    • 313 |
  • Etiqueta o cambeo con o suyo nombre
    • 314 |
  • Torna a fusionar a publicazión con a rama 'develop'
    • 315 |
  • Borra a rama d'a publicazión
    • 316 |
317 |
318 | git flow release finish RELEASE 319 |
320 |

321 | No xublides añadir as tags con git push --tags 322 |

323 | 324 |
325 |
326 |
327 | 328 |
329 |
330 | 331 |
332 |

Revisiones

333 | 334 |
    335 |
  • As revisions surten d'a nezesidat d'actuar immediatamén cuan a versión executando-se en produzión se troba en un estau que no deseyamos 336 |
    • 337 |
  • Puedes ramificar-se dende a versión correspondién etiquetada en a rama 'master' que corresponda a la versión en produzión.
    • 338 |
339 |

★ ★ ★

340 |
341 |

git flow hotfix start

342 | 343 |

Como atros comandos de git flow, una revisión s'ubre con

344 |
345 | git flow hotfix start VERSION [BASENAME] 346 |
347 |

L'argumento d'a versión determina o nombre d'a revisión. Opzionalmén, puedes adibir un nombre ta la base dende a cuala encomenzar.

348 |
349 |
350 |
351 |
352 |
353 | 354 |
355 |
356 |

Zarra una revisión

357 | 358 |

En zarrar una revisión, ista se fusiona en as ramas 'develop' e 'master'. Luego, o cambeo en 'master' ye etiquetado con o nombre d'a revisión.

359 |
360 | git flow hotfix finish VERSION 361 |
362 |
363 |
364 |
365 |
366 |
367 | 368 |
369 |
370 |
371 |
372 |
373 |
374 |
375 | 376 | 377 |
378 |

Comandos

379 | git-flow commands 380 |
381 | 382 |
383 |

Fayenas pendiens

384 |

★ ★ ★

385 |
    386 |
  • Aquí no s'han cubierto toz os comandos disponibles, nomás os más importans
    • 387 |
  • Agún puedes usar toz os comandos de git normals tal como los conoxes, git-flow nomás ye una ferramienta más que puez adibir a la tuya colezión. 388 |
    • 389 |
  • A carauteristica 'support' agún ista en fase beta e no se recomienda usar-la
    • 390 |
  • Si quieres furnir traduzions, serán bien rezibidas.
    • 391 |
392 |

★ ★ ★

393 |
394 |
395 | 396 | 403 | 404 | 417 | 419 | comments powered by Disqus 420 | 421 | 422 | 423 | -------------------------------------------------------------------------------- /index.ar_MA.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | git-flow cheatsheet 7 | 12 | 18 | 24 | 30 | 31 | 48 | 49 | 50 | 55 |
56 |

git-flow cheatsheet

57 | 58 |

59 | طور من طرف  Daniel Kummer  62 | 69 | 70 | 82 |

83 |

84 | كفاءة المتفرعة باستخدام git-flow من قبل 85 | Vincent Driessen 86 |

87 |

88 | الترجمات: English - 89 | Castellano - 90 | Brazilian Portugues 93 | - 94 | 繁體中文(Traditional Chinese) 97 | - 98 | 简体中文(Simplified Chinese) 101 | - 日本語 - 102 | Türkçe - 103 | 한국어(Korean) - 104 | Français - 105 | Magyar(Hungarian) - 106 | Italiano - 107 | Nederlands - 108 | Русский (Russian) - 109 | Deutsch (German) - 110 | Català (Catalan) - 111 | Română (Romanian) - 112 | Ελληνικά (Greek) 113 | - 114 | Українська (Ukrainian) 115 | - 116 | Tiếng Việt (Vietnamese) 119 | - Polski - 120 | العربية - 121 | فارسی - 122 | Bahasa Indonesia 123 |

124 |
125 | 126 |
127 |
128 |

حول

129 | 130 |

131 | git-flow هي إضافات لـ git لتوفير عمليات متطورة على المستودع لنموذج 132 | الفروع لفانسين دريسنز. 133 | للمزيد 138 |

139 |

★ ★ ★

140 | 141 |

هذه المذكرة تشرح أساسيات استعمال عمليات git-flow وتأثيراتها.

142 | 143 |

★ ★ ★

144 |
145 | 146 |
147 |

نصائح أساسية

148 |
    149 |
  • 150 | أوامر ومخرجات الـ git-flow توفر تسهيلات مهمة جدا. إقرأها بعناية لكي 151 | تفهم ماذا يحدث... 152 |
    • 153 |
  • 154 | يعتبر تطبيق الـ macOS/Windows 155 | سورستري 156 | واجهة مستخدم ممتازة لـ git الذي يدعم git-flow. 157 |
    • 158 |
  • 159 | Git-flow هي حل مبني على عمليات الدمج. التي لاتترك قاعدة على الفروع 160 | الوظيفية. 161 |
    • 162 |
163 |

★ ★ ★

164 |
165 | 166 |
167 |

التنصيب

168 |
    169 |
  • تحتاج إلى تنصيب git متوفر كشرط أساسي.
    • 170 |
  • Git flow يعمل في كل من macOS، الينوكس والويندوز.
    • 171 |
172 |

★ ★ ★

173 |
174 |

macOS

175 | Homebrew 176 |
$ brew install git-flow-avh
177 | Macports 178 |
$ port install git-flow-avh
179 |

لينُكس

180 |
$ apt-get install git-flow
181 |

ويندوز (Cygwin)

182 |
183 | $ wget -q -O - --no-check-certificate 184 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh 185 | install stable | bash 186 |
187 |

ستحتاج إلى wget و util-linux لكي تقوم بتنصيب git-flow.

188 |
189 |
190 |

191 | لتفسير مفصل عن التنصيب زر موقع 192 | git flow wiki. 196 |

197 | install git-flow 198 |
199 |
200 | 201 |
202 |

203 | الشروع في العمل 204 |

205 |

206 | Git flow .يحتاج للتهييئة كي تخصص تنصيب مشروعك 207 |

208 |

★ ★ ★

209 |
210 |

التهييئة

211 | 212 |

ابدأ باستعمال git-flow عن طريق التهييئة داخل مستودع git موفر.

213 |
git flow init
214 |

215 | ستحتاج إلى الإجابة عن بعض الأسئلة المتعلقة بنظام تسمية فروعك.
216 | من المستحسن استخدام القيم الافتراضية. 217 |

218 |
219 |
220 |
221 |
222 |
223 |
224 |
225 |
226 | 227 |
228 |

ميزات Features

229 | 230 |
    231 |
  • طور ميزات جديدة للإصدارات القادمة.
    • 232 |
  • توجد عادة في مستودع المبرمجين فقط.
    • 233 |
234 |

★ ★ ★

235 | 236 |
237 |

بدء ميزة جديدة

238 |

تبدأ عملية برمجة ميزات جديدة انطلاقا من فرع 'develop'.

239 |

إبدأ عملية برمجة ميزة جديدة بتنفيذ الأمر

240 |
git flow feature start MYFEATURE
241 |

242 | هذه العملية تصنع فرع ميزة جديد انطلاقا من فرع 'develop' وينتقل إليه. 243 |

244 | 245 |
255 |
256 |
257 |
258 |
259 | 260 |
261 |
262 |

إتمام الميزة

263 | 264 |

إتمام تطوير ميزة. هذه العملية تقوم بتنفيذ ما يلي:

265 |
    266 |
  • دمج MYFEATURE نحو فرع 'develop'
    • 267 |
  • تحذف فرع الميزة.
    • 268 |
  • تحول إلى فرع 'develop'
    • 269 |
270 | 271 |
git flow feature finish MYFEATURE
272 |
273 |
274 |
275 |
276 |
277 | 278 |
279 |
280 |

نشر ميزة

281 | 282 |

283 | هل تقوم بتطوير ميزة بالتعاون مع مجموعة مبرمجين؟ 284 |
285 | أنشر الميزة إلى نطاق السيرفر لكي يستطيع بقية المبرمجين استخدامها. 286 |

287 | 288 |
git flow feature publish MYFEATURE
289 |
290 |
291 |
292 |
293 |
294 | 295 |
296 |
297 |

الحصول على ميزة منشورة

298 | 299 |

الحصول على ميزة منشورة من طرف مستخدم آخر.

300 | 301 |
git flow feature pull origin MYFEATURE
302 | 303 |

304 | يمكنك تتبع ميزة على الأصل باستخدام 305 | git flow feature track MYFEATURE 306 |

307 |
308 |
309 |
310 |
311 |
312 | 313 |
314 |

315 | 316 | اصنع إصدارا Release 318 |

319 | 320 |
    321 |
  • دعم إعداد إنتاج اصدار جديد.
    • 322 |
  • السماح باصلاحات أخطاء طفيفة وإعداد بيانات وصفية لإصدار.
    • 323 |
324 |

★ ★ ★

325 |
326 |

إبدأ الإصدار

327 | 328 |

329 | لكي تبدأ إصدارا استخدم أوامر الإصدار لـ git flow. أنشىء فرع إصدار 330 | إنطلاقا من فرع 'develop' 331 |

332 |
333 | git flow release start RELEASE [BASE] 334 |
335 |

336 | يمكنك اختياريا اضافة التوريد [BASE] ايداع sha-1 hash كي 337 | تبدأ من خلالها الإصدار. الإيداع يجب أن يكون في فرع 'develop' 338 |

339 |

★ ★ ★

340 |

341 | من الأفضل نشر فرع الإصدار بعد إنشائه للسماح للمبرمجين بإيداع 342 | الإصدار. قم بنفس الشيء للميزات المنشورة باستخدام الأمر: 343 |

344 |
git flow release publish RELEASE
345 |

346 | يمكنك متابعة الاصدار على السرفر باستخدام
git flow release track RELEASE 349 |

350 |
351 |
352 |
353 |
354 |
355 | 356 |
357 |
358 |

إتمام إصدار

359 | 360 |

إتمام إصدار هي من أهم الخطوات في فروع git.

361 |
    362 |
  • دمج فرع الإصدار نحو فرع 'master'
    • 363 |
  • تسمية فرع الإصدار باسمه.
    • 364 |
  • رجع دمج فرع الإصدار نحو فرع 'develop'
    • 365 |
  • حذف فرع الإصدار
    • 366 |
367 |
git flow release finish RELEASE
368 |

لا تنسى دفع مسمياتك بتنفيذgit push --tags

369 |
370 |
371 |
372 |
373 |
374 | 375 |
376 |

الإصلاحات Hotfixes

377 | 378 |
    379 |
  • 380 | تنشأ الإصلاحات من ضرورة العمل فورا على حالة غير مرغوب فيها من نسخة 381 | الانتاج الحية. 382 |
    • 383 |
  • 384 | يمكن الاعتماد على تسمية فرع الإنتاج 'master' لإشارة على نسخة الإنتج 385 | الحية. 386 |
    • 387 |
388 |

★ ★ ★

389 |
390 |

بدأ إصلاح

391 | 392 |

كمثل أوامر git flow الأخرى تبدأ إصلاح بالأمر:

393 |
git flow hotfix start VERSION [BASENAME]
394 |

395 | يمثل المعامل VERSION اسم الإصلاح الجديد. اختياريا يمكنك تحديد 396 | basename أي إصدار يطبق الإصلاح. 397 |

398 |
399 |
400 |
401 |
402 |
403 | 404 |
405 |
406 |

إنهاء الإصلاح

407 | 408 |

409 | عند الانتهاء من الإصلاح فإنه يتم دمجها نحو develop و master. 410 | بالإضافة إلى ذلك يتم تسمية دمج master بنسخة الإصلاح. 411 |

412 |
git flow hotfix finish VERSION
413 |
414 |
415 |
416 |
417 |
418 | 419 |
420 |
421 |
422 |
423 |
424 |
425 |
426 | 427 |
428 |

الأوامر

429 | git-flow commands 430 |
431 | 432 |
433 |

الأعمال المعلقة

434 |

★ ★ ★

435 |
    436 |
  • ليست كل الأوامر مذكورة هنا، فقط الأساسية.
    • 437 |
  • 438 | يمكنك الاستمرار في استخدام git وجميع الأوامر بشكل طبيعي كما عاهدتهم، 439 | git flow ليست سوى مجموعة أدوات 440 |
    • 441 |
  • ميزة "دعم" لا تزال بيتا، لا ينصح باستخدامها.
    • 442 |
  • إذا كنت تريد إضافة ترجمة لهذه الوثيقة، سوف أدرجها بكل سرور.
    • 443 |
444 |

★ ★ ★

445 |
446 |
447 | 448 | 455 | 456 | 472 | 476 | comments powered by Disqus 479 | 480 | 481 | -------------------------------------------------------------------------------- /index.fr_FR.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | git-flow cheatsheet 7 | 8 | 9 | 10 | 11 | 12 | 13 | 27 | 28 | 29 | 30 |
31 | 32 |

git-flow cheatsheet

33 | 34 |

35 | créé par Daniel Kummer 36 | 37 | 46 |

47 |

modèle de versionnement efficace utilisant git-flow par Vincent Driessen

48 |

traductions: 49 | English - 50 | Castellano - 51 | Brazilian Portugues - 52 | 繁體中文(Traditional Chinese) - 53 | 简体中文(Simplified Chinese) - 54 | 日本語 - 55 | Türkçe - 56 | 한국어(Korean) - 57 | Français - 58 | Magyar(Hungarian) - 59 | Italiano - 60 | Nederlands - 61 | Русский (Russian) - 62 | Deutsch (German) - 63 | Català (Catalan) - 64 | Română (Romanian) - 65 | Ελληνικά (Greek) - 66 | Українська (Ukrainian) - 67 | Tiếng Việt (Vietnamese) - 68 | Polski - 69 | العربية - 70 | فارسی - 71 | Azərbaycanca (Azerbaijani) 72 | Bahasa Indonesia 73 |

74 |
75 | 76 |
77 | 78 | 79 |
80 |

À propos

81 | 82 |

83 | git-flow est un ensemble d'extensions git permettant des opérations de haut niveau sur un dépôt pour appliquer le modèle de branches de Vincent Driessen. 84 | détails 85 |

86 |

★ ★ ★

87 | 88 |

Cet aide-mémoire montre l'utilisation et les effets des opérations git-flow

89 | 90 |

★ ★ ★

91 |
92 | 93 |
94 |

Conseils de base

95 |
    96 |
  • Les commandes et sorties de Git-flow apportent une aide précieuse. Lisez-les attentivement pour comprendre ce qui se passe…
    • 97 |
  • Le logiciel pour macOS Sourcetree est une excellente interface graphique pour git qui supporte git-flow. 98 |
    • 99 |
  • Git-flow est une solution basée sur les fusions (merge). Elle n'effectue pas de rebase sur les branches de fonctionnalitées
    • 100 |
101 |

★ ★ ★

102 |
103 | 104 | 105 |
106 |

Installation

107 |
    108 |
  • Une installation fonctionnelle de git est requise
    • 109 |
  • Git flow fonctionne sur macOS, Linux et Windows
    • 110 |
111 |

★ ★ ★

112 |
113 |

macOS

114 | Homebrew 115 |
116 | $ brew install git-flow-avh 117 |
118 | Macports 119 |
120 | $ port install git-flow-avh 121 |
122 |

Linux

123 |
124 | $ apt-get install git-flow 125 |
126 |

Windows (Cygwin)

127 |
128 | $ wget -q -O - --no-check-certificate 129 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash 130 |
131 |

Vous aurez besoin de wget et de util-linux pour installer git-flow.

132 |
133 |
134 |

135 | Pour des instructions détaillées concernant l'installation de git-flow, consultez le 136 | wiki git-flow. 137 |

138 | install git-flow 139 |
140 |
141 | 142 |
143 |

Premiers pas

144 |

Git flow doit être initialisé afin de personnaliser la configuration de votre projet.

145 |

★ ★ ★

146 |
147 |

Initialisation

148 | 149 |

Commencez à utiliser git-flow en l'initialisant dans un dépôt git existant :

150 |
151 | git flow init 152 |
153 |

154 | Vous devrez répondre à quelques questions concernant les conventions de nommage pour vos branches.
155 | Il est recommandé d'utiliser les valeurs par défaut. 156 |

157 | 158 |
159 |
160 |
161 |
162 |
163 |
164 |
165 |
166 | 167 | 168 |
169 |

Fonctionnalités/Features

170 | 171 |
    172 |
  • Développe des nouvelles fonctionnalités pour la prochaine version
    • 173 |
  • Existe en général uniquement dans les dépôts des développeurs
    • 174 |
175 |

★ ★ ★

176 | 177 |
178 |

Commencer une feature

179 |

Le développement d'une fonctionnalité commence à partir de la branche 'develop'

180 |

Commencer le développement d'une nouvelle fonctionnalité avec :

181 |
182 | git flow feature start MYFEATURE 183 |
184 |

Cette commande crée une nouvelle branche de fonctionnalité basée sur 'develop' et passe sur cette branche

185 | 186 | 196 |
197 |
198 |
199 |
200 |
201 | 202 |
203 |
204 |

Terminer une fonctionnalité

205 |

206 | Termine le développement d'une fonctionnalité. 207 | Cette action effectue les opérations suivantes: 208 |

209 |
    210 |
  • Fusionne MYFEATURE dans 'develop'
    • 211 |
  • Supprime la branche de fonctionnalité
    • 212 |
  • Passe sur la branche 'develop'
    • 213 |
214 | 215 |
216 | git flow feature finish MYFEATURE 217 |
218 |
219 |
220 |
221 |
222 |
223 | 224 |
225 |
226 |

Publier une fonctionnalité

227 | 228 |

229 | Vous développez une fonctionnalité en collaboration?
230 | Publiez une fonctionnalité sur le serveur distant pour qu'elle puisse être utilisée par d'autres utilisateurs. 231 |

232 | 233 |
234 | git flow feature publish MYFEATURE 235 |
236 |
237 |
238 |
239 |
240 |
241 | 242 |
243 |
244 |

Récupérer une fonctionnalité publiée

245 | 246 |

247 | Récupérer une fonctionnalité publiée par un autre utilisateur 248 |

249 | 250 |
251 | git flow feature pull origin MYFEATURE 252 |
253 | 254 |

Vous pouvez suivre une fonctionnalité sur le serveur distant en utilisant git flow feature track MYFEATURE

255 |
256 |
257 |
258 |
259 |
260 | 261 | 262 |
263 |

Livraison/Release

264 | 265 |
    266 |
  • Prépare la sortie d'une nouvelle version de production
    • 267 |
  • Permet les corrections de bugs mineurs et la préparation des métadonnées de la release
    • 268 |
269 |

★ ★ ★

270 |
271 |

Commencer une livraison

272 | 273 |

Pour commencer une livraison, utilisez la commande git-flow release

274 | Créer une branche de livraison basée sur la branche de développement. 275 |

276 |
277 | git flow release start RELEASE [BASE] 278 |
279 |

Vous pouvez si besoin ajouter le paramètre [BASE], correspondant au hash d'un commit à partir duquel commencera la livraison. Ce commit doit faire partie de la branche de développement.

280 |

★ ★ ★

281 |

Il est préférable de publier la branche de livraison après l'avoir créée pour permettre aux autres développeurs de commiter dessus. De la même manière que pour les fonctionnalités, utilisez cette commande:

282 |
283 | git flow release publish RELEASE 284 |
285 |

Vous pouvez suivre une livraison sur le serveur distant en utilisant
git flow release track RELEASE

286 |
287 |
288 |
289 |
290 |
291 | 292 |
293 |
294 |

Terminer une livraison

295 | 296 |

Terminer une livraison est une des étapes majeures de cette méthode. Plusieurs actions sont réalisées :

297 |
    298 |
  • Fusionne la branche de livraison dans la branche 'master'
    • 299 |
  • Etiquette (tag) la livraison par son nom
    • 300 |
  • Fusionne la livraison dans la branche 'develop'
    • 301 |
  • Supprime la branche de livraison
    • 302 |
303 |
304 | git flow release finish RELEASE 305 |
306 |

N'oubliez pas de pousser vos étiquettes (tags) avec git push --tags

307 | 308 |
309 |
310 |
311 | 312 |
313 |
314 | 315 |
316 |

Correctifs/Hotfixes

317 | 318 |
    319 |
  • Les correctifs sont utiles quand il est nécessaire de corriger immédiatement l'état incorrect de la version en production 320 |
    • 321 |
  • Ils peuvent se baser sur l'étiquette de la branche 'master' indiquant la version en production.
    • 322 |
323 |

★ ★ ★

324 |
325 |

Commencer un hotfix

326 | 327 |

Comme pour les autres commandes git-flow, un hotfix est commencé par

328 |
329 | git flow hotfix start VERSION [BASE] 330 |
331 |

Ici, le paramètre VERSION indique le nom de la future release corrective. Vous pouvez si besoin spécifier le paramètre [BASE], correspondant au hash d'un commit ou au nom d'une branche à partir duquel s'appliquera le hotfix.

332 |
333 |
334 |
335 |
336 |
337 | 338 |
339 |
340 |

Terminer un hotfix

341 | 342 |

En terminant un hotfix, il est fusionné dans les branches 'develop' et 'master'. De plus la fusion vers 'master' est etiquetée par la version du hotfix.

343 |
344 | git flow hotfix finish VERSION 345 |
346 |
347 |
348 |
349 |
350 |
351 | 352 |
353 |
354 |
355 |
356 |
357 |
358 |
359 | 360 | 361 |
362 |

Commandes

363 | git-flow commands 364 |
365 | 366 |
367 |

En complément

368 |

★ ★ ★

369 |
    370 |
  • Toutes les commandes disponibles ne sont pas abordées ici, seulement les principales
    • 371 |
  • Vous pouvez toujours utiliser normalement git et toutes ses commandes telles que vous les connaissez, git flow est seulement un ensemble d'outils supplémentaires 372 |
    • 373 |
  • La fonction 'support' est encore en version bêta, il n'est pas conseillé de l'utiliser
    • 374 |
  • Si vous voulez ajouter des traductions de ce document, je les intégrerai avec plaisir
    • 375 |
376 |

★ ★ ★

377 |
378 |
379 | 380 | 381 | 382 | 389 | 390 | 403 | 405 | comments powered by Disqus 406 | 407 | 408 | 409 | 410 | -------------------------------------------------------------------------------- /index.id_ID.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | Rujukan git-flow 7 | 8 | 9 | 10 | 11 | 12 | 13 | 27 | 28 | 29 | 30 |
31 | 32 |

Rujukan
git-flow

33 | 34 |

35 | dibuat oleh: Daniel Kummer 36 | 37 | 46 |

47 |

menerapkan cabang (branch) yang efisien menggunakan git-flow oleh Vincent Driessen

48 |

Terjemahan: 49 | English - 50 | Castellano - 51 | Português Brasileiro - 52 | 繁體中文(Traditional Chinese) - 53 | 简体中文(Simplified Chinese) - 54 | 日本語 - 55 | Türkçe - 56 | 한국어(Korean) - 57 | Français - 58 | Magyar(Hungarian) - 59 | Italiano - 60 | Nederlands - 61 | Русский (Russian) - 62 | Deutsch (German) - 63 | Català (Catalan) - 64 | Română (Romanian) - 65 | Ελληνικά (Greek) - 66 | Українська (Ukrainian) - 67 | Tiếng Việt (Vietnamese) - 68 | Polski - 69 | العربية - 70 | فارسی - 71 | Lietuviškai (Lithuanian) - 72 | Azərbaycanca (Azerbaijani) - 73 | Bahasa Indonesia 74 |

75 |
76 | 77 |
78 | 79 | 80 |
81 |

Tentang git-flow

82 | 83 |

84 | git-flow adalah sebuah ekstensi git untuk menyediakan operasi repositori tingkat tinggi 85 | untuk model percabangan (branching model) Vincent Driessen. 86 | baca lebih lanjut 87 |

88 |

★ ★ ★

89 | 90 |

Rujukan ini menunjukan dasar penggunaan dan efek dari operasi git-flow

91 | 92 |

★ ★ ★

93 |
94 | 95 |
96 |

Tips dasar

97 |
    98 |
  • Git flow menyediakan bantuan command line yang sangat baik. Baca perlahan untuk melihat apa yang terjadi
    • 99 |
  • Sourcetree adalah salah satu program yang sangat baik untuk program git berbasis tampilan yang menyediakan dukungan git flow untuk macOS/Windows
    • 100 |
  • Git-flow adalah solusi berbasis merge. Ini tidak me-rebase fitur branch.
    • 101 |
102 |

★ ★ ★

103 |
104 | 105 | 106 |
107 |

Setup

108 |
    109 |
  • Sebagai prasyarat, anda diharuskan memasang/menginstal git
    • 110 |
  • Git flow dapat bekerja pada macOS, Linux dan Windows
    • 111 |
112 |

★ ★ ★

113 |
114 |

macOS

115 | Homebrew 116 |
117 | $ brew install git-flow-avh 118 |
119 | Macports 120 |
121 | $ port install git-flow-avh 122 |
123 |

Linux

124 |
125 | $ apt-get install git-flow 126 |
127 |

Windows (Cygwin)

128 |
129 | $ wget -q -O - --no-check-certificate 130 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash 131 |
132 |

Anda membutuhakn wget dan util-linus untuk menginstal git-flow.

133 |
134 |
135 |

136 | Untuk detil instruksi pemasangan git flow kunjungi git flow 137 | wiki. 138 |

139 | install git-flow 140 |
141 |
142 | 143 |
144 |

Mulai

145 |

Git flow membutuhkan inisialisasi untuk menyesuaikan dengan proyek anda.

146 |

★ ★ ★

147 |
148 |

Inisialisasi

149 | 150 |

Mulai menggunakan git-flow dengan menginisialisasi dalam repositori git yang sudah ada:

151 |
152 | git flow init 153 |
154 |

155 | Anda akan diharuskan untuk menjawab beberapa pertanyaan mengenai konvensi nama untuk branch anda.
156 | Sangat direkomendasikan untuk menggunakan nilai bawaan. 157 |

158 | 159 |
160 |
161 |
162 |
163 |
164 |
165 |
166 |
167 | 168 | 169 |
170 |

Fitur

171 | 172 |
    173 |
  • Mengembangkan fitur baru untuk rilis selanjutnya
    • 174 |
  • Khususnya hanya dalam repositori yang sudah ada sebelumnya
    • 175 |
176 |

★ ★ ★

177 | 178 |
179 |

Mulai sebuah fitur baru

180 |

Pengembangan fitur baru dimulai dari branch 'develop'.

181 |

Mulai pengembangan sebuah fitur baru dengan

182 |
183 | git flow feature start FITURSAYA 184 |
185 |

Perintah ini membuat sebuah branch fitur baru berdasarkan 'develop' dan beralih ke branch tersebut

186 | 187 | 197 |
198 |
199 |
200 |
201 |
202 | 203 |
204 |
205 |

Menyelesaikan sebuah fitur

206 | 207 |

208 | Menyelesaikan pengembangan sebuah fitur. 209 | Tindakan ini melakukan hal berikut 210 |

211 |
    212 |
  • Merge FITURSAYA kedalam 'develop'
    • 213 |
  • Menghapus branch fitur
    • 214 |
  • Beralih kembali ke branch 'develop'
    • 215 |
216 | 217 |
218 | git flow feature finish FITURSAYA 219 |
220 |
221 |
222 |
223 |
224 |
225 | 226 |
227 |
228 |

Mempublikasi sebuah Fitur

229 | 230 |

231 | Apakah anda mengembangkan sebuah fitur dalam kolaborasi?
232 | Mempublikasikan sebuah fitur ke dalam server remot agar bisa digunakan oleh pengguna yang lain. 233 |

234 | 235 |
236 | git flow feature publish FITURSAYA 237 |
238 |
239 |
240 |
241 |
242 |
243 | 244 |
245 |
246 |

Mendapatkan sebuah fitur yang telah terpublikasi

247 | 248 |

249 | Mendapatkan sebuah fitur yang telah terpublikasi oleh pengguna lain. 250 |

251 | 252 |
253 | git flow feature pull origin FITURSAYA 254 |
255 | 256 |

Anda dapat melacak sebuah fitur bedasarkan asalnya dengan menggunakan git flow feature track FITURSAYA

257 |
258 |
259 |
260 |
261 |
262 | 263 | 264 |
265 |

Membuat sebuah rilis

266 | 267 |
    268 |
  • Mendukung preparasi dari sebuah rilis produksi baru
    • 269 |
  • Memperbolehkan untuk pembenaran bug minor dan mempersiapkan meta-data untuk sebuah rilis
    • 270 |
271 |

★ ★ ★

272 |
273 |

Mulai sebuah rilis

274 | 275 |

Untuk memulai sebuah rilis, gunakan perintah git flow release. Perintah ini akan membuat sebuah branch rilis yang dibuat dari branch 'develop

276 |
277 | git flow release start RELEASE [BASE] 278 |
279 |

Anda dapat menambahkan opsi sebuah [BASE] commit sha-1 hash untuk memulai rilis dari. Commit harus berada dalam branch 'develop'.

280 |

★ ★ ★

281 |

Akan lebih bijak untuk mempublikasi branch rilis setelah membuatnya memperbolehkan merilis commits oleh developer yang lain. Melakukan ini sama dengan mempublikasi fitur dengan perintah:

282 |
283 | git flow release publish RELEASE 284 |
285 |

(Anda dapat melacak sebuah rilis remot dengan perintah
git flow release track RELEASE)

286 |
287 |
288 |
289 |
290 |
291 | 292 |
293 |
294 |

Menyelesaikan sebuah rilis

295 | 296 |

Menyelesaikan sebuah rilis adalah sebuah langkah besar dalam git branching. Ini melakukan beberapa tindakan:

297 |
    298 |
  • Merge branch rilis kembali ke 'master'
    • 299 |
  • Menandai (tags) rilis dengan namanya sendiri
    • 300 |
  • Merge rilis kembali ke dalam 'develop'
    • 301 |
  • Menghapus branch rilis
    • 302 |
303 |
304 | git flow release finish RELEASE 305 |
306 |

Jangan lupa untuk melakukan push pada penanda (tags) anda dengan git push --tags

307 | 308 |
309 |
310 |
311 | 312 |
313 |
314 | 315 |
316 |

Hotfixes

317 | 318 |
    319 |
  • Hotfixes muncul dari kebutuhan untuk melakukan tindakan sesegera mungkin atas keadaan yang tidak diinginan pada versi production
    • 320 |
  • Mungkin percabangan dari penanda (tag) yang sesuai dalam branch master yang ditandai sebagai versi production
    • 321 |
322 |

★ ★ ★

323 |
324 |

git flow hotfix start

325 | 326 |

Seperti perintah git flow yang lain, sebuah hotfix dimulai dengan

327 |
328 | git flow hotfix start VERSION [BASENAME] 329 |
330 |

Argumen versi dengan ini menandai nama sebuah rilis hotfix baru. Dengan opsi anda dapat menspesifikasikan sebuah penamaan dasar untuk memulai.

331 |
332 |
333 |
334 |
335 |
336 | 337 |
338 |
339 |

Menyelesaikan sebuah hotfix

340 | 341 |

Dengan menyelesaikan sebuah hotfix ini berarti akan di-merge kembali ke dalam develop dan master. Sebagai tambahan merge ke master ditandai dengan versi hotfix.

342 |
343 | git flow hotfix finish VERSION 344 |
345 |
346 |
347 |
348 |
349 |
350 | 351 |
352 |
353 |
354 |
355 |
356 |
357 |
358 | 359 | 360 |
361 |

Commands

362 | git-flow commands 363 |
364 | 365 |
366 |

Backlog

367 |

★ ★ ★

368 |
    369 |
  • Tidak semua perintah yang tersedia dapat mencakup semua, hanya yang paling penting saja
    • 370 |
  • Anda masih dapat menggunakan git dan semua perintahnya secara normal seperti yang anda ketahui, git flow adalah hanya sebuah koleksi alat
    • 371 |
  • Penyokong fitur masih dalam versi beta, menggunakan ini tidak disarankan
    • 372 |
  • Jika anda dapat menyediakan translasi saya akan senang untuk mengintegrasikannya
    • 373 |
374 |

★ ★ ★

375 |
376 |
377 | 378 | 379 | 380 |
381 |
382 |

Komentar

383 | 384 |
385 |
386 |
387 | 388 | 401 | 403 | komentar didukung oleh Disqus 404 | 405 | 406 | 407 | 408 | -------------------------------------------------------------------------------- /index.ja_JP.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | git-flow cheatsheet 7 | 8 | 9 | 10 | 11 | 12 | 13 | 27 | 28 | 29 | 30 |
31 | 32 |

git-flow cheatsheet

33 | 34 |

35 | created by Daniel Kummer 36 | 37 | 46 |

47 |

efficient branching using git-flow by Vincent Driessen

48 |

translations: 49 | English - 50 | Castellano - 51 | Brazilian Portugues - 52 | 繁體中文(Traditional Chinese) - 53 | 简体中文(Simplified Chinese) - 54 | 日本語 - 55 | Türkçe - 56 | 한국어(Korean) - 57 | Français - 58 | Magyar(Hungarian) - 59 | Italiano - 60 | Nederlands - 61 | Русский (Russian) - 62 | Deutsch (German) - 63 | Català (Catalan) - 64 | Română (Romanian) - 65 | Ελληνικά (Greek) - 66 | Українська (Ukrainian) - 67 | Tiếng Việt (Vietnamese) - 68 | Polski - 69 | العربية - 70 | فارسی - 71 | Azərbaycanca (Azerbaijani) 72 | Bahasa Indonesia 73 |

74 |
75 | 76 |
77 | 78 | 79 |
80 |

About

81 | 82 |

83 | git-flowはgitの拡張であり、Vincent Driessenの提唱するブランチモデルを実現するための高度なリポジトリ操作を提供します。 84 | more 85 |

86 |

★ ★ ★

87 | 88 |

このチートシートは基本的な使い方とgit-flowの効果を表します。

89 | 90 |

★ ★ ★

91 |
92 | 93 |
94 |

Basic tips

95 |
    96 |
  • Git flow は素晴らしいコマンドライン補助と出力を提供します。何が起こるか注意深く読み解いてください。
    • 97 |
  • macOS Clientの Sourcetree は素晴らしいGUIとgit-flowサポートを提供します。
    • 98 |
  • - Git-flow はマージすることをベースとして考えるソリューションです。リベースは行いません。
    • 99 |
100 |

★ ★ ★

101 |
102 | 103 | 104 |
105 |

Setup

106 |
    107 |
  • 前もってgitをインストールしておく必要があります。
    • 108 |
  • Git flow はmacOS、Linux、Windowsで動作します。
    • 109 |
110 |

★ ★ ★

111 |
112 |

macOS

113 | Homebrew 114 |
115 | $ brew install git-flow-avh 116 |
117 | Macports 118 |
119 | $ port install git-flow-avh 120 |
121 |

Linux

122 |
123 | $ apt-get install git-flow 124 |
125 |

Windows (Cygwin)

126 |
127 | $ wget -q -O - --no-check-certificate 128 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash 129 |
130 |

git-flowのインストールには、wgetとutil-linuxが必要です。

131 |
132 |
133 |

134 | 詳細なgit flowのインストール方法は以下のサイトを参考にしてください。 git flow 135 | wiki. 136 |

137 | install git-flow 138 |
139 |
140 | 141 |
142 |

Getting started

143 |

Git flowを開始するには 既存のプロジェクトをカスタマイズします。

144 |

★ ★ ★

145 |
146 |

初期化

147 | 148 |

通常のgitリポジトリ配下に移動した後、下記のコマンドでgit-flow化します。

149 |
150 | git flow init 151 |
152 |

153 | コマンドのあと対話形式で、いくつかの質問に答えます。 154 | 大体はデフォルトの値が推奨されます。 155 |

156 | 157 |
158 |
159 |
160 |
161 |
162 |
163 |
164 |
165 | 166 | 167 |
168 |

Features

169 | 170 |
    171 |
  • 通常の開発を行います。
    • 172 |
  • 基本的には開発者のリポジトリのみに行います。
    • 173 |
174 |

★ ★ ★

175 | 176 |
177 |

開発開始

178 |

開発用ブランチは 'develop' ブランチから開始します。開始方法は、

179 |
180 | git flow feature start MYFEATURE 181 |
182 |

新たな開発用ブランチを'develop'ブランチをベースとして作成し、開発用ブランチにスイッチします。

183 | 184 | 194 |
195 |
196 |
197 |
198 |
199 | 200 |
201 |
202 |

開発終了

203 | 204 |

205 | 開発が終了したらコマンドで以下の操作が行われます。 206 |

207 |
    208 |
  • MYFEATUREブランチを'develop'にマージします。
    • 209 |
  • 開発用ブランチを削除します。
    • 210 |
  • そして、'develop'ブランチにスイッチをします。
    • 211 |
212 | 213 |
214 | git flow feature finish MYFEATURE 215 |
216 |
217 |
218 |
219 |
220 |
221 | 222 |
223 |
224 |

開発分をリモートへ

225 | 226 |

227 | 複数人と同じ開発ブランチで作業するときは、 228 | 自分の変更分をリモートサーバにプッシュします。 229 |

230 | 231 |
232 | git flow feature publish MYFEATURE 233 |
234 |
235 |
236 |
237 |
238 |
239 | 240 |
241 |
242 |

修正分を取り込む

243 | 244 |

245 | 他の人の修正分を自分のローカルにプルします。 246 |

247 | 248 |
249 | git flow feature pull MYFEATURE 250 |
251 |
252 |
253 |
254 |
255 |
256 | 257 | 258 |
259 |

Make a release

260 | 261 |
    262 |
  • リリースのための作業を行います。
    • 263 |
  • 軽微なバグフィックスを行ったり、リリース用のメタデータの準備を行います。
    • 264 |
265 |

★ ★ ★

266 |
267 |

リリース作業開始

268 | 269 |

リリース作業を開始するには、git flowのreleaseコマンドを使います

270 | 'develop'ブランチから'release'ブランチを作成します 271 |

272 |
273 | git flow release start RELEASE [BASE] 274 |
275 |

[BASE]はオプションで 'develop'ブランチの特定のCommitのハッシュ値を指定します。指定がない場合はHEADが使われます。

276 |

★ ★ ★

277 |

'release'ブランチ作成後に修正をプッシュするには、'feature'の時と似たコマンドを使用します:

278 |
279 | git flow release publish RELEASE 280 |
281 |

('release'リポジトリの修正のトラッキングをすることもできます
git flow release track RELEASE )

282 |
283 |
284 |
285 |
286 |
287 | 288 |
289 |
290 |

リリース完了

291 | 292 |

リリースの完了は、gitブランチの最大のステップの1つです。このとき、いくつかのアクションが発生します。:

293 |
    294 |
  • 'release'ブランチを'master'にマージします。
    • 295 |
  • 'master'ブランチにリリース用のタグをつけます。
    • 296 |
  • 'develop'ブランチに'release'ブランチの内容がマージされます。
    • 297 |
  • 'release'ブランチが削除されます。
    • 298 |
299 |
300 | git flow release finish RELEASE 301 |
302 |
303 |
304 |
305 | 306 |
307 |
308 | 309 |
310 |

Hotfixes

311 | 312 |
    313 |
  • すぐに適用しなければいけないような、緊急の場合に使用します。
    • 314 |
  • 'master'ブランチのタグから、緊急対応用のブランチを作成します。
    • 315 |
316 |

★ ★ ★

317 |
318 |

緊急対応の開始

319 | 320 |

他のgit flowコマンドと似た形で、hotfixを開始します

321 |
322 | git flow hotfix start VERSION [BASENAME] 323 |
324 |

バージョンの引数は、ホットフィックスリリース名を指定します。 オプションとして開始するベースを指定出来ます。

325 |

326 |
327 |
328 |
329 |
330 |
331 | 332 |
333 |
334 |

緊急対応の終了

335 | 336 |

緊急対応の終了作業は、'develop'と'master'のブランチをマージします。加えて、'master'ブランチは緊急対応のタグが付けられます。

337 |
338 | git flow hotfix finish VERSION 339 |
340 |
341 |
342 |
343 |
344 |
345 | 346 |
347 |
348 |
349 |
350 |
351 |
352 |
353 | 354 | 355 |
356 |

Commands

357 | git-flow commands 358 |
359 | 360 |
361 |

Backlog

362 |

★ ★ ★

363 |
    364 |
  • コマンドのすべてをカバーしているわけではなく、重要なものだけカバーしています。
    • 365 |
  • もちろん、gitのコマンドは通常通りすべて使用することができます。git flowは単にgitのコマンドの集合です。
    • 366 |
  • 'support'ブランチの機能はまだベータ版です。それについては言及できません。
    • 367 |
  • もし翻訳して頂けるなら、統合してもらえると幸いです。
    • 368 |
369 |

★ ★ ★

370 |
371 |
372 | 373 | 374 | 375 |
376 |
377 |

Comments

378 | 379 |
380 |
381 |
382 | 383 | 396 | 398 | comments powered by Disqus 399 | 400 | 401 | 402 | 403 | -------------------------------------------------------------------------------- /index.ko_KR.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | git-flow cheatsheet 7 | 12 | 18 | 24 | 41 | 42 | 43 | 48 |
49 |

git-flow cheatsheet

50 |

51 | created by Daniel Kummer 52 | 59 | 71 |

72 |

73 | efficient branching using git-flow by 74 | Vincent Driessen 75 |

76 |

77 | translations: English - 78 | Castellano - 79 | Brazilian Portugues 82 | - 83 | 繁體中文(Traditional Chinese) 86 | - 87 | 简体中文(Simplified Chinese) 90 | - 日本語 - 91 | Türkçe - 92 | 한국어(Korean) - 93 | Français - 94 | Magyar(Hungarian) - 95 | Italiano - 96 | Nederlands - 97 | Русский (Russian) - 98 | Deutsch (German) - 99 | Català (Catalan) - 100 | Română (Romanian) - 101 | Ελληνικά (Greek) 102 | - 103 | Українська (Ukrainian) 104 | - 105 | Tiếng Việt (Vietnamese) 108 | - Polski - 109 | العربية - 110 | فارسی - 111 | Azərbaycanca (Azerbaijani) 112 | Bahasa Indonesia 113 |

114 |
115 |
116 |
117 |

About

118 |

119 | git-flow는 Vincent Driessen의 브랜칭 모델을 위한 고수준 저장소 작업을 120 | 제공하는 git의 확장입니다. 121 | more 126 |

127 |

★ ★ ★

128 |

129 | 이 치트 시트는 기본적인 사용법과 git-flow 작업의 효과를 보여줍니다. 130 |

131 |

★ ★ ★

132 |
133 |
134 |

Basic tips

135 |
    136 |
  • 137 | Git flow는 훌륭한 명령행 도움말과 출력을 제공합니다. 무슨 일이 138 | 일어나는지를 알려면 출력을 주의깊게 읽어주세요. 139 |
    • 140 |
  • 141 | macOS/Window Client 142 | Sourcetree는 훌륭한 git 143 | gui를 제공하고 git-flow에 대한 지원을 제공합니다. 144 |
    • 145 |
  • 146 | Git-flow는 병합(merge) 기반의 솔루션입니다. feature 브랜치를 147 | 리베이스(rebase)하지 않습니다. 148 |
    • 149 |
150 |

★ ★ ★

151 |
152 |
153 |

Setup

154 |
    155 |
  • 사전에 제대로 동작하는 git이 설치되어 있어야합니다.
    • 156 |
  • Git flow는 macOS, Linux, Windows에서 동작합니다.
    • 157 |
158 |

★ ★ ★

159 |
160 |

macOS

161 | Homebrew 162 |
$ brew install git-flow-avh
163 | Macports 164 |
$ port install git-flow-avh
165 |

Linux

166 |
$ apt-get install git-flow
167 |

Windows (Cygwin)

168 |
169 | $ wget -q -O - --no-check-certificate 170 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh 171 | install stable | bash 172 |
173 |

git-flow의 설치를 위해서는 wget과 util-linux가 필요합니다.

174 |
175 |
176 |

177 | 상세한 git flow의 설치 방법은 178 | git flow wiki를 참고하세요. 182 |

183 | install git-flow 184 |
185 |
186 |
187 |

188 | Getting started 189 |

190 |

Git flow는 프로젝트 설정을 변경하기 위해 초기화를 필요로 합니다.

191 |

★ ★ ★

192 |
193 |

초기화

194 |

195 | 기존 git 저장소 내에서 초기화하는 것으로 git-flow의 사용을 196 | 시작합니다. 197 |

198 |
git flow init
199 |

200 | 몇몇 질문에 대답해서 브랜치의 명명규칙을 정합니다. 기본 값을 201 | 사용하기를 권장합니다. 202 |

203 |
204 |
205 |
206 |
207 |
208 |
209 |
210 |
211 |
212 |

Features

213 |
    214 |
  • 다가오는 배포(release)를 위한 새 기능(feature)을 개발합니다.
    • 215 |
  • 일반적으로 개발자의 저장소에만 존재합니다.
    • 216 |
217 |

★ ★ ★

218 |
219 |

새 기능(feature) 시작하기

220 |

새 기능의 개발은 'develop' 브랜치에서 시작합니다.

221 |

다음과 같이 새 기능의 개발을 시작합니다.

222 |
git flow feature start MYFEATURE
223 |

224 | 이것은 'develop'에 기반한 새 기능(feature) 브랜치를 생성하고 그 225 | 브랜치로 전환합니다. 226 |

227 |
234 |
235 |
236 |
237 |
238 |
239 |
240 |

기능 완료

241 |

기능 개발을 완료합니다. 이것은 다음 작업들을 수행합니다.

242 |
    243 |
  • MYFEATURE 브랜치를 'develop'에 병합(merge)합니다.
    • 244 |
  • 기능 브랜치를 삭제합니다.
    • 245 |
  • 'develop' 브랜치로 전환합니다.
    • 246 |
247 |
git flow feature finish MYFEATURE
248 |
249 |
250 |
251 |
252 |
253 |
254 |
255 |

기능을 게시(publish)

256 |

257 | 기능을 공동으로 개발하고 있나요?
258 | 기능을 원격 서버에 게시하여 다른 사용자들도 사용할 수 있게 합니다. 259 |

260 |
git flow feature publish MYFEATURE
261 |
262 |
263 |
264 |
265 |
266 |
267 |
268 |

게시된 기능 가져오기

269 |

다른 사용자가 게시한 기능을 가져옵니다.

270 |
git flow feature pull origin MYFEATURE
271 |
272 |
273 |
274 |
275 |
276 |
277 |

Make a release

278 |
    279 |
  • 새로운 제품 출시 준비를 지원합니다.
    • 280 |
  • 281 | 출시를 위한 사소한 버그 수정이나, 메타 데이터 준비를 허용합니다. 282 |
    • 283 |
284 |

★ ★ ★

285 |
286 |

릴리스 시작

287 |

릴리스를 시작하려면 git flow의 release 명령을 사용합니다.

288 |

'develop' 브랜치로부터 'release' 브랜치를 생성합니다.

289 |
git flow release start RELEASE [BASE]
290 |

291 | 릴리스를 시작할 [BASE] commit sha-1 해시를 선택적으로 292 | 줄 수도 있습니다. 그 commit은 반드시 'develop' 브랜치에 293 | 있어야합니다. 294 |

295 |

★ ★ ★

296 |

297 | 릴리스 브랜치를 생성한 후에는 다른 개발자들의 릴리스 commit을 298 | 허용하기위해 게시(publish)하는 것이 현명합니다. 기능 게시와 비슷한 299 | 방법으로합니다. 300 |

301 |
git flow release publish RELEASE
302 |

303 | (원격 'release' 브랜치의 변경 추적은 다음과 같이 합니다
git flow release track RELEASE 306 | ) 307 |

308 |
309 |
310 |
311 |
312 |
313 |
314 |
315 |

릴리스 완료

316 |

317 | 릴리스 완료는 git 브랜치하기에서 가장 큰 단계입니다. 몇몇 작업을 318 | 수행합니다. 319 |

320 |
    321 |
  • 'release' 브랜치를 'master' 브랜치에 병합(merge)
    • 322 |
  • 릴리스를 릴리스 이름으로 태그(tag)
    • 323 |
  • 릴리스를 'develop' 브랜치로 재병합(back-merge)
    • 324 |
  • 'release' 브랜치 삭제
    • 325 |
326 |
git flow release finish RELEASE
327 |

328 | git push --tags를 사용해 태그들을 push하는 것을 329 | 잊지마세요. 330 |

331 |
332 |
333 |
334 |
335 |
336 |
337 |

Hotfixes

338 |
    339 |
  • 340 | 핫픽스는 현재 출시된 제품에 문제가 생겨서 즉각 대응해야하는 상황에서 341 | 필요합니다. 342 |
    • 343 |
  • 344 | 'master' 브랜치의 현재 출시된 버전으로 표기(mark)된 태그(tag)로부터 345 | 브랜치를 땁니다. 346 |
    • 347 |
348 |

★ ★ ★

349 |
350 |

핫픽스 시작

351 |

여타 git flow 명령과 비슷한 방법으로 시작합니다.

352 |
git flow hotfix start VERSION [BASENAME]
353 |

여기서 버전 인수는 핫픽스 릴리스 이름을 지정합니다.

354 |

선택적으로 basename으로 시작점을 지정할 수도 있습니다.

355 |
356 |
357 |
358 |
359 |
360 |
361 |
362 |

핫픽스 완료

363 |

364 | 핫픽스를 종료하면 핫픽스는 'develop' 및 'master' 브랜치로 365 | 병합(merge)됩니다. 366 |

367 |

추가적으로 'master'의 병합 부분은 핫픽스 버전으로 태그됩니다.

368 |
git flow hotfix finish VERSION
369 |
370 |
371 |
372 |
373 |
374 |
375 |
376 |
377 |
378 |
379 |
380 |
381 |
382 |

Commands

383 | git-flow commands 384 |
385 |
386 |

Backlog

387 |

★ ★ ★

388 |
    389 |
  • 390 | 여기서는 모든 명령을 다루지 않았습니다. 중요한 것들만 설명했습니다. 391 |
    • 392 |
  • 393 | git 명령도 사용할 수 있습니다. git flow는 단지 도구 모음일 뿐입니다. 394 |
    • 395 |
  • 396 | 'support' 기능은 아직 베타 버전입니다. 사용은 권장되지 않습니다. 397 |
    • 398 |
  • 번역해주신다면 저는 행복하게 통합할 것입니다.
    • 399 |
400 |

★ ★ ★

401 |
402 |
403 |
404 |
405 |

Comments

406 |
407 |
408 |
409 | 425 | 429 | comments powered by Disqus 432 | 433 | 434 | -------------------------------------------------------------------------------- /index.lt_LT.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | Apie git-flow 7 | 12 | 18 | 24 | 25 | 26 | 27 | 44 | 45 | 46 | 51 |
52 |

Apie git-flow

53 | 54 |

55 | sukurta Daniel Kummer 56 | 63 | 75 |

76 |

77 | efektyvus šakojimas naudojant git-flow, autorius 78 | Vincent Driessen 79 |

80 |

81 | vertimai: English - 82 | Castellano - 83 | Brazilian Portugues 86 | - 87 | 繁體中文(Traditional Chinese) 90 | - 91 | 简体中文(Simplified Chinese) 94 | - 日本語 - 95 | Türkçe - 96 | 한국어(Korean) - 97 | Français - 98 | Magyar(Hungarian) - 99 | Italiano - 100 | Nederlands - 101 | Русский (Russian) - 102 | Deutsch (German) - 103 | Català (Catalan) - 104 | Română (Romanian) - 105 | Ελληνικά (Greek) 106 | - 107 | Українська (Ukrainian) 108 | - 109 | Tiếng Việt (Vietnamese) 112 | - Polski - 113 | فارسی - 114 | Lietuviškai (Lithuanian) 117 | Bahasa Indonesia 118 |

119 |
120 | 121 |
122 |
123 |

Apie

124 | 125 |

126 | git-flow yra git plėtinių rinkinys, kuris įgalina aukšto lygio 127 | repozitorijos operacijas pagal Vincent Driessen šakojimosi modelį. 128 | daugiau 133 |

134 |

★ ★ ★

135 | 136 |

137 | Ši paruoštukė parodo pagrindinį git-flow operacijų panaudojimą ir 138 | efektą 139 |

140 | 141 |

★ ★ ★

142 |
143 | 144 |
145 |

Bendri patarimai

146 |
    147 |
  • 148 | Git flow suteikia puikią komandinės eilutės pagalbą ir išvedimą. 149 | Skaitykite tai atsargiai, kad pamatytumėte, kas vyksta... 150 |
    • 151 |
  • 152 | macOS/Windows klientas 153 | Sourcetree yra puikus 154 | git grafinis klientas ir palaiko git-flow 155 |
    • 156 |
  • 157 | Git-flow yra apjunginėjimu paremtas sprendimas. Jis nepakeičia šakų 158 | bazės ypatybių. 159 |
    • 160 |
161 |

★ ★ ★

162 |
163 | 164 |
165 |

Nustatymas

166 |
    167 |
  • Pačiai pradžiai yra reikalinga git instaliacija.
    • 168 |
  • Git flow veikia macOS, Linux ir Windows sistemose
    • 169 |
170 |

★ ★ ★

171 |
172 |

macOS

173 | Homebrew 174 |
$ brew install git-flow
175 | Macports 176 |
$ port install git-flow
177 |

Linux

178 |
$ apt-get install git-flow
179 |

Windows (Cygwin)

180 |
181 | $ wget -q -O - --no-check-certificate 182 | https://github.com/nvie/gitflow/raw/develop/contrib/gitflow-installer.sh 183 | | bash 184 |
185 |

Jums reikia wget ir util-linux, kad įdiegtumėte git-flow.

186 |
187 |
188 |

189 | Detalesnė git flow įdiegimo instaliacija yra pasiekiama 190 | git flow wiki 193 | puslapyje. 194 |

195 | install git-flow 196 |
197 |
198 | 199 |
200 |

Pradžia

201 |

202 | Git flow turi būti inicializuotas, kad būtų galima tinkinti jūsų 203 | projektą. 204 |

205 |

★ ★ ★

206 |
207 |

Inicializacija

208 | 209 |

210 | Norint pradėti naudoti git-flow by esančioje git repozitorijoje: 211 |

212 |
git flow init
213 |

214 | Jums reikės turėti atsakymus į kelis klausimus, susijusius su jūsų 215 | šakų pavadinimais.
216 | Rekomenduojama naudoti numatytąsias reikšmes. 217 |

218 |
219 |
220 |
221 |
222 |
223 |
224 |
225 |
226 | 227 |
228 |

Ypatybės

229 | 230 |
    231 |
  • Vystykite naujas ypatybes artėjantiems išleidimams
    • 232 |
  • Tipiškai yra tik kūrėjų repozitorijose
    • 233 |
234 |

★ ★ ★

235 | 236 |
237 |

Pradėti naują ypatybę

238 |

Naujų ypatybių kūrimas prasideda nuo 'develop' šakos.

239 |

Pradėkite kurti naują ypatybę su komanda

240 |
git flow feature start MYFEATURE
241 |

242 | Ši komanda sukuria naujos ypatybės šaką pagal 'develop' ir 243 | pasikeičia į ją 244 |

245 | 246 |
256 |
257 |
258 |
259 |
260 | 261 |
262 |
263 |

Užbaigti ypatybę

264 | 265 |

Užbaigti ypatybės kūrimą. Šis veiksmas atlieka tai:

266 |
    267 |
  • Sujungia MYFEATURE į 'develop'
    • 268 |
  • Pašalina ypatybės šaką
    • 269 |
  • Grįžta atgal į 'develop' šaką
    • 270 |
271 | 272 |
git flow feature finish MYFEATURE
273 |
274 |
275 |
276 |
277 |
278 | 279 |
280 |
281 |

Publikuoti ypatybę

282 | 283 |

284 | Ar kuriate ypatybę komandoje?
285 | Publikuokite ypatybę į nuotolinį serverį, jog jį galėtų pasiekti 286 | kiti naudotojai. 287 |

288 | 289 |
git flow feature publish MYFEATURE
290 |
291 |
292 |
293 |
294 |
295 | 296 |
297 |
298 |

Publikuotos ypatybės gavimas

299 | 300 |

Gauti kito naudotojo publikuotą ypatybę.

301 | 302 |
git flow feature pull origin MYFEATURE
303 | 304 |

305 | Galite sekti ypatybę kilmėje naudodami 306 | git flow feature track MYFEATURE 307 |

308 |
309 |
310 |
311 |
312 |
313 | 314 |
315 |

Atlikti išleidimą

316 | 317 |
    318 |
  • Palaiko pasiruošimą naujam išleidimui
    • 319 |
  • 320 | Leidžia mažybinius trikių ištaisymus ir paruošia metaduomenis 321 | išleidimui 322 |
    • 323 |
324 |

★ ★ ★

325 |
326 |

Pradėti išleidimą

327 | 328 |

329 | Norint pradėti išledimą, naudokite git glow release komandą. Ji 330 | sukuria išleidimo šaką pagal 'develop' šaką. 331 |

332 |
git flow release start RELEASE [BASE]
333 |

334 | Galite pasirinktinai nurodyti [BASE] komito sha-1 335 | hash'ą, nuo kurio norite pradėti. Komitas privalo būti 'develop' 336 | šakoje. 337 |

338 |

★ ★ ★

339 |

340 | Yra išmintinga publikuoti išleidimo šaką po to, kai leista daryti 341 | išleidimo komitus kitiems naudotojams. Tai daroma panašiai kaip ir 342 | su ypatybės išleidimu: 343 |

344 |
git flow release publish RELEASE
345 |

346 | (Galite sekti nuotolinį išleidimą su
git flow release track RELEASE 349 | komanda) 350 |

351 |
352 |
353 |
354 |
355 |
356 | 357 |
358 |
359 |

Užbaigti išleidimą

360 | 361 |

362 | Išleidimo užbaigimas yra vienas iš didelių žingsnių git šakojime. 363 | Jis atlieka kelis veiksmus: 364 |

365 |
    366 |
  • Sujungia išleidimo šaką atgal į 'master'
    • 367 |
  • Pažymi išleidimą kartu su gairės vardu
    • 368 |
  • Atgal-sujungia išleidimą su 'develop'
    • 369 |
  • Pašalina išledimo šaką
    • 370 |
371 |
git flow release finish RELEASE
372 |

Nepamirškite persiųsti gaires su git push --tags

373 |
374 |
375 |
376 |
377 |
378 | 379 |
380 |

Pataisymai

381 | 382 |
    383 |
  • 384 | Pataisymai atsiranda iš būtinumo taisyti jau išleistos versijos 385 | netenkinamą būseną 386 |
    • 387 |
  • 388 | Gali būti iššakotos nuo susijusios gairės master šakoje, kuri žymi 389 | produkcijos versiją. 390 |
    • 391 |
392 |

★ ★ ★

393 |
394 |

git flow hotfix start

395 | 396 |

Kaip ir kitos git flow komandos, pataisymas yra pradedamas su

397 |
git flow hotfix start VERSION [BASENAME]
398 |

399 | Versijos argumentas čia žymi naują pataisymo išleidimo pavadinimą. 400 | Pasirinktinai dar galite nurodyti pagrindinį vardą nuo kurio 401 | pradėti. 402 |

403 |
404 |
405 |
406 |
407 |
408 | 409 |
410 |
411 |

Užbaigti pataisymą

412 | 413 |

414 | Užbaigiant pataisymą jis yra sujungiamas atgal į develop ir master 415 | šakas. Taip pat master sujungimas yra pažymimas su pataisymo 416 | versija. 417 |

418 |
git flow hotfix finish VERSION
419 |
420 |
421 |
422 |
423 |
424 | 425 |
426 |
427 |
428 |
429 |
430 |
431 |
432 | 433 |
434 |

Komandos

435 | git-flow commands 436 |
437 | 438 |
439 |

Pastabos

440 |

★ ★ ★

441 |
    442 |
  • Ne visos galimos komandos yra čia aprašytos, tik svarbiausios
    • 443 |
  • 444 | Jūs vis tiek galite naudoti standartines git komandas kaip ir 445 | anksčiau, git flow yra įrankinių rinkinys 446 |
    • 447 |
  • 448 | 'support' ypatybė vis dar yra beta, jos naudojimas yra nepatartinas 449 |
    • 450 |
  • 451 | Jeigu norite pateikti vertimus, būsiu laimingas galėdamas juos 452 | integruoti 453 |
    • 454 |
455 |

★ ★ ★

456 |
457 |
458 | 459 | 466 | 467 | 483 | 487 | komantarus tvarko Disqus 490 | 491 | 492 | -------------------------------------------------------------------------------- /index.nl_NL.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | git-flow cheatsheet 7 | 8 | 9 | 10 | 11 | 12 | 13 | 27 | 28 | 29 | 30 |
31 | 32 |

git-flow cheatsheet

33 | 34 |

35 | gemaakt door Daniel Kummer 36 | 37 | 46 |

47 |

efficient branchen met behulp van git-flow door Vincent Driessen

48 |

vertalingen: 49 | English - 50 | Castellano - 51 | Brazilian Portugues - 52 | 繁體中文(Traditional Chinese) - 53 | 简体中文(Simplified Chinese) - 54 | 日本語 - 55 | Türkçe - 56 | 한국어(Korean) - 57 | Français - 58 | Magyar(Hungarian) - 59 | Italiano - 60 | Nederlands - 61 | Deutsch (German) - 62 | Català (Catalan) - 63 | Română (Romanian) - 64 | Ελληνικά (Greek) - 65 | Українська (Ukrainian) - 66 | Tiếng Việt (Vietnamese) - 67 | Polski - 68 | العربية - 69 | فارسی - 70 | Azərbaycanca (Azerbaijani) 71 | Bahasa Indonesia 72 |

73 |
74 | 75 |
76 | 77 | 78 |
79 |

Over

80 | 81 |

82 | git-flow is een set van git extensies voor high-level repository operaties voor Vincent 83 | Driessen's branching model. 84 | meer 85 |

86 |

★ ★ ★

87 | 88 |

Dit cheatsheet laat het basisgebruik en de effecten zien van git-flow operaties

89 | 90 |

★ ★ ★

91 |
92 | 93 |
94 |

Basistips

95 |
    96 |
  • Git flow biedt uitstekende commandline hulp en output. Lees het zorgvuldig om te zien wat er gebeurt...
    • 97 |
  • Het macOS/Windows programma Sourcetree is een uitstekende grafische git interface en biedt 98 | git-flow ondersteuning 99 |
    • 100 |
  • Git-flow is een op merge gebaseerde oplossing. Het rebaset feature branches niet.
    • 101 |
102 |

★ ★ ★

103 |
104 | 105 | 106 |
107 |

Installatie

108 |
    109 |
  • Je hebt een werkende git installatie nodig.
    • 110 |
  • Git flow werkt op macOS, Linux en Windows
    • 111 |
112 |

★ ★ ★

113 |
114 |

macOS

115 | Homebrew 116 |
117 | $ brew install git-flow-avh 118 |
119 | Macports 120 |
121 | $ port install git-flow-avh 122 |
123 |

Linux

124 |
125 | $ apt-get install git-flow 126 |
127 |

Windows (Cygwin)

128 |
129 | $ wget -q -O - --no-check-certificate 130 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash 131 |
132 |

Je hebt wget en util-linux nodig om git-flow te installeren.

133 |
134 |
135 |

136 | Gedetailleerde installatie instructies voor git flow kun je vinden op de git flow 137 | wiki. 138 |

139 | install git-flow 140 |
141 |
142 | 143 |
144 |

Aan de slag

145 |

Git flow moet geinitializeerd zijn om je project setup aan te passen.

146 |

★ ★ ★

147 |
148 |

Initializatie

149 | 150 |

Je kan git-flow initializeren door het volgende commando in een bestaande git repository uit te voeren:

151 |
152 | git flow init 153 |
154 |

155 | Je dient een paar vragen te beantwoorden over de naamgevingsconventies voor je branches.
156 | Het is aanbevolen om de standaard waarden te gebruiken. 157 |

158 | 159 |
160 |
161 |
162 |
163 |
164 |
165 |
166 |
167 | 168 | 169 |
170 |

Features

171 | 172 |
    173 |
  • Ontwikkel nieuwe features voor aankomende releases
    • 174 |
  • Bestaat typisch alleen in de repository van de ontwikkelaar
    • 175 |
176 |

★ ★ ★

177 | 178 |
179 |

Een nieuwe feature starten

180 |

Nieuwe features hebben de 'develop' branch als uitgangspunt.

181 |

Start met ontwikkelen van een nieuwe feature met

182 |
183 | git flow feature start MYFEATURE 184 |
185 |

Deze actie maakt een nieuwe feature branch gebaseerd op 'develop' en schakelt over naar deze

186 | 187 | 197 |
198 |
199 |
200 |
201 |
202 | 203 |
204 |
205 |

Het afronden van een feature

206 | 207 |

208 | Rond de ontwikkeling van een feature af. 209 | Deze actie voert de volgende stappen uit 210 |

211 |
    212 |
  • Merge MYFEATURE in 'develop'
    • 213 |
  • Verwijdert de feature branch
    • 214 |
  • Schakelt terug naar de 'develop' branch
    • 215 |
216 | 217 |
218 | git flow feature finish MYFEATURE 219 |
220 |
221 |
222 |
223 |
224 |
225 | 226 |
227 |
228 |

Een feature publiceren

229 | 230 |

231 | Ontwikkel je de feature samen met anderen?
232 | Publiceer de feature branch dan naar de remote server zodat anderen deze branch ook kunnen gebruiken. 233 |

234 | 235 |
236 | git flow feature publish MYFEATURE 237 |
238 |
239 |
240 |
241 |
242 |
243 | 244 |
245 |
246 |

Een gepubliceerde feature ophalen

247 | 248 |

249 | Haal een door een andere ontwikkelaar gepubliceerde feature op. 250 |

251 | 252 |
253 | git flow feature pull origin MYFEATURE 254 |
255 | 256 |

Je kan de wijzigingen op de feature bijhouden op de server door git flow feature track MYFEATURE uit te voeren

257 |
258 |
259 |
260 |
261 |
262 | 263 | 264 |
265 |

Een release maken

266 | 267 |
    268 |
  • Ondersteunt de voorbereiding op een nieuwe productie release
    • 269 |
  • Staat kleine bugfixes toe en bereidt meta-data van een release voor
    • 270 |
271 |

★ ★ ★

272 |
273 |

Een release starten

274 | 275 |

Om een release te starten, kun je het git flow release commando gebruiken. Dit

276 | maakt een release branch aan gebaseerd op de 'develop' branch. 277 |

278 |
279 | git flow release start RELEASE [BASE] 280 |
281 |

Je kan optioneel een [BASE] commit sha-1 hash toevoegen om de release hiervandaan te beginnen. Deze commit moet op de 282 | 'develop' branch aanwezig zijn.

283 |

★ ★ ★

284 |

Het is verstandig om de release branch te publiceren zodat andere ontwikkelaars hieraan kunnen meewerken. Dit lijkt op het publiceren van een feature branch:

285 |
286 | git flow release publish RELEASE 287 |
288 |

(Je kan wijzigingen op de release branch bijhouden met het
git flow release track RELEASE commando)

289 |
290 |
291 |
292 |
293 |
294 | 295 |
296 |
297 |

Een release afronden

298 | 299 |

Een release afronden is een grote stap in git branchen. Het voert verschillende acties uit:

300 |
    301 |
  • De release branch wordt terug in 'master' gemerged
    • 302 |
  • De release wordt getagged met zijn naam
    • 303 |
  • De release wordt terug in 'develop' gemerged
    • 304 |
  • Verwijdert de release branch
    • 305 |
306 |
307 | git flow release finish RELEASE 308 |
309 |

Vergeet niet je tags te pushen met git push --tags

310 | 311 |
312 |
313 |
314 | 315 |
316 |
317 | 318 |
319 |

Hotfixes

320 | 321 |
    322 |
  • Hotfixes ontstaan wanneer er onmiddellijk gehandeld moet worden na een bug in de live versie 323 |
    • 324 |
  • Kan de corresponderende tag op de 'master' branch als basis hebben.
    • 325 |
326 |

★ ★ ★

327 |
328 |

git flow hotfix start

329 | 330 |

Zoals andere git flow commando's, een hotfix wordt gestart door

331 |
332 | git flow hotfix start VERSION [BASENAME] 333 |
334 |

Het VERSION argument slaat op de nieuwe hotfix release naam. Optioneel kun je de BASENAME aangeven waarvandaan begonnen moet worden.

335 |
336 |
337 |
338 |
339 |
340 | 341 |
342 |
343 |

Een hotfix afronden

344 | 345 |

Het afronden van een hotfix zorgt ervoor dat deze zowel in develop als in master gemerged wordt. Aansluitend wordt de merge in de master getagged met de hotfix versie.

346 |
347 | git flow hotfix finish VERSION 348 |
349 |
350 |
351 |
352 |
353 |
354 | 355 |
356 |
357 |
358 |
359 |
360 |
361 |
362 | 363 | 364 |
365 |

Commando's

366 | git-flow commands 367 |
368 | 369 |
370 |

Backlog

371 |

★ ★ ★

372 |
    373 |
  • Niet alle beschikbare commando's zijn hier behandeld, alleen de belangrijkste
    • 374 |
  • Je kan git en al zijn commando's gewoon blijven gebruiken daar git flow alleen een handig gereedschap is
    • 375 |
  • De 'support' feature is nog steeds in beta, het gebruik hiervan wordt niet geadviseerd
    • 376 |
  • Als je vertalingen wilt aanleveren, zal ik deze graag integreren
    • 377 |
378 |

★ ★ ★

379 |
380 |
381 | 382 | 383 | 384 |
385 |
386 |

Reacties

387 | 388 |
389 |
390 |
391 | 392 | 405 | 407 | comments powered by Disqus 408 | 409 | 410 | 411 | 412 | -------------------------------------------------------------------------------- /index.vi_VN.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | Tóm tắt Git-Flow 7 | 8 | 9 | 10 | 11 | 12 | 13 | 27 | 28 | 29 | 30 |
31 | 32 |

Tóm tắt về Git-Flow

33 | 34 |

35 | tác giả bài viết Daniel Kummer 36 | 37 | 46 |

47 |

Phân nhánh tự động với công cụ git-flow của Vincent Driessen

48 |

các bản dịch khác: 49 | English - 50 | Castellano - 51 | Brazilian Portugues - 52 | 繁體中文(Traditional Chinese) - 53 | 简体中文(Simplified Chinese) - 54 | 日本語 - 55 | Türkçe - 56 | 한국어(Korean) - 57 | Français - 58 | Magyar(Hungarian) - 59 | Italiano - 60 | Nederlands - 61 | Русский (Russian) - 62 | Deutsch (German) - 63 | Català (Catalan) - 64 | Română (Romanian) - 65 | Ελληνικά (Greek) - 66 | Українська (Ukrainian) - 67 | Tiếng Việt (Vietnamese) - 68 | Polski - 69 | العربية - 70 | فارسی - 71 | Azərbaycanca (Azerbaijani) 72 | Bahasa Indonesia 73 |

74 |
75 | 76 |
77 | 78 | 79 |
80 |

git-flow là gì?

81 | 82 |

83 | git-flow là một tiện ích mở rộng của git, giúp các thao tác trên repository (kho mã nguồn) trở nên dễ dàng và hiệu quả hơn dựa trên mô hình phân nhánh của Vincent Driessen. 84 | xem chi tết ở đây 85 |

86 |

★ ★ ★

87 | 88 |

Bài tóm tắt nãy sẽ cho bạn biết các thao tác sử dụng cơ bản và sự hiệu quả của git-flow.

89 | 90 |

★ ★ ★

91 |
92 | 93 |
94 |

Một vài lời khuyên

95 |
    96 |
  • Git-flow sẽ hỗ trợ thao tác và cho ra kết quả rất tuyệt vời. Hãy đọc bài viết này cẩn thận để xem điều kì diệu gì sẽ xảy ra ;)
    • 97 |
  • Git-client - Sourcetree là một git-client có giao diện GUI rất tiện lợi và cũng hỗ trợ git-flow trên giao diện.
    • 98 |
  • Git-flow hoạt động dựa trên các thao tác gộp nhánh (merge). Nó không thực hiện các thao tác sắp xếp commits (rebase) trên các nhánh tính năng.
    • 99 |
100 |

★ ★ ★

101 |
102 | 103 | 104 |
105 |

Cài đặt

106 |
    107 |
  • Bạn cần cài đặt git trước khi có thể cài git-flow.
    • 108 |
  • Git-flow có thể hoạt động trên macOS, Linux và Windows.
    • 109 |
110 |

★ ★ ★

111 |
112 |

macOS

113 | Homebrew 114 |
115 | $ brew install git-flow-avh 116 |
117 | Macports 118 |
119 | $ port install git-flow-avh 120 |
121 |

Linux

122 |
123 | $ apt-get install git-flow 124 |
125 |

Windows (Cygwin)

126 |
127 | $ wget -q -O - --no-check-certificate 128 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash 129 |
130 |

Bạn cần wget và util-linux để cài đặt git-flow.

131 |
132 |
133 |

134 | Xem chi tiết về cách cài đặt git-flow ở trang sau: git-flow 135 | wiki. 136 |

137 | install git-flow 138 |
139 |
140 | 141 |
142 |

Bắt đầu nào

143 |

Git flow cần phải được khởi tạo để có thể tùy chỉnh các cài đặt của dự án của bạn.

144 |

★ ★ ★

145 |
146 |

Khởi tạo

147 | 148 |

Sau khi di chuyển tới thư mục dự án, chạy lệnh sau để khởi tạo git-flow.

149 |
150 | git flow init 151 |
152 |

153 | Bạn sẽ cần trả lời một số câu hỏi cho việc thiết lập git-flow sau câu lệnh khởi tạo. 154 | Chúng tôi khuyên bạn nên sử dụng các giá trị [mặc định]. 155 |

156 | 157 |
158 |
159 |
160 |
161 |
162 |
163 |
164 |
165 | 166 | 167 |
168 |

Làm việc với các chức năng

169 | 170 |
    171 |
  • Phát triển các chức năng mới cho lần phát hành kế tiếp.
    • 172 |
  • Về cơ bản việc này thường chỉ xảy ra ở kho mã nguồn (respository) của các lập trình viên.
    • 173 |
174 |

★ ★ ★

175 | 176 |
177 |

Bắt đầu quá trình phát triển một chức năng mới

178 |

Để phát triển chức năng mới bạn nên bắt đầu từ nhánh phát triển 'develop'. Ví dụ với chức năng MYFEATURE:

179 |
180 | git flow feature start MYFEATURE 181 |
182 |

Lệnh này sẽ tạo ra một nhánh mới từ nhánh 'develop' và tự động chuyển sang nhánh mới này.

183 | 184 | 194 |
195 |
196 |
197 |
198 |
199 | 200 |
201 |
202 |

Kết thúc quá trình phát triển một chức năng

203 | 204 |

205 | Điều này xảy ra sau khi bạn đã phát triển xong một chức năng (ví dụ phía trên là MYFEATURE), lệnh kết thúc quá trình phát triển chức năng sẽ tự động thực hiện các thao tác: 206 |

207 |
    208 |
  • Gộp nhánh (merge branch) chức năng (MYFEATURE) vào nhánh 'develop'
    • 209 |
  • Xoá nhánh chức năng (MYFEATURE)
    • 210 |
  • Chuyển sang (checkout) nhánh 'develop'
    • 211 |
212 | 213 |
214 | git flow feature finish MYFEATURE 215 |
216 |
217 |
218 |
219 |
220 |
221 | 222 |
223 |
224 |

Đẩy mã nguồn của chức năng lên máy chủ

225 | 226 |

227 | Khi bạn làm việc với những người khác trên cùng một chức năng, 228 | bạn sẽ cần đẩy (push) phần mã nguồn của bạn cho chức năng đó lên máy chủ (remote) 229 | để những người khác có thể kéo về (pull) được. 230 |

231 | 232 |
233 | git flow feature publish MYFEATURE 234 |
235 |
236 |
237 |
238 |
239 |
240 | 241 |
242 |
243 |

Kéo mã nguồn của chức năng xuống máy bạn

244 | 245 |

246 | Khi bạn cần kéo (pull) mã nguồn của chức năng về để phát triển tiếp sau khi nó đã được cập nhập bởi những thành viên khác (và họ đã đẩy nó lên máy chủ). 247 |

248 | 249 |
250 | git flow feature pull REMOTE_NAME MYFEATURE 251 |
252 |
253 |
254 |
255 |
256 |
257 | 258 | 259 |
260 |

Tạo một bản phát hành

261 | 262 |
    263 |
  • Hỗ trợ bạn chuẩn bị cho bản phát hành mới.
    • 264 |
  • Cho phép sửa các lỗi nhỏ và chuẩn bị các tài liệu cần thiết cho bản phát hành.
    • 265 |
266 |

★ ★ ★

267 |
268 |

Bắt đầu một phát hành mới

269 | 270 |

Để bắt đầu một phát hành mới, sử dụng lệnh release của git flow.

271 | Lệnh này sẽ tạo ra nhánh 'release' từ nhánh 'develop'. 272 |

273 |
274 | git flow release start RELEASE [BASE] 275 |
276 |

Tùy chọn [BASE] cho phép commit được một giá trị hash sha-1. Trường hợp không chỉ định tùy chọn này thì HEAD sẽ được sử dụng.

277 |

★ ★ ★

278 |

Để công bố phần code 'release' của mình cho các thành viên khác, ta có thể làm tương tự như với công bố tính năng bằng lệnh sau:

279 |
280 | git flow release publish RELEASE 281 |
282 |

(Bạn có thể theo dấu remote 'release' bằng lệnh
git flow release track RELEASE )

283 |
284 |
285 |
286 |
287 |
288 | 289 |
290 |
291 |

Kết thúc release

292 | 293 |

Kết thúc release là một bước lớn trong chiến lược phân nhánh git. Nó thực hiện các việc sau:

294 |
    295 |
  • Merge nhánh 'release' vào nhánh 'master'
    • 296 |
  • Gắn tag ở nhánh 'master' dành cho bản release
    • 297 |
  • Merge lại nhánh 'release' vào nhánh 'develop'
    • 298 |
  • Xóa bỏ nhánh 'release'
    • 299 |
300 |
301 | git flow release finish RELEASE 302 |
303 |
304 |
305 |
306 | 307 |
308 |
309 | 310 |
311 |

Sửa đổi nóng - hotfix

312 | 313 |
    314 |
  • Sử dụng cho các trường hợp khẩn cấp cần phải sửa đổi ngay trên bản sản phẩm (nhánh master).
    • 315 |
  • Có thể tạo nhánh giải quyết khẩn cấp từ tag của nhánh 'master'.
    • 316 |
317 |

★ ★ ★

318 |
319 |

Bắt đầu hotfix

320 | 321 |

Giống như các lệnh khác của git flow, hotfix bắt đầu với:

322 |
323 | git flow hotfix start VERSION [BASENAME] 324 |
325 |

Tham số VERSION ở đây chỉ định tên của phiên bản release hotfix này. Còn tham số tùy chọn basename sẽ chỉ định tên nhánh cơ bản thay cho hotfix thay vì nhánh 'master'

326 |

327 |
328 |
329 |
330 |
331 |
332 | 333 |
334 |
335 |

Kết thúc hotfix

336 | 337 |

Kết thúc hotfix sẽ merge lại nội dung thay đổi vào nhánh 'develop' và 'master'. Ở nhánh 'master' sẽ được gắn tag là phiên bản của hotfix.

338 |
339 | git flow hotfix finish VERSION 340 |
341 |
342 |
343 |
344 |
345 |
346 | 347 |
348 |
349 |
350 |
351 |
352 |
353 |
354 | 355 | 356 |
357 |

Các lệnh

358 | git-flow commands 359 |
360 | 361 |
362 |

Lưu ý

363 |

★ ★ ★

364 |
    365 |
  • Ở đây không giới thiệu được tất cả các lệnh mà chỉ đưa ra một số lệnh quan trọng nhất của git-flow.
    • 366 |
  • Tất nhiên là bạn vẫn có thể sử dụng toàn bộ các lệnh thông thường của git. Git-flow chỉ đơn giản là một tập hợp các lệnh mở rộng cho git.
    • 367 |
  • Chức năng nhánh 'support' vẫn đang là bản beta nên không được đề cập ở đây.
    • 368 |
  • Tôi rất sẵn sàng tích hợp bất kì bản dịch nào nếu bạn sẵn lòng :)
    • 369 |
370 |

★ ★ ★

371 |
372 |
373 | 374 | 375 | 376 | 383 | 384 | 397 | 399 | comments powered by Disqus 400 | 401 | 402 | 403 | 404 | -------------------------------------------------------------------------------- /index.zh_CN.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | git-flow 备忘清单 7 | 8 | 9 | 10 | 11 | 25 | 26 | 27 | 28 |
29 | 30 |

git-flow 备忘清单

31 | 32 |

33 | 由 Daniel Kummer (Tweet) 创建 34 | 35 |

36 |

使用 git-flow 进行有效的分支实践。 by Vincent Driessen

37 |

翻译: 38 | English - 39 | Castellano - 40 | Brazilian Portugues - 41 | 繁體中文(Traditional Chinese) - 42 | 简体中文(Simplified Chinese) 43 | 日本語 - 44 | Türkçe - 45 | 한국어(Korean) - 46 | Français - 47 | Magyar(Hungarian) - 48 | Italiano - 49 | Nederlands - 50 | Русский (Russian) - 51 | Deutsch (German) - 52 | Română (Romanian) - 53 | Ελληνικά (Greek) - 54 | Українська (Ukrainian) - 55 | Tiếng Việt (Vietnamese) - 56 | Polski - 57 | العربية - 58 | فارسی - 59 | Azərbaycanca (Azerbaijani) 60 | Bahasa Indonesia 61 |

62 |
63 | 64 |
65 | 66 | 67 |
68 |

关于

69 | 70 |

71 | git-flow 是一个 git 扩展集，按 Vincent Driessen 的分支模型提供高层次的库操作。 72 | 查看详情 73 |

74 |

★ ★ ★

75 | 76 |

这个备忘清单展示了 git-flow 的基本操作和效果。

77 | 78 |

★ ★ ★

79 |
80 | 81 |
82 |

基础建议

83 |
    84 |
  • Git flow 提供了极出色的命令帮忙以及输出提示。请仔细阅读并观察发生了什么事情...
    • 85 |
  • macOS 程序 Sourcetree 是一个极出色的 git 界面客户端，已经提供了 git-flow 的支持。
    • 86 |
  • - Git-flow 是一个基于归并的解决方案，它并没有提供重置(rebase)特性分支的能力。
    • 87 |
88 |

★ ★ ★

89 |
90 | 91 | 92 |
93 |

安装

94 |
    95 |
  • 你需要有一个可以工作的 git 作为前提。
    • 96 |
  • Git flow 可以工作在 macOS, Linux 和 Windows之下
    • 97 |
98 |

★ ★ ★

99 |
100 |

macOS

101 | Homebrew 102 |
103 | $ brew install git-flow-avh 104 |
105 | Macports 106 |
107 | $ port install git-flow-avh 108 |
109 |

Linux

110 |
111 | $ apt-get install git-flow 112 |
113 |

Windows (Cygwin)

114 |
115 | $ wget -q -O - --no-check-certificate 116 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh install stable | bash 117 |
118 |

安装 git-flow, 你需要 wget 和 util-linux。

119 |
120 |
121 |

122 | 更多的 git flow 安装指引，请阅读 git flow wiki. 123 |

124 | install git-flow 125 |
126 |
127 | 128 |
129 |

开始

130 |

为了自定义你的项目，Git flow 需要初始化过程。

131 |

★ ★ ★

132 |
133 |

初始化

134 | 135 |

使用 git-flow，从初始化一个现有的 git 库内开始:

136 |
137 | git flow init 138 |
139 |

140 | 你必须回答几个关于分支的命名约定的问题。
建议使用默认值。 141 |

142 | 143 |
144 |
145 |
146 |
147 |
148 |
149 |
150 |
151 | 152 | 153 |
154 |

特性

155 | 156 |
    157 |
  • 为即将发布的版本开发新功能特性。
    • 158 |
  • 这通常只存在开发者的库中。
    • 159 |
160 |

★ ★ ★

161 | 162 |
163 |

增加新特性

164 |

新特性的开发是基于 'develop' 分支的。

165 |

通过下面的命令开始开发新特性：

166 |
167 | git flow feature start MYFEATURE 168 |
169 |

这个操作创建了一个基于'develop'的特性分支，并切换到这个分支之下。

170 |
171 |
172 |
173 |
174 |
175 | 176 |
177 |
178 |

完成新特性

179 | 180 |

完成开发新特性。这个动作执行下面的操作. 181 |

182 |
    183 |
  • 合并 MYFEATURE 分支到 'develop'
    • 184 |
  • 删除这个新特性分支
    • 185 |
  • 切换回 'develop' 分支
    • 186 |
187 | 188 |
189 | git flow feature finish MYFEATURE 190 |
191 |
192 |
193 |
194 |
195 |
196 | 197 |
198 |
199 |

发布新特性

200 | 201 |

202 | 你是否合作开发一项新特性？
203 | 发布新特性分支到远程服务器，所以，其它用户也可以使用这分支。 204 |

205 | 206 |
207 | git flow feature publish MYFEATURE 208 |
209 |
210 |
211 |
212 |
213 |
214 | 215 |
216 |
217 |

取得一个发布的新特性分支

218 | 219 |

220 | 取得其它用户发布的新特性分支，并签出远程的变更。 221 |

222 | 223 |
224 | git flow feature pull origin MYFEATURE 225 |
226 | 227 |

你可以使用 git flow feature track MYFEATURE 跟踪在origin上的特性分支。

228 |
229 |
230 |
231 |
232 |
233 | 234 | 235 |
236 |

作一个release版本

237 | 238 |
    239 |
  • 支持一个新的用于生产环境的发布版本。
    • 240 |
  • 允许修正小问题，并为发布版本准备元数据。
    • 241 |
242 |

★ ★ ★

243 |
244 |

开始准备release版本

245 | 246 |

开始准备release版本，使用 git flow release 命令.

247 | 它从 'develop' 分支开始创建一个 release 分支。 248 |

249 |
250 | git flow release start RELEASE [BASE] 251 |
252 |

你可以选择提供一个 [BASE]参数，即提交记录的 sha-1 hash 值，来开启动 release 分支. 这个提交记录的 sha-1 hash 值必须是'develop' 分支下的。

253 |

★ ★ ★

254 |

创建 release 分支之后立即发布允许其它用户向这个 release 分支提交内容是个明智的做法。命令十分类似发布新特性：

255 |
256 | git flow release publish RELEASE 257 |
258 |

(你可以通过
git flow release track RELEASE 命令签出 release 版本的远程变更)

259 |
260 |
261 |
262 |
263 |
264 | 265 |
266 |
267 |

完成 release 版本

268 | 269 |

完成 release 版本是一个大 git 分支操作。它执行下面几个动作：

270 |
    271 |
  • 归并 release 分支到 'master' 分支
    • 272 |
  • 用 release 分支名打 Tag
    • 273 |
  • 归并 release 分支到 'develop'
    • 274 |
  • 移除 release 分支
    • 275 |
276 |
277 | git flow release finish RELEASE 278 |
279 |
280 |
281 |
282 | 283 |
284 |
285 | 286 |
287 |

紧急修复

288 | 289 |
    290 |
  • 紧急修复来自这样的需求：生产环境的版本处于一个不预期状态，需要立即修正。
    • 291 |
  • 有可能是需要修正 master 分支上某个 TAG 标记的生产版本。
    • 292 |
293 |

★ ★ ★

294 |
295 |

开始 git flow 紧急修复

296 | 297 |

像其它 git flow 命令一样, 紧急修复分支开始自：

298 |
299 | git flow hotfix start VERSION [BASENAME] 300 |
301 |

VERSION 参数标记着修正版本。你可以从 [BASENAME]开始，[BASENAME]为finish release时填写的版本号

302 |
303 |
304 |
305 |
306 |
307 | 308 |
309 |
310 |

完成紧急修复

311 | 312 |

当完成紧急修复分支，代码归并回 develop 和 master 分支。相应地，master 分支打上修正版本的 TAG。

313 |
314 | git flow hotfix finish VERSION 315 |
316 |
317 |
318 |
319 |
320 |
321 | 322 |
323 |
324 |
325 |
326 |
327 |
328 |
329 | 330 | 331 |
332 |

命令

333 | git-flow commands 334 |
335 | 336 |
337 |

Backlog

338 |

★ ★ ★

339 |
    340 |
  • 并非所有可用的命令都涵盖在这里，这里包含有最重要的部分命令。
    • 341 |
  • 你依旧可以继续使用你所知道和了解的 git 命令， git flow 只是一个工具集合。
    • 342 |
  • 'support' 功能只是测试版本, 不建议使用
    • 343 |
  • 如果你乐意提供翻译，我很乐意整合它。
    • 344 |
345 |

★ ★ ★

346 |
347 |
348 | 349 | 350 | 351 |
352 |
353 |

Comments

354 | 355 |
356 |
357 |
358 | 371 | 373 | comments powered by Disqus 374 | 375 | 376 | 377 | -------------------------------------------------------------------------------- /index.zh_TW.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | git-flow 備忘清單 7 | 12 | 18 | 24 | 30 | 31 | 48 | 49 | 50 | 55 |
56 |

git-flow 備忘清單

57 | 58 |

59 | 由 60 | Daniel Kummer (Tweet) 65 | 建立 66 |

67 |

68 | 使用 git-flow 進行高效率的分支使用。 by 69 | Vincent Driessen 70 |

71 |

72 | 翻譯: English - 73 | Castellano - 74 | Brazilian Portugues 77 | - 78 | 繁體中文(Traditional Chinese) 81 | - 82 | 简体中文(Simplified Chinese)
85 | 日本語 - 86 | Türkçe - 87 | 한국어(Korean) - 88 | Français - 89 | Magyar(Hungarian) - 90 | Italiano - 91 | Nederlands - 92 | Русский (Russian) - 93 | Deutsch (German) - 94 | Català (Catalan) - 95 | Română (Romanian) - 96 | Ελληνικά (Greek) 97 | - 98 | Українська (Ukrainian) 99 | - 100 | Tiếng Việt (Vietnamese) 103 | - Polski - 104 | العربية - 105 | فارسی - 106 | Azərbaycanca (Azerbaijani) 107 | Bahasa Indonesia 108 |

109 |
110 | 111 |
112 |
113 |

什麼是 git-flow ?

114 | 115 |

116 | git-flow 是一個 git 擴充功能，依照 Vincent Driessen 117 | 的分支模型提供高層次的倉庫控制方式。 118 | 查看更多 123 |

124 |

★ ★ ★

125 | 126 |

這個備忘清單將會為您展示 git-flow 的基本操作方式與結果。

127 | 128 |

★ ★ ★

129 |
130 | 131 |
132 |

基礎提示

133 |
    134 |
  • 135 | git-flow 136 | 提供了極為出色的指令與輸出提示。請仔細閱讀並觀察發生了什麼事情... 137 |
    • 138 |
  • 139 | SourceTree 140 | 是一個極為出色的 git 圖形介面應用程式，以內建了 git-flow 141 | 的功能。(支援 Mac OS X 與 Windows) 142 |
    • 143 |
  • 144 | git-flow 145 | 是一個以合並(Merge)概念為基底的解決方案，它並無提供重置(rebase)特性分支的功能。 146 |
    • 147 |
148 |

★ ★ ★

149 |
150 | 151 |
152 |

安裝

153 |
    154 |
  • 你需要有一個已經初始化的 git 倉庫。
    • 155 |
  • git-flow 可以在 macOS、Linux 和 Windows 之下使用。
    • 156 |
157 |

★ ★ ★

158 |
159 |

Mac OS X

160 | 透過 Homebrew 安裝 161 |
$ brew install git-flow-avh
162 | 透過 Macports 安裝 163 |
$ port install git-flow-avh
164 |

Linux

165 |
$ apt-get install git-flow
166 |

Windows (Cygwin)

167 |
168 | $ wget -q -O - --no-check-certificate 169 | https://raw.github.com/petervanderdoes/gitflow-avh/develop/contrib/gitflow-installer.sh 170 | install stable | bash 171 |
172 |

在 Windows 下安装 git-flow, 你會需要 wget 和 util-linux。

173 |
174 |
175 |

176 | 更詳細的 git-flow 安裝指南，請參閱 177 | git flow wiki. 182 |

183 | install git-flow 184 |
185 |
186 | 187 |
188 |

189 | 開始 git-flow 190 |

191 |

在開始使用 git-flow 之前，你必須完成一些簡單的設定。

192 |

★ ★ ★

193 |
194 |

初始化

195 | 196 |

197 | 開始使用 git-flow 前，你必須切換目錄至你的 git 198 | 專案中，並且以下列指令進行初始化: 199 |

200 |
git flow init
201 |

202 | 接著您必須回答幾個問題，是關於分支名稱的定義。
這裡建議使用預設值。 203 |

204 |
205 |
206 |
207 |
208 |
209 |
210 |
211 |
212 | 213 |
214 |

新功能分支(Feature)

215 | 216 |
    217 |
  • 為接下即將發佈的版本開發新功能時使用。
    • 218 |
  • 通常新功能分支只會存於開發者機器上。
    • 219 |
220 |

★ ★ ★

221 | 222 |
223 |

開始新功能設計

224 |

新功能的開發是由 'develop' 分支的最後一個版本發展出來的。

225 |

使用下列的命令可以開始一個新功能的分支：

226 |
git flow feature start MYFEATURE
227 |

228 | 這個命令將會於 'develop' 的最後一個版本建立出另一個 229 | 'feature/MYFEATURE' 230 | 分支，並自動切換至這個分支底下。現在你可以開始製作新功能。 231 |

232 |
233 |
234 |
235 |
236 |
237 | 238 |
239 |
240 |

完成新功能

241 | 242 |

當你在新功能分支完成新功能後，使用下列指令來結束新功能開發:

243 |
git flow feature finish MYFEATURE
244 |

這個指令會替你完成下列動作:

245 |
    246 |
  • 合並(Merge) MYFEATURE 分支回到 'develop'
    • 247 |
  • 刪除這個新功能分支
    • 248 |
  • 切換回 'develop' 分支
    • 249 |
250 |
251 |
252 |
253 |
254 |
255 | 256 |
257 |
258 |

發佈新功能分支

259 | 260 |

261 | 你是否需多人合作開發新功能？
262 | 透過下列命令來發佈新功能分支到遠端 git 263 | 伺服器，讓其他使用者也能共用這個新功能分支。 264 |

265 | 266 |
git flow feature publish MYFEATURE
267 |
268 |
269 |
270 |
271 |
272 | 273 |
274 |
275 |

取得新功能分支

276 | 277 |

278 | 當你需接手完成新功能時，透過下列命令取得遠端伺服器上的新功能分支，並得到所有保存在遠端伺服器上的變更紀錄： 279 |

280 | 281 |
git flow feature pull MYFEATURE
282 | 283 |

你也可以透過下列指令進而追蹤一個功能:

284 | 285 |
git flow feature track MYFEATURE
286 |
287 |
288 |
289 |
290 |
291 | 292 |
293 |

製作發佈版本(release)

294 | 295 |
    296 |
  • 用於支援準備發佈正式產品前的預備分支。
    • 297 |
  • 允許修正小問題，並為發布版本準備或修改中介資料。
    • 298 |
299 |

★ ★ ★

300 |
301 |

開始推出新版本

302 | 303 |

使用下列指令準備推出(release)新版本分支:

304 |
git flow release start RELEASE [BASE]
305 |

它會從 'develop' 分支的最後一個版本創建出 release 分支。

306 |

307 | 你也可以選擇性的加入一個 sha-1 hash 308 | 於[BASE]參數，這會讓 release 分支於您指定的 develop 309 | 提交紀錄點產生分支。有一點需要注意的是，sha-1 hash 只能是於'develop' 310 | 分支下。 311 |

312 |

★ ★ ★

313 |

314 | 最佳的狀況下，在創建出新的 release 315 | 分支後，應要立即的發布至遠端伺服器上，讓其他團隊中的開發者也能存取這個 316 | release 分支。而這個發布指令很類似於發布新功能: 317 |

318 |
git flow release publish RELEASE
319 |

320 | (您也可以透過
git flow release track RELEASE 321 | 指令來取得 release 版本的遠端更改) 322 |

323 |
324 |
325 |
326 |
327 |
328 | 329 |
330 |
331 |

完成推出新版本

332 | 333 |

334 | 完成 release 版本是一個很大的 git 分支操作。但你只許要執行下列指令: 335 |

336 |
git flow release finish RELEASE
337 |

git flow 會幫你執行下面幾個步驟:

338 |
    339 |
  • 合並 release 分支到 'master'
    • 340 |
  • 在 master 加上版本號標籤(Tag)
    • 341 |
  • 合並 release 分支到 'develop'
    • 342 |
  • 移除 release 分支
    • 343 |
344 |
345 |
346 |
347 |
348 |
349 | 350 |
351 |

快速修復(hotfix)

352 | 353 |
    354 |
  • 355 | 當你的產品發佈環境處於不可預期的狀況，且發生了一些需要立即修正的問題，您可以使用 356 | hotfix 來幫助您。 357 |
    • 358 |
  • hotfix 是從 master 中加入的版本標籤開始。
    • 359 |
360 |

★ ★ ★

361 |
362 |

開始快速修復

363 | 364 |

365 | 快速修復(hotfix)就像其他的 git flow 366 | 指令一樣，您可以透過下列指令開始： 367 |

368 |
git flow hotfix start VERSION [BASENAME]
369 |

370 | 你必須填寫一個 VERSION 參數，這代表當你完成 hotfix 371 | 時發佈的版本號碼。 372 |

373 |

374 | 此外你可以自由挑選修復開始的分支名稱[BASENAME]，分支名稱如果不填寫的狀況下，預設是 375 | 'master'。 376 |

377 |
378 |
379 |
380 |
381 |
382 | 383 |
384 |
385 |

完成快速修復

386 | 387 |

388 | 當你在快速修復分支完成修復後，透過下列的指令讓修復分支合並回 develop 389 | 和 master 分支。並且在 master 分支加上修訂版本號的標籤(tag): 390 |

391 |
git flow hotfix finish VERSION
392 |
393 |
394 |
395 |
396 |
397 | 398 |
399 |
400 |
401 |
402 |
403 |
404 |
405 | 406 |
407 |

指令一覽圖

408 | git-flow commands 409 |
410 | 411 |
412 |

備註

413 |

★ ★ ★

414 |
    415 |
  • 這裡我們只介紹了重要且常用的功能，並非包含所有的指令。
    • 416 |
  • 417 | git-flow 只是一個額外的擴充功能，即使安裝了 git-flow 418 | 後你依然可以使用你所知道的原生 git 指令。 419 |
    • 420 |
  • 'support' 分支目前為測試版本不建議使用。
    • 421 |
  • 如果你很樂意提供翻譯，我很樂意整合。
    • 422 |
423 |

★ ★ ★

424 |
425 |
426 | 427 | 434 | 450 | 456 | comments powered by Disqus 459 | 460 | 461 | --------------------------------------------------------------------------------