class: title-slide, center, top background-image: url(img/git_github.png), url(img/useR2022.jpg) background-position: 90% 75%, 75% 75% background-size: 20%, cover .right-column[ # First Steps in Learning the Use of Git & GitHub in RStudio ### **Mouna Belaid**<br> June 18th, 2022 ] --- name: about-me layout: false class: about-me-slide, inverse, middle, center # About me <img style="border-radius: 50%;" src=img/Me.jpg width="150px"/> ## Mouna Belaid ### Business Intelligence Consultant<br>Prime Analytics - Tunis, Tunisia<br>Co-Founder & Co-Organizer at Tunis R User Group [<svg viewBox="0 0 512 512" style="height:1em;position:relative;display:inline-block;top:.1em;" xmlns="http://www.w3.org/2000/svg"> <path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"></path></svg>mounabelaid.netlify.app/](https://mounabelaid.netlify.app/) [<svg viewBox="0 0 512 512" style="height:1em;position:relative;display:inline-block;top:.1em;" xmlns="http://www.w3.org/2000/svg"> <path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path></svg>@mounaa_belaid](https://twitter.com/mounaa_belaid) [<svg viewBox="0 0 496 512" style="position:relative;display:inline-block;top:.1em;height:1em;" xmlns="http://www.w3.org/2000/svg"> <path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"></path></svg> @MounaBelaid](https://github.com/MounaBelaid) [<svg viewBox="0 0 576 512" style="position:relative;display:inline-block;top:.1em;height:1em;" xmlns="http://www.w3.org/2000/svg"> <path d="M549.655 124.083c-6.281-23.65-24.787-42.276-48.284-48.597C458.781 64 288 64 288 64S117.22 64 74.629 75.486c-23.497 6.322-42.003 24.947-48.284 48.597-11.412 42.867-11.412 132.305-11.412 132.305s0 89.438 11.412 132.305c6.281 23.65 24.787 41.5 48.284 47.821C117.22 448 288 448 288 448s170.78 0 213.371-11.486c23.497-6.321 42.003-24.171 48.284-47.821 11.412-42.867 11.412-132.305 11.412-132.305s0-89.438-11.412-132.305zm-317.51 213.508V175.185l142.739 81.205-142.739 81.201z"></path></svg> Mouna Belaid](https://www.youtube.com/channel/UCID33pDULsQg2y4FVlv4CnQ) --- layout: true <a class="footer-link" href="https://bit.ly/3B5oZcv">bit.ly/3B5oZcv — Mouna Belaid</a> <!-- this adds the link footer to all slides, depends on footer-link class in css--> --- # Session Outline .pull-left[ 1) Overview of Version Control, benefits of version control, and popular version control systems 2) What is Git? 3) What is GitHub? 4) Getting the most out of GitHub and Git - Connect a new RStudio project started from scratch to GitHub - Learn about GitHub fundamentals - Clone an existing GitHub Repository to an RStudio Project - Create branches - Make commits - Introduce changes to your R script with pull requests ] .pull-right[ 5) Practice a set of tasks to get familiar with Git and GitHub in RStudio 6) Submission of a new Cheatsheet to the ["Cheatsheets" GitHub Repository](https://github.com/rstudio/cheatsheets) maintained by RStudio ] --- # Requirements -- .pull-left-narrow[ .center[<img src="img/r-rstudio.png" width="180%"/>]] .pull-right-wide[### .black[R and RStudio installed]] -- .pull-left-narrow[ .center[<img src="img/logo-Git.png" width="50%"/>]] .pull-right-wide[### .black[Git installed]] -- .pull-left-narrow[ .center[<svg viewBox="0 0 496 512" style="position:relative;display:inline-block;top:.1em;height:2em;" xmlns="http://www.w3.org/2000/svg"> <path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"></path></svg>]] .pull-right-wide[### .black[Free GitHub account]] --- name: question class: inverse, middle, center {{content}} --- template: question <svg viewBox="0 0 512 512" style="position:relative;display:inline-block;top:.1em;fill:white;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M256 8C119.043 8 8 119.083 8 256c0 136.997 111.043 248 248 248s248-111.003 248-248C504 119.083 392.957 8 256 8zm0 448c-110.532 0-200-89.431-200-200 0-110.495 89.472-200 200-200 110.491 0 200 89.471 200 200 0 110.53-89.431 200-200 200zm107.244-255.2c0 67.052-72.421 68.084-72.421 92.863V300c0 6.627-5.373 12-12 12h-45.647c-6.627 0-12-5.373-12-12v-8.659c0-35.745 27.1-50.034 47.579-61.516 17.561-9.845 28.324-16.541 28.324-29.579 0-17.246-21.999-28.693-39.784-28.693-23.189 0-33.894 10.977-48.942 29.969-4.057 5.12-11.46 6.071-16.666 2.124l-27.824-21.098c-5.107-3.872-6.251-11.066-2.644-16.363C184.846 131.491 214.94 112 261.794 112c49.071 0 101.45 38.304 101.45 88.8zM298 368c0 23.159-18.841 42-42 42s-42-18.841-42-42 18.841-42 42-42 42 18.841 42 42z"></path></svg> # What is version control? --- ## What is version control? .panelset[ .panel[.panel-name[Definition] .pull-left[ Version control, also known as **source control**, is the practice of tracking and managing changes to software code. Version control systems are software tools that help software teams manage changes to source code over time. ] .pull-right[ .center[ ![:scale 140%](img/project-history.png) <font size="-0.5"> The Turing Way project illustration by Scriberia. Used under a CC-BY 4.0 licence. DOI: <a href="https://doi.org/10.5281/zenodo.3332807">10.5281/zenodo.3332807</a> </font> ] ] ] .panel[.panel-name[Benefits of version control] .pull-left-wide[ - A complete .my-red[long-term] change history of every file - Branching and merging - Ability to make your work more .my-red[reproducible] ] ] .panel[.panel-name[Popular Version Control Systems] .center[ ![:scale 200%](img/VCS.png) ] ] ] --- template: question <svg viewBox="0 0 512 512" style="position:relative;display:inline-block;top:.1em;fill:white;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M256 8C119.043 8 8 119.083 8 256c0 136.997 111.043 248 248 248s248-111.003 248-248C504 119.083 392.957 8 256 8zm0 448c-110.532 0-200-89.431-200-200 0-110.495 89.472-200 200-200 110.491 0 200 89.471 200 200 0 110.53-89.431 200-200 200zm107.244-255.2c0 67.052-72.421 68.084-72.421 92.863V300c0 6.627-5.373 12-12 12h-45.647c-6.627 0-12-5.373-12-12v-8.659c0-35.745 27.1-50.034 47.579-61.516 17.561-9.845 28.324-16.541 28.324-29.579 0-17.246-21.999-28.693-39.784-28.693-23.189 0-33.894 10.977-48.942 29.969-4.057 5.12-11.46 6.071-16.666 2.124l-27.824-21.098c-5.107-3.872-6.251-11.066-2.644-16.363C184.846 131.491 214.94 112 261.794 112c49.071 0 101.45 38.304 101.45 88.8zM298 368c0 23.159-18.841 42-42 42s-42-18.841-42-42 18.841-42 42-42 42 18.841 42 42z"></path></svg> # What is Git? --- ## What is Git? -- .pull-left-narrow[ .center[<img src="img/logo-Git.png" width="100%"/>]] .pull-right-wide[### .black[Git is an open source software for version control, originally developed in 2005 by Linus Torvalds, the creator of the Linux operating system kernel]] -- .pull-right-wide[### .black[Git is a distributed version control tool to track the changes in the source code of a project]] -- .pull-right-wide[### .black[Git's key design objectives are functionality, performance, security and flexibility]] --- template: question <svg viewBox="0 0 512 512" style="position:relative;display:inline-block;top:.1em;fill:white;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M256 8C119.043 8 8 119.083 8 256c0 136.997 111.043 248 248 248s248-111.003 248-248C504 119.083 392.957 8 256 8zm0 448c-110.532 0-200-89.431-200-200 0-110.495 89.472-200 200-200 110.491 0 200 89.471 200 200 0 110.53-89.431 200-200 200zm107.244-255.2c0 67.052-72.421 68.084-72.421 92.863V300c0 6.627-5.373 12-12 12h-45.647c-6.627 0-12-5.373-12-12v-8.659c0-35.745 27.1-50.034 47.579-61.516 17.561-9.845 28.324-16.541 28.324-29.579 0-17.246-21.999-28.693-39.784-28.693-23.189 0-33.894 10.977-48.942 29.969-4.057 5.12-11.46 6.071-16.666 2.124l-27.824-21.098c-5.107-3.872-6.251-11.066-2.644-16.363C184.846 131.491 214.94 112 261.794 112c49.071 0 101.45 38.304 101.45 88.8zM298 368c0 23.159-18.841 42-42 42s-42-18.841-42-42 18.841-42 42-42 42 18.841 42 42z"></path></svg> # What is GitHub? --- ## What is GitHub? -- .pull-left-narrow[ .center[<img src="img/github.png" width="50%"/>]] .pull-right-wide[### .black[GitHub is the most popular hosting service for collaborating on code using Git. Other hosting services include Bitbucket, and Gitlab.]] -- .pull-right-wide[### .black[GitHub is a collaboration platform.]] -- .pull-right-wide[### .black[GitHub uses <img src="img/logo-Git.png" width="20%"/> the most popular open source version control software, to track every contribution and contributor to a defined project.]] --- template: question ๐ # Getting Started with Git --- ## Getting Started with Git .panelset[ .panel[.panel-name[Check that Git is installed] **Step 1.** In the Terminal of RStudio, enter the following code ```r which git ``` You can check the version of Git ```r git --version ``` ] .panel[.panel-name[Communicate with GitHub via HTTPS] .pull-left[ **Step 2.** Go to [https://github.com/settings/tokens](https://github.com/settings/tokens) and click *Generate token* ![:scale 100%](img/token1.png) **Step 3.** Copy the generated PAT to your clipboard. Or leave that browser window open and available for a little while, so you can come back to copy the PAT. ] .pull-right[ Provide this PAT next time a Git operation asks for your password. ![:scale 100%](img/token2.png) ] ] .panel[.panel-name[Tell Git who you are] **Step 4.** In RStudio, click *Tools* -> *Shell* and type each line separately: ```r git config --global user.email "jack.bel@gmail.com" # use your mail address instead git config --global user.name "jack.bel" # use your GitHub username instead ``` ] ] --- template: question <svg viewBox="0 0 448 512" style="position:relative;display:inline-block;top:.1em;fill:white;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M400 32H48C21.49 32 0 53.49 0 80v352c0 26.51 21.49 48 48 48h352c26.51 0 48-21.49 48-48V80c0-26.51-21.49-48-48-48zm0 400H48V80h352v352zm-35.864-241.724L191.547 361.48c-4.705 4.667-12.303 4.637-16.97-.068l-90.781-91.516c-4.667-4.705-4.637-12.303.069-16.971l22.719-22.536c4.705-4.667 12.303-4.637 16.97.069l59.792 60.277 141.352-140.216c4.705-4.667 12.303-4.637 16.97.068l22.536 22.718c4.667 4.706 4.637 12.304-.068 16.971z"></path></svg> # Getting the most out of GitHub and Git --- ## Getting the most out of GitHub and Git .panelset[ .panel[.panel-name[1) Create a new RStudio Project and push it to GitHub] ๐ **Learning objectives** .pull-left[- Clone a GitHub repository on your own machine - Fork a GitHub repository - Create a branch on GitHub using Git - Open a pull request] .pull-right[- Respond to a review - Merge your pull request - Explore the following commands: `git init`, `git clone`, `git config`, `git add`, `git status`, `git commit`, `git push`, `git pull`, `git branch`, and `git merge`] ]<!----> .panel[.panel-name[2) Clone an existing GitHub Repository to an RStudio Project] ๐ **Learning objectives** - Connect a new RStudio project started from scratch to GitHub - GitHub fundamentals - Find interesting Open Source projects to work on - Explore a GitHub repository ] <!----> ] --- template: question <svg viewBox="0 0 448 512" style="position:relative;display:inline-block;top:.1em;fill:white;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M400 32H48C21.49 32 0 53.49 0 80v352c0 26.51 21.49 48 48 48h352c26.51 0 48-21.49 48-48V80c0-26.51-21.49-48-48-48zm0 400H48V80h352v352zm-35.864-241.724L191.547 361.48c-4.705 4.667-12.303 4.637-16.97-.068l-90.781-91.516c-4.667-4.705-4.637-12.303.069-16.971l22.719-22.536c4.705-4.667 12.303-4.637 16.97.069l59.792 60.277 141.352-140.216c4.705-4.667 12.303-4.637 16.97.068l22.536 22.718c4.667 4.706 4.637 12.304-.068 16.971z"></path></svg> # GitHub Knowledge Base --- ## GitHub Knowledge Base .center[ ![:scale 80%](img/Git-process1.png) ] --- ## GitHub Knowledge Base .center[ ![:scale 80%](img/Git-process2.png) ] --- ## GitHub Knowledge Base .center[ ![:scale 80%](img/Git-process3.png) ] --- ## GitHub Knowledge Base .center[ ![:scale 80%](img/Git-process4.png) ] --- ## GitHub Knowledge Base .center[ ![:scale 80%](img/Git-process5.png) ] --- ## GitHub Knowledge Base .center[ ![:scale 80%](img/Git-process6.png) ] --- ## GitHub Knowledge Base .center[ ![:scale 80%](img/Git-process7.png) ] --- ## GitHub Knowledge Base .pull-left[ .my-blue[Commands] | .my-blue[Operations] ------------- | ------------- `git init <directory>` | Create empty Git repo in specified directory `git clone <repository>` | Clone a repository located at <repository> your local machine `git config user.name <username>` | Define author name to be used for all commits in current repository `git add <directory>` | Stage all changes in <directory> for the next commit ] .pull-right[ .my-blue[Commands] | .my-blue[Operations] ------------- | ------------- `get commit -m <"message">` | Commit the staged snapshot, but instead of launching a text editor, use <"message"> as the commit message `get status` | List which files are staged, unstaged, and untracked `git log` | Display the entire commit history using the default format ] --- ## GitHub Knowledge Base .pull-left[ .my-blue[Commands] | .my-blue[Operations] ------------- | ------------- `git diff` | Show unstaged changes between your index and working directory `git branch` | List all of the branches in your repository `git merge <branch>` | Merge <branch> into the current branch ] .pull-right[ .my-blue[Commands] | .my-blue[Operations] ------------- | ------------- `git pull <remote>` | Fetch the specified remoteโs copy of current branch and immediately merge it into the local copy `git push <remote> <branch>` | Upload local repository content to a remote repository ] **Pull requests** are proposed changes to a repository submitted by a user and accepted or rejected by a repository's collaborators. Like issues, pull requests each have their own discussion forum. **Issues** are suggested improvements, tasks or questions related to the repository. Issues can be created by anyone (for public repositories), and are moderated by repository collaborators. Each issue contains its own discussion thread. --- template: question <svg viewBox="0 0 448 512" style="position:relative;display:inline-block;top:.1em;fill:white;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M400 32H48C21.49 32 0 53.49 0 80v352c0 26.51 21.49 48 48 48h352c26.51 0 48-21.49 48-48V80c0-26.51-21.49-48-48-48zm0 400H48V80h352v352zm-35.864-241.724L191.547 361.48c-4.705 4.667-12.303 4.637-16.97-.068l-90.781-91.516c-4.667-4.705-4.637-12.303.069-16.971l22.719-22.536c4.705-4.667 12.303-4.637 16.97.069l59.792 60.277 141.352-140.216c4.705-4.667 12.303-4.637 16.97.068l22.536 22.718c4.667 4.706 4.637 12.304-.068 16.971z"></path></svg> # 1) Create a new RStudio Project and push it to GitHub --- ## 1) Create a new RStudio Project and push it to GitHub .pull-left[ **Step 1.** In RStudio click *File* > *New Project* > *New Directory* > *New Project* ![:scale 100%](img/project.png) ![:scale 100%](img/project2.png) ] .pull-right[ **Step 2.** Give a name to the project in the *Directory name* tab and select *Create a git repository* then click on *Create Project* ![:scale 100%](img/project3.png) ] --- ## 1) Create a new RStudio Project and push it to GitHub .pull-left[ **Step 3.** Create a new R script. In the next steps, this script will be added to a repository on GitHub by using Git. ![:scale 100%](img/project4.png) ] .pull-right[ **Step 4.** The *Welcome.R* script is created and is saved in the project directory. It should also appear in the Git tab next to the *Environment* or the *History* tab. You need to select this R script on the Git panel. ![:scale 100%](img/project5.png) ] --- name: repository ## 1) Create a new RStudio Project and push it to GitHub .pull-left[ **Step 5.** Now click *Commit*. A new window is open. Enter an identifying message in the *Commit message* tab. ![:scale 100%](img/project6.png) You have now committed the current version of this *Welcome.R* script to your repository on your computer. Now you want to push the contents of this commit to GitHub, so it is also backed-up off site and available to collaborators. ] .pull-right[ **Step 6.** Go to [GitHub](https://github.com/). Create a *New repository*, and name it ] --- ## 1) Create a new RStudio Project and push it to GitHub **Step 7.** In the *Terminal* tab, type the following three lines of code and click enter ```r git remote add origin https://github.com/MounaBelaid/Test.git # Test is the repository name that I've created on GitHub git branch -M main git push -u origin main ``` <svg viewBox="0 0 576 512" style="height:1em;position:relative;display:inline-block;top:.1em;color:#e5bf00;" xmlns="http://www.w3.org/2000/svg"> <path d="M528.1 171.5L382 150.2 316.7 17.8c-11.7-23.6-45.6-23.9-57.4 0L194 150.2 47.9 171.5c-26.2 3.8-36.7 36.1-17.7 54.6l105.7 103-25 145.5c-4.5 26.3 23.2 46 46.4 33.7L288 439.6l130.7 68.7c23.2 12.2 50.9-7.4 46.4-33.7l-25-145.5 105.7-103c19-18.5 8.5-50.8-17.7-54.6zM388.6 312.3l23.7 138.4L288 385.4l-124.3 65.3 23.7-138.4-100.6-98 139-20.2 62.2-126 62.2 126 139 20.2-100.6 98z"></path></svg> You have now pushed your commit to GitHub, and should be able to see your files in your GitHub account. The *Pull* and *Push* buttons in RStudio will now also work. ![:scale 100%](img/project7.png) --- template: question <svg viewBox="0 0 448 512" style="position:relative;display:inline-block;top:.1em;fill:white;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M400 32H48C21.49 32 0 53.49 0 80v352c0 26.51 21.49 48 48 48h352c26.51 0 48-21.49 48-48V80c0-26.51-21.49-48-48-48zm0 400H48V80h352v352zm-35.864-241.724L191.547 361.48c-4.705 4.667-12.303 4.637-16.97-.068l-90.781-91.516c-4.667-4.705-4.637-12.303.069-16.971l22.719-22.536c4.705-4.667 12.303-4.637 16.97.069l59.792 60.277 141.352-140.216c4.705-4.667 12.303-4.637 16.97.068l22.536 22.718c4.667 4.706 4.637 12.304-.068 16.971z"></path></svg> # 2) Clone an existing GitHub Repository to an RStudio Project --- ## 2) Clone an existing GitHub Repository to an RStudio Project .pull-left[ **Step 1.** In RStudio click *File* > *New Project* > *Version Control* > *Git* ![:scale 100%](img/PR_Clone1.png) ] .pull-right[ **Step 2.** Go to the Resporitory on GitHub and click on *Code* and make a copy of the git link in order to clone this repository i.e to get a copy of this existing Git respository into your local machine. ![:scale 100%](img/PR_Clone2.png) ] --- ## 2) Clone an existing GitHub Repository to an RStudio Project **Step 3.** Go back to you R session and enter the link in *Respository URL* then click on *Create Project* ![:scale 45%](img/PR_Clone3.png) --- template: question <svg viewBox="0 0 448 512" style="position:relative;display:inline-block;top:.1em;fill:white;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M400 32H48C21.49 32 0 53.49 0 80v352c0 26.51 21.49 48 48 48h352c26.51 0 48-21.49 48-48V80c0-26.51-21.49-48-48-48zm0 400H48V80h352v352zm-35.864-241.724L191.547 361.48c-4.705 4.667-12.303 4.637-16.97-.068l-90.781-91.516c-4.667-4.705-4.637-12.303.069-16.971l22.719-22.536c4.705-4.667 12.303-4.637 16.97.069l59.792 60.277 141.352-140.216c4.705-4.667 12.303-4.637 16.97.068l22.536 22.718c4.667 4.706 4.637 12.304-.068 16.971z"></path></svg> # Let's master fundamentals on GitHub! --- name: activity class: inverse .left-column[ ## Activity<br><svg viewBox="0 0 576 512" style="height:1em;position:relative;display:inline-block;top:.1em;" xmlns="http://www.w3.org/2000/svg"> <path d="M402.3 344.9l32-32c5-5 13.7-1.5 13.7 5.7V464c0 26.5-21.5 48-48 48H48c-26.5 0-48-21.5-48-48V112c0-26.5 21.5-48 48-48h273.5c7.1 0 10.7 8.6 5.7 13.7l-32 32c-1.5 1.5-3.5 2.3-5.7 2.3H48v352h352V350.5c0-2.1.8-4.1 2.3-5.6zm156.6-201.8L296.3 405.7l-90.4 10c-26.2 2.9-48.5-19.2-45.6-45.6l10-90.4L432.9 17.1c22.9-22.9 59.9-22.9 82.7 0l43.2 43.2c22.9 22.9 22.9 60 .1 82.8zM460.1 174L402 115.9 216.2 301.8l-7.3 65.3 65.3-7.3L460.1 174zm64.8-79.7l-43.2-43.2c-4.1-4.1-10.8-4.1-14.8 0L436 82l58.1 58.1 30.9-30.9c4-4.2 4-10.8-.1-14.9z"></path></svg><br> ### 10:00 mins ] .right-column[ ### Let's master fundamentals on GitHub! ---- .my-white[ 1. Create a branch in the repository that you've created [earlier](#repository) 2. Make changes to this repository 3. Commit and push your changes to your branch 4. Create a pull request to ask collaborators for feedback on your changes 5. Merge your pull request 6. Delete your branch] ] --- template: question <svg viewBox="0 0 384 512" style="position:relative;display:inline-block;top:.1em;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M369.9 97.9L286 14C277 5 264.8-.1 252.1-.1H48C21.5 0 0 21.5 0 48v416c0 26.5 21.5 48 48 48h288c26.5 0 48-21.5 48-48V131.9c0-12.7-5.1-25-14.1-34zM332.1 128H256V51.9l76.1 76.1zM48 464V48h160v104c0 13.3 10.7 24 24 24h104v288H48z"></path></svg> # My Submission of a new Cheatsheet to the "Cheatsheets" GitHub Repository maintained by RStudio --- name: Cheatsheet ## My Submission of a new Cheatsheet to the "Cheatsheets" GitHub Repository maintained by RStudio: **Volunteer Basis** ![:scale 50%](img/git-github.png) --- name: Cheatsheet ## My Submission of a new Cheatsheet to the "Cheatsheets" GitHub Repository maintained by RStudio: **Volunteer Basis** ![:scale 100%](img/cheatsheet0.png) --- name: Cheatsheet ## My Submission of a new Cheatsheet to the "Cheatsheets" GitHub Repository maintained by RStudio: **Volunteer Basis** .pull-left[ **Step 1.** *Fork* the [repository](https://github.com/rstudio/cheatsheets) ![:scale 100%](img/cheatsheet1.png) **Step 2.** Clone Git repository ![:scale 100%](img/cheatsheet2.png) ] .pull-right[ ![:scale 100%](img/cheatsheet3.png) ![:scale 100%](img/cheatsheet4.png) ] --- name: Cheatsheet ## My Submission of a new Cheatsheet to the "Cheatsheets" GitHub Repository maintained by RStudio: **Volunteer Basis** .pull-left[ **Step 3.** I put the PDF document in the directory where the other PDF cheatsheets are provided ![:scale 100%](img/cheatsheet5.png) ] .pull-right[ ![:scale 100%](img/cheatsheet6.png) ] --- name: Cheatsheet ## My Submission of a new Cheatsheet to the "Cheatsheets" GitHub Repository maintained by RStudio: **Volunteer Basis** .pull-left[ **Step 4.** I did the same for the PowerPoint version ![:scale 100%](img/cheatsheet7.png) ] .pull-right[ **Step 5.** I included .png image of the first page of the *git-github* cheatsheet ![:scale 100%](img/cheatsheet8.png) ] --- name: Cheatsheet ## My Submission of a new Cheatsheet to the "Cheatsheets" GitHub Repository maintained by RStudio: **Volunteer Basis** .pull-left[ **Step 6.** I made a *commit* ![:scale 100%](img/cheatsheet9.png) ![:scale 100%](img/cheatsheet10.png) ![:scale 100%](img/cheatsheet11.png) ] .pull-right[ **Step 7.** I created a *pull request* ![:scale 100%](img/cheatsheet13.png) ] --- name: Cheatsheet ## My Submission of a new Cheatsheet to the "Cheatsheets" GitHub Repository maintained by RStudio: **Volunteer Basis** .pull-left[ ![:scale 100%](img/cheatsheet15.png) ] .pull-right[ **Step 8.** I provided information about the cheatsheet in the section below ![:scale 100%](img/cheatsheet17.png) ] --- template: question <svg viewBox="0 0 384 512" style="position:relative;display:inline-block;top:.1em;height:3em;" xmlns="http://www.w3.org/2000/svg"> <path d="M369.9 97.9L286 14C277 5 264.8-.1 252.1-.1H48C21.5 0 0 21.5 0 48v416c0 26.5 21.5 48 48 48h288c26.5 0 48-21.5 48-48V131.9c0-12.7-5.1-25-14.1-34zM332.1 128H256V51.9l76.1 76.1zM48 464V48h160v104c0 13.3 10.7 24 24 24h104v288H48z"></path></svg> # Want to keep learning? --- name: learning-resources ## Want to keep learning? - [Happy Git and GitHub for the useR](https://happygitwithr.com/index.html): a book which was written by Jenny Bryan, the STAT 545 TAs, Jim Hester - [GitHub Docs](https://docs.github.com/en): a full open source documentation provided by GitHub - [Introduction to GitHub](https://lab.github.com/githubtraining/introduction-to-github): a free course offered by GitHub --- class: goodbye-slide, inverse, middle, left .pull-left[ <img style="border-radius: 50%;" src="img/Me.jpg" width="170px"/> # Thank you! ### Here's where you can find me... .right[ [mounabelaid.netlify.app/ <svg viewBox="0 0 512 512" style="height:1em;position:relative;display:inline-block;top:.1em;" xmlns="http://www.w3.org/2000/svg"> <path d="M326.612 185.391c59.747 59.809 58.927 155.698.36 214.59-.11.12-.24.25-.36.37l-67.2 67.2c-59.27 59.27-155.699 59.262-214.96 0-59.27-59.26-59.27-155.7 0-214.96l37.106-37.106c9.84-9.84 26.786-3.3 27.294 10.606.648 17.722 3.826 35.527 9.69 52.721 1.986 5.822.567 12.262-3.783 16.612l-13.087 13.087c-28.026 28.026-28.905 73.66-1.155 101.96 28.024 28.579 74.086 28.749 102.325.51l67.2-67.19c28.191-28.191 28.073-73.757 0-101.83-3.701-3.694-7.429-6.564-10.341-8.569a16.037 16.037 0 0 1-6.947-12.606c-.396-10.567 3.348-21.456 11.698-29.806l21.054-21.055c5.521-5.521 14.182-6.199 20.584-1.731a152.482 152.482 0 0 1 20.522 17.197zM467.547 44.449c-59.261-59.262-155.69-59.27-214.96 0l-67.2 67.2c-.12.12-.25.25-.36.37-58.566 58.892-59.387 154.781.36 214.59a152.454 152.454 0 0 0 20.521 17.196c6.402 4.468 15.064 3.789 20.584-1.731l21.054-21.055c8.35-8.35 12.094-19.239 11.698-29.806a16.037 16.037 0 0 0-6.947-12.606c-2.912-2.005-6.64-4.875-10.341-8.569-28.073-28.073-28.191-73.639 0-101.83l67.2-67.19c28.239-28.239 74.3-28.069 102.325.51 27.75 28.3 26.872 73.934-1.155 101.96l-13.087 13.087c-4.35 4.35-5.769 10.79-3.783 16.612 5.864 17.194 9.042 34.999 9.69 52.721.509 13.906 17.454 20.446 27.294 10.606l37.106-37.106c59.271-59.259 59.271-155.699.001-214.959z"></path></svg>](https://mounabelaid.netlify.app/)<br/> [@mounaa_belaid <svg viewBox="0 0 512 512" style="height:1em;position:relative;display:inline-block;top:.1em;" xmlns="http://www.w3.org/2000/svg"> <path d="M459.37 151.716c.325 4.548.325 9.097.325 13.645 0 138.72-105.583 298.558-298.558 298.558-59.452 0-114.68-17.219-161.137-47.106 8.447.974 16.568 1.299 25.34 1.299 49.055 0 94.213-16.568 130.274-44.832-46.132-.975-84.792-31.188-98.112-72.772 6.498.974 12.995 1.624 19.818 1.624 9.421 0 18.843-1.3 27.614-3.573-48.081-9.747-84.143-51.98-84.143-102.985v-1.299c13.969 7.797 30.214 12.67 47.431 13.319-28.264-18.843-46.781-51.005-46.781-87.391 0-19.492 5.197-37.36 14.294-52.954 51.655 63.675 129.3 105.258 216.365 109.807-1.624-7.797-2.599-15.918-2.599-24.04 0-57.828 46.782-104.934 104.934-104.934 30.213 0 57.502 12.67 76.67 33.137 23.715-4.548 46.456-13.32 66.599-25.34-7.798 24.366-24.366 44.833-46.132 57.827 21.117-2.273 41.584-8.122 60.426-16.243-14.292 20.791-32.161 39.308-52.628 54.253z"></path></svg>](https://twitter.com/mounaa_belaid)<br/> [@MounaBelaid <svg viewBox="0 0 496 512" style="height:1em;position:relative;display:inline-block;top:.1em;" xmlns="http://www.w3.org/2000/svg"> <path d="M165.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6zm-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3zm44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9zM244.8 8C106.1 8 0 113.3 0 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C428.2 457.8 496 362.9 496 252 496 113.3 383.5 8 244.8 8zM97.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1zm-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7zm32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1zm-11.4-14.7c-1.6 1-1.6 3.6 0 5.9 1.6 2.3 4.3 3.3 5.6 2.3 1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2z"></path></svg>](https://github.com/MounaBelaid)<br/> [Mouna Belaid <svg viewBox="0 0 576 512" style="height:1em;position:relative;display:inline-block;top:.1em;" xmlns="http://www.w3.org/2000/svg"> <path d="M549.655 124.083c-6.281-23.65-24.787-42.276-48.284-48.597C458.781 64 288 64 288 64S117.22 64 74.629 75.486c-23.497 6.322-42.003 24.947-48.284 48.597-11.412 42.867-11.412 132.305-11.412 132.305s0 89.438 11.412 132.305c6.281 23.65 24.787 41.5 48.284 47.821C117.22 448 288 448 288 448s170.78 0 213.371-11.486c23.497-6.321 42.003-24.171 48.284-47.821 11.412-42.867 11.412-132.305 11.412-132.305s0-89.438-11.412-132.305zm-317.51 213.508V175.185l142.739 81.205-142.739 81.201z"></path></svg>](https://www.youtube.com/channel/UCID33pDULsQg2y4FVlv4CnQ)<br/> ]]