{"id":25729520,"url":"https://github.com/8bituhm/acmmanoa-site","last_synced_at":"2026-03-01T16:32:17.201Z","repository":{"id":284858442,"uuid":"953350269","full_name":"8bitUHM/acmmanoa-site","owner":"8bitUHM","description":"The Association for Computing Machinery website","archived":false,"fork":false,"pushed_at":"2025-09-30T21:31:35.000Z","size":441,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-30T23:24:48.763Z","etag":null,"topics":["django","postgresql","tailwindcss"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/8bitUHM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-03-23T06:31:51.000Z","updated_at":"2025-09-30T21:31:39.000Z","dependencies_parsed_at":null,"dependency_job_id":"c9938cf7-cc8a-4578-8366-f9d6b11f9acf","html_url":"https://github.com/8bitUHM/acmmanoa-site","commit_stats":null,"previous_names":["8bituhm/acmmanoa-site"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/8bitUHM/acmmanoa-site","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8bitUHM%2Facmmanoa-site","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8bitUHM%2Facmmanoa-site/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8bitUHM%2Facmmanoa-site/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8bitUHM%2Facmmanoa-site/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/8bitUHM","download_url":"https://codeload.github.com/8bitUHM/acmmanoa-site/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/8bitUHM%2Facmmanoa-site/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29974745,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T16:18:32.386Z","status":"ssl_error","status_checked_at":"2026-03-01T16:18:04.258Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["django","postgresql","tailwindcss"],"created_at":"2025-02-26T01:38:08.514Z","updated_at":"2026-03-01T16:32:17.193Z","avatar_url":"https://github.com/8bitUHM.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **The Association for Computing Machinery at the University of Hawaii at Manoa (ACM)**\n\nThis is the ACM website, ported from the old site [here](https://acmmanoa.org/) to Django.  \nThe old site repository can be found [here](https://github.com/ACManoa/acmanoa.github.io)\n\n## **Table of Contents**\n1. [Project Structure](#project-structure)\n2. [Getting the App Running](#getting-the-app-running)\n\n---\n\n## **Project Structure**\n\nThe project is organized into several components:\n\n- **`core/`**: The main Django project directory.\n  - `settings.py`: Configuration settings for the project, including database settings, middleware, installed apps, and other configurations.\n  - `urls.py`: URL configuration for the project, mapping URLs to views.\n\n- **`db_file_storage/`**: A file storage system that allows storing files as raw bytes and mimetypes in the database.\n\n- **`website/`**: The Django app for the website.\n  - `migrations/`: Database migration files.\n  - `static/`: Static files (CSS, JavaScript, images).\n  - `templates/`: HTML templates.\n  - `admin.py`: Admin interface configuration.\n  - `forms.py`: Defines forms for user input and validation.\n  - `models.py`: Defines database structure and interactions.\n  - `serializers.py`: Converts complex data types into JSON, XML, or other formats.\n  - `tests.py`: Unit tests.\n  - `urls.py`: URL configuration for the website app.\n  - `views.py`: Handles HTTP requests and returns responses.\n\n- **Project root files:**\n  - `manage.py`: Django’s command-line utility for administrative tasks.\n  - `requirements.txt`: Contains project dependencies.\n\n---\n\n## **Getting the App Running**\n\n### **Prerequisites**\nEnsure you have **Python 3.8+** installed. You can check your Python version with:\n\n```sh\npython --version\n```\n\nor\n\n```sh\npython3 --version\n```\n\nIf Python is not installed, download and install it from [python.org](https://www.python.org/downloads/).\n\n---\n\n### **Setup Instructions**\n\n1. **Clone the repository**  \n   Open a terminal and run:\n\n   ```sh\n   git clone https://github.com/your-repo/acmmanoa-site.git\n   cd acmmanoa-site\n   ```\n\n2. **Create a virtual environment (recommended)**  \n   ```sh\n   python -m venv venv\n   source venv/bin/activate  # On macOS/Linux\n   venv\\Scripts\\activate  # On Windows\n   ```\n\n3. **Install dependencies**  \n   ```sh\n   pip install -r requirements.txt\n   ```\n\n4. **Create a local settings file**  \n   Inside the `core/` directory, create a new file named `local_settings.py` and add the following:\n\n   ```python\n   from pathlib import Path\n\n   BASE_DIR = Path(__file__).resolve().parent.parent\n\n   DEBUG = True\n\n   DATABASES = {\n       \"default\": {\n           \"ENGINE\": \"django.db.backends.sqlite3\",\n           \"NAME\": BASE_DIR / \"db.sqlite3\",\n       }\n   }\n   ```\n\n5. **Create a `.env` file**  \n   In the `core/` directory, create a new file named `.env` and add the required environment variables.  \n   These variables can be found in the **acmmanoa** project Discord channel.\n\n6. **Apply database migrations**  \n   ```sh\n   python manage.py migrate\n   ```\n\n7. **Collect static files**  \n   ```sh\n   python manage.py collectstatic\n   ```\n\n8. **Create a superuser (optional, for admin access)**  \n   ```sh\n   python manage.py createsuperuser\n   ```\n   Follow the prompts to set up an admin account.\n\n9. **Run the development server**  \n   ```sh\n   python manage.py runserver\n   ```\n   The app should now be running locally at **[http://127.0.0.1:8000](http://127.0.0.1:8000/)**.\n\n---\n\n### **Development Notes**\n- The **admin panel** is accessible at **[http://127.0.0.1:8000/admin/](http://127.0.0.1:8000/admin/)**.\n- If you make changes to the models, run:\n\n  ```sh\n  python manage.py makemigrations\n  python manage.py migrate\n  ```\n\n- If you add new static files, re-run:\n\n  ```sh\n  python manage.py collectstatic\n  ```\n\n---\n\n### **License**\nThis project is maintained by ***8bit***.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8bituhm%2Facmmanoa-site","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F8bituhm%2Facmmanoa-site","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F8bituhm%2Facmmanoa-site/lists"}