cyberfreedom/content/how/getting-started.md

72 lines
2.4 KiB
Markdown
Raw Normal View History

2023-12-27 20:51:34 -05:00
---
title: "Getting Started"
---
2024-01-20 23:38:55 -05:00
# 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:
```bash
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
2023-12-27 20:51:34 -05:00
1. Fork the Repository
2024-01-20 19:14:19 -05:00
The Github repository is [here](https://code.gabe.rocks/gabriel/cyberfreedom)
2023-12-27 20:51:34 -05:00
2. Make your Changes
2024-01-20 19:31:02 -05:00
3. Publish your changes
- Github
- Gitlab
- Directly
2024-01-20 23:38:55 -05:00
## Getting your changes on the Site