FROM INITIAL_SET_UP

Place this into ~/.bashrc or ~/.bash_aliases file
    alias python=python3
After adding the above in the file, run source ~/.bashrc or source ~/.bash_aliases.

*//Commands to configure getting the server running on Ubuntu 20.04 or newer//*
*//Also read "requirements.txt"//*
*//After loading Virtual Environment: A Shortcut method: pip install -r requirements.txt *//

sudo apt update
sudo apt install python3-pip
pip3 install --user pipenv
pip3 install Django==3.0.6
*//RESTART COMPUTER//*


*//Configure your git//*
git config --global user.name "[firstname lastname]"
git config --global user.email "[valid-email]"


*//Within Project folder you create to get the project downloaded//*

git init
git remote add origin https://github.com/ClemsonRunningClub/ClemsonRunning
git pull origin master  // or whatever branch you want
pipenv install requests
pipenv shell
python -m pip install Django

    // pillow allows for the image model within django
pip install pillow
    // crispy forms uses automatically formats forms using bootstrap4.0 indicated in settings.py
pip install django-crispy-forms



// use whenever any models are updated
python manage.py migrate
python manage.py runserver


FROM SET_UP

// will run server DURING DEVELOPMENT ONLY
  python manage.py runserver


To those who want to make changes:

  To add a new page to the website:
    1. add the html file within the "pages/templates" directory
    2. create a function with a return request of the new html file within "pages/views.py"
    3. import the new function within "runningclub/urls.py"
    4. set a new path in the "urlpatterns" section of "runningclub/urls.py"

  If making changes to the modules, make sure to run the following commands:

  	python manage.py makemigrations
  	python manage.py migrate

  Migrating database problems. Use the following command to create tables without migrations:
    python manage.py migrate --run-syncdb

Directories explained:

  "assets" contains all static files for the site:
    including: pictures, css theme, js code

  "media" contains all the media uploaded to the site:
    including: pictures

  "bucks" and "pages" are both applications created using the command
                      python manage.py startapp appname
    "bucks" allows user accounts and data to be stored
    "pages" provide html files for all pages of the website


Git Help:
  To Configure your git:
    git config --global user.name “[firstname lastname]”
    git config --global user.email “[valid-email]”

  To Initialize remote repository:
    git remote add origin https://github.com/ClemsonRunningClub/ClemsonRunning (only need once)

  To Pull:
    git pull origin master  OR   git fetch [alias]

  To Commit:
    git add files.py (only files you want to add)
    git commit -m "whatever changes you add"
    git push origin master
    sign in and the repositiory will update