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
- On Windows
-
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 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.