69 lines
2.4 KiB
Markdown
69 lines
2.4 KiB
Markdown
---
|
|
title: "Getting Started"
|
|
---
|
|
|
|
|
|
# Getting Started
|
|
|
|
If you're interested in making changes please see the [rules](/about/rules/) and ensure they are in alignment with what you hope to share.
|
|
|
|
## Concepts
|
|
|
|
### Git
|
|
|
|
[Git](https://git-scm.com/) is a distributed version control system that allows for tracking and managing changes to text files.
|
|
To understand why git is necessary take a look at: [Why git?](/about/why-git)
|
|
|
|
### Source Files
|
|
|
|
Files that are put into a process that creates some product.
|
|
In this case, the source filed are used with [hugo](https://gohugo.io/) to generate this website.
|
|
Programmers use source code to compile programs, and the possibilities are endless.
|
|
|
|
|
|
## Cloning the Repository
|
|
|
|
The source files for this site live in [this repository](https://code.gabe.rocks/gabriel/cyberfreedom).
|
|
|
|
You can clone the repository using the following command:
|
|
|
|
```git clone https://code.gabe.rocks/gabriel/cyberfreedom.git```
|
|
|
|
This will place the source files into a folder.
|
|
|
|
Or you can download a .zip of the files at: https://code.gabe.rocks/gabriel/cyberfreedom/archive/main.zip
|
|
|
|
### Github
|
|
|
|
1. Create or Sign in to your account with Github
|
|
2. [Import](https://github.com/new/import) the repository with this clone URL: `https://code.gabe.rocks/gabriel/cyberfreedom.git` and give it a name of your choosing.
|
|
3. Hit "Begin Import"
|
|
|
|
|
|
## Making Changes
|
|
|
|
The beauty of git is that you can use simple tools! If you prefer a simple text editor like notepad, or want to use a code-editor with built-in git features it's entirely up to you!
|
|
|
|
### Staying up to date
|
|
|
|
Ensure you run `git pull` once in a while to make sure you have the latest changes.
|
|
|
|
## Using Git
|
|
|
|
After you've made some changes, you'll want to keep track of them. A set of changes is called a **commit**. To create a commit you'll use your git tools, or using the terminal write `git commit -m ` with a short message after a space. Some tools will automatically track files and stage the changes for you, if you're creating a new fille you'll want to make sure it's added to the commit with `git add ` and then the filename both of these commands require a space before you add your message or file.
|
|
|
|
## Publishing Your Changes
|
|
|
|
1. Fork the Repository
|
|
|
|
The Github repository is [here](https://code.gabe.rocks/gabriel/cyberfreedom)
|
|
2. Make your Changes
|
|
3. Publish your changes
|
|
|
|
- Github
|
|
- Gitlab
|
|
- Directly
|
|
|
|
## Getting your changes on the Site
|
|
|
|
|