diff --git a/README.md b/README.md index 64848b5..47b53e5 100644 --- a/README.md +++ b/README.md @@ -20,4 +20,4 @@ python3 scrape_server.py curl "http://127.0.0.1:8765/?hash=3b245504cf5f11bbdbe1201cea6a6bf45aee1bc0" ``` -[Documentation complète](docs/) · [Démo interactive](https://team4kw.fr/trigun-remaster-1080p/#infos) +[Documentation complète](https://git.azuze.fr/kawa/Torrent-Indicator/wiki/?action=_pages) · [Démo interactive](https://team4kw.fr/trigun-remaster-1080p/#infos) diff --git a/docs/installation.md b/docs/installation.md deleted file mode 100644 index 5e5a03e..0000000 --- a/docs/installation.md +++ /dev/null @@ -1,120 +0,0 @@ -# Installation - -## Prérequis - -- VPS Linux avec Python 3.8+ -- nginx -- Certbot - ---- - -## 1. Déployer le serveur Python - -```bash -sudo mkdir -p /var/www/torrent-indicator -sudo cp scrape_server.py /var/www/torrent-indicator/ -``` - -### Activer le service systemd - -```bash -sudo cp torrent-scrape.service /etc/systemd/system/ -sudo systemctl daemon-reload -sudo systemctl enable --now torrent-scrape -``` - -Vérifier : - -```bash -sudo systemctl status torrent-scrape -# ● torrent-scrape.service - Torrent Tracker Scrape Server -# Active: active (running) -``` - ---- - -## 2. Obtenir le certificat SSL - -```bash -sudo certbot certonly --nginx -d torrent-api.monsite.com -``` - ---- - -## 3. Configurer nginx - -Ajouter dans `/etc/nginx/sites-available/votresite` : - -```nginx -server { - server_name torrent-api.monsite.com; - - location / { - proxy_pass http://127.0.0.1:8765/; - proxy_set_header Host $host; - proxy_set_header X-Real-IP $remote_addr; - proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; - proxy_set_header X-Forwarded-Proto $scheme; - proxy_read_timeout 15s; - } - - listen 443 ssl; - ssl_certificate /etc/letsencrypt/live/torrent-api.monsite.com/fullchain.pem; - ssl_certificate_key /etc/letsencrypt/live/torrent-api.monsite.com/privkey.pem; - include /etc/letsencrypt/options-ssl-nginx.conf; - ssl_dhparam /etc/letsencrypt/ssl-dhparams.pem; -} - -server { - if ($host = torrent-api.monsite.com) { - return 301 https://$host$request_uri; - } - listen 80; - server_name torrent-api.monsite.com; - return 404; -} -``` - -```bash -sudo nginx -t && sudo nginx -s reload -``` - ---- - -## 4. Vérifier l'API publique - -```bash -curl "https://torrent-api.monsite.com/?hash=3b245504cf5f11bbdbe1201cea6a6bf45aee1bc0" -``` - -Réponse attendue : - -```json -{ - "seeders": 1234, - "leechers": 56, - "health": "excellent", - "popularity": "popular", - "sources": 4 -} -``` - ---- - -## Configuration - -Les paramètres se trouvent en haut de `scrape_server.py` : - -| Variable | Défaut | Description | -|---|---|---| -| `HOST` | `127.0.0.1` | Interface d'écoute | -| `PORT` | `8765` | Port du serveur | -| `TIMEOUT` | `7` | Timeout par tracker (secondes) | -| `CACHE_TTL` | `300` | Durée du cache (secondes) | -| `TRACKERS` | *(liste)* | Trackers HTTP interrogés | - -Après modification, redémarrer le service : - -```bash -sudo systemctl restart torrent-scrape -``` diff --git a/docs/standalone.md b/docs/standalone.md deleted file mode 100644 index 7c97c72..0000000 --- a/docs/standalone.md +++ /dev/null @@ -1,100 +0,0 @@ -# Intégration hors Ghost - -Le widget fonctionne sur n'importe quelle page HTML. Voir `demo.html` pour des exemples concrets. - -## Intégration en 2 étapes - -### 1. Ajouter le CSS et le JS - -Copier le bloc ` - - -``` - -Le script se place de préférence juste avant ``. - -### 2. Placer les widgets dans le HTML - -```html - -
- - -
-``` - ---- - -## Cas d'usage - -### Page de téléchargement - -```html -

Télécharger

-
-Ouvrir le magnet -``` - -### Tableau comparatif de plusieurs torrents - -```html -
-
- -
-
-``` - -### Création dynamique via JavaScript - -```html - -
- - -``` - -### Rafraîchissement manuel - -```js -// Rafraîchir tous les widgets de la page -TorrentIndicator.refreshAll(); -``` - ---- - -## Compatibilité - -- Navigateurs modernes (Chrome, Firefox, Safari, Edge) -- Aucune dépendance externe -- Fonctionne avec : sites statiques, WordPress, Joomla, Drupal, forums, etc. diff --git a/docs/widget.md b/docs/widget.md deleted file mode 100644 index 16cd5f3..0000000 --- a/docs/widget.md +++ /dev/null @@ -1,96 +0,0 @@ -# Widget Ghost - -## 1. Code Injection (une seule fois) - -Dans **Ghost Admin → Settings → Code injection → Site Header**, coller tout le contenu de `ghost-inject.html`. - -Mettre à jour l'URL de l'API en haut du script : - -```js -var API_URL = 'https://torrent-api.monsite.com'; -``` - ---- - -## 2. Utilisation dans les articles - -Dans l'éditeur Ghost, insérer un bloc **HTML** et coller l'un des snippets suivants. - -### Layout compact (vertical) - -```html -
-``` - -### Layout large (horizontal, centré) - -```html -
-``` - -### Via lien magnet - -```html -
-``` - ---- - -## Attributs disponibles - -| Attribut | Requis | Description | -|---|---|---| -| `data-hash` | Oui* | Info hash hexadécimal (40 caractères) | -| `data-magnet` | Oui* | Lien magnet complet | -| `data-label` | Non | Titre affiché dans l'en-tête du widget | -| `data-layout` | Non | `wide` pour le layout horizontal | - -*`data-hash` ou `data-magnet`, l'un des deux est obligatoire. - ---- - -## Valeurs retournées - -### Santé (`health`) - -| Valeur | Condition | -|---|---| -| `dead` | 0 seeder | -| `poor` | ratio seeders/(seeders+leechers) < 20 % | -| `good` | ratio ≥ 20 % | -| `excellent` | ratio ≥ 50 % | - -### Popularité (`popularity`) - -| Valeur | Total seeders + leechers | -|---|---| -| `low` | < 10 | -| `moderate` | 10 – 99 | -| `popular` | 100 – 999 | -| `viral` | ≥ 1 000 | - ---- - -## Cache et données périmées - -Le serveur met les résultats en cache 5 minutes. Si les trackers sont temporairement inaccessibles, le widget affiche les dernières données connues avec la mention *données en cache* dans le pied de page, plutôt qu'un message d'erreur. - ---- - -## API publique JavaScript - -```js -// Rafraîchir tous les widgets de la page -TorrentIndicator.refreshAll(); - -// Initialiser un élément spécifique -TorrentIndicator.init(document.querySelector('.torrent-indicator')); -```