Blogger is a basic blogging application which includes user to create account and post their views.

• Frontend: HTML/CSS
• Backend: Django

• Fork it :

Get your own Fork/Copy of repository by clicking Fork button right upper corner.

• Clone:

$ git clone https://github.com/harsh-9in/Blogger.git
$ cd Blogger/mysite

• Branching

$ git checkout -b [your_branch_name]

• Make Changes in Source Code

• Create a Virtual Environment

python3 -m venv env

• Activate the Virtual Environment

  • On Windows

    env\Scripts\activate
    

  • On Linux or MAC

    source env/bin/activate
    

• Install dependencies using

pip install -r requirements.txt

• Make migrations using

python manage.py makemigrations

• Migrate Database

python manage.py migrate

• Create a superuser

python manage.py createsuperuser

• Run server using

python manage.py runserver

• Stage your Changes and Commit

# For adding/Staging Changes

$ git add .


# For Commiting Changes

$ git commit -m "<your commit message>"

• Push your Commit to Repo

$ git push origin <branch_name>

• Take a look at existing issues or create your own issues.
• Claim the issue in the comment section.
• Wait for the issue to be assigned to you after which you can start working on it.
• Create a seperate Branch for every issue you are working on.
• Refer to the issue that a PR solves, so that a PR can be related to an issue.
• Create PR to specified Branch which will be promptly reviewed and suggestions would be added for improving it.
• Add proper commit messages and documentation to your code.
• Add screenshots of your implementation to help better understand the features you have implemented (must for design related PR).
• To keep youself Merge Conflict-free

# Configuring a remote for a fork
$ git remote -v
> origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
> origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

$ git remote add upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git 
> origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
> origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)
> upstream  https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (fetch)
> upstream  https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)


# to sync fork with original repository

$ git fetch upstream
> From https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY
>  * [new branch]      master     -> upstream/master

$ git checkout master
> Switched to branch 'master'

$ git merge upstream/master

• If you are making multiple commits, make sure to squash the commits amd make a PR.
• Don't override "First Come, First Serve". If someone has claimed that issue, please don't ask yourself to be assigned the same.

• Contributor's Hack 2020

Contributor's Hack 2020 is a program that helps students grow with ""OPEN SOURCE"". This initiative by HakinCodes provides you the best platform to improve your skills and abilities by contributing to vast variety of OPEN SOURCE Projects and opportunity to interact with the mentors and the Organizing Team.