Repository files navigation

UQCS Website

The website of The University of Queensland Computing Society.

This site is built on a verison of the jamstack using:

  • Hugo Templating
  • Bulma CSS Framework
  • Font Awesome Icons
  • Custom CSS and JS

Which is compiled to static files using Github Actions and then hosted Github Pages.

Contributing

The UQCS site is a place to show off both the club itself, and the work of its members. You can contribute ideas, bugs or suggestions by clicking the Issues tab above and creating a new issue.

You can contribute code by forking the repository, making your changes and creating a pull request. It's encouraged to create an issue for the changes you plan on making in your pull request and you should mention the IDs of any issues you work on in your pull request description.

For more information checkout the CONTRIBUTING.md

Want help with creating a pull request? No problem! Email us at contact@uqcs.org.au for help, or ask in Discord.

Getting Setup

  1. Install Git.
  2. Install Hugo (make sure to get the extended version).
  3. Open your preferred terminal.
  4. Run git clone https://github.com/UQComputingSociety/website.git
  5. Run cd website
  6. Run hugo server -D
  7. Open your preferred browser.
  8. Navigate to http://localhost:1313/
WSL

A couple extra steps are needed for running hugo on WSL. Do steps 1-5, then:

  1. In a windows terminal, use wsl -t $name to terminate any WSL instances except the one you want to run hugo on.
  2. Run wsl hostname -I to find the IP address of that WSL instance.
  3. Run hugo server -D --bind $ip --baseURL=$ip instead of just hugo server -D
  4. Open your preferred browser.
  5. Navigate to http://$ip:1313/

Showcasing Your Project

