What You'll Need
- A computer: Windows, macOS, or Linux will work.
- Internet access: To download Git.
Part 1: Installing Git Bash
Git Bash is a terminal application that provides the Git command-line environment for Windows. Here's how to install it:
-
Visit the Git website: Go to https://git-scm.com/downloads.
-
Download: Select the installer that matches your operating system (Windows, macOS, or Linux).
-
Run the installer:
- Windows: Follow the on-screen instructions, accepting most defaults. A key selection is when asked about your default editor—most new users will benefit from choosing a code editor like VS Code or Notepad++.
- macOS/Linux: The installer process likely involves the terminal and specific package managers. Refer to the website instructions for more detailed guidance.
-
Verify installation:
- Open a terminal or command prompt window.
- Type
git --version
and press Enter. If you see a Git version number, the installation was successful.
Part 2: Cloning Your First Repository
Let's use Keybase to clone the Documentation repository as your first step. If you haven't done so already, set up your account and find the team here: Keybase Setup.
-
Find the repository:
- Once you are logged into Keybase, go into the "Git" tab on the left.
- Select the "team" repository titled "Documentation"
-
Locate the repository's URL:
- On the repository's main page, click the blue clipboard icon to the right of the "Clone" button.
-
Open your terminal: Open a terminal (Git Bash on Windows, or the default terminal on macOS/Linux).
-
Navigate to the desired location:** Use the
cd
command to move into the directory where you want to save the cloned repository. For example:cd Documents/Projects
-
Clone the repository: Type the following command, replacing
<repository-url>
with the URL you copied:Bash
git clone <repository-url>
This will download a copy of the repository's code into a new folder within your current location.
Congratulations! You've installed Git Bash and cloned your first repository.
Additional Notes:
-
Basic Git commands: After cloning, you can start working on the code. Here are some essential Git commands:
git status
: Show the changes in your local copy.git add <filename>
: Stage a file to be committed.git commit -m "Your commit message"
: Commit your changes.git push
: Push your commits to the remote repository (after setting up SSH or HTTPS authentication).
-
GUI Clients: While command-line is a robust way to use Git, several GUI clients exist if you prefer a visual interface, such as GitHub Desktop, or VSCode
-
Obsidian Setup: Now that you have your documentation repository cloned, proceed to set up Obsidian here: Obsidian Setup.
Feel free to explore the world of Git! There are lots of fantastic resources online for more learning. Let me know if you have more questions.