ausglamr/README.md

90 lines
2.1 KiB
Markdown
Raw Permalink Normal View History

2024-01-04 11:54:56 +11:00
# Aus GLAMR
A django app running on Docker. Replaces _Aus GLAM Blogs_.
2024-01-07 16:58:56 +11:00
## Deploy
* `cp .env.example .env` and enter env values for your app
* set up web server config (nginx example coming soon)
2024-01-07 16:58:56 +11:00
* `docker compose build`
* `./glamr-dev migrate`
2024-01-09 18:11:22 +11:00
* `./glamr-dev createsuperuser`
* `docker compose up -d`
2024-01-26 11:03:58 +11:00
* set up database backups (as cron jobs): `./glamr-dev backup`:
2024-01-07 16:58:56 +11:00
* set up cron jobs for management commands as below
2024-01-04 11:54:56 +11:00
## Admin
2024-01-26 11:03:58 +11:00
Don't forget to add some Content Warnings for use by the Mastodon bot, within `/admin`.
2024-01-04 11:54:56 +11:00
## CLI tool
Use `glamr-dev` to make your life easier (thanks to Mouse Reeve for the inspiration):
* announce
2024-01-26 11:00:26 +11:00
* backup
2024-01-04 11:54:56 +11:00
* check_feeds
* manage [django management command]
* makemigrations
* migrate
* queue_announcements
* send_weekly_email
And for dev work:
* black
* collectstatic
* createsuperuser
* pylint
* resetdb
* test
## Registration
- users can register a blog, group, event, newsletter, or Call for Papers.
- most of these ask for an "owner email" - this is optional but allows us to communicate with the person registering.
- all registrations should trigger an email to admin
- all must be approved before they are included
## Management commands
There are four commands:
- announce
- check_feeds
- queue_announcements
- send_weekly_email
These will not be triggered within the app - they should be called via cron jobs.
### announce
This announces the next queued announcement on Mastodon.
Run every 21 mins.
### check_feeds
This checks all blog feeds for any new posts, and adds them to the database as long as they don't have an exclusion tag and were not published during a time the blog was suspended.
2024-01-26 11:00:26 +11:00
Also checks newsletter articles if there is a feed.
2024-01-04 11:54:56 +11:00
Run every hour.
### queue_announcements
This queues announcements for events and CFPs. These are announced three times, evenly spaced between when they were added and when the event starts or the CFP closes.
Run daily.
### send_weekly_email
Does what you think. Creates a weekly email of the latest stuff, and send to everyone in Subscribers.
2024-01-26 11:00:26 +11:00
Run weekly.
### Backups
There is a `backup` command in `glamr-dev`. You can adjust the filepaths in your `.env` file.
Run daily