Have you built something cool you want to show off to the world? It's easy to publish your project to the UQCS Showcase.

  1. Fork this repository so you can make changes.
  2. Follow the "Getting Setup" instructions above, replacing the URL with your fork's URL.
  3. Add your project to content/showcase/_index.html by copying the format of an existing showcase-item. New projects should be added to the top.
  4. Modify the caption text with a short blurb for your project. If you want to, you can use basic HTML in this field.
  5. Add an image by adding it to the static/img/media/showcase/ folder then specifying the src attribute. Images should be at least 1000×750 (larger images with the same aspect ratio are also fine).
  6. Link your project's GitHub repository or website using the link attribute.
  7. Preview the showcase page at http://localhost:1313/showcase/ and make sure you're happy with how it looks.
  8. Create a pull request by following the steps at CONTRIBUTING.md (creating a new issue isn't required for showcase items).
  9. Once merged, you should be able to see your project at https://uqcs.org/showcase/!

Google Calendar API Key

The /events calendar uses FullCalendar.js and fetches events from Google Calendar. To do this, it needs a Google API key. Currently, the production key is specified in events/_index.html but you will need your own key to test locally.

  1. Go to https://console.developers.google.com/apis/dashboard.
  2. If you haven't done so already, sign up with a Google account and create a new project. (UQCS committee can sign in with the Google account and use the "UQCS Website Calendar" project.)
  3. If you created a new project, enable the Google Calendar API from within APIs & Services → Library.
  4. Go to APIs & Services → Credentials and create new credentials. This page also shows existing API keys.
  5. Copy the key use it where needed. Optionally, you can restrict this key to specific websites and APIs.

Licensing

This project is licensed under the Apache License 2.0.

About

The UQ Computing Society website.

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

Repository files navigation

UQCS Website

The website of The University of Queensland Computing Society.

This site is built on a verison of the jamstack using:

  • Hugo Templating
  • Bulma CSS Framework
  • Font Awesome Icons
  • Custom CSS and JS

Which is compiled to static files using Github Actions and then hosted Github Pages.

Contributing

The UQCS site is a place to show off both the club itself, and the work of its members. You can contribute ideas, bugs or suggestions by clicking the Issues tab above and creating a new issue.

You can contribute code by forking the repository, making your changes and creating a pull request. It's encouraged to create an issue for the changes you plan on making in your pull request and you should mention the IDs of any issues you work on in your pull request description.

For more information checkout the CONTRIBUTING.md

Want help with creating a pull request? No problem! Email us at contact@uqcs.org.au for help, or ask in Discord.

Getting Setup

  1. Install Git.
  2. Install Hugo (make sure to get the extended version).
  3. Open your preferred terminal.
  4. Run git clone https://github.com/UQComputingSociety/website.git
  5. Run cd website
  6. Run hugo server -D
  7. Open your preferred browser.
  8. Navigate to http://localhost:1313/
WSL

A couple extra steps are needed for running hugo on WSL. Do steps 1-5, then:

  1. In a windows terminal, use wsl -t $name to terminate any WSL instances except the one you want to run hugo on.
  2. Run wsl hostname -I to find the IP address of that WSL instance.
  3. Run hugo server -D --bind $ip --baseURL=$ip instead of just hugo server -D
  4. Open your preferred browser.
  5. Navigate to http://$ip:1313/

Showcasing Your Project

Have you built something cool you want to show off to the world? It's easy to publish your project to the UQCS Showcase.

  1. Fork this repository so you can make changes.
  2. Follow the "Getting Setup" instructions above, replacing the URL with your fork's URL.
  3. Add your project to content/showcase/_index.html by copying the format of an existing showcase-item. New projects should be added to the top.
  4. Modify the caption text with a short blurb for your project. If you want to, you can use basic HTML in this field.
  5. Add an image by adding it to the static/img/media/showcase/ folder then specifying the src attribute. Images should be at least 1000×750 (larger images with the same aspect ratio are also fine).
  6. Link your project's GitHub repository or website using the link attribute.
  7. Preview the showcase page at http://localhost:1313/showcase/ and make sure you're happy with how it looks.
  8. Create a pull request by following the steps at CONTRIBUTING.md (creating a new issue isn't required for showcase items).
  9. Once merged, you should be able to see your project at https://uqcs.org/showcase/!

Google Calendar API Key

The /events calendar uses FullCalendar.js and fetches events from Google Calendar. To do this, it needs a Google API key. Currently, the production key is specified in events/_index.html but you will need your own key to test locally.

  1. Go to https://console.developers.google.com/apis/dashboard.
  2. If you haven't done so already, sign up with a Google account and create a new project. (UQCS committee can sign in with the Google account and use the "UQCS Website Calendar" project.)
  3. If you created a new project, enable the Google Calendar API from within APIs & Services → Library.
  4. Go to APIs & Services → Credentials and create new credentials. This page also shows existing API keys.
  5. Copy the key use it where needed. Optionally, you can restrict this key to specific websites and APIs.

Licensing

This project is licensed under the Apache License 2.0.

About

The UQ Computing Society website.

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

UQCS Website

The website of The University of Queensland Computing Society.

This site is built on a verison of the jamstack using:

  • Hugo Templating
  • Bulma CSS Framework
  • Font Awesome Icons
  • Custom CSS and JS

Which is compiled to static files using Github Actions and then hosted Github Pages.

Contributing

The UQCS site is a place to show off both the club itself, and the work of its members. You can contribute ideas, bugs or suggestions by clicking the Issues tab above and creating a new issue.

You can contribute code by forking the repository, making your changes and creating a pull request. It's encouraged to create an issue for the changes you plan on making in your pull request and you should mention the IDs of any issues you work on in your pull request description.

For more information checkout the CONTRIBUTING.md

Want help with creating a pull request? No problem! Email us at contact@uqcs.org.au for help, or ask in Discord.

Getting Setup

  1. Install Git.
  2. Install Hugo (make sure to get the extended version).
  3. Open your preferred terminal.
  4. Run git clone https://github.com/UQComputingSociety/website.git
  5. Run cd website
  6. Run hugo server -D
  7. Open your preferred browser.
  8. Navigate to http://localhost:1313/
WSL

A couple extra steps are needed for running hugo on WSL. Do steps 1-5, then:

  1. In a windows terminal, use wsl -t $name to terminate any WSL instances except the one you want to run hugo on.
  2. Run wsl hostname -I to find the IP address of that WSL instance.
  3. Run hugo server -D --bind $ip --baseURL=$ip instead of just hugo server -D
  4. Open your preferred browser.
  5. Navigate to http://$ip:1313/

Showcasing Your Project

Have you built something cool you want to show off to the world? It's easy to publish your project to the UQCS Showcase.

  1. Fork this repository so you can make changes.
  2. Follow the "Getting Setup" instructions above, replacing the URL with your fork's URL.
  3. Add your project to content/showcase/_index.html by copying the format of an existing showcase-item. New projects should be added to the top.
  4. Modify the caption text with a short blurb for your project. If you want to, you can use basic HTML in this field.
  5. Add an image by adding it to the static/img/media/showcase/ folder then specifying the src attribute. Images should be at least 1000×750 (larger images with the same aspect ratio are also fine).
  6. Link your project's GitHub repository or website using the link attribute.
  7. Preview the showcase page at http://localhost:1313/showcase/ and make sure you're happy with how it looks.
  8. Create a pull request by following the steps at CONTRIBUTING.md (creating a new issue isn't required for showcase items).
  9. Once merged, you should be able to see your project at https://uqcs.org/showcase/!

Google Calendar API Key

The /events calendar uses FullCalendar.js and fetches events from Google Calendar. To do this, it needs a Google API key. Currently, the production key is specified in events/_index.html but you will need your own key to test locally.

  1. Go to https://console.developers.google.com/apis/dashboard.
  2. If you haven't done so already, sign up with a Google account and create a new project. (UQCS committee can sign in with the Google account and use the "UQCS Website Calendar" project.)
  3. If you created a new project, enable the Google Calendar API from within APIs & Services → Library.
  4. Go to APIs & Services → Credentials and create new credentials. This page also shows existing API keys.
  5. Copy the key use it where needed. Optionally, you can restrict this key to specific websites and APIs.

Licensing

This project is licensed under the Apache License 2.0.

About

The UQ Computing Society website.

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

UQCS Website

The website of The University of Queensland Computing Society.

This site is built on a verison of the jamstack using:

  • Hugo Templating
  • Bulma CSS Framework
  • Font Awesome Icons
  • Custom CSS and JS

Which is compiled to static files using Github Actions and then hosted Github Pages.

Contributing

The UQCS site is a place to show off both the club itself, and the work of its members. You can contribute ideas, bugs or suggestions by clicking the Issues tab above and creating a new issue.

You can contribute code by forking the repository, making your changes and creating a pull request. It's encouraged to create an issue for the changes you plan on making in your pull request and you should mention the IDs of any issues you work on in your pull request description.

For more information checkout the CONTRIBUTING.md

Want help with creating a pull request? No problem! Email us at contact@uqcs.org.au for help, or ask in Discord.

Getting Setup

  1. Install Git.
  2. Install Hugo (make sure to get the extended version).
  3. Open your preferred terminal.
  4. Run git clone https://github.com/UQComputingSociety/website.git
  5. Run cd website
  6. Run hugo server -D
  7. Open your preferred browser.
  8. Navigate to http://localhost:1313/
WSL

A couple extra steps are needed for running hugo on WSL. Do steps 1-5, then:

  1. In a windows terminal, use wsl -t $name to terminate any WSL instances except the one you want to run hugo on.
  2. Run wsl hostname -I to find the IP address of that WSL instance.
  3. Run hugo server -D --bind $ip --baseURL=$ip instead of just hugo server -D
  4. Open your preferred browser.
  5. Navigate to http://$ip:1313/

Showcasing Your Project

Have you built something cool you want to show off to the world? It's easy to publish your project to the UQCS Showcase.

  1. Fork this repository so you can make changes.
  2. Follow the "Getting Setup" instructions above, replacing the URL with your fork's URL.
  3. Add your project to content/showcase/_index.html by copying the format of an existing showcase-item. New projects should be added to the top.
  4. Modify the caption text with a short blurb for your project. If you want to, you can use basic HTML in this field.
  5. Add an image by adding it to the static/img/media/showcase/ folder then specifying the src attribute. Images should be at least 1000×750 (larger images with the same aspect ratio are also fine).
  6. Link your project's GitHub repository or website using the link attribute.
  7. Preview the showcase page at http://localhost:1313/showcase/ and make sure you're happy with how it looks.
  8. Create a pull request by following the steps at CONTRIBUTING.md (creating a new issue isn't required for showcase items).
  9. Once merged, you should be able to see your project at https://uqcs.org/showcase/!

Google Calendar API Key

The /events calendar uses FullCalendar.js and fetches events from Google Calendar. To do this, it needs a Google API key. Currently, the production key is specified in events/_index.html but you will need your own key to test locally.

  1. Go to https://console.developers.google.com/apis/dashboard.
  2. If you haven't done so already, sign up with a Google account and create a new project. (UQCS committee can sign in with the Google account and use the "UQCS Website Calendar" project.)
  3. If you created a new project, enable the Google Calendar API from within APIs & Services → Library.
  4. Go to APIs & Services → Credentials and create new credentials. This page also shows existing API keys.
  5. Copy the key use it where needed. Optionally, you can restrict this key to specific websites and APIs.

Licensing

This project is licensed under the Apache License 2.0.

About

The UQ Computing Society website.

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

Repository files navigation

UQCS Website

The website of The University of Queensland Computing Society.

This site is built on a verison of the jamstack using:

  • Hugo Templating
  • Bulma CSS Framework
  • Font Awesome Icons
  • Custom CSS and JS

Which is compiled to static files using Github Actions and then hosted Github Pages.

Contributing

The UQCS site is a place to show off both the club itself, and the work of its members. You can contribute ideas, bugs or suggestions by clicking the Issues tab above and creating a new issue.

You can contribute code by forking the repository, making your changes and creating a pull request. It's encouraged to create an issue for the changes you plan on making in your pull request and you should mention the IDs of any issues you work on in your pull request description.

For more information checkout the CONTRIBUTING.md

Want help with creating a pull request? No problem! Email us at contact@uqcs.org.au for help, or ask in Discord.

Getting Setup

  1. Install Git.
  2. Install Hugo (make sure to get the extended version).
  3. Open your preferred terminal.
  4. Run git clone https://github.com/UQComputingSociety/website.git
  5. Run cd website
  6. Run hugo server -D
  7. Open your preferred browser.
  8. Navigate to http://localhost:1313/
WSL

A couple extra steps are needed for running hugo on WSL. Do steps 1-5, then:

  1. In a windows terminal, use wsl -t $name to terminate any WSL instances except the one you want to run hugo on.
  2. Run wsl hostname -I to find the IP address of that WSL instance.
  3. Run hugo server -D --bind $ip --baseURL=$ip instead of just hugo server -D
  4. Open your preferred browser.
  5. Navigate to http://$ip:1313/

Showcasing Your Project

Have you built something cool you want to show off to the world? It's easy to publish your project to the UQCS Showcase.

  1. Fork this repository so you can make changes.
  2. Follow the "Getting Setup" instructions above, replacing the URL with your fork's URL.
  3. Add your project to content/showcase/_index.html by copying the format of an existing showcase-item. New projects should be added to the top.
  4. Modify the caption text with a short blurb for your project. If you want to, you can use basic HTML in this field.
  5. Add an image by adding it to the static/img/media/showcase/ folder then specifying the src attribute. Images should be at least 1000×750 (larger images with the same aspect ratio are also fine).
  6. Link your project's GitHub repository or website using the link attribute.
  7. Preview the showcase page at http://localhost:1313/showcase/ and make sure you're happy with how it looks.
  8. Create a pull request by following the steps at CONTRIBUTING.md (creating a new issue isn't required for showcase items).
  9. Once merged, you should be able to see your project at https://uqcs.org/showcase/!

Google Calendar API Key

The /events calendar uses FullCalendar.js and fetches events from Google Calendar. To do this, it needs a Google API key. Currently, the production key is specified in events/_index.html but you will need your own key to test locally.

  1. Go to https://console.developers.google.com/apis/dashboard.
  2. If you haven't done so already, sign up with a Google account and create a new project. (UQCS committee can sign in with the Google account and use the "UQCS Website Calendar" project.)
  3. If you created a new project, enable the Google Calendar API from within APIs & Services → Library.
  4. Go to APIs & Services → Credentials and create new credentials. This page also shows existing API keys.
  5. Copy the key use it where needed. Optionally, you can restrict this key to specific websites and APIs.

Licensing

This project is licensed under the Apache License 2.0.

About

The UQ Computing Society website.

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

UQCS Website

The website of The University of Queensland Computing Society.

This site is built on a verison of the jamstack using:

  • Hugo Templating
  • Bulma CSS Framework
  • Font Awesome Icons
  • Custom CSS and JS

Which is compiled to static files using Github Actions and then hosted Github Pages.

Contributing

The UQCS site is a place to show off both the club itself, and the work of its members. You can contribute ideas, bugs or suggestions by clicking the Issues tab above and creating a new issue.

You can contribute code by forking the repository, making your changes and creating a pull request. It's encouraged to create an issue for the changes you plan on making in your pull request and you should mention the IDs of any issues you work on in your pull request description.

For more information checkout the CONTRIBUTING.md

Want help with creating a pull request? No problem! Email us at contact@uqcs.org.au for help, or ask in Discord.

Getting Setup

  1. Install Git.
  2. Install Hugo (make sure to get the extended version).
  3. Open your preferred terminal.
  4. Run git clone https://github.com/UQComputingSociety/website.git
  5. Run cd website
  6. Run hugo server -D
  7. Open your preferred browser.
  8. Navigate to http://localhost:1313/
WSL

A couple extra steps are needed for running hugo on WSL. Do steps 1-5, then:

  1. In a windows terminal, use wsl -t $name to terminate any WSL instances except the one you want to run hugo on.
  2. Run wsl hostname -I to find the IP address of that WSL instance.
  3. Run hugo server -D --bind $ip --baseURL=$ip instead of just hugo server -D
  4. Open your preferred browser.
  5. Navigate to http://$ip:1313/

Showcasing Your Project

Have you built something cool you want to show off to the world? It's easy to publish your project to the UQCS Showcase.

  1. Fork this repository so you can make changes.
  2. Follow the "Getting Setup" instructions above, replacing the URL with your fork's URL.
  3. Add your project to content/showcase/_index.html by copying the format of an existing showcase-item. New projects should be added to the top.
  4. Modify the caption text with a short blurb for your project. If you want to, you can use basic HTML in this field.
  5. Add an image by adding it to the static/img/media/showcase/ folder then specifying the src attribute. Images should be at least 1000×750 (larger images with the same aspect ratio are also fine).
  6. Link your project's GitHub repository or website using the link attribute.
  7. Preview the showcase page at http://localhost:1313/showcase/ and make sure you're happy with how it looks.
  8. Create a pull request by following the steps at CONTRIBUTING.md (creating a new issue isn't required for showcase items).
  9. Once merged, you should be able to see your project at https://uqcs.org/showcase/!

Google Calendar API Key

The /events calendar uses FullCalendar.js and fetches events from Google Calendar. To do this, it needs a Google API key. Currently, the production key is specified in events/_index.html but you will need your own key to test locally.

  1. Go to https://console.developers.google.com/apis/dashboard.
  2. If you haven't done so already, sign up with a Google account and create a new project. (UQCS committee can sign in with the Google account and use the "UQCS Website Calendar" project.)
  3. If you created a new project, enable the Google Calendar API from within APIs & Services → Library.
  4. Go to APIs & Services → Credentials and create new credentials. This page also shows existing API keys.
  5. Copy the key use it where needed. Optionally, you can restrict this key to specific websites and APIs.

Licensing

This project is licensed under the Apache License 2.0.

About

The UQ Computing Society website.

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

Repository files navigation

UQCS Website

The website of The University of Queensland Computing Society.

This site is built on a verison of the jamstack using:

  • Hugo Templating
  • Bulma CSS Framework
  • Font Awesome Icons
  • Custom CSS and JS

Which is compiled to static files using Github Actions and then hosted Github Pages.

Contributing

The UQCS site is a place to show off both the club itself, and the work of its members. You can contribute ideas, bugs or suggestions by clicking the Issues tab above and creating a new issue.

You can contribute code by forking the repository, making your changes and creating a pull request. It's encouraged to create an issue for the changes you plan on making in your pull request and you should mention the IDs of any issues you work on in your pull request description.

For more information checkout the CONTRIBUTING.md

Want help with creating a pull request? No problem! Email us at contact@uqcs.org.au for help, or ask in Discord.

Getting Setup

  1. Install Git.
  2. Install Hugo (make sure to get the extended version).
  3. Open your preferred terminal.
  4. Run git clone https://github.com/UQComputingSociety/website.git
  5. Run cd website
  6. Run hugo server -D
  7. Open your preferred browser.
  8. Navigate to http://localhost:1313/
WSL

A couple extra steps are needed for running hugo on WSL. Do steps 1-5, then:

  1. In a windows terminal, use wsl -t $name to terminate any WSL instances except the one you want to run hugo on.
  2. Run wsl hostname -I to find the IP address of that WSL instance.
  3. Run hugo server -D --bind $ip --baseURL=$ip instead of just hugo server -D
  4. Open your preferred browser.
  5. Navigate to http://$ip:1313/

Showcasing Your Project

Have you built something cool you want to show off to the world? It's easy to publish your project to the UQCS Showcase.

  1. Fork this repository so you can make changes.
  2. Follow the "Getting Setup" instructions above, replacing the URL with your fork's URL.
  3. Add your project to content/showcase/_index.html by copying the format of an existing showcase-item. New projects should be added to the top.
  4. Modify the caption text with a short blurb for your project. If you want to, you can use basic HTML in this field.
  5. Add an image by adding it to the static/img/media/showcase/ folder then specifying the src attribute. Images should be at least 1000×750 (larger images with the same aspect ratio are also fine).
  6. Link your project's GitHub repository or website using the link attribute.
  7. Preview the showcase page at http://localhost:1313/showcase/ and make sure you're happy with how it looks.
  8. Create a pull request by following the steps at CONTRIBUTING.md (creating a new issue isn't required for showcase items).
  9. Once merged, you should be able to see your project at https://uqcs.org/showcase/!

Google Calendar API Key

The /events calendar uses FullCalendar.js and fetches events from Google Calendar. To do this, it needs a Google API key. Currently, the production key is specified in events/_index.html but you will need your own key to test locally.

  1. Go to https://console.developers.google.com/apis/dashboard.
  2. If you haven't done so already, sign up with a Google account and create a new project. (UQCS committee can sign in with the Google account and use the "UQCS Website Calendar" project.)
  3. If you created a new project, enable the Google Calendar API from within APIs & Services → Library.
  4. Go to APIs & Services → Credentials and create new credentials. This page also shows existing API keys.
  5. Copy the key use it where needed. Optionally, you can restrict this key to specific websites and APIs.

Licensing

This project is licensed under the Apache License 2.0.

About

The UQ Computing Society website.

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages

, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

Repository files navigation

UQCS Website

The website of The University of Queensland Computing Society.

This site is built on a verison of the jamstack using:

  • Hugo Templating
  • Bulma CSS Framework
  • Font Awesome Icons
  • Custom CSS and JS

Which is compiled to static files using Github Actions and then hosted Github Pages.

Contributing

The UQCS site is a place to show off both the club itself, and the work of its members. You can contribute ideas, bugs or suggestions by clicking the Issues tab above and creating a new issue.

You can contribute code by forking the repository, making your changes and creating a pull request. It's encouraged to create an issue for the changes you plan on making in your pull request and you should mention the IDs of any issues you work on in your pull request description.

For more information checkout the CONTRIBUTING.md

Want help with creating a pull request? No problem! Email us at contact@uqcs.org.au for help, or ask in Discord.

Getting Setup

  1. Install Git.
  2. Install Hugo (make sure to get the extended version).
  3. Open your preferred terminal.
  4. Run git clone https://github.com/UQComputingSociety/website.git
  5. Run cd website
  6. Run hugo server -D
  7. Open your preferred browser.
  8. Navigate to http://localhost:1313/
WSL

A couple extra steps are needed for running hugo on WSL. Do steps 1-5, then:

  1. In a windows terminal, use wsl -t $name to terminate any WSL instances except the one you want to run hugo on.
  2. Run wsl hostname -I to find the IP address of that WSL instance.
  3. Run hugo server -D --bind $ip --baseURL=$ip instead of just hugo server -D
  4. Open your preferred browser.
  5. Navigate to http://$ip:1313/

Showcasing Your Project

Have you built something cool you want to show off to the world? It's easy to publish your project to the UQCS Showcase.

  1. Fork this repository so you can make changes.
  2. Follow the "Getting Setup" instructions above, replacing the URL with your fork's URL.
  3. Add your project to content/showcase/_index.html by copying the format of an existing showcase-item. New projects should be added to the top.
  4. Modify the caption text with a short blurb for your project. If you want to, you can use basic HTML in this field.
  5. Add an image by adding it to the static/img/media/showcase/ folder then specifying the src attribute. Images should be at least 1000×750 (larger images with the same aspect ratio are also fine).
  6. Link your project's GitHub repository or website using the link attribute.
  7. Preview the showcase page at http://localhost:1313/showcase/ and make sure you're happy with how it looks.
  8. Create a pull request by following the steps at CONTRIBUTING.md (creating a new issue isn't required for showcase items).
  9. Once merged, you should be able to see your project at https://uqcs.org/showcase/!

Google Calendar API Key

The /events calendar uses FullCalendar.js and fetches events from Google Calendar. To do this, it needs a Google API key. Currently, the production key is specified in events/_index.html but you will need your own key to test locally.

  1. Go to https://console.developers.google.com/apis/dashboard.
  2. If you haven't done so already, sign up with a Google account and create a new project. (UQCS committee can sign in with the Google account and use the "UQCS Website Calendar" project.)
  3. If you created a new project, enable the Google Calendar API from within APIs & Services → Library.
  4. Go to APIs & Services → Credentials and create new credentials. This page also shows existing API keys.
  5. Copy the key use it where needed. Optionally, you can restrict this key to specific websites and APIs.

Licensing

This project is licensed under the Apache License 2.0.

About

The UQ Computing Society website.

Resources

Code of conduct

Contributing

Stars

14 stars

Watchers

13 watching

Forks

Releases

Packages

Used by

Contributors

Languages