Working with Git repositories - Revision history

Akivela: /* Starting with a Github repository */

2017-10-17T10:54:18Z

‎Starting with a Github repository

Akivela: /* Clone remote repository */

2017-10-17T10:48:20Z

‎Clone remote repository

Akivela: /* Examples */

2017-10-17T10:42:01Z

‎Examples

Akivela: /* Unsupported Git commands */

2017-10-17T10:41:12Z

‎Unsupported Git commands

Akivela: /* Initializing local repository */

2017-10-17T07:49:39Z

‎Initializing local repository

Akivela: /* Clone remote repository */

2017-10-17T07:48:15Z

‎Clone remote repository

Akivela: /* Clone remote repository */

2017-10-17T07:34:40Z

‎Clone remote repository

Akivela: Akivela moved page Supported Git commands to Working with Git repositories without leaving a redirect

2017-10-17T07:26:58Z

Akivela moved page Supported Git commands to Working with Git repositories without leaving a redirect

Akivela: /* Clone remote repository */

2017-10-17T07:25:53Z

‎Clone remote repository

Akivela: /* Push to remote */

2017-10-17T07:22:30Z

‎Push to remote

@@ Line 25: / Line 25: @@
 As it was written above, Wandora doesn't limit the content of cloned repository. The cloned repository can be empty or it may contain files that do not belong to the Wandora project. Steps required to start working with a Github repository:
-* First, the user creates a Github repository using tools in Github. Created repository is empty.
+* The user creates a Github repository using tools in Github. Created repository is empty.
-* Second, the user uses Wandora application and it's '''Clone remote repository''' tool to copy just created Github repository. As the copied repository is empty and doesn't contain valid Wandora project, user may skip opening the project.
+* The user clones just created remote Github repository using Wandora application. As the copied repository is empty and doesn't contain valid Wandora project, user may skip opening the project.
-* Third, the user saves Wandora project into the clone directory. Now the local Github repository directory contains valid Wandora project.
+* The user saves Wandora project into the clone directory. Now the local Github repository directory contains valid Wandora project.
-* Now the user can use all other Git tools in Wandora application to commit, push and pull changes back and forth between local project directory and remote Github repository.
+* Now the user can commit, push and pull changes back and forth between local project directory and remote Github repository using Wandora application.
 == Initialize local repository ==

@@ Line 21: / Line 21: @@
 Once the user has cloned a remote repository, the local directory contains copies of remote files. Cloned repository files in the local directory can now be changed with Wandora application and manually.
-As it was written above, Wandora doesn't limit the content of cloned repository. The cloned repository can be empty or it may contain files that do not belong to the Wandora project. This feature can be used to start a Github project for example. First, the user creates a Github repository using tools in Github. Created repository is empty. Second, the user uses Wandora application and it's '''Clone remote repository''' tool to copy just created Github repository. As the copied repository is empty and doesn't contain valid Wandora project, user may skip opening the project. Third, the user saves Wandora project into the clone directory. Now the local Github repository directory contains valid Wandora project. Now the user can use use all other Git tools in Wandora application to commit, push and pull changes back and forth between local project directory and remote Github repository.
+=== Starting with a Github repository ===
 == Initialize local repository ==

@@ Line 59: / Line 59: @@
 == Examples ==
-Github contains several example project Wandora user can clone for example:
+Github contains several example projects Wandora user can clone:
 * Wordnet, https://github.com/topic-maps-library/wordnet
 * Sample of Donald Trump Tweets, https://github.com/topic-maps-library/realDonaldTrump-tweets

← Older revision		Revision as of 10:41, 17 October 2017
Line 56:		Line 56:

	Wandora supports only small subset of Git commands. To use unsupported Git commands, the user should install any standard Git software package and start using it's commands. Any standard Git software package contains commands that can be used with repositories initialized using Wandora.		Wandora supports only small subset of Git commands. To use unsupported Git commands, the user should install any standard Git software package and start using it's commands. Any standard Git software package contains commands that can be used with repositories initialized using Wandora.
		+
		+	== Examples ==
		+
		+	Github contains several example project Wandora user can clone for example:
		+
		+	* Wordnet, https://github.com/topic-maps-library/wordnet
		+	* Sample of Donald Trump Tweets, https://github.com/topic-maps-library/realDonaldTrump-tweets

@@ Line 23: / Line 23: @@
 As it was written above, Wandora doesn't limit the content of cloned repository. The cloned repository can be empty or it may contain files that do not belong to the Wandora project. This feature can be used to start a Github project for example. First, the user creates a Github repository using tools in Github. Created repository is empty. Second, the user uses Wandora application and it's '''Clone remote repository''' tool to copy just created Github repository. As the copied repository is empty and doesn't contain valid Wandora project, user may skip opening the project. Third, the user saves Wandora project into the clone directory. Now the local Github repository directory contains valid Wandora project. Now the user can use use all other Git tools in Wandora application to commit, push and pull changes back and forth between local project directory and remote Github repository.
-== Initializing local repository ==
+== Initialize local repository ==
 If there is no remote repository and the user wants to keep track of changes, she can initialize local Git repository using menu option '''File > Git > Initialize local repository...'''. Menu option creates local Git repository and saves current Wandora project into the repository.

← Older revision		Revision as of 07:34, 17 October 2017
Line 20:		Line 20:

	Once the user has cloned a remote repository, the local directory contains copies of remote files. Cloned repository files in the local directory can now be changed with Wandora application and manually.		Once the user has cloned a remote repository, the local directory contains copies of remote files. Cloned repository files in the local directory can now be changed with Wandora application and manually.
		+
		+	As it was written above, Wandora doesn't limit the content of cloned repository. The cloned repository can be empty or it may contain files that do not belong to the Wandora project.

	== Initializing local repository ==		== Initializing local repository ==

@@ Line 12: / Line 12: @@
 Cloning a remote repository is perhaps the most common method to start working with a Git repository. Cloning copies remote repository to user's computer into a user defined directory. Wandora assumes the cloned repository contains a Wandora project including options.xml and layer folders, each containing one topic map file or topic map specification file. It should be noted that Wandora doesn't limit repository content. Cloning a remote Git project starts with a menu option '''File > Git > Initialize by cloning a remote repository...'''. The menu option opens a dialog window as shown below.
 [[File:Git_clone.png|center]]
 Before Wandora can clone a remote repository, user must enter the clone url and local directory for the repository. Optionally the user may enter username and password if the remote repository requires credentials. Credentials may be necessary if the user wishes to commit and push changes back to the remote repository. Finally the user may choose to open cloned repository after clone finishes. Remote repository can be opened only if the cloned repository is a valid Wandora project. If cloned repository is not valid Wandora project and the user has selected to open the cloned project, Wandora views an error dialog.

@@ Line 41: / Line 41: @@
 Choosing menu option '''File > Git > Push to remote''' pushes all local remote changes to the remote repository.
-Push works for remote Git repositories only.
+Push works for remote Git repositories only. If the repository was initialized as a local Git repository, push is not supported.
 == Pull from remote ==