Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vault19/django-courses

Simple Django to manage courses
https://github.com/vault19/django-courses

django django-application education hacktoberfest python

Last synced: 3 months ago
JSON representation

Simple Django to manage courses

Awesome Lists containing this project

README

        

=======
Courses
=======

.. image:: https://img.shields.io/pypi/pyversions/django-courses.svg
:alt: PyPI - Python Version
:target: https://pypi.org/project/django-courses/

.. image:: https://img.shields.io/pypi/djversions/django-courses
:alt: PyPI - Django Version
:target: https://pypi.org/project/django-courses/

.. image:: https://img.shields.io/pypi/format/django-courses
:alt: PyPI - Format
:target: https://pypi.org/project/django-courses/

.. image:: https://img.shields.io/github/checks-status/vault19/django-courses/main
:alt: GitHub branch checks state
:target: https://github.com/vault19/django-courses/actions

.. image:: https://img.shields.io/github/license/vault19/django-courses.svg
:alt: LICENSE
:target: https://github.com/vault19/django-courses/blob/master/LICENSE

Courses is a simple Django app to manage online courses (education). Application is already used by civic association
`SPy o.z. `_ (non-profit) for project "Teaching with hardware" in Slovak "Učíme s hardvérom":
https://kurzy.ucimesharverom.sk

Project "Učíme s hardvérom" is run in Slovak language (however this app is in English, but has Slovak translations)
and is aimed for Slovak teachers to introduce hardware (such as `BBC microbit `_) into computing
lessons at primary and secondary schools.

Read more in our `**documentation** `_.

Quick start
-----------

1. Install django-courses via pip::

pip install django-courses

Alternatively install latest development version from Github::

pip install https://github.com/vault19/django-courses/archive/refs/heads/main.zip

2. Add "courses" to your INSTALLED_APPS setting like this::

INSTALLED_APPS = [
...
'wkhtmltopdf',
'courses',
]

3. Include the polls URLconf in your project urls.py like this::

path("", include("courses.urls")),

4. Run `python manage.py migrate` to create the courses tables in DB.

5. Start the development server and visit http://127.0.0.1:8000/admin/
to manage your courses (you'll need the Admin app enabled).

6. Visit http://127.0.0.1:8000/ to view the courses list.

Contributing
------------

All contributions are welcome! It doesnt have to be code, there are more possibilities how to get involved.

We have written extensive how to for beginners. Read more in our `documentation `_.

Support
-------

`Vault19 o.z. `_ (non profit micro hackerspace) did this app because
`SPy o.z. `_ (non profit supporting Slovak Python community) needed something for better
management of their courses. We like to program and we wanted to design a clean
`Django `_ app and learn one or two things in the process...