Skip to content

How to create a custom resource repository in GitHub

Oliver Tseng edited this page Jul 30, 2022 · 13 revisions

Overview

  • Create a blank repository in GitHub
  • Create a local repository
  • Upload data from local repository to GitHub repository

Prerequisites:

Naming convention:

  • Name your repo as UBA-type-description, where type can be Bibles, Books, Commentaries, Devotionals, PDF, DOCX, MP3, MP4.
  • Examples: UBA-PDF-Ancient-Israel-History, UBA-Books-My-personal-sermons, UBA-Commentaries-Foreign-langages, UBA-MP3-Worship-Music

Create a repository in GitHub

  1. If you don't have a GitHub account, create an account

  2. In the top right, select the "+" button and select "New Repository"

  3. Fill out the data

  • Enter Repository name using above naming convention
  • Add optional description
  • Select "Public"
  • Select "Creative Commons" license

Create a local repository

  1. Clone the repo from GitHub

You can get the url to clone from the main page of your repo and click on the green "Code" button.

git git@github.com:otseng/UBA-PDF-Ancient-Israel-History.git

  1. Copy all your files into the directory

  2. Zip each file and remove the original files so only zip files are in the directory

  3. Initialize the local repo

git init

  1. Add all the files into the local repo

git add .

  1. Commit the files into the local repo

git commit -m "Add files"

Upload data from local repository to GitHub repository

  1. Run git push

git push -u origin main

  1. Go to your repo in your browser and verify all the files are there.

Private custom repo

If you do not wish all UBA users to be able to access your repository, you can make your repository private. But, in order for you to access it, you will need to setup a personal access token.

Add custom resource repo to UBA

See User Custom Repos

Clone this wiki locally