diff --git a/.github/workflows/generate-readme.yml b/.github/workflows/generate-readme.yml
index f8cd3fb..88b3224 100644
--- a/.github/workflows/generate-readme.yml
+++ b/.github/workflows/generate-readme.yml
@@ -4,8 +4,8 @@ on:
branches: ['main']
paths:
- '**.user.js'
- - 'generate-readme.ps1'
- - 'ReadmeTemplate.md'
+ - 'doc/generate-readme.ps1'
+ - 'doc/ReadmeTemplate.md'
- 'doc/**'
name: Generate Readme
@@ -20,7 +20,7 @@ jobs:
- name: Generate Readme
shell: pwsh
run: |
- ./generate-readme.ps1 | Out-File -filePath README.md -Encoding UTF8
+ ./doc/generate-readme.ps1 | Out-File -filePath README.md -Encoding UTF8
git config user.email "m365-bot@ntnu.no"
git config user.name "github-actions[bot]"
diff --git a/README.md b/README.md
index 3f9a223..dd499b5 100644
--- a/README.md
+++ b/README.md
@@ -32,7 +32,7 @@ TamperMonkey scripts to improve sites (Fuglane, Innsida etc.)
### BAS - Modern Style Toggle
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/modern-bas.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/modern-bas/modern-bas.user.js)
- **Author:** Øyvind Nilsen (on@ntnu.no)
- **Match:** `https://bas.ntnu.no/*`
- **Exclude:**
@@ -41,7 +41,7 @@ TamperMonkey scripts to improve sites (Fuglane, Innsida etc.)
- **Description:** Apply modern styling to BAS/Cereweb with toggle between modern and classic
### BAS - Quick Search
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/bas-search.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/bas-search/bas-search.user.js)
- **Author:** Øyvind Nilsen (on@ntnu.no)
- **Match:** `https://bas.ntnu.no/*`
- **Description:** Quick search using `Ctrl` + `Shift` + `F` hotkey, group search with "g:" and person search with "p:" prefix. Navigate tabs with Ctrl + Left/Right keys. Navigate search results with up and down keys.
@@ -57,22 +57,22 @@ TamperMonkey scripts to improve sites (Fuglane, Innsida etc.)
- On the login page, the username field is automatically focused.
#### Video:
-
+
### Diri.ai - Remove blur
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/diri.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/diri/diri.user.js)
- **Author:** Øyvind Nilsen (on@ntnu.no)
- **Match:** `https://diri.ai/*`
- **Description:** Sets --blur-xs to 0px instead of 4px for diri.ai
### Feide - Auto-Press Microsoft Sign-In.
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/feide-microsoft.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/feide-microsoft/feide-microsoft.user.js)
- **Author:** Øyvind Nilsen (on@ntnu.no)
- **Match:** `https://idp.feide.no/simplesaml/module.php/*`
- **Description:** Automatically press the Microsoft sign-in button.
### Fuglane - Issue links
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/fuglane.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/fuglane/fuglane.user.js)
- **Author:** Øyvind Nilsen (on@ntnu.no)
- **Match:**
- `https://fuglane.it.ntnu.no/display/*`
@@ -82,63 +82,90 @@ TamperMonkey scripts to improve sites (Fuglane, Innsida etc.)
- **Description:** Replace NTNU issue numbers, change numbers and upn's with clickable links to TopDesk
### Innsida - Custom CSS
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/innsida-custom-css.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/innsida-custom-css/innsida-custom-css.user.js)
- **Author:** Magnus Børnes (magnborn@ntnu.no)
- **Match:** `https://innsida.ntnu.no/*`
- **Description:** Custom CSS and Text Removal for innsida.ntnu.no
### Innsida - Quick Search
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/innsida-search.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/innsida-search/innsida-search.user.js)
- **Author:** Øyvind Nilsen (on@ntnu.no)
- **Match:** `https://innsida.ntnu.no/*`
- **Description:** `Ctrl` + `Shift` + `F` to search on Innsida
### M365 Admin - PIM Activate Hotkey
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/m365-admin.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/m365-admin/m365-admin.user.js)
- **Author:** Øyvind Nilsen (on@ntnu.no)
- **Match:** `https://portal.azure.com/*`
- **Description:** `Ctrl` + `Enter` to Activate PIM role instead of having to manually click the `Activate` button.
### TopDesk - Copy Issuenumber
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/topdesk.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/topdesk/topdesk.user.js)
- **Author:** Øyvind Nilsen (on@ntnu.no)
- **Match:** `https://hjelp.ntnu.no/tas/secure/mango/window/*`
- **Description:** Copies the issue number if you click it in TopDesk or with the hotkey `ctrl` + `alt` + `c`. It copies plain text and a clickable HTML version. So if the place you paste supports HTML, you can paste a clickable link to the issue.
-
+
### TOPdesk - Highlight Summary
- - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/topdesk-highlight-summary.user.js)
+ - **Install:** [](https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main//home/ubuntu/actions-runner/_work/MonkeyMagic/MonkeyMagic/scripts/topdesk-highlight-summary/topdesk-highlight-summary.user.js)
- **Author:** Magnus Børnes (magnborn@ntnu.no)
- **Match:** `https://hjelp.ntnu.no/tas/secure/mango/window/*`
- **Description:** Highlight the summary section in a box with a slightly yellow-orange background
# Contribute
-## Basic Contribution
+
+## Getting Started
1. Clone the repository
```bash
git clone git@git.ntnu.no:M365-Drift/MonkeyMagic.git
cd MonkeyMagic
```
-2. Pull the latest changes. (Important since the README.md is generated)
+2. If there have been made changes in the repository after you cloned it you should pull the latest changes. (Important since the README.md is auto generated)
```bash
git pull
```
-3. Add your script to the repository
-```bash
- git add myscript.user.js
- git commit -m "Added my script"
- git push
- ```
-4. A Github Action will be automatically triggered and generate a new README.md file.
-## Advanced Contribution
+## Creating Your UserScript
+
+### Hello World Example
+Here's a simple hello world UserScript to get you started:
-### Auto Update
-To enable auto update of your UserScript, you need to add the following lines (change the filename to your filename) to the top of your script. This will make TamperMonkey check for updates every 24 hours.
```javascript
-// @updateURL https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/bas-search.user.js
-// @downloadURL https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/bas-search.user.js
+// ==UserScript==
+// @name Hello World Example
+// @namespace https://git.ntnu.no/M365-Drift/MonkeyMagic/
+// @version 1.0.0
+// @description A simple hello world example
+// @author Your Name (your.email@ntnu.no)
+// @match https://example.com/*
+// @updateURL https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/scripts/hello-world/hello-world.user.js
+// @downloadURL https://git.ntnu.no/M365-Drift/MonkeyMagic/raw/main/scripts/hello-world/hello-world.user.js
+// @grant none
+// ==/UserScript==
+
+(function() {
+ 'use strict';
+ console.log('Hello World from MonkeyMagic!');
+ alert('Hello World!');
+})();
+```
+
+### Important Guidelines
+- **Namespace**: Always use `https://git.ntnu.no/M365-Drift/MonkeyMagic/` as your namespace
+- **Folder Structure**: Create a subfolder under `scripts/` for your script (e.g., `scripts/hello-world/`)
+- **Auto Update**: Include `@updateURL` and `@downloadURL` pointing to your script's location in the repository. This enables automatic updates every 24 hours in TamperMonkey.
+
+### Adding Your Script
+1. Create a new folder under `scripts/` with your script name
+2. Place your `.user.js` file in that folder
+3. Add any documentation or media files to the same folder
+4. Commit and push your changes:
+```bash
+ git add scripts/your-script-name/
+ git commit -m "Added your-script-name userscript"
+ git push
```
+5. A GitHub Action will automatically update the README.md file with your script information.
diff --git a/ReadmeTemplate.md b/ReadmeTemplate.md
deleted file mode 100644
index 0dc109b..0000000
--- a/ReadmeTemplate.md
+++ /dev/null
@@ -1,49 +0,0 @@
-
-
-
+
+