From 2be820f31edabd8251f004c0c27225d78252005a Mon Sep 17 00:00:00 2001 From: Andrii Komarnitskyi Date: Sat, 25 Mar 2017 18:16:18 +0200 Subject: [PATCH 1/4] pages ua translate --- lib/locale-uk-UA.json | 8 ++ lib/locale.js | 6 +- .../10_requesting_you_pull_please.html | 56 ++++++++ .../uk-UA/challenges/11_merge_tada.html | 65 +++++++++ .../contents/uk-UA/challenges/1_get_git.html | 70 ++++++++++ .../uk-UA/challenges/2_repository.html | 74 +++++++++++ .../uk-UA/challenges/3_commit_to_it.html | 68 ++++++++++ .../uk-UA/challenges/4_githubbin.html | 53 ++++++++ .../uk-UA/challenges/5_remote_control.html | 114 ++++++++++++++++ .../uk-UA/challenges/6_forks_and_clones.html | 86 ++++++++++++ .../7_branches_arent_just_for_birds.html | 124 ++++++++++++++++++ .../uk-UA/challenges/8_its_a_small_world.html | 31 +++++ .../challenges/9_pull_never_out_of_date.html | 39 ++++++ resources/contents/uk-UA/pages/about.html | 12 ++ .../contents/uk-UA/pages/dictionary.html | 108 +++++++++++++++ resources/contents/uk-UA/pages/index.html | 116 ++++++++++++++++ resources/contents/uk-UA/pages/resources.html | 50 +++++++ .../contents/uk-UA/partials/chal-footer.html | 12 ++ .../contents/uk-UA/partials/chal-header.html | 16 +++ .../contents/uk-UA/partials/chal-sidebar.html | 15 +++ resources/contents/uk-UA/partials/footer.html | 11 ++ resources/contents/uk-UA/partials/header.html | 17 +++ .../uk-UA/partials/verify-button.html | 10 ++ .../partials/verify-directory-button.html | 13 ++ 24 files changed, 1172 insertions(+), 2 deletions(-) create mode 100644 lib/locale-uk-UA.json create mode 100644 resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html create mode 100644 resources/contents/uk-UA/challenges/11_merge_tada.html create mode 100644 resources/contents/uk-UA/challenges/1_get_git.html create mode 100644 resources/contents/uk-UA/challenges/2_repository.html create mode 100644 resources/contents/uk-UA/challenges/3_commit_to_it.html create mode 100644 resources/contents/uk-UA/challenges/4_githubbin.html create mode 100644 resources/contents/uk-UA/challenges/5_remote_control.html create mode 100644 resources/contents/uk-UA/challenges/6_forks_and_clones.html create mode 100644 resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html create mode 100644 resources/contents/uk-UA/challenges/8_its_a_small_world.html create mode 100644 resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html create mode 100644 resources/contents/uk-UA/pages/about.html create mode 100644 resources/contents/uk-UA/pages/dictionary.html create mode 100644 resources/contents/uk-UA/pages/index.html create mode 100644 resources/contents/uk-UA/pages/resources.html create mode 100644 resources/contents/uk-UA/partials/chal-footer.html create mode 100644 resources/contents/uk-UA/partials/chal-header.html create mode 100644 resources/contents/uk-UA/partials/chal-sidebar.html create mode 100644 resources/contents/uk-UA/partials/footer.html create mode 100644 resources/contents/uk-UA/partials/header.html create mode 100644 resources/contents/uk-UA/partials/verify-button.html create mode 100644 resources/contents/uk-UA/partials/verify-directory-button.html diff --git a/lib/locale-uk-UA.json b/lib/locale-uk-UA.json new file mode 100644 index 0000000000..06b40437db --- /dev/null +++ b/lib/locale-uk-UA.json @@ -0,0 +1,8 @@ +{ + "n": { + }, + "v": { + }, + "adj": { + } +} \ No newline at end of file diff --git a/lib/locale.js b/lib/locale.js index 434fc5b8b7..eacde7462b 100644 --- a/lib/locale.js +++ b/lib/locale.js @@ -11,7 +11,8 @@ var available = { 'ja-JP': '日本語', 'zh-TW': '中文(臺灣)', 'ko-KR': '한국어', - 'pt-BR': 'Português Brasileiro' + 'pt-BR': 'Português Brasileiro', + 'uk-UA': 'Українська' } /** @@ -24,7 +25,8 @@ var aliases = { 'ja': 'ja-JP', 'zh': 'zh-TW', 'kr': 'ko-KR', - 'br': 'pt-BR' + 'br': 'pt-BR', + 'uk': 'uk-UA' } /** diff --git a/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html b/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html new file mode 100644 index 0000000000..e37100b32e --- /dev/null +++ b/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html @@ -0,0 +1,56 @@ +
+

Submit a Pull Request to the original Patchwork repository.

+
+ +
+

Pull Requests

+

Often when you make changes and improvements to a project you've forked, you'll want to send those changes to the + maintainer of the original and request that they pull those changes into the + original so that everyone can benefit from the updates—that's a pull request.

+ +

We want to add you to the list of workshop finishers, so make a pull request to add your + username file to the original: github.com/jlord/patchwork. +

+ + An illustration showing two options. The latter option contains more of the alphabet than the first and is asking the first to accept its work so that the alapabet is complete. +
+ +
+

Create a pull request

+

Visit the original repository you forked on GitHub, in this case http://github.com/jlord/patchwork. +

+ +

Often GitHub will detect if you've pushed a branch to a fork and display it at the top of the original's website. + If you see that with your 'add-username' branch, you can click to create a Pull Request from there. If not:

+ + + +

You'll now see a page with the details of the pull request you're in the process of submitting. This page shows + the commits and changes, in the form of a diff, associated with your pull request as compared to the 'gh-pages' + branch of the original.

+ +

If the original repository has a contribution documentation, GitHub will link to it. This is + documentation from repository owners on how to best make contributions to that project—very helpful to read if + you'd like to see your changes adopted!

+ +

If everything on the page looks good and as you expect it:

+ + + +

Bingo! You submitted a pull request—take a few seconds to bask in the moment. + +

If all is well with your pull request, it will be merged within moments. If it's not merged automatically within + a few minutes, you'll then likely have some comments from @reporobot on why it couldn't merge it. If this is the + case, close your pull request on GitHub, make the necessary changes to your branch, push those changes back to + your fork and reopen (this will poke @reporobot to look over it again) your pull request.

+
+ +{{{ verify_button }}} diff --git a/resources/contents/uk-UA/challenges/11_merge_tada.html b/resources/contents/uk-UA/challenges/11_merge_tada.html new file mode 100644 index 0000000000..e166073da7 --- /dev/null +++ b/resources/contents/uk-UA/challenges/11_merge_tada.html @@ -0,0 +1,65 @@ +
+

Merge your branch locally, delete the branch and pull from upstream.

+
+ +
+

Cleaning up

+ +

Once you don't need branches anymore you can delete them locally and remotely. This is helpful so that you don't + end up with a pile of old branches.

+
+ +
+

Merge Locally

+

Your pull request has been merged! Your branch was merged into the 'gh-pages' branch of the original on GitHub. + You can merge your branch locally, too.

+ +

First, move into the branch you want to merge into—in this case, the branch 'gh-pages'.

+

git checkout gh-pages

+ +

Now tell Git what branch you want to merge in—in this case, your feature branch that begins with "add-".

+

git merge <BRANCHNAME>

+ +

Tidy up by deleting your feature branch. Now that it has been merged you don't really need it around.

+

git branch -d <BRANCHNAME>

+ +

You can also delete the branch from your remote on GitHub:

+

git push <REMOTENAME> --delete <BRANCHNAME>

+
+ +
+

Pull from Upstream

+

And last but not least, the original has changed since your pull request was merged—Reporobot added your name to + the website! If you pull in these changes from upstream you'll be up to date and have that version too. You can + actually see it live as well at: yourusername.github.io/patchwork.

+ +

To pull from the original upstream:

+

git pull upstream gh-pages

+
+ +
+

Congratulations!

+

You've created local repositories, remote repositories, worked with a collaborator, pushed, pulled and joined the + millions of others developing and enriching open source!

+ +

Visit jlord.github.io/patchwork to see your name + incorporated! Looking to keep going? Checkout the What Next + section on the resources page in this app.

+
+ +{{{ verify_directory_button }}} + +
+ +
diff --git a/resources/contents/uk-UA/challenges/1_get_git.html b/resources/contents/uk-UA/challenges/1_get_git.html new file mode 100644 index 0000000000..e2897c2ac7 --- /dev/null +++ b/resources/contents/uk-UA/challenges/1_get_git.html @@ -0,0 +1,70 @@ +
+

Install Git on your computer and configure your name and email.

+
+ +
+

Git

+

Git is free open source software (the source code is + public) written by Linus Torvalds who also wrote the Linux operating system.

+

Git is a program for keeping track of changes over time, known in programming as version control. + If you've used a track changes feature in a text editing software then you're already familiar with the concept! +

+
+ +
+

Install Git

+

We recommend installing Git on your computer by downloading the GitHub + Desktop app. We'll not use the desktop app in Git-it (we're learning terminal!) but it includes Git and is + the easiest way to install Git on all platforms in the same way.

+ + + +

Already have Git or not sure? Type git --version in your terminal and if it returns a version number + higher than 1.7.10, you're set! For more information, visit the Git + website.

+
+ +
+

Git Software

+

The GitHub Desktop app can do a lot of things with Git but not all, which is why learning the terminal is + important. But once you've got that down, you'll be glad to have the desktop app because it organizes your + project's information more visually, like the GitHub website.

+ +

Git on its own isn't like other programs on your computer. You'll likely not see an icon on your desktop, but it + will always be available to you and you'll be able to access it at anytime from your terminal or Git desktop + applications.

+
+ +
+

Configure Git

+

Once GitHub Desktop (and therefore Git) is installed, open your terminal. + You can verify that Git is really there by typing:

+ +

git --version

+ +

This will return the version of Git on your computer and look something like this:

+ +

git version 1.9.1

+ +

Next, configure Git so it knows to associate your work to you:

+

Set your name:

+

git config --global user.name "Your Name"

+

Now set your email:

+

git config --global user.email "youremail@example.com"

+ +

You're done with your first challenge! Click the 'Verify' button to check the challenge.

+
+ +{{{ verify_button }}} + +
+

Dollar Signs in Code Documentation

+

Dollar signs $ are often used in programming documentation to signify that the line is command + line code (see the code snippets above). You don't actually type the $ in though, only + type what comes after.

+
diff --git a/resources/contents/uk-UA/challenges/2_repository.html b/resources/contents/uk-UA/challenges/2_repository.html new file mode 100644 index 0000000000..9c84dcc4c8 --- /dev/null +++ b/resources/contents/uk-UA/challenges/2_repository.html @@ -0,0 +1,74 @@ +
+

Create a new repository on your computer.

+
+ +
+

Repositories

+

A repository is a collection of related items. In our case, when writing software, it is a + collection of files related to a software project. You can imagine it as a project folder with all the relevant + files inside of it. In fact, that's what it will look like on your computer anyways. Sometimes they're called + "repos" for short.

+ + A drawing of four file folders + +

You tell Git what your project is and Git will start tracking all of the changes to that folder. This makes it a + Git repository: a folder of items being tracked by Git. Git tracks when files are added, subtracted or even a + single letter in a single file is changed. All of this plus who did it and when is tracked by Git. In software, + tracking changes like this is called version control.

+ +

Using Terminal

+

Terminal (or Bash) is a way to instruct your computer to do things by typing commands rather + than clicking applications with your mouse. You can rename files, open files, create new folders, move between + directories (folders) and more all by running typed commands. You can even use a text editor for code (like Vim) in your terminal and + never have to leave!

+ +

Besides navigating your computer, you can also use programs in Terminal that have a command-line + interface (CLI), meaning they can be run with commands in terminal. Git is one of these. The first part + of the command lets your computer know you're talking to Git. The parts following that are the commands and the + different options you want Git to act on.

+ +

In Git-it you'll learn a few basic command-line actions (in addition to Git commands) for navigating your + computer; they're described within the steps.

+
+ +
+

Create a Repository

+

You're going to create a new project folder and then initialize it as a Git repository. We'll name the folder 'hello-world' + in this challenge, but you can choose a different name if you already have a folder named this (it's a common first project name).

+ +

Time to open your terminal! +

+ +

In your terminal window, type these commands, one at a time, pressing enter/return after each.

+ +

First, make a new folder:
Tip: mkdir stands for make directory

+ mkdir hello-world + +

Then go into that folder:
Tip: cd stands for change directory

+ cd hello-world + +

Finally, tell Git to initialize (start tracking) the folder you are now in:

+ git init + +

The last command should return something starting with "Initialized empty Git repository". The others commands do + not return anything.

+ +

You did it! If you want to be double-sure that it's a Git repository, type git status and if it + doesn't return 'fatal: Not a git repository...', you're golden!

+
+ +{{{ verify_directory_button }}} + +
+ +
diff --git a/resources/contents/uk-UA/challenges/3_commit_to_it.html b/resources/contents/uk-UA/challenges/3_commit_to_it.html new file mode 100644 index 0000000000..6394e66cb0 --- /dev/null +++ b/resources/contents/uk-UA/challenges/3_commit_to_it.html @@ -0,0 +1,68 @@ +
+

Create a file in your new repository, add something to that file and commit that change with Git.

+
+ +
+

Commits

+

Commits are core to using Git. They are the moments in which you save and describe the work you've done. They are + the ticks in the timeline of your project's history.

+
+ +
+

Create a New File

+

Now that you've got a repository started let's add a file to it.

+

Open your text editor and create a new empty file. Now write a little bit of text, perhaps type "Hello!", and + save the file as 'readme.txt' in the 'hello-world' folder you created in the last challenge.

+
+ +
+

Check Status + Add and Commit Changes

+

Next check the status of your repository to find out if there have been changes. You know you + have changed something, but does Git?

+ +

Make sure you're still within your 'hello-world' directory when you're running these commands. Use Git to see + what changed in your repository:

+ +

First, check the status:

+

git status

+

Git should tell you that a file has been added.

+ +

Then add the file you just created so that it becomes a part of the changes you will commit + (aka save) with Git:

+

git add readme.txt

+ +

Finally, commit those changes to the repository's history with a + short (m) message describing the updates.

+

git commit -m "Created readme"

+
+ +
+

Step: Make More Changes

+

Now add another line to 'readme.txt' and save the file again.

+ +

In terminal, you can view the difference between the file now and how it was at your last + commit.

+ +

Tell Git to show you the diff:

+

git diff

+ +

Now with what you just learned above, commit this latest change.

+
+ +{{{ verify_directory_button }}} + +
+
diff --git a/resources/contents/uk-UA/challenges/4_githubbin.html b/resources/contents/uk-UA/challenges/4_githubbin.html new file mode 100644 index 0000000000..06872f9728 --- /dev/null +++ b/resources/contents/uk-UA/challenges/4_githubbin.html @@ -0,0 +1,53 @@ +
+

Create a GitHub account and add your username to your Git config.

+
+ +
+

Working Better, Together

+ +

The repository you've created so far is just on your computer, which is handy, but makes it pretty hard to share + and work on with others. No worries, that's what GitHub is for!

+ +

GitHub is a website that allows people everywhere to upload what they're working on with Git so that everyone can + easily work together on the same project. GitHub which acts as the central repository for you and everyone else + to share. You push your changes to it and pull down changes from others.

+
+ +
+

Create a GitHub Account

+ +

Visit github.com and sign up for a free account. High + five, welcome!

+
+ +
+

Add GitHub username to Git

+

Add your GitHub username to your Git configuration. We'll do this just for the sake of Git-it; it makes it easier + to verify the upcoming challenges. Save it exactly as you created it on GitHub and capitalize where + capitalized. Note, you don't need to enter the "<" and ">".

+ +

Add your GitHub username to your Git configuration:

+ git config --global user.username <USerNamE> + +

You can double check what you have set in your Git config by typing:

+ git config --global user.username +
+ +{{{ verify_button }}} + +
+

Make sure you type "user.username" above and not "user.name", which would override the name you + set in the first challenge and leave you with no username property! If you found you did that, it's ok, just + repeat the step in the first challenge to add your name and then complete the step above.

+
+ +
+

GitHub & Git config usernames do not match

+ +

A common error is not having your GitHub username match the case of the one you set with git config. + For instance, 'JLord' isn't the same as 'jlord'

+

To change your username set with Git, just do the same command you did earlier, but with the correct + capitalization:

+

git config --global user.username <USerNamE>

+

When you've made your updates, verify again!

+
diff --git a/resources/contents/uk-UA/challenges/5_remote_control.html b/resources/contents/uk-UA/challenges/5_remote_control.html new file mode 100644 index 0000000000..b0768833a9 --- /dev/null +++ b/resources/contents/uk-UA/challenges/5_remote_control.html @@ -0,0 +1,114 @@ +
+

Connect your local repository to a remote one and push changes to it.

+
+ +
+

Remotes

+ +

When you put something on GitHub that copy lives on one of GitHub's servers. This makes it a + remote repository because it is not on your computer, but on a server, "remote" and somewhere + else. By pushing your local (on your computer) changes to it, you keep it up + to date.

+ +

Others can always then get the latest from your project by pulling your changes down from the + remote (and onto their computer). This is how everyone can work on a project together without needing access to + your computer where your local copy is stored.

+ + A diagram showing GitHub as a central server which creates the GitHub.com website. Two computers, on either side, are pushing and pulling from GitHub. +
+ +
+

Create a Remote Repository

+

You want to sync your local version with one stored on GitHub.com. First create a new remote + repository on GitHub.com.

+ + +
+ +
+

Readmes, .gitignores and Licenses

+

These are common files in open source projects so to make starting a new project easier, GitHub provides an + option for creating them for you.

+

A readme explains what the project is, how to use it, and often times, how to contribute (though + sometimes there is an extra file, 'CONTRIBUTING.md', for those details).

+

A .gitignore is a list of files that Git should not track, for instance, files with + passwords!

+

A license file is the type of license you put on your project. This lets others know how they + can use it. Information on the types is here: choosealicense.com. +

+
+ +
+

Connect your Local to your Remote

+

Now you've got an empty repository started on GitHub.com. At the top you'll see 'Quick Setup', make sure the + 'HTTPS' button is selected and copy the address—this is the address of your repository on GitHub's servers.

+ +

Back in your terminal, and inside of the 'hello-world' folder that you initialized as a Git repository in the + earlier challenge, you want to tell Git to remember the address of the remote version on GitHub's servers. You + can have multiple remotes so each requires a name. The primary remote is typically named origin. +

+ +

To add a remote named 'origin' to your repository:

+ git remote add origin <URLFROMGITHUB> + +

Your local repository now knows where your remote repository, named 'origin', + lives on GitHub's servers. Think of it as adding a name and address on speed dial—now when you need to send + something there, you can.

+ +
+

Windows Users:

+

If you have GitHub Desktop on your computer, a remote named 'origin' is automatically + created in your local repository. In that case, you'll just need to tell it what URL to associate with + 'origin'. Use this command instead of the 'add' one above:

+ + git remote set-url origin <URLFROMGITHUB> +
+
+ +
+

Push Work to your Remote

+

Next you want to push (send) everything you've done locally to your remote repository on GitHub. + This is something you'll do often so that your remote version is up to date and matching the state of your local + version.

+ +

Git has a branching system so that you can work on different parts of a project at different times. We'll learn + more about that later, but by default the first branch is named 'master'. When you push (and later pull) from a + project, you tell Git the branch name you want and the name of the remote that + it lives on.

+ +

In this case, we'll send our branch named 'master' to our remote on GitHub named 'origin'.

+ git push origin master + +

Now go to your remote repository's page on GitHub.com and refresh the page. Wow! Everything is + now the same locally as it is remotely. Congrats on your first public repository!

+
+ +{{{ verify_directory_button }}} + +
+ +
diff --git a/resources/contents/uk-UA/challenges/6_forks_and_clones.html b/resources/contents/uk-UA/challenges/6_forks_and_clones.html new file mode 100644 index 0000000000..0105e1b5c8 --- /dev/null +++ b/resources/contents/uk-UA/challenges/6_forks_and_clones.html @@ -0,0 +1,86 @@ +
+

Fork a project from GitHub.com and clone it locally.

+
+ +
+

Forks

+

So far you have made a project locally and pushed it to GitHub, but that's only half the fun! The other half is + working with other people and other projects.

+ +

When you fork a repository, you're creating a copy of it on your GitHub account. Your forked + copy begins its life as a remote repository—it exists just on your GitHub account, not on your + computer. Forks are used for creating your own version of a project (this diversion from the original is like + taking a fork in the road) or contributing back your changes (such as bug fixes or new features) to the original + project.

+ +

To get a forked repository from your GitHub account onto your computer you clone it. This + cloning action copies the remote repository onto your computer so that you can work on it locally.

+ + A diagram showing a repository from GitHub copied onto your GitHub account and then copied onto your local computer from there. +
+ +
+

Fork the Patchwork Repository

+

The project we'll work with is at github.com/jlord/patchwork. + Go to that page and click the 'Fork' button at the top right. Once the forking animation is complete, you have a + copy on your account. Copy your fork's HTTP URL from the address bar in your browser, this is the address of + your fork on GitHub's servers.

+ +
+ +
+

Clone Your Fork Locally

+

Now, in terminal, you'll clone the repository onto your computer. It will automatically create a new folder for + the repository so there is no need to create one yourself. But make sure you aren't cloning it inside of another + Git repository folder!

+ +

So be sure you're not inside of the 'hello-world' directory from the previous challenges. To back out and leave + this folder so that you can clone, follow these steps:

+ +

Back out of your 'hello-world' folder:
Tip: the two dots mean step out of a directory one level +

+

cd ..

+ +

Now that you're no longer in another Git repository, clone your fork:

+

git clone <URLFROMGITHUB>

+ +

Go into the folder it created for your local copy of the fork (in this case, named 'patchwork').

+

cd patchwork

+ +

Now you've got a copy of the repository on your computer and it is automatically connected to the remote + repository (your forked copy) on your GitHub account. Type git remote -v to see that the address to + the fork is already set up.

+
+ +
+

Connect to the Original Repository

+ +

What if the original repository you forked happens to change? You'll want to be able to pull in + those changes too. So let's add another remote connection, this time to the original, github.com/jlord/patchwork, repository with + its URL.

+ +

You can name this remote connection anything you want, but typically people use the name 'upstream'; let's use + that for this.

+ +

git remote add upstream https://github.com/jlord/patchwork.git

+ +

To be sure you have the correct remotes set up, type git remote -v to list out the addresses you + have stored. You should have an 'origin' remote with your fork's address and then an 'upstream' remote with + the address to the original, the URL noted above in this step.

+
+ +{{{ verify_directory_button }}} + +
+ +
diff --git a/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html b/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html new file mode 100644 index 0000000000..570dc867d9 --- /dev/null +++ b/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html @@ -0,0 +1,124 @@ +
+

Add a branch, locally, to your forked repository to work on your changes.

+
+ +
+

Branches

+

Git repositories use branches to isolate work when needed. It's common practice when working on a project or with + others on a project to create a branch to keep your working changes in. This way you can do + your work while the main, commonly named 'master', branch stays stable. When the work on your branch is finished + you merge it back into the 'master' master branch.

+ +

The diagram below shows how you can branch off of your 'master' branch, do work and the merge those changes back + into 'master'. You can even branch off of a branch if you need to, the 'master' branch doesn't have to be the + base.

+ + A diagram showing a horizontal line, representing the master branch, with another line branching off the top and later re-joining the original. Another line branches off the master branch line from below and yet another branch branches off of that. Both of these meet back up with the original master line, too. + +

For a great visualization on how branches work in a project, see this GitHub Guide: guides.github.com/overviews/flow

+ +

GitHub Pages

+

GitHub will automatically serve and host static website files in branches named 'gh-pages'. This free service is + called GitHub Pages. Since the project you forked creates a website, its + main branch is named 'gh-pages' instead of 'master'. All repositories that have a 'gh-pages' branch with website + files can be found, live online, using this pattern for the URL:

+ + http://githubusername.github.io/repositoryname +
+ +
+

Create a branch

+

When you create a branch, Git copies everything from the current branch you're on and places it in the branch + you've requested be made.

+ +

While still inside of your local 'patchwork' repository, type git status to see what branch you're + currently on. Git should reply that you're on the 'gh-pages' branch.

+ +

Now create a new branch and name it "add-<username>", where 'username' is your username. For instance, + "add-jlord". Branches are case-sensitive so name your branch exactly the way your GitHub name + appears.

+ +

git branch <BRANCHNAME>

+ +

Now you have a branch with a new name that is identical to 'gh-pages'.

+ +

To go into that branch and work on it you checkout a branch. Go on your new branch:

+ +

git checkout <BRANCHNAME>

+
+ +
+

Step: Create a new file

+

Back in your text editor:

+ +
+ +
+

Check-in

+

Go through the steps for checking in a project:

+ +

git status

+

git add <contributors/FILENAME>

+

git commit -m "commit message"

+ +

Now push your update to your fork, 'origin', on GitHub:

+

git push origin <BRANCHNAME>

+
+ +{{{ verify_directory_button }}} + +
+

Permission denied...error: 403

+

You are pushing changes to a repository you don't have write access to. In this case, you're likely pushing ot + the original 'jlord/patchwork'. Make sure that you're pushing to 'origin' and that it points to your fork's + address on GitHub. To check and see what your remotes are and where they point run git remote -v. + You should have 'upstream' pointing to 'jlord/patchwork' and 'origin' pointing to 'yourusername/patchwork'. + +

To fix a remote that is pointing to the wrong place you can re-set its url: git remote set-url origin + + . + +

Authentication failed...error: 401

+

Your identity could not be verified. You may have 2FA (Two Factor Authentication) turned on in which case you must use a personal access token as your password. You can generate one by following these instructions. You'll need to keep this and use it in place of your password when prompted. You can also save this access token on your computer so that you don't have to re-enter it.

+ +

File NOT in contributors folder

+

The file you create should be placed inside the existing 'contributors' folder in the Patchwork repository. If + you put it somewhere else, simply use Finder or Windows Explorer to move your file into the folder. You can + check git status again and you'll find it sees your changes. Stage and then commit "all" (-A) of + these changes (additions and deletions) with the commands below.

+

git add -A

+

git commit -m "move file into contributors folder"

+ +

Branch name expected: _____

+

The branch name should match your user name exactly. To change your branch name:

+

git branch -m <NEWBRANCHNAME>

+

When you've made your updates, verify again!

+
+ +
+ +
diff --git a/resources/contents/uk-UA/challenges/8_its_a_small_world.html b/resources/contents/uk-UA/challenges/8_its_a_small_world.html new file mode 100644 index 0000000000..782061bab3 --- /dev/null +++ b/resources/contents/uk-UA/challenges/8_its_a_small_world.html @@ -0,0 +1,31 @@ +
+

Add a collaborator to your project.

+
+ +
+

Social Coding

+

Working with others is one of the best things about GitHub because it is easier to work from any place or + timezone with someone else.

+ +

Collaborators are other GitHub users who are given permission to make edits to a repository + owned by someone else. You may also hear the term contributors, this describes another GitHub + user who have made contributions, through a Fork and Pull Request, to a project.

+ + A photo of a cat with a space helment drawn on. This is Reporobot the cat and your collaborator + @reporobot is a robot from outer space that loves collaborating on repos. +
+ +
+

Hello, Repo Robot!

+

To add collaborators to one of your projects, visit the repository's page on your GitHub account and click the + 'Settings' tab in the menu in the upper part of the page. Then select the 'Collaborators' option. Type the + username into the text box add and click 'Add'.

+ +

Go to your forked Patchwork repository's page on GitHub and add 'reporobot' as a collaborator. The URL should + look like this, but with your username.

+ + github.com/YOURUSERNAME/patchwork/settings/collaboration +
+ +{{{ verify_button }}} diff --git a/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html b/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html new file mode 100644 index 0000000000..75216a52ab --- /dev/null +++ b/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html @@ -0,0 +1,39 @@ +
+

Keep your file up to date by pulling in changes from collaborators.

+
+ +
+

Pulling from a Remote

+

If you're working on something with someone else you need to stay up to date with the latest changes. So you'll + want to pull in any changes that may have been pushed to the central GitHub repository.

+ + A diagram shows a computer pulling information down from a repository's website +
+ +
+

What has Reporobot been up to?

+

See if Reporobot has made any changes to your branch by pulling in any changes from the remote named 'origin' on + GitHub:

+ +

git pull <REMOTENAME> <BRANCHNAME>

+ +

If nothing's changed, it will tell you 'Already up-to-date'. If there are changes, Git will merge those changes + into your local version.

+ +

Did Reporobot make changes? Git tells you where changes were made. You can open that file and see Reporobot's + updates. Surprise, Reporobot is an artist!

+
+ +{{{ verify_directory_button }}} + +
+ +
diff --git a/resources/contents/uk-UA/pages/about.html b/resources/contents/uk-UA/pages/about.html new file mode 100644 index 0000000000..a629ebdd72 --- /dev/null +++ b/resources/contents/uk-UA/pages/about.html @@ -0,0 +1,12 @@ +

Про Git-it

+

Git-it навчає основам, Git команди які розробники використовують кожного дня

+ +

Деякі завдання потребують з’єднання із інтернетом, тому вам потрібно бути в мережі, щоб завершити Git-it. Проте, ви можете в будь-який момент відкрити додаток офлайн щоб подивитися завдання.

+ +

Справжнє робоче оточення

+ +

Git-it використовує справжній термінал, Git та GitHub (замість того щоб емулювати їх). Після закінчення воркшопу у вас будуть справжні репозиторії на GitHub аккаунті та відмітки на графіку комітів.

+ +

The Code that Made Git-it

+ +

Додаток зроблений на HTML, CSS та JS та використовує Electron. Весь код Git-it знаходиться на GitHub. Git-it зроблено із ❤ @jlord та контрибюторами.

diff --git a/resources/contents/uk-UA/pages/dictionary.html b/resources/contents/uk-UA/pages/dictionary.html new file mode 100644 index 0000000000..d99b5a4e2a --- /dev/null +++ b/resources/contents/uk-UA/pages/dictionary.html @@ -0,0 +1,108 @@ +

Нижче наведено команди Git та терміналу які використовуються у Git-it завданнях.

+ +

Bash/Terminal Основи

+
+ +
+ +

Налаштування Git

+
+ +
+ +

Основи Git

+
+ +
+ +

Вітки Git

+
+ +
+ +

Git Remotes

+
+ +
+ +

Отримання змін Git

+
+ +
+ +

Push & Merge у Git

+
+ +
+ +

Видалення віддалених репозиторіїв та віток у Git

+
+ +
diff --git a/resources/contents/uk-UA/pages/index.html b/resources/contents/uk-UA/pages/index.html new file mode 100644 index 0000000000..a4cfd69d3d --- /dev/null +++ b/resources/contents/uk-UA/pages/index.html @@ -0,0 +1,116 @@ + + + + + Git-it + + + + + + + + +
+
+ +
+ Git-it +
+ +
+
+ Виконані завдання: + +
+
+
+
+
+
+
+
+
+
+
+ + +
+ +
+

Привіт!

+

Git-он навчає основам використання Git і GitHub. Ці навички ви будете використовувати постійно у своїй роботі, як над власними проектами, так і вкладаючи свою частку у

+ +
+

Але це ще не все

+

Ви також можете пройти Git-it на Традиційній Китайській чи Японській, + просто оберіть мову яку ви хочете у лівому верхньому меню

+ +

Ви можете перейти до сторінок Словник, Ресурси та Про воркшоп

+
+ + + + +
+ +
+ +

On your way!

+

Ви на шляху до успіху, продовжуйте в тому ж дусі! Можете глянути де ви зупинилися

+ + + +
+ +
+ +

Вітання!

+

Ви закінчили усі завдання, тепер можна приступати до

+ + + + +
+ +
+ + + diff --git a/resources/contents/uk-UA/pages/resources.html b/resources/contents/uk-UA/pages/resources.html new file mode 100644 index 0000000000..b766c42174 --- /dev/null +++ b/resources/contents/uk-UA/pages/resources.html @@ -0,0 +1,50 @@ +

Resources

+

To reinforce what you just learned or to try another way, here are suggestions for other guides and tutorials.

+

If you're ready to dive into a project, jump to the beginner projects section.

+ +
+

Interactive Tutorial

+ + +

Guides, Books and Cheatsheets

+ + +

GitHub Desktop

+

You likely installed this before you started Git-it but if you didn't, here's the link.

+

The GitHub Desktop app lets you do much of what you can do in terminal (though not all) and is a bit easier to + read at times. Personally, I use it to look over anything not small diff I have. Your changes are + really nice to see this way.

+ +
+ +

What Next?

+
+

Now that you're feeling good because you've got the fundamentals down, here are some beginner project ideas to + keep you going!

+ +
diff --git a/resources/contents/uk-UA/partials/chal-footer.html b/resources/contents/uk-UA/partials/chal-footer.html new file mode 100644 index 0000000000..635e2fd4fd --- /dev/null +++ b/resources/contents/uk-UA/partials/chal-footer.html @@ -0,0 +1,12 @@ +
+
+ {{ prename }} +
+ +
+
+ {{ nextname }} +
+ +
+
diff --git a/resources/contents/uk-UA/partials/chal-header.html b/resources/contents/uk-UA/partials/chal-header.html new file mode 100644 index 0000000000..3338b1ad6d --- /dev/null +++ b/resources/contents/uk-UA/partials/chal-header.html @@ -0,0 +1,16 @@ + + + \ No newline at end of file diff --git a/resources/contents/uk-UA/partials/chal-sidebar.html b/resources/contents/uk-UA/partials/chal-sidebar.html new file mode 100644 index 0000000000..db6c8ae163 --- /dev/null +++ b/resources/contents/uk-UA/partials/chal-sidebar.html @@ -0,0 +1,15 @@ + diff --git a/resources/contents/uk-UA/partials/footer.html b/resources/contents/uk-UA/partials/footer.html new file mode 100644 index 0000000000..8922caf2cd --- /dev/null +++ b/resources/contents/uk-UA/partials/footer.html @@ -0,0 +1,11 @@ + diff --git a/resources/contents/uk-UA/partials/header.html b/resources/contents/uk-UA/partials/header.html new file mode 100644 index 0000000000..31b907e85c --- /dev/null +++ b/resources/contents/uk-UA/partials/header.html @@ -0,0 +1,17 @@ + + + + \ No newline at end of file diff --git a/resources/contents/uk-UA/partials/verify-button.html b/resources/contents/uk-UA/partials/verify-button.html new file mode 100644 index 0000000000..65a2e2f18c --- /dev/null +++ b/resources/contents/uk-UA/partials/verify-button.html @@ -0,0 +1,10 @@ +
+ +
+
+
+
+ + +
diff --git a/resources/contents/uk-UA/partials/verify-directory-button.html b/resources/contents/uk-UA/partials/verify-directory-button.html new file mode 100644 index 0000000000..09a2c4c0f2 --- /dev/null +++ b/resources/contents/uk-UA/partials/verify-directory-button.html @@ -0,0 +1,13 @@ +
+ + +
+
+
+
+ Оберіть директорію репозиторія. + + + +
From 03f40f17104619710c1f74c6fbf60808b604c42f Mon Sep 17 00:00:00 2001 From: Andrii Komarnitskyi Date: Mon, 27 Mar 2017 12:27:03 +0300 Subject: [PATCH 2/4] finished pages translate --- resources/contents/uk-UA/pages/index.html | 2 +- resources/contents/uk-UA/pages/resources.html | 49 +++++++++---------- 2 files changed, 24 insertions(+), 27 deletions(-) diff --git a/resources/contents/uk-UA/pages/index.html b/resources/contents/uk-UA/pages/index.html index a4cfd69d3d..617031806f 100644 --- a/resources/contents/uk-UA/pages/index.html +++ b/resources/contents/uk-UA/pages/index.html @@ -41,7 +41,7 @@

Привіт!

-

Git-он навчає основам використання Git і GitHub. Ці навички ви будете використовувати постійно у своїй роботі, як над власними проектами, так і вкладаючи свою частку у

+

Git-it навчає основам використання Git і GitHub. Ці навички ви будете використовувати постійно у своїй роботі, як над власними проектами, так і вкладаючи свою частку у

Але це ще не все

diff --git a/resources/contents/uk-UA/pages/resources.html b/resources/contents/uk-UA/pages/resources.html index b766c42174..887e1d9bd4 100644 --- a/resources/contents/uk-UA/pages/resources.html +++ b/resources/contents/uk-UA/pages/resources.html @@ -1,50 +1,47 @@ -

Resources

-

To reinforce what you just learned or to try another way, here are suggestions for other guides and tutorials.

-

If you're ready to dive into a project, jump to the beginner projects section.

+

Ресурси

+

Для того, щоб зміцнити те, що ви тільки що дізналися, або спробувати інший спосіб, тут зібрані посилання на інші інструкції та підручники.

+

Якщо ви уже готові до справжнього проекту, перейдіть до проектів для початківців.

-

Interactive Tutorial

+

Інтерактивний підручник

    -
  • Try Git (Uses an terminal emulator) by CodeSchool +
  • Спробувати Git (Використовуючи емулятор терміналу) від CodeSchool
-

Guides, Books and Cheatsheets

+

Інструкції, книги та шпаргалки

GitHub Desktop

-

You likely installed this before you started Git-it but if you didn't, here's the link.

-

The GitHub Desktop app lets you do much of what you can do in terminal (though not all) and is a bit easier to - read at times. Personally, I use it to look over anything not small diff I have. Your changes are - really nice to see this way.

+

Напевне, ви уже встановили це, перш ніж взятися за Git-it але якщо ні, ось посилання.

+

GitHub Desktop дозволяє робити майже все що ви робите через термінал (але не все) значно простіше. Наприклад, я використовую його для буль зручного переглядудіфів.

-

What Next?

+

Що далі?

-

Now that you're feeling good because you've got the fundamentals down, here are some beginner project ideas to - keep you going!

+

Тепер, коли ви вже впевнено почуваєте себе із Git, ось кілька ідей для початківців:

From 8ae4e5826385771ccbb2dd8024eba154fbe94718 Mon Sep 17 00:00:00 2001 From: Andrii Komarnitskyi Date: Mon, 27 Mar 2017 18:46:28 +0300 Subject: [PATCH 3/4] ua translate for challenge 1 --- .../contents/uk-UA/challenges/1_get_git.html | 53 ++++++++----------- 1 file changed, 23 insertions(+), 30 deletions(-) diff --git a/resources/contents/uk-UA/challenges/1_get_git.html b/resources/contents/uk-UA/challenges/1_get_git.html index e2897c2ac7..fca79a1cea 100644 --- a/resources/contents/uk-UA/challenges/1_get_git.html +++ b/resources/contents/uk-UA/challenges/1_get_git.html @@ -1,70 +1,63 @@
-

Install Git on your computer and configure your name and email.

+

Встановіть Git на ваш комп'ютер та налаштуйте своє ім'я та email.

Git

-

Git is free open source software (the source code is - public) written by Linus Torvalds who also wrote the Linux operating system.

-

Git is a program for keeping track of changes over time, known in programming as version control. - If you've used a track changes feature in a text editing software then you're already familiar with the concept! +

Git - безкоштовний,(програмне забезпечення із відкритим вихідним кодом) створений Лінусом Торвальдом, який також написав операційну систему Linux.

+

Git - це програма відслідковування змін в проекті протягом розробки, відома в програмуванні як система контролю версій. + Якщо ви використовуєте функцію відслудковування змін у своєму текстовому редакторі чи IDE, ви уже знайомі із ідеєю контролю версій!

-

Install Git

-

We recommend installing Git on your computer by downloading the GitHub - Desktop app. We'll not use the desktop app in Git-it (we're learning terminal!) but it includes Git and is - the easiest way to install Git on all platforms in the same way.

+

Встановлення Git

+

Ми рекомендуємо встановлювати Git встановивши додаток GitHub + Desktop. Ми не використовуємо додаток у Git-it (ми вивчаємо термінал!) але він містить у собі Git і простий у встановленні для будь-якої операційної системи.

    -
  • Windows: Use the Git Shell for your terminal.
    • -
  • Mac: Open GitHub Desktop and from Preferences, select the command line tools install. Use - the terminal app as your terminal. +
  • Windows: Використовуйте Git Shell для терміналу.
    • +
  • Mac: Відкрийте GitHub Desktop і із пункту меню Preferences, оберіть command line tools install. Використовуйте + додаток terminal як ваш термінал.
-

Already have Git or not sure? Type git --version in your terminal and if it returns a version number - higher than 1.7.10, you're set! For more information, visit the Git +

Уже маєте Git або не впевнені? Виконайте git --version у вашому терміналі, і якщо у відповідь отримаєте версію вище 1.7.10, тоді усе готово! Щоб отримати більше інформації, відвідайте Git website.

Git Software

-

The GitHub Desktop app can do a lot of things with Git but not all, which is why learning the terminal is - important. But once you've got that down, you'll be glad to have the desktop app because it organizes your - project's information more visually, like the GitHub website.

+

Додаток GitHub Desktop може робити багато речей з Git, але не все, тому вивчення терміналу є +          важливим. Але після вивчення роботи із Git через термінал, буде зручно перейти на Git Desktop App, через те що він уміє більш наочно показати інформацію.

-

Git on its own isn't like other programs on your computer. You'll likely not see an icon on your desktop, but it - will always be available to you and you'll be able to access it at anytime from your terminal or Git desktop - applications.

+

Git не схожий на інші ваші програми, швидше за все ви не побачите його іконки на робочому столі, проте він завжди буде доступний у терміналі, або у графічному інтерфейсі Git Desktop App.

-

Configure Git

-

Once GitHub Desktop (and therefore Git) is installed, open your terminal. - You can verify that Git is really there by typing:

+

Конфігурація Git

+

Коли GitHub Desktop (і відповідно Git) буде встановлено, відкрийте свій термінал. + Ви можете перевірити Git просто ввівши:

git --version

-

This will return the version of Git on your computer and look something like this:

+

Це перевне версію Git що встановлено на комп'юері, виглядатиме наступним чином:

git version 1.9.1

-

Next, configure Git so it knows to associate your work to you:

+

Далі, налаштуйте Git щоб він знав, із ким асоціювати те що ви робите:

Set your name:

git config --global user.name "Your Name"

Now set your email:

git config --global user.email "youremail@example.com"

-

You're done with your first challenge! Click the 'Verify' button to check the challenge.

+

Ви виконали перше завдання! Натисність кнопку 'Перевірити' щоб перевірити завдання.

{{{ verify_button }}}
-

Dollar Signs in Code Documentation

-

Dollar signs $ are often used in programming documentation to signify that the line is command - line code (see the code snippets above). You don't actually type the $ in though, only - type what comes after.

+

Символ долара в документації

+

Символ $ часто зустрічається в документації, щоб позначити що рядок відповідає коду командного рядка. Вам не потрібно вводити символ $ + , а лише те що слідує за ним.

From 2d3ab113439f16d7ebb11eeaef97489fbdc3e2aa Mon Sep 17 00:00:00 2001 From: Andrii Komarnitskyi Date: Thu, 30 Mar 2017 14:17:46 +0300 Subject: [PATCH 4/4] finished ukrainian translation --- .../10_requesting_you_pull_please.html | 59 +++++----- .../uk-UA/challenges/11_merge_tada.html | 55 ++++----- .../uk-UA/challenges/2_repository.html | 73 +++++------- .../uk-UA/challenges/3_commit_to_it.html | 64 +++++----- .../uk-UA/challenges/4_githubbin.html | 44 +++---- .../uk-UA/challenges/5_remote_control.html | 105 +++++++---------- .../uk-UA/challenges/6_forks_and_clones.html | 75 ++++++------ .../7_branches_arent_just_for_birds.html | 111 +++++++++--------- .../uk-UA/challenges/8_its_a_small_world.html | 31 ++--- .../challenges/9_pull_never_out_of_date.html | 32 ++--- resources/contents/uk-UA/pages/index.html | 3 +- .../contents/uk-UA/partials/chal-footer.html | 18 +++ 12 files changed, 328 insertions(+), 342 deletions(-) diff --git a/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html b/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html index e37100b32e..7d71e1e4dd 100644 --- a/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html +++ b/resources/contents/uk-UA/challenges/10_requesting_you_pull_please.html @@ -1,56 +1,57 @@ +
-

Submit a Pull Request to the original Patchwork repository.

+

Надішліть Pull Request до оригінального Patchwork репозиторію.

-

Pull Requests

-

Often when you make changes and improvements to a project you've forked, you'll want to send those changes to the - maintainer of the original and request that they pull those changes into the - original so that everyone can benefit from the updates—that's a pull request.

+

Pull реквести

+

Часто, коли ви робите зміни до проекту над яким ви працюєте (forked), ви хочете надіслати ці зміни до + упорядника проекту і зробити запит, щоб вони могли затягнути ваші зміни до віддаленого + репозиторію, таким чином будь-хто може скористатися оновленнями які ви внесли - це pull request.

-

We want to add you to the list of workshop finishers, so make a pull request to add your - username file to the original: github.com/jlord/patchwork. -

+

Ми хочемо додати вас до списку тих хто завершив воркшоп, будь ласка, зробіть pull request щоб додати + ваш файл з іменем до першоджерела: github.com/jlord/patchwork.

An illustration showing two options. The latter option contains more of the alphabet than the first and is asking the first to accept its work so that the alapabet is complete.
-

Create a pull request

-

Visit the original repository you forked on GitHub, in this case http://github.com/jlord/patchwork. +

Створення pull request

+

Відвідайте початковий репозиторій який ви (forked) на GitHub, в нашому випадку це http://github.com/jlord/patchwork.

-

Often GitHub will detect if you've pushed a branch to a fork and display it at the top of the original's website. - If you see that with your 'add-username' branch, you can click to create a Pull Request from there. If not:

+

Часто GitHub буде відслідковувати чи ви викладали гілку до віддаленого репозиторію і показувати її в верхній частині веб-сайту. + Якщо гілка з назвою 'add-username' присутня, ви можете створити Pull Request натиснувшити на неї. Якщо ні: +

    -
  • Click the green 'New pull request' button.
    • -
  • Select the branch with the changes you want to submit. It should be the one with 'add-yourusername'.
    • +
  • Натисніть на зелену кнопку 'New pull request'.
    • +
  • Виберіть гілку зі змінами які вихочите надіслати. Це повинна бути гілка з 'add-yourusername'.
-

You'll now see a page with the details of the pull request you're in the process of submitting. This page shows - the commits and changes, in the form of a diff, associated with your pull request as compared to the 'gh-pages' - branch of the original.

+

Тепер ви зможете побачити сторінку з деталями про pull request який зараз знаходиться у процесі надсилання. + Ця сторінка показує комміти та зміни, у вигляді схеми, повязаними з вашим pull request і в порівнянні з 'gh-pages' + гілкою з початкового репозиторію.

-

If the original repository has a contribution documentation, GitHub will link to it. This is - documentation from repository owners on how to best make contributions to that project—very helpful to read if - you'd like to see your changes adopted!

+

Якщо початковий репозиторій має contribution documentation, GitHub вкаже посилання на неї. + Це документація від власників репозиторію, яка описує як робити зміни в цей проект і якшо ви хочете, щоб ваші зміни + були додані, варто звернути на неї увагу.

-

If everything on the page looks good and as you expect it:

+

Якщо все на сторінці виглядає так як ви очікуєте:

    -
  • Click 'Create pull request'
    • -
  • Add a title and description to the changes you're suggesting the original author pull in.
    • -
  • Click 'Send pull request'!
    • +
  • Натисніть 'Create pull request'
    • +
  • Додайте назву та опис до змін, які ви просити власника репозиторію затягнути.
    • +
  • Натисніть 'Send pull request'!
-

Bingo! You submitted a pull request—take a few seconds to bask in the moment. +

Бінго! Ви додали pull request - зупиніться на хвильку і насолодіться моментом. -

If all is well with your pull request, it will be merged within moments. If it's not merged automatically within - a few minutes, you'll then likely have some comments from @reporobot on why it couldn't merge it. If this is the - case, close your pull request on GitHub, make the necessary changes to your branch, push those changes back to - your fork and reopen (this will poke @reporobot to look over it again) your pull request.

+

Якщо все добре з вашим pull request, він буде злитий протягом декількох секунд. Якщо він не був автоматично злитий + протягом декількох хвилин, скоріше за все ви отримаєте коментарі від @reporobot чому злиття не пройшло вдало. + Якщо такі коментарі присутні, закрийте pull request на GitHub, внесіть необхідні зміни до вашої гілки, надішліть зміни + до репозиторію та перевідкрийте ваш pull request, що в свою чергу змусить @reporobot переглянути їх знову.

{{{ verify_button }}} diff --git a/resources/contents/uk-UA/challenges/11_merge_tada.html b/resources/contents/uk-UA/challenges/11_merge_tada.html index e166073da7..9da8298631 100644 --- a/resources/contents/uk-UA/challenges/11_merge_tada.html +++ b/resources/contents/uk-UA/challenges/11_merge_tada.html @@ -1,65 +1,66 @@
-

Merge your branch locally, delete the branch and pull from upstream.

+

Мердж гілки локально, видалення гілки зтягнення з upstream.

-

Cleaning up

+

Очищення

-

Once you don't need branches anymore you can delete them locally and remotely. This is helpful so that you don't - end up with a pile of old branches.

+

Якщо гілки більше не потрібні, ви можете видалити їх локально і віддалено. Вчасне видалення - + зручний спосіб підтримання чистоти і зручної структурованості репозиторію.

-

Merge Locally

-

Your pull request has been merged! Your branch was merged into the 'gh-pages' branch of the original on GitHub. - You can merge your branch locally, too.

+

Локальний мердж

+

Ваш pull request був злитий. Ваша гілка була злита в гілку 'gh-pages' оригінального репозиторію на GitHub. + Ви можете злити вашу гілку також локально.

-

First, move into the branch you want to merge into—in this case, the branch 'gh-pages'.

+

Для початку, перемістіться у гілку в яку ви хочете змерджити, в нашому випадку це буде гілка 'gh-pages'.

git checkout gh-pages

-

Now tell Git what branch you want to merge in—in this case, your feature branch that begins with "add-".

+

Тепер вкажіть яку саме гілку ви хочете сюди змерджити. В цьому випадку, ваша гілку яка починається з "add-".

git merge <BRANCHNAME>

-

Tidy up by deleting your feature branch. Now that it has been merged you don't really need it around.

+

Очистіть репозиторій за рахунок видалення цієї гілки. Тепер коли вона вже була злита вам вона вже не потрібна тут.

git branch -d <BRANCHNAME>

-

You can also delete the branch from your remote on GitHub:

+

Ви також можете видалити цю гілку з віддаленого репозиторію на GitHub:

git push <REMOTENAME> --delete <BRANCHNAME>

-

Pull from Upstream

-

And last but not least, the original has changed since your pull request was merged—Reporobot added your name to - the website! If you pull in these changes from upstream you'll be up to date and have that version too. You can - actually see it live as well at: yourusername.github.io/patchwork.

+

Затягнення з Upstream

+

І останній пункт, який також є дуже важливим, початковий репозиторій був змінений коли ваш pull request був злитий. + Reporobot додав ваше імя на веб-сайті. Якщо ви затягнете ці зміни з upstream, ви отримаєте зміни які є в тій версії також. + Ви можете переглянути їх в: yourusername.github.io/patchwork.

-

To pull from the original upstream:

+

Щоб затягнути з original upstream:

git pull upstream gh-pages

-

Congratulations!

-

You've created local repositories, remote repositories, worked with a collaborator, pushed, pulled and joined the - millions of others developing and enriching open source!

+

Вітаємо!

+

Ви створили локальний репозиторій, віддалений репозиторій, попрацювали в парі, викладали, затягували і долучились + до міліонів інших розробників який розвивають та насичують open source!

-

Visit jlord.github.io/patchwork to see your name - incorporated! Looking to keep going? Checkout the What Next - section on the resources page in this app.

+

Відвідайте jlord.github.io/patchwork щоб побачити своє ім'я! Думаєте що далі? Гляньте сюди.

{{{ verify_directory_button }}}
    -
  • Merge a branch into current branch
    • +
  • Злити в поточну гілку
    • git merge <BRANCHNAME> -
  • Change the branch you're working on
    • +
  • Змінити гілку в якій ви працюєте
    • git checkout <BRANCHNAME> -
  • Delete a local branch
    • +
  • Видалити локальну гілку
    • git branch -d <BRANCHNAME> -
  • Delete a remote branch
    • +
  • Видалити віддалену гілку
    • git push <REMOTENAME> --delete <BRANCHNAME> -
  • Pull from a remote branch
    • +
  • Затягнути с віддаленого репозиторію
    • git pull <REMOTENAME> <BRANCHNAME>
+ + + diff --git a/resources/contents/uk-UA/challenges/2_repository.html b/resources/contents/uk-UA/challenges/2_repository.html index 9c84dcc4c8..f649d9ae9f 100644 --- a/resources/contents/uk-UA/challenges/2_repository.html +++ b/resources/contents/uk-UA/challenges/2_repository.html @@ -1,74 +1,65 @@
-

Create a new repository on your computer.

+

Створити новий репозиторій на вашому комп'ютері.

-

Repositories

-

A repository is a collection of related items. In our case, when writing software, it is a - collection of files related to a software project. You can imagine it as a project folder with all the relevant - files inside of it. In fact, that's what it will look like on your computer anyways. Sometimes they're called - "repos" for short.

+

Репозиторії

+

Репозиторій це колекція схожих матеріалів. У нашому випадку, при написанні програмного забезпечення, це колекція файлів які відносяться до проекту. Ви можете уявити це як папку із файлами. Насправді, це так і виглядатиме на вашому комп'ютері. Інколи їх називають + "repos", так коротше.

A drawing of four file folders -

You tell Git what your project is and Git will start tracking all of the changes to that folder. This makes it a - Git repository: a folder of items being tracked by Git. Git tracks when files are added, subtracted or even a - single letter in a single file is changed. All of this plus who did it and when is tracked by Git. In software, - tracking changes like this is called version control.

- -

Using Terminal

-

Terminal (or Bash) is a way to instruct your computer to do things by typing commands rather - than clicking applications with your mouse. You can rename files, open files, create new folders, move between - directories (folders) and more all by running typed commands. You can even use a text editor for code (like Vim) in your terminal and - never have to leave!

- -

Besides navigating your computer, you can also use programs in Terminal that have a command-line - interface (CLI), meaning they can be run with commands in terminal. Git is one of these. The first part - of the command lets your computer know you're talking to Git. The parts following that are the commands and the - different options you want Git to act on.

- -

In Git-it you'll learn a few basic command-line actions (in addition to Git commands) for navigating your - computer; they're described within the steps.

+

Ви кажете Git де знаходиться ваш проект та Git почне відслідковувати всі зміни всередині неї. Це зробить + Git репозиторій: папка, зміни в якій відслідковує Git. Git відслідковує коли файли були додані, видалені, або були внесені зміни всередині. Все це, а також те, хто вносив зміни, відслідковує Git. У розробці програмного забезпечення, + подібні відслідковування називається контролем версій.

+ +

Використання терміналу

+

Термінал (або Bash) спосіб задання команд вашому комп'ютеру, швидше ніж кліки мишкою. Ви можете перейменувати файли, відкрити, створити нові папки, + переміщатися між папками та багато іншого за допомогою введення команд. Ви можете навіть використовувати текстовий редактор в терміналі! (наприклад Vim)

+ +

Окрім навігації по комп'ютеру, ви можете використовувати у терміналі програми які мають command-line + interface (CLI), що означає, що вони мають можливість керуватися командами із терміналу. Git — одна із них. Перша частина + команди дає знати що ви звертаєтеся саме до Git. Все те що слідує за нею - різні команди і опції які повинен виконати Git.

+ +

У Git-it ви навчитеся деяким базовим діям використовуючи командний рядок для навігації по вашиму комп'ютері;

-

Create a Repository

-

You're going to create a new project folder and then initialize it as a Git repository. We'll name the folder 'hello-world' - in this challenge, but you can choose a different name if you already have a folder named this (it's a common first project name).

+

Створення репозиторія

+

Ви збираєтеся творити нову папку проекта та ініціалізувати у ній Git репозиторій. Назвемо папку 'hello-world', але ви можете вибрати будь-яке інше ім'я, якщо у вас уже є папка із такою назвою.

-

Time to open your terminal! +

Час відкрити ваш термінал!

-

In your terminal window, type these commands, one at a time, pressing enter/return after each.

+

У вікні вашого терміналу, введіть ці команди, по одній за раз, натисніть enter/return після кожної.

-

First, make a new folder:
Tip: mkdir stands for make directory

+

Перше, створимо нову папку:
Підказка: mkdir використовується для створення папки

mkdir hello-world -

Then go into that folder:
Tip: cd stands for change directory

+

Далі, перейдіть до цієї папки:
Підказка: cd використовується для зміни папки

cd hello-world -

Finally, tell Git to initialize (start tracking) the folder you are now in:

+

Останнє, скажіть Git щоб він ініціалізувався (почав відслідковувати) у папці де ви зараз знаходитеся:

git init -

The last command should return something starting with "Initialized empty Git repository". The others commands do - not return anything.

+

Остання команда повинна повернути повідомлення що починається із "Initialized empty Git repository". Інші команди не повертають нічогою

-

You did it! If you want to be double-sure that it's a Git repository, type git status and if it - doesn't return 'fatal: Not a git repository...', you're golden!

+

Ви зробили це! Якщо ви хочете ще раз перевірити чи це Git репозиторій, введіть git status + і якщо ви не побачите 'fatal: Not a git repository...', у вас все вийшло!

{{{ verify_directory_button }}}
    -
  • Make a new folder (aka make directory)
    • +
  • Створити нову папку (aka створити директоріюy)
    • mkdir <FOLDERNAME> -
  • Navigate into an existing folder (aka change directory)
    • +
  • Перейти до існуючої папкиr (aka змінити директорію)
    • cd <FOLDERNAME> -
  • List the items in a folder
    • +
  • Показати вміст папки
    • ls -
  • Turn Git on for a folder
    • +
  • Ініціалізувати Git для папки
    • git init
diff --git a/resources/contents/uk-UA/challenges/3_commit_to_it.html b/resources/contents/uk-UA/challenges/3_commit_to_it.html index 6394e66cb0..eb39fb1e46 100644 --- a/resources/contents/uk-UA/challenges/3_commit_to_it.html +++ b/resources/contents/uk-UA/challenges/3_commit_to_it.html @@ -1,68 +1,70 @@
-

Create a file in your new repository, add something to that file and commit that change with Git.

+

Створіть файл у вашому новому репозиторії, додайте щось у файл та закомітьте за допомогою Git.

-

Commits

-

Commits are core to using Git. They are the moments in which you save and describe the work you've done. They are - the ticks in the timeline of your project's history.

+

Коміти

+

Коміти - це основа роботи із Git. Це моменти у які ви зберігаєте та описуєте повідомленням, те що зробили. Це + точки у таймлайні історії вашого проекту.

-

Create a New File

-

Now that you've got a repository started let's add a file to it.

-

Open your text editor and create a new empty file. Now write a little bit of text, perhaps type "Hello!", and - save the file as 'readme.txt' in the 'hello-world' folder you created in the last challenge.

+

Створення нового файлу

+

Тепер, коли у вас є репозиторій, додамо у нього файл.

+

Відкрийте свій текстовий редактор та створіть навий порожній файл. Тепер напишіть щось у ньому, наприклад + "Hello!", та + збережіть цей файл як 'readme.txt' у папці 'hello-world', яку ви створили у попередньому завданні.

-

Check Status + Add and Commit Changes

-

Next check the status of your repository to find out if there have been changes. You know you - have changed something, but does Git?

+

Первірка статусу + Додавання та Фіксація змін

+

Далі, перевірте статус вашого репозиторія, щоб дізнатися які були внесені зміни. Ви знаєте що + внесли зміни, але чи знає Git?

-

Make sure you're still within your 'hello-world' directory when you're running these commands. Use Git to see - what changed in your repository:

+

Переконайтесь що ви знаходитесь всередині папки 'hello-world' коли виконуєте команди. Використайте Git щоб + побачити які зміни були здійснені у репозиторії:

-

First, check the status:

+

Спершу, перевірте статус:

git status

-

Git should tell you that a file has been added.

+

Git повинен показати що був доданий новий файл.

-

Then add the file you just created so that it becomes a part of the changes you will commit - (aka save) with Git:

+

Далі додайте щойно створений файл, щоб він був частиною змін, які ви зараз + зафіксуєте + (aka закомітите) використовуючи Git:

git add readme.txt

-

Finally, commit those changes to the repository's history with a - short (m) message describing the updates.

+

І останнє, зафіксуйте зміни в історії репозиторія, додавши короткий опис того, що ви зробили. +

git commit -m "Created readme"

-

Step: Make More Changes

-

Now add another line to 'readme.txt' and save the file again.

+

Step: Зробіть більше змін

+

Тепер додайте ще одлин рядок до файлу 'readme.txt' і збережіть файл знову.

-

In terminal, you can view the difference between the file now and how it was at your last - commit.

+

У терміналі ви зможете побачити різницю між станом файлу зараз, та станом із попереднього + коміту.

-

Tell Git to show you the diff:

+

Введіть команду, щоб Git показав різницю:

git diff

-

Now with what you just learned above, commit this latest change.

+

Тепер ви можете закомітити свої нові зміни.

{{{ verify_directory_button }}}
    -
  • Check status of changes to a repository
    • +
  • Перевірити статус репозиторія
  • git status
    • -
  • View changes to files
    • +
  • Переглянути зміни у файлах
  • git diff
    • -
  • Add a file's changes to be committed
    • +
  • Додати зміни у файлі, для того щоб закомітити
  • git add <FILENAME>
    • -
  • To add all files changes
    • +
  • Щоб додати усі файли
  • git add .
    • -
  • To commit (aka save) the changes you've added with a short message describing the changes +
  • Для фіксації змін (aka коміту) що ви зробили, із коротким повідомленням що їх описує
  • git commit -m "your commit message"
    • -
      +
diff --git a/resources/contents/uk-UA/challenges/4_githubbin.html b/resources/contents/uk-UA/challenges/4_githubbin.html index 06872f9728..72cff7a712 100644 --- a/resources/contents/uk-UA/challenges/4_githubbin.html +++ b/resources/contents/uk-UA/challenges/4_githubbin.html @@ -1,53 +1,47 @@
-

Create a GitHub account and add your username to your Git config.

+

Створення GitHub аккаунту та прикріплення вашого юзернейма до Git параметрів.

-

Working Better, Together

+

Працюємо ефективніше, разом

-

The repository you've created so far is just on your computer, which is handy, but makes it pretty hard to share - and work on with others. No worries, that's what GitHub is for!

+

Репозиторій, який ви створили покищо існує лише на вашому комп'ютері, що дуже зручно, але складно ділитися та працювати над проектом разом з іншими розробниками. Не хвилюйтеся, для цього існує GitHub!

-

GitHub is a website that allows people everywhere to upload what they're working on with Git so that everyone can - easily work together on the same project. GitHub which acts as the central repository for you and everyone else - to share. You push your changes to it and pull down changes from others.

+

GitHub це сайт який дозволяє людям із будь-якого куточку світу, завантажувати те над чим вони працюють використовуючи Git, саме тому будь-хто може приєнатися до роботи над проектом. + GitHub виступає у ролі цетралізованого сховища репозиторіїв для вас та будь кого іншого, хто хоче ділитися своїм кодом. Ви надсилаєте зміни що вносите в репозиторій, а також завантажуєте зміни які зробили інші розробники.

-

Create a GitHub Account

+

Створення GitHub Аккаунту

-

Visit github.com and sign up for a free account. High - five, welcome!

+

Відвідайте github.com та зареєструйте аккаунт, це безкоштовно.

-

Add GitHub username to Git

-

Add your GitHub username to your Git configuration. We'll do this just for the sake of Git-it; it makes it easier - to verify the upcoming challenges. Save it exactly as you created it on GitHub and capitalize where - capitalized. Note, you don't need to enter the "<" and ">".

+

Додавання GitHub юзернейма до Git

+

Додайте свій GitHub юзернейм до вашої Git конфігурації. Зробимо це лише заради Git-it; це зробить простішою перевірку наступних завдань. Збережіть юзернейм саме так як створювали на GitHub, враховуючи регістр. Note, you don't need to enter the "<" and ">".

-

Add your GitHub username to your Git configuration:

+

Додайте свій GitHub юзернейм до вашої Git конфігурації:

git config --global user.username <USerNamE> -

You can double check what you have set in your Git config by typing:

+

Ви можете перевірити чи додали у Git конфіг юзернейм, просто ввівши:

git config --global user.username
{{{ verify_button }}}
-

Make sure you type "user.username" above and not "user.name", which would override the name you - set in the first challenge and leave you with no username property! If you found you did that, it's ok, just - repeat the step in the first challenge to add your name and then complete the step above.

+

Переконайтесь що ви ввели саме "user.username" у коді вище, а не "user.name", що може перезаписати те, що ви робили + у першому завданні а також залишить вас без встановленого юзернейма! Якщо ви все ж зробили неправильно, нічого страшного, + просто повторіть кроки із першого завдання, а тоді повертайтеся сюди.

-

GitHub & Git config usernames do not match

+

GitHub & Git конфігурації юзернеймів не співпадають

-

A common error is not having your GitHub username match the case of the one you set with git config. - For instance, 'JLord' isn't the same as 'jlord'

-

To change your username set with Git, just do the same command you did earlier, but with the correct - capitalization:

+

Поширена помилка полягає в тому, що GitHub юзернейм чутливий до регістру. + Наприклад, 'JLord' це не те ж саме що й 'jlord'

+

Щоб змінити юзернейм який ви задали у Git конфіг, просто повторіть ту ж команду що виконували раніше, але враховуйте регістр:

git config --global user.username <USerNamE>

-

When you've made your updates, verify again!

+

Коли ви зробили зміни, запустіть перевірку знову!

diff --git a/resources/contents/uk-UA/challenges/5_remote_control.html b/resources/contents/uk-UA/challenges/5_remote_control.html index b0768833a9..4131b44875 100644 --- a/resources/contents/uk-UA/challenges/5_remote_control.html +++ b/resources/contents/uk-UA/challenges/5_remote_control.html @@ -1,114 +1,99 @@
-

Connect your local repository to a remote one and push changes to it.

+

З'єднання вашого локального репозиторія із віддаленим, надсилання данних до нього.

-

Remotes

+

Віддалені репозиторії

-

When you put something on GitHub that copy lives on one of GitHub's servers. This makes it a - remote repository because it is not on your computer, but on a server, "remote" and somewhere - else. By pushing your local (on your computer) changes to it, you keep it up - to date.

+

Коли ви кладете щось на GitHub, його копія існує на одному із серверів GitHub'у. Це робить його + віддаленим (remote) репоиторієм, тому що він знаходиться не локально на вашому комп'ютері, а на сервері. Надсилаючи (push) ваші локальні (ті що знаходяться на комп'ютері) зміни до віддаленого репозиторія, ви тримаєте його актуальним.

-

Others can always then get the latest from your project by pulling your changes down from the - remote (and onto their computer). This is how everyone can work on a project together without needing access to - your computer where your local copy is stored.

+

Інші бажаючі можуть в будь який момент отримати актуальний стан репозиторя стягнувши (pull) ваші зміни із + віддаленого репозиторія (на свій комп'ютер). Саме так, будь-хто, може працювати із вашим проектом не маючи безпосереднього доступу до вашого комп'ютера, та власне вашої локальної копії.

A diagram showing GitHub as a central server which creates the GitHub.com website. Two computers, on either side, are pushing and pulling from GitHub.
-

Create a Remote Repository

-

You want to sync your local version with one stored on GitHub.com. First create a new remote - repository on GitHub.com.

+

Створення віддаленого репозиторія

+

Ви хочете синхронізувати вашу локальну версію із тією, що знаходиться на GitHub.com. Спершу потрібно створити новий віддалений (remote) + репозиторій на GitHub.com.

    -
  • Go to github.com, log in, and click the '+' in the top - right and then click 'New repository'. +
  • Перейдіть на github.com, авторизуйтесь, та натисніть '+' зверху справа, та оберіть 'New repository'.
    • -
  • Give it a name that matches your local repository's name, 'hello-world', and a short description.
    • -
  • Make it public. This means it'll be listed on your public profile.
    • -
  • Don't initialize with a README because we already have a file, locally, named 'readme.txt'. This is a helper - option from GitHub if you hadn't already made it. +
  • Дайте йому таке ж ім'я, як і у вашого локального репозиторія, 'hello-world', та короткий опис.
    • +
  • Зробіть його публічним. Це означає що його буде видно у списку ваших публічних репозиторіїв.
    • +
  • Ініціалізуйте його без README тому що ми уже мамо його локально, із назвою 'readme.txt'. Це лише допоміжна опція GitHub, якщо ви ще цього не зробили.
    • -
  • Leave '.gitignore' and 'license' set to 'none'. We won't use them this tutorial.
    • -
  • Click create repository!
    • +
  • Залиште '.gitignore' та 'license' виставленими у 'none'. У наших завданнях ми їх не використовуватимемо.
    • +
  • Натисніть на кноку створення репозиторія!
-

Readmes, .gitignores and Licenses

-

These are common files in open source projects so to make starting a new project easier, GitHub provides an - option for creating them for you.

-

A readme explains what the project is, how to use it, and often times, how to contribute (though - sometimes there is an extra file, 'CONTRIBUTING.md', for those details).

-

A .gitignore is a list of files that Git should not track, for instance, files with - passwords!

-

A license file is the type of license you put on your project. This lets others know how they - can use it. Information on the types is here: choosealicense.com. +

Readme, .gitignore and Ліцензії

+

Це загальні файли для open source проектів, саме тому, для швидкого старту проекту, GitHub надає можливість створити ці файли для вас.

+

Readme описує проект в загальному, як запустити, як контрибютити (інколи це описує спеціальний файл, 'CONTRIBUTING.md').

+

.gitignore це список файлів всередині репозиторія, зміни яких Git не повинен відслідковувати, наприклад, + наприклад, файли із паролями!

+

license - це файл ліцензії, під якою ви розповсюджуєте проект. Завдяки цьому, інші будуть знати, яким чином вони можуть використовувати ваш проект. Інформація про ліцензії: choosealicense.com.

-

Connect your Local to your Remote

-

Now you've got an empty repository started on GitHub.com. At the top you'll see 'Quick Setup', make sure the - 'HTTPS' button is selected and copy the address—this is the address of your repository on GitHub's servers.

+

З'єднання локального репозиторія з віддаленим

+

Зараз ви маєте порожній репозиторій, створений на GitHub.com. Зверху ви побачите 'Quick Setup', впевніться що кнопка + 'HTTPS' вибрана та скопіюйте адресу — це буде адреса вашого репозиторія на сервері GitHub'у.

-

Back in your terminal, and inside of the 'hello-world' folder that you initialized as a Git repository in the - earlier challenge, you want to tell Git to remember the address of the remote version on GitHub's servers. You - can have multiple remotes so each requires a name. The primary remote is typically named origin. +

Поверніться у ваш термінал, та всередині папки 'hello-world' яку ви ініціалізували як Git репозиторій у попередньому завданні, вам потрібно сказати Git'у щоб він запам'ятав віддалену версію проекту що знаходиться на GitHub'і. Ви + можете вказати декілька віддалених репозиторії, але кожен із них потребує власного імені. Основний віддалений репозиторій зазвичай називається origin.

-

To add a remote named 'origin' to your repository:

+

Щоб додати віддалений репозиторій 'origin' до вашого репозиторія:

git remote add origin <URLFROMGITHUB> -

Your local repository now knows where your remote repository, named 'origin', - lives on GitHub's servers. Think of it as adding a name and address on speed dial—now when you need to send - something there, you can.

+

Ваш локальний репозиторій тепер знає де ваш віддалений (remote) репозиторій, що називається 'origin', + і живе на сервері GitHub'у.

-

Windows Users:

-

If you have GitHub Desktop on your computer, a remote named 'origin' is automatically - created in your local repository. In that case, you'll just need to tell it what URL to associate with - 'origin'. Use this command instead of the 'add' one above:

+

Для користувачів Windows:

+

Якщо у вас є GitHub Desktop встановлений на комп'ютері, віддалений репозиторій із іменем 'origin' автоматично створюється у вашому репозиторії. У цьому випадку, вам лише потрібно вказати із яким URL асоціювати + 'origin'. Використовуйте наступну команду, замість 'add':

git remote set-url origin <URLFROMGITHUB>
-

Push Work to your Remote

-

Next you want to push (send) everything you've done locally to your remote repository on GitHub. - This is something you'll do often so that your remote version is up to date and matching the state of your local - version.

+

Надсилання змін на ваш віддалений репозиторій

+

Далі вам потрібно виконати надсилання (push) всього що ви зробили локально, у ваш віддалений репозиторій на GitHub. + Це те що ви будете робити часто, для того щоб віддалений репозиторій відображав актуальний стан вашого локального репозиторія.

-

Git has a branching system so that you can work on different parts of a project at different times. We'll learn - more about that later, but by default the first branch is named 'master'. When you push (and later pull) from a - project, you tell Git the branch name you want and the name of the remote that - it lives on.

+

Git має систему віткування, тобто ви можете працювати над різними частинами проекту у різні моменти часу. Ми розберемо це пізніше, але за замовчуванням, перша вітка називається 'master'. Коли ви надсилаєте (push) зміни (або отримуєте (pull)) + зміни з проекту, ви вказуєте Git'у ім'я вітки в яку зміни будуть записані на віддалений репозиторій.

-

In this case, we'll send our branch named 'master' to our remote on GitHub named 'origin'.

+

У цьому випадку, ми надішлемо нашу вітку що називаєтсья 'master' до нашого віддаленого репозиторія на GitHub що збережений як 'origin'.

git push origin master -

Now go to your remote repository's page on GitHub.com and refresh the page. Wow! Everything is - now the same locally as it is remotely. Congrats on your first public repository!

+

Тепер перейдіть на GitHub.com на сторінку вашого репозиторія та оновіть сторінку. Чудово! Всі зміни із вашого локального репозиторія тепер є і на віддаленому!

{{{ verify_directory_button }}}
    -
  • Add remote connections
    • +
  • Додати віддалене з'єднання
    • git remote add <REMOTENAME> <URL> -
  • Set a URL to a remote
    • +
  • Встановити URL для віддаленого з'єднання
    • git remote set-url <REMOTENAME> <URL> -
  • Pull in changes
    • +
  • Отримати зміни (pull)
    • git pull <REMOTENAME> <BRANCHNAME> -
  • View remote addresses
    • +
  • Переглянути віддалені з'єднання
    • git remote -v -
  • Push changes
    • +
  • Надсилання змін (push)
    • git push <REMOTENAME> <BRANCH>
diff --git a/resources/contents/uk-UA/challenges/6_forks_and_clones.html b/resources/contents/uk-UA/challenges/6_forks_and_clones.html index 0105e1b5c8..801bcc8a65 100644 --- a/resources/contents/uk-UA/challenges/6_forks_and_clones.html +++ b/resources/contents/uk-UA/challenges/6_forks_and_clones.html @@ -1,86 +1,77 @@
-

Fork a project from GitHub.com and clone it locally.

+

Форк проекта із GitHub.com та його клонування на комп'ютер.

-

Forks

-

So far you have made a project locally and pushed it to GitHub, but that's only half the fun! The other half is - working with other people and other projects.

+

Форки

+

Раніше ви створили свій репозиторій та завантажили ойго на GitHub, але це лише частина веселощів! Інша частина + полягає у роботі над проектами інших людей.

-

When you fork a repository, you're creating a copy of it on your GitHub account. Your forked - copy begins its life as a remote repository—it exists just on your GitHub account, not on your - computer. Forks are used for creating your own version of a project (this diversion from the original is like - taking a fork in the road) or contributing back your changes (such as bug fixes or new features) to the original - project.

+

Коли ви робите форк (fork) реозиторія, ви створюєте його копію на власному GitHub аккаунті. Ваша + форкнута копія починає свій шлях як віддалений (remote) репозиторій — він існує лише на вашому + GitHub аккаунті, + а не на вашому комп'ютері. Форки використовуються для створення вашої власної версії проекту (це схоже на + розгалуження доріг) або контрибютинг власних змін (наприклад виправлення багів, новий функціонал) + в оригінальний проект.

-

To get a forked repository from your GitHub account onto your computer you clone it. This - cloning action copies the remote repository onto your computer so that you can work on it locally.

+

Щоб отримати форкнутий репозиторій із вашого GitHub аккаунту на ваш комп'ютер просто клонуйте (clone) його. Ця команда завантажить репозиторій на ваш комп'ютер, щоб ви могли працювати над ним локально.

A diagram showing a repository from GitHub copied onto your GitHub account and then copied onto your local computer from there.
-

Fork the Patchwork Repository

-

The project we'll work with is at github.com/jlord/patchwork. - Go to that page and click the 'Fork' button at the top right. Once the forking animation is complete, you have a - copy on your account. Copy your fork's HTTP URL from the address bar in your browser, this is the address of - your fork on GitHub's servers.

+

Форк Patchwork репозиторія

+

Проект, із якого потрібно зробити форк github.com/jlord/patchwork. + Перейдіть на цю сторінку та натисніть 'Fork' зверху справа. Після завершення процесу копіювання репозиторія, ви отримаєте копію проекта на своєму аккаунті. Скопіюйте HTTP URL вашого форку із адресного рядка вашого браузера, + це ареса вашого форку на сервері GitHub.

-

Clone Your Fork Locally

-

Now, in terminal, you'll clone the repository onto your computer. It will automatically create a new folder for - the repository so there is no need to create one yourself. But make sure you aren't cloning it inside of another - Git repository folder!

+

Клонування вашого форку

+

Тепер, у терміналі, вам потрібно скопіювати репозиторій на ваш комп'ютер. Автоматично створиться нова папка дял вашого проекту, тому не потрібно створювати її власноруч. Але переконайтесь що ви не клонуєте його всередині іншого Git репозиторія!

-

So be sure you're not inside of the 'hello-world' directory from the previous challenges. To back out and leave - this folder so that you can clone, follow these steps:

+

Впевніться що не всередині папки 'hello-world' із попереднього завдання. Для того щоб повернутися назад та можна було клонувати репозиторій, потрібно виконати наступні команди:

-

Back out of your 'hello-world' folder:
Tip: the two dots mean step out of a directory one level +

Перейти на 1 рівень вверх відносно папки 'hello-world':
Підказка: дві крапки означають те що ви підніметеся на один рівень вище відносно поточного розсташування

cd ..

-

Now that you're no longer in another Git repository, clone your fork:

+

Тепер, коли ви не всередині іншого репозиторія, потрібно виконати наступну команду:

git clone <URLFROMGITHUB>

-

Go into the folder it created for your local copy of the fork (in this case, named 'patchwork').

+

Перейдіть у папку із вашою локальною копією проекту в нашому випадку вона називається 'patchwork').

cd patchwork

-

Now you've got a copy of the repository on your computer and it is automatically connected to the remote - repository (your forked copy) on your GitHub account. Type git remote -v to see that the address to - the fork is already set up.

+

Ви щойно отримали локальну копію репозиторія яка автоматично приєнана до вашого віддаленого репозиторія (вашої форкнутої копії) на вашому GitHub аккаунті. Введіть git remote -v + щоб переконатися що адреса дійсно вказує на ваш форк.

-

Connect to the Original Repository

+

Приєднання до оригінального репозиторія

-

What if the original repository you forked happens to change? You'll want to be able to pull in - those changes too. So let's add another remote connection, this time to the original, github.com/jlord/patchwork, repository with - its URL.

+

А що якщо оригінальний репозиторій, із якого ви зробили свій форк зміниться? Ви захочете отримати (pull) зміни що були зроблені. Тому давайте додамо ще одне віддалене з'єднання, цьог оразу воно вказуватиме на оригінал, github.com/jlord/patchwork, із наступним URL.

-

You can name this remote connection anything you want, but typically people use the name 'upstream'; let's use - that for this.

+

Ви можете дати йому будь-яку назву, проте зазвичай використовується ім'я 'upstream'; давайте і ми його використаємо.

git remote add upstream https://github.com/jlord/patchwork.git

-

To be sure you have the correct remotes set up, type git remote -v to list out the addresses you - have stored. You should have an 'origin' remote with your fork's address and then an 'upstream' remote with - the address to the original, the URL noted above in this step.

+

Щоб переконатися що під'єднані правильні віддалені сервери, введіть git remote -v щоб побачити збережені вами адреси. У Вас повинен бути 'origin' із адрусоювашого форку та 'upstream' + із URL оригінального репозиторія.

{{{ verify_directory_button }}}
    -
  • Add a remote
    • +
  • Додати remote
  • git remote add <REMOTENAME> <URL>
    • -
  • Change a remote URL
    • +
  • Змінити URL для remote
  • git remote set-url <REMOTENAME> <URL>
    • -
  • View remote connections
    • +
  • Переглянути віддалені репозиторії
  • git remote -v
diff --git a/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html b/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html index 570dc867d9..1c7424233a 100644 --- a/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html +++ b/resources/contents/uk-UA/challenges/7_branches_arent_just_for_birds.html @@ -1,78 +1,75 @@
-

Add a branch, locally, to your forked repository to work on your changes.

+

Створення гілки, локально, у вашому форкнутому репозиторії, для роботи над вашими змінами.

-

Branches

-

Git repositories use branches to isolate work when needed. It's common practice when working on a project or with - others on a project to create a branch to keep your working changes in. This way you can do - your work while the main, commonly named 'master', branch stays stable. When the work on your branch is finished - you merge it back into the 'master' master branch.

- -

The diagram below shows how you can branch off of your 'master' branch, do work and the merge those changes back - into 'master'. You can even branch off of a branch if you need to, the 'master' branch doesn't have to be the - base.

+

Гілки (Branches)

+

Git репозиторії використовують гілки для ізоляції роботи над певною частиною проекту, за потребою. + Це загальна практика, коли ви працюєте самі, або із іншими людьми над проектом, ізолювати свої зміни у власній + гілці. Це спосіб працювати над своїми функціоналом, в той час, + коли на гілці master залишається стабільна версія проекту. Коли робота у вашій гілці завершена, її можна + змерджити у гілку "master".

+

Діаграма що наведена нижче показує, як ви можете перейти на іншу гілку із 'master', зробити свою роботу та + змерджити зміни назад у 'master' + Також ви можете зробити гілку не лише із 'master' а із будь-якої іншої гілки.

A diagram showing a horizontal line, representing the master branch, with another line branching off the top and later re-joining the original. Another line branches off the master branch line from below and yet another branch branches off of that. Both of these meet back up with the original master line, too. -

For a great visualization on how branches work in a project, see this GitHub Guide: Для кращого розуміння того .як працюють гілки, дивіться GitHub Guide: guides.github.com/overviews/flow

-

GitHub Pages

-

GitHub will automatically serve and host static website files in branches named 'gh-pages'. This free service is - called GitHub Pages. Since the project you forked creates a website, its - main branch is named 'gh-pages' instead of 'master'. All repositories that have a 'gh-pages' branch with website - files can be found, live online, using this pattern for the URL:

+

GitHub Сторінки

+

GitHub буде автоматично слідкувати та хостити статичні вебсайти із файлів у гілці 'gh-pages'. Цей безкоштовний сервіс називається GitHub Pages. Так як проект який ви форкаєте створює вебсайт, + його головна гілка називаєтсья 'gh-pages' а не 'master'. Всі репозиторії що мають гілку 'gh-pages'із файлами вебсайту + , можна побачити онлайн, використавши маску URL:

http://githubusername.github.io/repositoryname
-

Create a branch

-

When you create a branch, Git copies everything from the current branch you're on and places it in the branch - you've requested be made.

+

Створення гілки

+

Коли ви створюєте гілку, Git копіює все із вашої поточної гілки і кладе це у гілку що ви хочете створити.

-

While still inside of your local 'patchwork' repository, type git status to see what branch you're - currently on. Git should reply that you're on the 'gh-pages' branch.

+

Доки ви всередині репозиторія 'patchwork', введіть git status щоб побачити гілку в якій ви зараз знаходитесь. + Git повинен відповісти що ви зараз у гілці 'gh-pages'.

-

Now create a new branch and name it "add-<username>", where 'username' is your username. For instance, - "add-jlord". Branches are case-sensitive so name your branch exactly the way your GitHub name - appears.

+

Тепер створіть нову гілку та назвіть її "add-<username>", де 'username' це ваш юзернейм. Наприклад, + "add-jlord". Не забувайте про те що гілки чутливі до регістру .

git branch <BRANCHNAME>

-

Now you have a branch with a new name that is identical to 'gh-pages'.

+

Тепер у вас є гілка, яка ідентична гілці 'gh-pages'.

-

To go into that branch and work on it you checkout a branch. Go on your new branch:

+

Щоб перейти у цю гілку та почати у ній працювати, потрібно зробити checkout гілки:

git checkout <BRANCHNAME>

-

Step: Create a new file

-

Back in your text editor:

+

Крок: Створення нового файлу

+

Поверніться у ваш текстовий редактор:

    -
  • Create a new file named "add-<USERNAME>.txt", where - 'username' is your username. For instance, "add-jlord.txt". +
  • Створіть новий файл із назвою "add-<USERNAME>.txt", де + 'username' ваш юзернейм. Наприклад, "add-jlord.txt".
    • -
  • Then, just write your GitHub username in it, that's it and that's all. For instance, I'd type 'jlord'.
    • -
  • Save this file in the 'contributors' folder in Patchwork: Patchwork/contributors/add-yourusername.txt +
  • Далі, просто напишіть ваш GitHub юзернейм у ньому.
    • +
  • Збережіть цей файл у папці 'contributors' у Patchwork: Patchwork/contributors/add-yourusername.txt
    • -
  • Next, check in your changes (see below).
    • +
  • Далі, внесіть свої зміни (дивіться нижче).
-

Check-in

-

Go through the steps for checking in a project:

+

Внесення змін

+

Пройдіть ці кроки для внесення змін у проект

git status

git add <contributors/FILENAME>

git commit -m "commit message"

-

Now push your update to your fork, 'origin', on GitHub:

+

Тепер надішліть (push) ваші зміни до вашого форку, 'origin', on GitHub:

git push origin <BRANCHNAME>

@@ -80,45 +77,45 @@

Check-in

Permission denied...error: 403

-

You are pushing changes to a repository you don't have write access to. In this case, you're likely pushing ot - the original 'jlord/patchwork'. Make sure that you're pushing to 'origin' and that it points to your fork's - address on GitHub. To check and see what your remotes are and where they point run git remote -v. - You should have 'upstream' pointing to 'jlord/patchwork' and 'origin' pointing to 'yourusername/patchwork'. +

Ви надсилаєте зміни до репозиторію, до якого немаєте прав на запис. В цьому випадку, ви напевне надсилаєте зміни до оригінального 'jlord/patchwork'. Переконайтесь, що ви надсилаєте зміни до 'origin' і він вказує на ваш репозиторій + на GitHub. Для того щоб це перевірити виконайте git remote -v. + Ви повинні отримати 'upstream' що вказує на 'jlord/patchwork' та 'origin' що вказує на 'yourusername/patchwork'. -

To fix a remote that is pointing to the wrong place you can re-set its url: git remote set-url origin +

Щоб виправити цю пробелму потрібно перезаписати url: git remote set-url origin .

Authentication failed...error: 401

-

Your identity could not be verified. You may have 2FA (Two Factor Authentication) turned on in which case you must use a personal access token as your password. You can generate one by following these instructions. You'll need to keep this and use it in place of your password when prompted. You can also save this access token on your computer so that you don't have to re-enter it.

- -

File NOT in contributors folder

-

The file you create should be placed inside the existing 'contributors' folder in the Patchwork repository. If - you put it somewhere else, simply use Finder or Windows Explorer to move your file into the folder. You can - check git status again and you'll find it sees your changes. Stage and then commit "all" (-A) of - these changes (additions and deletions) with the commands below.

+

Ви не розпізнані. У вас повинна бути увімкнена 2FA (Two Factor Authentication), для того щоб підтверджувати свої дії унікальним токеном, таким як пароль. Ви можете згенерувати його слідуючи цим інструкціям. Вам потрібно зберегти його, та використовувати як пароль. Також ви можете + зберегти цей ключ доступу на + вашому комп'ютері і відпаде потреба його вводити кожного разу.

+ +

Файл НЕ в папці contributors

+

Файл що ви створили повинен знаходитися всередині папки 'contributors' у репозиторії Patchwork. якщо ви поклали його в іншому місці, просто використайте Finder чи Windows Explorer (Провідник) щоб перенести його у правильну папку. + Ви можете перевірити git status знову і побачите свої зміни. Застейджіть а тоді commit "all" (-A) цих змін, за допомогою команд що наведені нижче

git add -A

git commit -m "move file into contributors folder"

Branch name expected: _____

-

The branch name should match your user name exactly. To change your branch name:

+

Назва гілки повинна містити саме ваш юзернейм. Для зміни назви гілки, використайте:

git branch -m <NEWBRANCHNAME>

-

When you've made your updates, verify again!

+

Після внесення змін, зробіть перевірку.

    -
  • You can create and switch to a branch in one line
    • +
  • Ви можете створити та перейти у гілку однією командою
  • git checkout -b <BRANCHNAME>
    • -
  • Create a new branch
    • +
  • Створити нову гілку
  • git branch <BRANCHNAME>
    • -
  • Move onto a branch
    • +
  • Перейти на гілку
  • git checkout <BRANCHNAME>
    • -
  • List the branches
    • +
  • Список гілок
  • git branch
    • -
  • Rename a branch you're currently on
    • +
  • Перейментувати гілку в якій ви знаходитесь.
  • git branch -m <NEWBRANCHNAME>
    • -
  • Verify what branch you're working on
    • +
  • Перевірити, в якій гілці ви знаходитесь.
  • git status
diff --git a/resources/contents/uk-UA/challenges/8_its_a_small_world.html b/resources/contents/uk-UA/challenges/8_its_a_small_world.html index 782061bab3..968cb354f9 100644 --- a/resources/contents/uk-UA/challenges/8_its_a_small_world.html +++ b/resources/contents/uk-UA/challenges/8_its_a_small_world.html @@ -1,29 +1,32 @@
-

Add a collaborator to your project.

+

Додайте коллаборатора до вашого проекту.

+
-

Social Coding

-

Working with others is one of the best things about GitHub because it is easier to work from any place or - timezone with someone else.

+

Соціальний Кодінг

+

Можливість працювати разом з іншими це одна з найкращих можливостей, які надає GitHub, тому що спрощує роботу + з будь-якого місця чи часового поясу разом з іншими людьми.

-

Collaborators are other GitHub users who are given permission to make edits to a repository - owned by someone else. You may also hear the term contributors, this describes another GitHub - user who have made contributions, through a Fork and Pull Request, to a project.

+

Коллаборатори це інші GitHub юзери, яким надано право вносити зміни до репозиторію, + який належить комусь іншому. Ви також напевно чули термін contributors, + він обозначає іншого GitHub юзера який зробив внесок до проекту за допомогою форку та пул реквесту.

A photo of a cat with a space helment drawn on. This is Reporobot the cat and your collaborator - @reporobot is a robot from outer space that loves collaborating on repos. + @reporobot + це робот з космосу, який любить співпрацювати в роботі на репозиторіями. +
-

Hello, Repo Robot!

-

To add collaborators to one of your projects, visit the repository's page on your GitHub account and click the - 'Settings' tab in the menu in the upper part of the page. Then select the 'Collaborators' option. Type the - username into the text box add and click 'Add'.

+

Привіт, Repo Robot!

+

Для того щоб додати колаборатора до одного з ваших проектів, відвідайте сторінку репозиторія на вашому + GitHub аккаунті і натисніть 'Settings' в меню, яке розташоване в верхній частині сторінки. Потім виберіть + опцію 'Collaborators'. Наберіть імя юзера в текстовому полі і натисніть 'Add'.

-

Go to your forked Patchwork repository's page on GitHub and add 'reporobot' as a collaborator. The URL should - look like this, but with your username.

+

Переїдіть до сторінки Patchwork репозиторію на GitHub і додайте 'reporobot' в якості коллаборатора. + URL повинен виглядати як наведений нижче, але в з вашим іменем користувача.

github.com/YOURUSERNAME/patchwork/settings/collaboration
diff --git a/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html b/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html index 75216a52ab..00b35dacff 100644 --- a/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html +++ b/resources/contents/uk-UA/challenges/9_pull_never_out_of_date.html @@ -1,39 +1,41 @@ +
-

Keep your file up to date by pulling in changes from collaborators.

+

Оновлення версії вашого файлу за домопогою отримання (pull) змін, зроблених іншими коллабораторам..

-

Pulling from a Remote

-

If you're working on something with someone else you need to stay up to date with the latest changes. So you'll - want to pull in any changes that may have been pushed to the central GitHub repository.

+

Затягування з віддаленого репозиторію.

+

Якщо ви працюєте над чимось разом із іншими, вам необхіодно завжди синхронізувати вашу версію файлів з останніми змінами + Таким чином вам знадобиться зробити pull щоб отримати будь-які зміни, які були внесені до центрального + GitHub репозиторію.

A diagram shows a computer pulling information down from a repository's website
-

What has Reporobot been up to?

-

See if Reporobot has made any changes to your branch by pulling in any changes from the remote named 'origin' on - GitHub:

+

Чим займався Reporobot?

+

Подивіться чи Reporobot зробив якісь зміни до вашої гілки за допомогою затягування змін з віддаленого репозиторію з назвою + 'origin' на GitHub:

git pull <REMOTENAME> <BRANCHNAME>

-

If nothing's changed, it will tell you 'Already up-to-date'. If there are changes, Git will merge those changes - into your local version.

+

Якщо нічого не змінилось, ви отримаєте повідомлення 'Already up-to-date'. Якщо зміни є, Git злиє ці зміни у вашу локальну версію. +

-

Did Reporobot make changes? Git tells you where changes were made. You can open that file and see Reporobot's - updates. Surprise, Reporobot is an artist!

+

Чи зробив Reporobot зміни? Git вказує де зміни були внесені. Ви можете відкрити той файл і побачити зміни зроблені Reporobot. + Сюрприз, Reporobot - артист!

{{{ verify_directory_button }}}
    -
  • Check Git status
    • +
  • Перевірка Git статусу
    • git status -
  • Pull in changes from a remote branch
    • +
  • Отримання змін із віддаленої гілки
    • git pull <REMOTENAME> <REMOTEBRANCH> -
  • See changes to the remote before you pull in
    • +
  • Проглянути зміни у віддаленій гілці, перед тим як їх отримувати
    • git fetch --dry-run
-
+
\ No newline at end of file diff --git a/resources/contents/uk-UA/pages/index.html b/resources/contents/uk-UA/pages/index.html index 617031806f..8282f2f154 100644 --- a/resources/contents/uk-UA/pages/index.html +++ b/resources/contents/uk-UA/pages/index.html @@ -9,6 +9,7 @@ +
@@ -102,7 +103,7 @@

On your way!

--> -

Вітання!

+

Вітання!

Ви закінчили усі завдання, тепер можна приступати до

diff --git a/resources/contents/uk-UA/partials/chal-footer.html b/resources/contents/uk-UA/partials/chal-footer.html index 635e2fd4fd..463843787a 100644 --- a/resources/contents/uk-UA/partials/chal-footer.html +++ b/resources/contents/uk-UA/partials/chal-footer.html @@ -10,3 +10,21 @@ + +