{"id":17207065,"url":"https://github.com/nature1995/ran-django-template","last_synced_at":"2026-03-06T09:02:26.478Z","repository":{"id":54477165,"uuid":"167902493","full_name":"nature1995/ran-django-template","owner":"nature1995","description":"An awesome Django + Bootstrap4 project template for Django 2.0+ include IOT restful api","archived":false,"fork":false,"pushed_at":"2022-12-27T15:35:16.000Z","size":18552,"stargazers_count":109,"open_issues_count":2,"forks_count":32,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-13T22:12:47.495Z","etag":null,"topics":["django-project","django-templates","python","restful-api","starter-template"],"latest_commit_sha":null,"homepage":"https://ranxiaolang.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nature1995.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"custom":["https://nature1995.club/"]}},"created_at":"2019-01-28T05:11:02.000Z","updated_at":"2024-07-17T20:02:28.000Z","dependencies_parsed_at":"2023-01-31T05:30:54.567Z","dependency_job_id":null,"html_url":"https://github.com/nature1995/ran-django-template","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/nature1995/ran-django-template","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nature1995%2Fran-django-template","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nature1995%2Fran-django-template/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nature1995%2Fran-django-template/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nature1995%2Fran-django-template/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nature1995","download_url":"https://codeload.github.com/nature1995/ran-django-template/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nature1995%2Fran-django-template/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30168608,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T07:56:45.623Z","status":"ssl_error","status_checked_at":"2026-03-06T07:55:55.621Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["django-project","django-templates","python","restful-api","starter-template"],"created_at":"2024-10-15T02:44:35.327Z","updated_at":"2026-03-06T09:02:26.433Z","avatar_url":"https://github.com/nature1995.png","language":"Python","funding_links":["https://nature1995.club/"],"categories":[],"sub_categories":[],"readme":"\n# ran-django-template\n\n\u003cdiv align=\"center\"\u003e\n    \u003ca href=\"\"\u003e\u003cimg src=\"https://s2.ax1x.com/2019/03/24/AYmuIf.png\" width=\"100\" hegiht=\"100\"/\u003e\u003c/a\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\n[![python3.5](https://img.shields.io/badge/python-3.5-red.svg)]()\n[![python3.6](https://img.shields.io/badge/python-3.6-brightgreen.svg)]()\n[![python3.7](https://img.shields.io/badge/python-3.7-blue.svg)]()\n[![django3.0](https://img.shields.io/badge/django-3.0.0-green.svg)]()\n[![Build Status](https://travis-ci.com/nature1995/ran-django-template.svg?token=ihxd9jwdJ367UvYy3j9G\u0026branch=master)](https://travis-ci.com/nature1995/ran-django-template)\n\n## Feature\nFor Site\n- [x] Create Django web server in local\n- [x] Gallery and carousel control in home page\n- [x] Beautify site admin interface\n- [x] Restful API for IOT control\n- [x] Oauth2.0 for third party account login，such as: Github\n- [x] QR code generator\n- [x] PC, Mobile auto adaptation\n- [x] Support [Font awesome](https://fontawesome.com/), [django-jet](http://jet.geex-arts.com/), [Bootstrap](https://getbootstrap.com/), [Animate.css](https://daneden.github.io/animate.css/)\n\nFor Blog\n- [x] Rich text editor\n- [x] Article management and counting, including adding, deleting and editing\n- [x] Tag management, including adding, deleting and editing\n- [x] Classified management, including adding, deleting and editing\n- [x] Read more\n\n\n## Documentation\n\n#### Add INSTALLED_APPS setting:\n```\n    INSTALLED_APPS = [\n\t\t'jet.dashboard', #  before your django admin\n\t\t'jet',\t#  before your django admin\n\t    \t'apps.gallery.apps.GalleryConfig',\n\t\t'allauth',\n\t\t'allauth.account',\n\t\t'allauth.socialaccount',\n\t\t'allauth.socialaccount.providers.github',\n\t\t'myauth',\n\t\t'widget_tweaks',\n\t\t'werkzeug_debugger_runserver',\n\t\t'django_extensions',\n\t\t'rest_framework',\n\t\t'apps.myapp',\n\t\t'apps.blogs',\n\t\t'apps.qrcreate',\n\t\t'apps.blog',    # Blog for new version\n\t\t'django_summernote',\n    ]\n```\n\n#### How to run it\n```\ngit clone https://github.com/nature1995/ran-django-template.git\n```\n```\ncd ran-django-template\npip install -r requirements.txt\npython manage.py makemigrations\npython manage.py migrate\npython manage.py runserver 0.0.0.0:8000\n```\nAccess the web page though this link: http://0.0.0.0:8000/\n\n## Compatibility\n\nThe codes are tested using Travis-CI platform with django 2.1.5 and Python 3.5, 3.6, 3.7. \nDjango\\Python  \t| 3.5 | 3.6 | 3.7 \n--------------- | --- | --- | ---\n2.0.x   \t|  *  |  *  |  *\n2.1.x    \t|  *  |  *  |  *\n3.0.0\t\t|  *  |  *  |  *  \n\n**Notice:**\n\n1. Because the jet admin do not support django==3.0.0. Please remove jet in setting.py and urls.py, if you would like to use django == 3.0.0\n\n2. Django 2.1.x need to using the following change:**\n\nIf you have the ERROR message with `render() got an unexpected keyword argument 'renderer'；`, \nplease find Python folder: `\\lib\\site-packages\\django\\forms\\boundfield.py`. \nThen, comment the as_widget, line 93, like the follow:\n\n```\nreturn widget.render(\n\tname=self.html_initial_name if only_initial else self.html_name,\n\tvalue=self.value(),\n\tattrs=attrs,\n\t# renderer=self.form.renderer,\n)\n```\n## Demo\n\nWeb Page: https://ranxiaolang.com or https://www.zran.xyz\n\n![image](https://github.com/nature1995/ran-django-template/raw/master/images/preview2.2.png)\n\n\u003cdiv\u003e\n\u003cimg src=\"https://s2.ax1x.com/2019/03/24/AYu7IP.png\" width=\"820\" height=\"400\" alt=\"Result01.png\" title=\"Result01.png\" /\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\u003cdiv\u003e\n\u003cimg src=\"https://s2.ax1x.com/2019/03/24/AYuVEt.png\" width=\"410\" height=\"250\" alt=\"Result01.png\" title=\"Result01.png\" /\u003e\n\u003cimg src=\"https://s2.ax1x.com/2019/03/24/AYuAHI.png\" width=\"410\" height=\"250\"  alt=\"Result03.png\" title=\"Result03.png\" /\u003e\n\u003c/div\u003e\n\u003cbr\u003e\n\u003cdiv\u003e\n\u003cimg src=\"https://s2.ax1x.com/2019/03/23/A8XvGD.png\" width=\"270\" height=\"550\" alt=\"Result01.png\" title=\"Result01.png\" /\u003e\n\u003cimg src=\"https://s2.ax1x.com/2019/03/23/A8XxRe.png\" width=\"270\" height=\"550\" alt=\"Result03.png\" title=\"Result03.png\" /\u003e\n\u003cimg src=\"https://s2.ax1x.com/2019/03/23/A8XjPO.png\" width=\"270\" height=\"550\" alt=\"Result02.png\" title=\"Result02.png\" /\u003e  \n\u003c/div\u003e\n\n## Site Admin installation\n\nAdd 'jet.dashboard' application to the INSTALLED_APPS setting of your Django project settings.py file (note it should be before 'jet'):\n```\nINSTALLED_APPS = (\n    ...\n    'jet.dashboard',  # before your django admin\n    'jet',  # before your django admin\n    'django.contrib.admin',\n    ...\n)\n```\n\nAdd URL-pattern to the urlpatterns of your Django project urls.py file (they are needed for related–lookups and autocompletes):\nbefore 'jet'):\n```\nurlpatterns = patterns(\n    ...\n    path(r'admin/', admin.site.urls),\n    path('jet/', include('jet.urls', 'jet')),  # Django JET URLS\n    path('jet/dashboard/', include('jet.dashboard.urls', 'jet-dashboard')),  # Django JET dashboard URLS\n    ...\n)\nbefore 'jet'):\n```\nFor Google Analytics widgets only install python package:\n```\npip install google-api-python-client==1.4.1\n```\nCreate database tables:\n```\npython manage.py migrate dashboard\n# or\npython manage.py syncdb\n```\nCollect static if you are in production environment:\nbefore 'jet'):\n```\npython manage.py collectstatic\n```\n\n## Others\n\n**Admin Account**  \n``` \npython manage.py createsuperuser\n\nusername: ranxiaolang\nemail: YOUR EMAIL  \npassword: ranxiaolang  \n```\nAccess the web page though this link: http://0.0.0.0:8000/admin\n\n**Django Restframework**  \nAccess the web page though this link: http://0.0.0.0:8000/iot/\n\n## TODO\n- [ ] Add more social Oauth2.0\n- [ ] Add comment\n- [ ] Add site map\n\n## Author\n\n* **Ziran Gong** - [Web Page](http://ranxiaolang.com)\n\n## License\n\nThis software is licensed under the GNU General Public License v3.0 License. For more information, read the file `LICENSE`.  \nJust can be used for non-business projects.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnature1995%2Fran-django-template","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnature1995%2Fran-django-template","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnature1995%2Fran-django-template/lists"}