Initial commit

.github/workflows/ci.yml

@@ -0,0 +1,15 @@
+name: ci 
+on:
+  push:
+    branches:
+      - main
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v3
+      - uses: actions/setup-python@v3
+        with:
+          python-version: 3.x
+      - run: pip install -r requirements.txt
+      - run: mkdocs gh-deploy --force --no-history

.gitignore

@@ -0,0 +1,3 @@
+.vscode
+*__pycache__*
+.venv

README.md

@@ -0,0 +1,46 @@
+# Project Name
+
+Project Information
+
+## Setup Guide
+
+This website used mkdocs to generate a static site. Follow the steps below to setup the project on your local machine.
+
+Ensure Python is installed on your machine, this project was built with Python 3.10 but it should work with Python >= 3.6.
+
+Open the terminal/Command Line and follow the steps below.
+
+```bash
+python -m venv .venv
+```
+
+For Windows
+
+```bash
+.venv/Scripts/activate
+```
+
+For Unix OSes
+
+```bash
+source .venv/bin/activate
+```
+
+Install the required packages
+
+```bash
+pip install -r requirements.txt
+mkdocs serve # this will deploy the website locally, make sure all your work is in the docs/ folder
+```
+
+When the the main branch is updated, a workflow will run to deploy the website to gh-pages branch. Ensure workflows are given all read and write permissions in settings else the action will fail. During development forks or other branches can be used, but the main branch should be used only when ready for deployment.
+
+Deployment can be setup via GitHub pages pointing to the gh-pages branch. DNS will have to be setup.
+
+Files to be changed:
+
+- CNAME
+- mkdocs.yml
+- index.md
+
+Images can be put in the docs/assets folder. Requirement.txt must be updated with any of the python requirements.

docs/CNAME

@@ -0,0 +1 @@
+template_site.acmbpdc.org

docs/index.md

@@ -0,0 +1,3 @@
+# Template Title
+
+Template text

mkdocs.yml

@@ -0,0 +1,60 @@
+site_name: Template Site
+remote_branch: gh-pages
+site_url: https://template_site.acmbpdc.org
+site_author: ACM BPDC
+site_description: A template site, replace this with the actual description
+repo_url: https://github.com/acmbpdc/mkdocs-template
+repo_name: acmbpdc/mkdocs-template
+
+copyright: Copyright © 2024 - ACM BITS Pilani Dubai Campus
+
+theme:
+  name: material
+  palette:
+    - media: "(prefers-color-scheme: light)"
+      scheme: default
+      toggle:
+        icon: material/brightness-7
+        name: Switch to dark mode
+    - media: "(prefers-color-scheme: dark)"
+      scheme: slate
+      toggle:
+        icon: material/brightness-4
+        name: Switch to light mode
+  logo: assets/ACM_Logo.png
+  favicon: assets/favicon.ico
+  icon:
+    repo: fontawesome/brands/github
+  features:
+    - navigation.instant
+    - navigation.tracking
+    - navigation.tabs
+    - navigation.tabs.sticky
+    - navigation.sections
+    - navigation.expand
+    - navigation.top
+    - search.suggest
+    - search.highlight
+    - header.autohide
+
+extra:
+  social:
+    - icon: fontawesome/brands/instagram
+      link: https://instagram.com/acmbpdc
+    - icon: fontawesome/brands/github 
+      link: https://github.com/acmbpdc
+    - icon: fontawesome/brands/discord
+      link: https://discord.gg/DYQdxquYwP
+
+# Use the below section for more specific control
+# nav:
+#   - Home: index.md
+#   - Git & GitHub Workshop: workshop.md
+
+markdown_extensions:
+  - toc:
+      permalink: True
+
+plugins:
+  - search
+  - mkdocs-jupyter

requirements.txt

@@ -0,0 +1,3 @@
+mkdocs
+mkdocs-material
+mkdocs-jupyter