Workshop: R Programming I

Workshop:
Introduction to Git

Karl Ho

School of Economic, Political and Policy Sciences

University of Texas at Dallas

Workshop: Github and GitHub Pages

What is Version Control System (VCS)?
GitHub repository system
GitHub Pages as website hosting
GitHub and Rstudio cloud

What is Git ?

Git is a version control system for tracking changes in files and coordinating work among multiple parties.
It is primarily used for source code management in software development, but it can be used to keep track of changes in any set of files.

What is Git ?

Git is a distributed version control system for tracking changes in files and coordinating work among multiple parties.
It is primarily used for source code management in software development, but it can be used to keep track of changes in any set of files.

What is Git ?

Git is primarily command-line based.

Basic commands

git init
- Initialize
git configure
- git config --global user.name "Your Name"
- git config --global user.email "your.email@example.com"
git clone
git add
git commit
git push
git pull

Branch management commands

git branch
git checkout
git merge

What is GitHub ?

GitHub is a web-based hosting service for version control using Git but with additional features including access control and several collaboration features such as bug tracking, feature requests, task management, and wikis for every project.

What is GitHub ?

GitHub is now owned by Microsoft and is open and free for individual use.
It will become one of the world's largest repository systems for hosting and social coding

Terminology

Repository
The repository is where files' current and historical data are stored, often on a server.

Version control system (VCS)
A management system of changes to documents, usually scripts or computer programs
e.g. Subversion (SVN), git

Branch
A set of files under version control may be branched or forked at a point in time so that, from that time forward, two copies of those files may develop at different speeds or in different ways independently of each other.

Terminology (continued)

Commit
To commit is to proceed or merge the changes made in the working copy to the repository. The terms 'commit' and 'checkin' can also be used as nouns to describe the new revision that is created as a result of committing.

Initialize
to create a new, empty repository.

Pull, push
Copy revisions from one repository into another. Pull (or Fetch) is initiated by the receiving repository, while push is initiated by the source.

Terminology (continued)

Clone
Cloning means creating a repository containing the revisions from another repository. This is equivalent to pushing or pulling into an empty (newly initialized) repository. As a noun, two repositories can be said to be clones if they are kept synchronized, and contain the same revisions.

What is GitHub ?

Git works on branches, which represent independent lines of development, as each snapshot is linked to a 'parent' one it built upon. By default, everyone's repositories are on a "master" branch.

source: http://hades.github.io/2010/01/git-your-friend-not-foe-vol-2-branches/

Why GitHub?

GitHub is an easy way to collaborate with others on shared Git repositories.
GitHub hosts programs, data files and data products and even websites.
Users can sync local files with changes made and pushed to the shared one.
It is designed for "social coding" and collaboration even from strangers.

Create a GitHub account

Login to github.com
Pick a username that you will use for login and future public profile. If your name is unavailable, add a number or a name that identifies you.
1. e.g. johndoe1
Avoid funny or whimsical terms since this is your professional profile.

Create a repository

Once login, you may create a repository like folder or directory.

Create a repository

You may initialize the repository with a Readme.md file
md stands for Markdown, which is a new web language that makes documentation online much easier.
You may edit your Readme.md on Github and leave descriptions using the markdown language.
Try the following (order and unordered list,
with italics):

1. Introduction
2. Data Theory
3. Messages in Data

```
Data, Messenger and Message. 
```

```
Headers:
```

# H1
## H2
### H3
#### H4
##### H5
###### H6

Emphasis (Italics)

```
*asterisks* or _underscores_
```

Github Desktop

Github Desktop is a local app for synchronizing files to Github website.
For now, using the web version of Github is recommended.

GitHub website

GitHub hosts website by project or account names with the domain github.io (e.g. karl-ho.github.io)
That's why your account name is important!

Create GitHub website

Create GitHub repository to host you web content
create karl-ho.github.io

Create GitHub website

Once repository is created, create a new file called index.html
Click commit new file
Type "Your name Github website"
Try some HTML script?

```
HTML:
```

<h1>This is a Heading</h1>
<p>This is a paragraph.</p>

```
<center>Center this line</center>
```

GitHub page: blog

Jekyll/Jekyll now
Hugo
Pelican (Python based)

GitHub and RStudio cloud

Github works closely with Rstudio, allowing to login to Rstudio cloud using GitHub account and run R program on cloud.

Reference

Bitbucket Tutorial: Git Branch
https://www.atlassian.com/git/tutorials/using-branches
The House of Hades: Git Is Your Friend not a Foe v2: Branches
http://hades.github.io/2010/01/git-your-friend-not-foe-vol-2-branches/

Introduction to Git

By Karl Ho

Introduction to Git

Introduction to Github

Karl Ho

Data Generation datageneration.io

Workshop: Introduction to Git

Workshop: Github and GitHub Pages

What is Version Control System (VCS)?

GitHub repository system

GitHub Pages as website hosting

GitHub and Rstudio cloud

What is Git ?

Git is a version control system for tracking changes in files and coordinating work among multiple parties.

It is primarily used for source code management in software development, but it can be used to keep track of changes in any set of files.

What is Git ?

Git is a distributed version control system for tracking changes in files and coordinating work among multiple parties.

It is primarily used for source code management in software development, but it can be used to keep track of changes in any set of files.

What is Git ?

Git is primarily command-line based.

Basic commands

git init

git clone

git add

git commit

git push

git pull

Branch management commands

git branch

git checkout

git merge

What is GitHub ?

GitHub is a web-based hosting service for version control using Git but with additional features including access control and several collaboration features such as bug tracking, feature requests, task management, and wikis for every project.

What is GitHub ?

GitHub is now owned by Microsoft and is open and free for individual use.

It will become one of the world's largest repository systems for hosting and social coding

What is GitHub ?

Git works on branches, which represent independent lines of development, as each snapshot is linked to a 'parent' one it built upon. By default, everyone's repositories are on a "master" branch.

Why GitHub?

GitHub is an easy way to collaborate with others on shared Git repositories.

GitHub hosts programs, data files and data products and even websites.

Users can sync local files with changes made and pushed to the shared one.

It is designed for "social coding" and collaboration even from strangers.

Create a GitHub account

Login to github.com

Pick a username that you will use for login and future public profile. If your name is unavailable, add a number or a name that identifies you.

e.g. johndoe1

Avoid funny or whimsical terms since this is your professional profile.

Create a repository

Once login, you may create a repository like folder or directory.

Create a repository

You may initialize the repository with a Readme.md file

md stands for Markdown, which is a new web language that makes documentation online much easier.

Github Desktop

Github Desktop is a local app for synchronizing files to Github website.

For now, using the web version of Github is recommended.

GitHub website

GitHub hosts website by project or account names with the domain github.io (e.g. karl-ho.github.io)

That's why your account name is important!

Create GitHub website

Create GitHub repository to host you web content

Create GitHub website

Once repository is created, create a new file called index.html

Click commit new file

Type "Your name Github website"

Try some HTML script?

GitHub page: blog

Jekyll/Jekyll now

Hugo

Pelican (Python based)

GitHub and RStudio cloud

Reference

Introduction to Git

More from Karl Ho

Workshop:
Introduction to Git