Files
Wolfnova-WebTools/GITEA-SETUP-GUIDE.md
2026-01-19 15:50:27 +00:00

311 lines
7.4 KiB
Markdown

# 🚀 Gitea Setup Guide - LinkedIn AI-Text Generator
## Steg-för-steg installation pÄ din Gitea-server
---
## Steg 1: Skapa Repository i Gitea
1. **Logga in** pÄ din Gitea-server (t.ex. `https://wolfnova.ai/gitea`)
2. Klicka pĂ„ **"+"** → **"New Repository"**
3. **Repository name:** `linkedin-ai-tools`
4. **Visibility:** Public (viktigt! annars fungerar inte bookmarklet)
5. **Initialize repository:**
- ✅ Kryssa i "Initialize Repository"
- ✅ Add README: (vi ersĂ€tter den senare)
- License: None (eller vÀlj en)
6. **Create Repository**
---
## Steg 2: Ladda upp filer
Du har tre alternativ:
### Alternativ A: Via Gitea Web UI (Enklast)
1. I ditt nya repo, klicka **"Upload file"**
2. Dra och slÀpp dessa filer:
- `linkedin-ai.js`
- `version.json`
- `README.md` (ersÀtter befintlig)
3. **Commit message:** "Initial upload v2.0.0"
4. **Commit Changes**
### Alternativ B: Via Git CLI
```bash
# Klona repot
git clone https://wolfnova.ai/gitea/DITTANVÄNDARNAMN/linkedin-ai-tools.git
cd linkedin-ai-tools
# Kopiera filerna till mappen
cp /path/to/linkedin-ai.js .
cp /path/to/version.json .
cp /path/to/README.md .
# Commit och pusha
git add .
git commit -m "Initial upload v2.0.0"
git push origin main
```
### Alternativ C: Direkt redigera i Gitea
1. Klicka pÄ varje fil i repot
2. Klicka **"Edit"**
3. Klistra in innehÄllet
4. **Commit Changes**
---
## Steg 3: Hitta Raw URL
1. I Gitea-repot, klicka pÄ **`linkedin-ai.js`**
2. Klicka pÄ **"Raw"**-knappen
3. Kopiera URL:en frÄn adressfÀltet
**URL-format blir:**
```
https://wolfnova.ai/gitea/DITTANVÄNDARNAMN/linkedin-ai-tools/raw/branch/main/linkedin-ai.js
```
**Exempel:**
```
https://wolfnova.ai/gitea/wolfnova/linkedin-ai-tools/raw/branch/main/linkedin-ai.js
```
---
## Steg 4: Skapa Bookmarklet
Nu skapar du bookmarklet som laddar frÄn din Gitea:
### Bookmarklet-kod:
```javascript
javascript:(function(){var s=document.createElement('script');s.src='https://wolfnova.ai/gitea/DITTANVÄNDARNAMN/linkedin-ai-tools/raw/branch/main/linkedin-ai.js';document.body.appendChild(s);})();
```
**⚠ VIKTIGT:** Byt ut `DITTANVÄNDARNAMN` och domĂ€nen mot din faktiska Gitea-URL!
### Skapa bokmÀrket:
1. **Högerklicka** i bokmÀrkesfÀltet
2. **"Add bookmark"** eller **"LÀgg till bokmÀrke"**
3. **Name:** `✹ LinkedIn AI`
4. **URL:** Klistra in bookmarklet-koden ovan (med din URL!)
5. **Save**
---
## Steg 5: Testa
1. GĂ„ till **LinkedIn.com**
2. **Markera vilken text som helst**
3. **Klicka pĂ„ `✹ LinkedIn AI`** i bokmĂ€rkesfĂ€ltet
4. **Popup ska dyka upp!** ✹
Om det fungerar: 🎉 **Grattis!**
---
## Steg 6: Dela med teamet
### Intern distribution:
**Skapa en guide för ditt team:**
```markdown
# AnvÀnd LinkedIn AI-Text Generator
1. Högerklicka i bokmÀrkesfÀltet
2. VĂ€lj "Add bookmark"
3. Namn: ✹ LinkedIn AI
4. URL: [din bookmarklet-kod hÀr]
5. Spara
Klart! Nu kan du markera text och klicka pÄ bokmÀrket.
```
### Eller skapa en "installer-sida":
Skapa `install.html` i Gitea-repot:
```html
<!DOCTYPE html>
<html>
<head>
<title>LinkedIn AI - Installation</title>
<style>
body { font-family: system-ui; max-width: 800px; margin: 50px auto; padding: 20px; }
.bookmarklet {
display: inline-block;
background: #2c5aa0;
color: white;
padding: 12px 24px;
border-radius: 8px;
text-decoration: none;
font-weight: bold;
}
.bookmarklet:hover { background: #1e3a6b; }
</style>
</head>
<body>
<h1>✹ LinkedIn AI-Text Generator</h1>
<p>Dra detta till ditt bokmÀrkesfÀlt:</p>
<a href="javascript:(function(){var s=document.createElement('script');s.src='https://wolfnova.ai/gitea/DITTANVÄNDARNAMN/linkedin-ai-tools/raw/branch/main/linkedin-ai.js';document.body.appendChild(s);})();" class="bookmarklet">
✹ LinkedIn AI
</a>
<h2>AnvÀndning</h2>
<ol>
<li>GĂ„ till LinkedIn</li>
<li>Markera text</li>
<li>Klicka pÄ bokmÀrket</li>
<li>VĂ€lj funktion</li>
</ol>
</body>
</html>
```
Dela lĂ€nken: `https://wolfnova.ai/gitea/DITTANVÄNDARNAMN/linkedin-ai-tools/src/branch/main/install.html`
---
## Hantera CORS (Om problem uppstÄr)
Om bookmarklet inte kan ladda scriptet pÄ grund av CORS, lÀgg till dessa headers i Gitea:
### Nginx config (om du anvÀnder Nginx framför Gitea):
```nginx
location /gitea/wolfnova/linkedin-ai-tools/raw/ {
add_header Access-Control-Allow-Origin *;
add_header Access-Control-Allow-Methods "GET, OPTIONS";
proxy_pass http://localhost:3000;
}
```
### Alternativt: AnvÀnd CDN
Om CORS Àr ett problem, anvÀnd en CDN som automatiskt lÀgger till CORS-headers:
1. LÀgg scriptet pÄ **jsDelivr** eller **cdnjs**
2. Eller anvÀnd din egen Nginx/Apache med CORS-headers
---
## Uppdatera Scriptet
NĂ€r du vill uppdatera:
1. **Redigera `linkedin-ai.js`** i Gitea
2. **Uppdatera `version.json`:**
```json
{
"version": "2.1.0",
"released": "2026-01-20",
...
}
```
3. **Commit changes**
4. **✅ Alla anvĂ€ndare fĂ„r automatiskt uppdateringen!**
Ingen behöver uppdatera sitt bokmÀrke manuellt!
---
## Felsökning
### Problem: Script laddar inte
**Kontrollera:**
```bash
# Testa om URL:en Àr tillgÀnglig
curl https://wolfnova.ai/gitea/DITTANVÄNDARNAMN/linkedin-ai-tools/raw/branch/main/linkedin-ai.js
# Ska returnera JavaScript-kod, inte HTML
```
**Lösning:**
- Kontrollera att repot Àr Public
- Verifiera att filen heter exakt `linkedin-ai.js`
- Kolla att branch heter `main` (inte `master`)
### Problem: CORS-fel i Console
**Fel:**
```
Access to script at '...' from origin 'https://linkedin.com' has been blocked by CORS policy
```
**Lösning:**
1. LĂ€gg till CORS-headers (se ovan)
2. Eller anvÀnd **fallback inline bookmarklet** (se nedan)
### Problem: CSP-blockering
Vissa sidor (LinkedIn, GitHub) blockerar externa scripts.
**Lösning: Hybrid Bookmarklet**
```javascript
javascript:(function(){
fetch('https://wolfnova.ai/gitea/DITTANVÄNDARNAMN/linkedin-ai-tools/raw/branch/main/linkedin-ai.js')
.then(r => r.text())
.then(code => eval(code))
.catch(e => {
alert('❌ Kunde inte ladda script. Kontrollera att servern Ă€r tillgĂ€nglig.');
console.error(e);
});
})();
```
---
## Backup: Fallback Inline Bookmarklet
Om Gitea-lösningen inte fungerar pÄ grund av CORS/CSP, ha denna som backup:
**Minifierad inline-version** (ingen server behövs):
```javascript
[Din nuvarande inline bookmarklet-kod hÀr som backup]
```
---
## Fördelar med Gitea-lösningen
✅ **Centraliserad uppdatering** - Uppdatera en gĂ„ng, alla fĂ„r uppdateringen
✅ **Versionskontroll** - Git-historik över alla Ă€ndringar
✅ **Collaboration** - Flera kan bidra till utvecklingen
✅ **Self-hosted** - Full kontroll över koden
✅ **Privat eller public** - Du bestĂ€mmer
✅ **CI/CD möjligt** - Kan koppla pĂ„ automatiska tester
---
## NĂ€sta steg
Efter basic setup, övervÀg:
1. **LĂ€gg till fler funktioner** i `linkedin-ai.js`
2. **Skapa installer-sida** för enklare distribution
3. **SĂ€tt upp monitoring** - logga hur ofta scriptet laddas
4. **Version check** - Notifiera anvÀndare om nya versioner
5. **A/B testing** - Testa olika prompts och UI-varianter
---
## Support
Problem? Kontakta:
- **Email:** [din email]
- **Gitea:** https://wolfnova.ai/gitea/DITTANVÄNDARNAMN/linkedin-ai-tools/issues
---
**Lycka till! 🚀**
Wolfnova Innovation