cyberfreedom/content/how/getting-started.md
2024-01-20 23:43:51 -05:00

2.4 KiB

title
Getting Started

Getting Started

If you're interested in making changes please see the rules and ensure they are in alignment with what you hope to share.

Concepts

Git

Git 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?

Source Files

Files that are put into a process that creates some product.
In this case, the source filed are used with hugo 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.

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 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

  2. Make your Changes

  3. Publish your changes

    • Github
    • Gitlab
    • Directly

Getting your changes on the Site