|Project Name||Stars||Downloads||Repos Using This||Packages Using This||Most Recent Commit||Total Releases||Latest Release||Open Issues||License||Language|
|Tutorial||1,469||a month ago||107||other||Makefile|
|This is a tutorial we are using for Django Girls workshops|
|Django Locallibrary Tutorial||1,427||2 months ago||3||cc0-1.0||Python|
|Local Library website written in Django; example for the MDN server-side development Django module: https://developer.mozilla.org/en-US/docs/Learn/Server-side/Django.|
|Docker Tutorial||1,330||3 months ago||5||mit||Python|
|Docker 基本教學 - 從無到有 Docker-Beginners-Guide 教你用 Docker 建立 Django + PostgreSQL 📝|
|Hellodjango Blog Tutorial||1,264||3 months ago||13||gpl-3.0||Python|
|免费带你学 django 全栈！基于 django 2.2 的个人博客，初学者绝对不能错过的 django 教程！｡◕ᴗ◕｡|
|Python Learning Resources||1,026||8 months ago||4|
|Source code for Django For Beginners|
|Django Beginners Guide||950||2 years ago||22||mit||Python|
|A Complete Beginner's Guide to Django - Code Samples|
|Django Rest Framework Tutorial||682||2 years ago||5||mit||Python|
|Django-REST-framework 基本教學 - 從無到有 DRF-Beginners-Guide 📝|
|My_ml_service||560||a year ago||12||mit||Python|
|My Machine Learning Web Service|
|Docker Django Nginx Uwsgi Postgres Tutorial||413||4 months ago||3||mit||Python|
|Docker + Django + Nginx + uWSGI + Postgres 基本教學 - 從無到有 ( Docker + Django + Nginx + uWSGI + Postgres Tutorial )|
This is the source code repository for the Django Girls Tutorial. Django Girls Tutorial is used on tutorial.djangogirls.org so if you want to read it, please go there. If you want to contribute please do go further with this file.
The Django Girls Tutorial is licensed under a Creative Commons Attribution-ShareAlike 4.0 license. Everyone is free to add, edit and correct the tutorial.
The tutorial is written in Markdown mark up language.
You can find any discussions about the contents of the tutorial on the GitHub issue tracker.
Crowdin platform is used to manage translations. If you want to join an existing translation team or launch a new translation, send an email to the translation managers or contact support team. If you want to propose some small changes or fix typos in existing translations, please create a Pull Request.
For contributing to the tutorial the following is needed to get started:
First fork the DjangoGirls/tutorial repository to your personal GitHub account:
This command line tool use
make to create development environment. It is optional to use this tool. While building the document, it builds the document for every language. The build process can be limited to any one language using this tool and reduce build time considerbly. Afterwards, the translation to other languages are done from crowdin localization process.
Usage instructions are available though
make help command.
Try the command
make dev to start development process.
For simple changes like typo corrections you can use the GitHub online editor:
and you can edit the chapter directly on github.com.
Markdown syntax is used to edit the individual pages of the tutorial.
Save your changes and create a pull request as explained below.
For adding new chapters, writing longer snippets of text or adding images, you need to get a copy of the tutorial to your local computer.
Either use the GitHub app for your operating system (mentioned above) or
git command line to get the repository locally. You get the repository address from the front page of your own GitHub repository fork:
git clone [email protected]:yourgithubusername/tutorial.git
Move to the folder containing the project, to run the following commands.
Then, create a branch for your new changes to sit in. It helps to call the branch something related to the changes you are going to make.
git checkout -b contributing
Install the project's requirements using
To preview and serve local files, with auto-reload capabilities, run HonKit using:
npx honkit serve
The local server will be available at http://localhost:4000.
If auto-reload is slow, you can temporarily remove unwanted languages from
LANGS.md, to speed up the process.
Then commit the changes using
git and push the changes to your remote GitHub repository.
$ git status On branch contributing Untracked files: (use "git add <file>..." to include in what will be committed) contributing_and_editing_this_book/images/gitbook.png $ git add contributing_and_editing_this_book/images/gitbook.png $ git commit -m "Added gitbook editor screenshot" [contributing fe36152] Added gitbook screenshot 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 contributing_and_editing_this_book/images/gitbook.png $ git push Counting objects: 11, done. Delta compression using up to 8 threads. Compressing objects: 100% (5/5), done. Writing objects: 100% (5/5), 266.37 KiB | 0 bytes/s, done. Total 5 (delta 1), reused 0 (delta 0) To [email protected]:miohtama/tutorial.git b37ca59..fe36152 contributing -> contributing
After you have finished your changes you need to create a pull request on GitHub. DjangoGirls will get notified about the pull request, review your changes, suggest any corrections if needed and then pull your changes to the master version.
In your own repository on GitHub press do Compare & pull request
Fill in the information why this change is being made. The reviewer can see the details of the actual change, so you don't need repeat the content of the change.
Then press Create pull request.
GitHub emails will notify you for the follow up process.
GitHub has an excellent documentation. Check it out if you need help!
For further questions please contact DjangoGirls.