Files
myriad/README.md

59 lines
3.5 KiB
Markdown
Raw Normal View History

2026-03-15 23:16:24 +00:00
# myriad
2026-03-31 14:54:17 +01:00
flask app for plural systems to publicly share member lists. the software is in basically a usable state right now, just be sure to keep regular backups. documentation is fairly limited but we're working on that. drop an email to `myriad [at] cubes [dot] link` if you wanna contact us about this project :)
2026-03-16 01:39:00 +00:00
2026-03-20 02:19:39 +00:00
logged in users are presumed to all be admins with distinction only between being logged in and not
2026-03-20 19:27:01 +00:00
in the blog view, member privacy outweighs individual post privacy. if a private member makes a public post, it will not show up in the public feed. however, if that member switches to public, their public posts will all become publicly viewable (but private posts will remain private).
2026-03-21 00:30:47 +00:00
the blinkies and stamps stuff is literally just because i want an easy way to upload them when i find them. and im the dev so i get to decide mwa ha ha
2026-03-23 22:27:54 +00:00
make sure blinkies are actually blinkie-sized, and stamps are likewise stamp-sized. too much variation in size will make the layout weird. there's not validation because its designed just to make uploading the images not require ftp + manual code as i had been doing before.
2026-05-08 20:20:20 +01:00
# Config
this is how your config should look at the latest update
```
REGISTRATION = True # Make sure to disable in production
2026-05-09 20:19:40 +01:00
STATIC_FOLDER = 'myriad/static'
2026-05-08 20:20:20 +01:00
ICON_UPLOAD_FOLDER = 'myriad/static/icons' # where member icons will be stored
BLINKIES_UPLOAD_FOLDER = 'myriad/static/blinkies' # where blinkies will be stored
STAMPS_UPLOAD_FOLDER = 'myriad/static/stamps' # where stamps will be stored
MISC_UPLOAD_FOLDER = 'myriad/static/misc' # where misc image uploads will be stored
THEMES_FOLDER = 'myriad/static/themes' # all the theme css files are here
TMP_FOLDER = 'myriad/static/tmp' # required for exports
SYSTEM_NAME = 'Myriad' # will be shown in the title bar
PAGES_NAME = 'Read More...' # will be shown in the nav bar if using custom pages
SECRET_KEY = "dev" # CHANGE THIS - see wiki for details
```
most likely if you get an error after updating, you need to make sure your config has all the fields as sampled above. we may have added something that you now need.
2026-03-31 23:20:50 +01:00
# A note on data export/import
there are currently various ways to export and import data for use within myriad. individual member exports and imports deal only with the fields (though icons, stamps, and blinkies can be exported to a zip folder). they're designed to be used with an active database for whatever purpose the user requires.
the other option is to export the entire system to json or zip file. **importing an entire system is best used on a completely empty database, as it deals with inserting id fields**. a full system import is useful for when an update is released that requires the database to be re-initialised, you can quickly restore information and images you had before.
both are a little janky as they've just been implemented rather quickly to cover the base requirement of being able to migrate the database in some form. **don't rely on them, be sure to keep your own backups**.
2026-03-30 16:48:04 +01:00
**individual member import via zip folder is not currently possible**
2026-03-31 23:20:50 +01:00
# Development set up (Windows)
2026-03-16 01:39:00 +00:00
2026-03-31 23:20:50 +01:00
[Dev instructions are here](https://tea.cubes.link/cube/myriad/wiki/Development-setup-%28Windows%29)
2026-03-31 23:20:50 +01:00
# Deployment
2026-03-31 23:20:50 +01:00
[Deployment instructions are here](https://tea.cubes.link/cube/myriad/wiki/deployment-instructions)
2026-03-31 23:20:50 +01:00
# Usage
2026-03-28 22:46:52 +00:00
2026-03-31 23:20:50 +01:00
- The software here is free to use, and there's no requirement to link back
- Edit the styles and functionality to suit your needs. I'm sure some of you out there are far better with CSS than us
2026-03-28 22:46:52 +00:00
2026-03-31 23:20:50 +01:00
# Preview
2026-03-28 22:46:52 +00:00
2026-03-31 23:20:50 +01:00
[Check out our own personal instance](https://system.cubes.link)