Compare commits

...

3 Commits

4 changed files with 39 additions and 21 deletions

View File

@ -1,8 +1,25 @@
====================================== ======================================
The Mia! Django Accounting Application The Mia! Accounting Django Application
====================================== ======================================
Warning
=======
This is the last release of Django. It will be replaced by a new
Flask_ release, starting from scratch. Do not upgrade to the next
release, as it will not work.
This was my first large Python project, and at that time, I had zero
experience with Django. I ended up in a mess with Django MVT. The
code is unnecessarily complicated, and I do not actually know how the
views work anymore.
If you are new to the Mia! Accounting project, please skip this and
try the new release. You may contact me if you have problems with
the existing installation, but I may not be able to help you.
Description Description
=========== ===========
@ -13,7 +30,7 @@ a modern back-end framework and front-end technology like jQuery. The
first revision was in Perl/Mojolicious_ in 2019. This is the second first revision was in Perl/Mojolicious_ in 2019. This is the second
revision in Python/Django in 2020. revision in Python/Django in 2020.
The Mia! Django accounting application comes with two parts: The Mia! Accounting Django application comes with two parts:
- The ``accounting`` application contains the main accounting - The ``accounting`` application contains the main accounting
application. application.
@ -23,10 +40,11 @@ The Mia! Django accounting application comes with two parts:
You may try it in live demonstration at: You may try it in live demonstration at:
- URL: https://accounting.imacat.idv.tw/accounting - URL: https://accounting-django.imacat.idv.tw/accounting
- Username: ``admin`` - Username: ``admin``
- Password: ``12345`` - Password: ``12345``
.. _Flask: https://flask.palletsprojects.com
.. _Django: https://www.djangoproject.com .. _Django: https://www.djangoproject.com
.. _mod_perl: https://perl.apache.org .. _mod_perl: https://perl.apache.org
.. _Mojolicious: https://mojolicious.org .. _Mojolicious: https://mojolicious.org
@ -38,14 +56,14 @@ Installation
Install Install
------- -------
The Mia! Django accounting application requires Python 3.7 and Django The Mia! Accounting Django application requires Python 3.7 and Django
3.1. 3.1.
Install ``mia-accounting`` with ``pip``. Install ``mia-accounting-django`` with ``pip``.
.. code:: .. code::
pip install mia-accounting pip install mia-accounting-django
``settings.py`` ``settings.py``
--------------- ---------------
@ -147,7 +165,7 @@ And you are done.
Management Commands Management Commands
=================== ===================
The following management commands are added by *the Mia! accounting The following management commands are added by *the Mia! Accounting Django
application* to ``manage.py``: application* to ``manage.py``:
``accounting_accounts`` ``accounting_accounts``
@ -283,9 +301,9 @@ The following advanced settings are available in ``settings.py``.
Bugs and Supports Bugs and Supports
================= =================
The Mia! Django accounting application is hosted on GitHub. The Mia! Accounting Django application is hosted on GitHub.
https://github.com/imacat/mia-accounting https://github.com/imacat/mia-accounting-django
Address all bugs and support requests to imacat@mail.imacat.idv.tw. Address all bugs and support requests to imacat@mail.imacat.idv.tw.
@ -293,7 +311,7 @@ Address all bugs and support requests to imacat@mail.imacat.idv.tw.
Copyright Copyright
========= =========
Copyright (c) 2020-2021 imacat. Copyright (c) 2020-2023 imacat.
Licensed under the Apache License, Version 2.0 (the "License"); Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License. you may not use this file except in compliance with the License.

View File

@ -14,10 +14,10 @@ django.setup()
# -- Project information ----------------------------------------------------- # -- Project information -----------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
project = 'Mia! Accounting' project = 'Mia! Accounting Django'
copyright = '2022, imacat' copyright = '2022-2023, imacat'
author = 'imacat' author = 'imacat'
release = '0.1.0' release = '0.2.0'
# -- General configuration --------------------------------------------------- # -- General configuration ---------------------------------------------------
# https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration

View File

@ -1,10 +1,10 @@
.. Mia! Accounting documentation master file, created by .. Mia! Accounting Django documentation master file, created by
sphinx-quickstart on Thu Dec 8 00:42:14 2022. sphinx-quickstart on Thu Dec 8 00:42:14 2022.
You can adapt this file completely to your liking, but it should at least You can adapt this file completely to your liking, but it should at least
contain the root `toctree` directive. contain the root `toctree` directive.
Welcome to Mia! Accounting's documentation! Welcome to Mia! Accounting Django's documentation!
=========================================== ==================================================
.. toctree:: .. toctree::
:maxdepth: 2 :maxdepth: 2

View File

@ -1,7 +1,7 @@
# The setup.cfg # The setup.cfg
# by imacat <imacat@mail.imacat.idv.tw>, 2020/9/7 # by imacat <imacat@mail.imacat.idv.tw>, 2020/9/7
# Copyright (c) 2020 imacat. # Copyright (c) 2020-2023 imacat.
# #
# Licensed under the Apache License, Version 2.0 (the "License"); # Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License. # you may not use this file except in compliance with the License.
@ -17,15 +17,15 @@
[metadata] [metadata]
name = mia-accounting name = mia-accounting
version = 0.1.0 version = 0.2.0
author = imacat author = imacat
author_email = imacat@mail.imacat.idv.tw author_email = imacat@mail.imacat.idv.tw
description = A Django accounting application. description = The Mia! Accounting Django project.
long_description = file: README.rst long_description = file: README.rst
long_description_content_type = text/x-rst long_description_content_type = text/x-rst
url = https://github.com/imacat/mia-accounting url = https://github.com/imacat/mia-accounting-django
project_urls = project_urls =
Bug Tracker = https://github.com/imacat/mia-accounting/issues Bug Tracker = https://github.com/imacat/mia-accounting-django/issues
classifiers = classifiers =
Programming Language :: Python :: 3 Programming Language :: Python :: 3
License :: OSI Approved :: Apache Software License License :: OSI Approved :: Apache Software License