37 lines
1.4 KiB
Markdown
37 lines
1.4 KiB
Markdown
# CMS Management
|
|
|
|
A management site for the [Claremont MakerSpace](https://claremontmakerspace.org)
|
|
|
|
## Development
|
|
|
|
This assumes a relatively recent Linux system.
|
|
It should work fine on MacOS, and might work on Windows.
|
|
|
|
### Python Setup
|
|
|
|
1. Get Python 3.11 and [PDM](https://pdm.fming.dev/)
|
|
2. Run `pdm install`
|
|
3. Create `settings.dev.env` with config as required by [./cmsmanage/settings.py](`./cmsmanage/settings.py`)
|
|
4. Run `pdm run ./manage.py migrate` to create database tables
|
|
- At present, this will require an annoying amount of manual
|
|
fiddling to create the `JSON_TABLE` views (due to MariaDB bugs)
|
|
unless you run this as the root user for the database.
|
|
5. (Optional) If you have access to the production server, you can use real data:
|
|
1. `pdm run ./manage.py dumpdata -o whatever.json` (on the server)
|
|
2. `pdm run ./manage.py loaddata whatever.json` (on your machine)
|
|
6. Run `pdm run ./manage.py createsuperuser` to make a user
|
|
|
|
### JavaScript setup
|
|
|
|
1. Install NodeJS and [pnpm](https://pnpm.io/installation)
|
|
2. Run `pnpm install`
|
|
|
|
### Running the dev server
|
|
|
|
- If you don't intend to work on the JavaScript code:
|
|
- `pnpm run build` to build the JS/CSS
|
|
- `pdm run ./manage.py runserver` to start the Django server
|
|
- Otherwise:
|
|
- `pnpm run dev` to start the Vite dev server
|
|
- `DJANGO_VITE_DEV_MODE=true pdm run ./manage.py runserver` to start the Django server
|