YMCA CCE YIG/MUN manual parser
Go to file
stupidcomputer 25415a099f maint: add two sample books again 2024-07-23 23:51:47 -05:00
archive maint: add two sample books again 2024-07-23 23:51:47 -05:00
contrib add contrib franklincce.nix NixOS module 2024-06-29 20:49:38 -05:00
franklincce maint: squash migrations into one 2024-07-23 23:51:37 -05:00
kb final doc commit 2024-06-30 00:32:21 -05:00
nginx add a specific exemption for the admin panel 2024-06-29 18:33:30 -05:00
.env.dev docker-composing the debug=True version works 2024-06-23 14:06:22 -05:00
.env.prod.orig remove secret and prevent it from leaking again 2024-06-28 16:42:25 -05:00
.gitignore remove secret and prevent it from leaking again 2024-06-28 16:42:25 -05:00
LICENSE.md license the project under the AGPL 2024-06-24 02:49:06 -05:00
Makefile add a knowledgebase feature 2024-06-29 15:48:06 -05:00
README.md Update README.md 2024-06-29 16:50:20 -05:00
docker-compose.prod.yml keeping tidy 2024-06-29 15:48:53 -05:00
docker-compose.yml make explorer more production ready 2024-06-28 16:37:21 -05:00
gen_kb.sh add a homepage thing 2024-06-29 18:15:33 -05:00
links-to-html.lua add a knowledgebase feature 2024-06-29 15:48:06 -05:00
shell.nix add a knowledgebase feature 2024-06-29 15:48:06 -05:00
template.html move /kb path to /knowledge 2024-06-29 18:29:27 -05:00

README.md

yig

yig is a django app for exploring bills and resolutions in previous YMCA CCE conferences. It's sort of ballooned to also contain a knowledge-base thing.

Deploying in production

  1. Ensure that you have Docker installed and good to go.

For NixOS machines, this involves the following:

{ ... }
{
    virtualisation.docker.enable = true;
    users.users.<your user>.extraGroups = [ ... ] ++ [ "docker" ];
}
  1. Enter the nix-shell.
  2. make permissions
  3. make

To tear down the docker container, type make clean.

If you've just started the instance, you also need to configure a superuser.

  1. Run docker ps | grep yig-web | awk -F' ' '{print $1}' to get the container id
  2. Run docker exec -it <container-id> bash to get a shell.
  3. Run python3 manage.py createsuperuser and follow the prompts.

Usage

In order to use the explorer component of this package, you need to add some legislative texts. These are in the form of PDFs -- they come from the YMCA CCE website or are sometimes emailed or otherwise shared with you. Only these PDFs will work because they follow a very specific format which the software exploits.

  1. Login with your admin account.
  2. Click on the add button next to Legislation books in the sidebar
  3. Upload your book, add a name, and choose the correct Import strategy
  4. Click save

More information

More information about operation of this project can be found in the knowledgebase directory.

License

yig is licensed under the AGPLv3 -- the terms of the license are available in LICENSE.md.