Spaces:
Running
Running
thibaud frere
commited on
Commit
·
8593dc4
1
Parent(s):
ca41799
try to liveshare with codespace
Browse files- .devcontainer/devcontainer.json +3 -0
- COLLABORATION.md +130 -0
- app/src/styles/components/_button.css +2 -2
- scripts/setup-collaboration.sh +44 -0
.devcontainer/devcontainer.json
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:79a20e69bb53755d95829b1a9a67f8b7ad9e6cad4859412d6e7d3bc7d5570c93
|
| 3 |
+
size 1282
|
COLLABORATION.md
ADDED
|
@@ -0,0 +1,130 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# 👥 Guide de Collaboration - Research Article Template
|
| 2 |
+
|
| 3 |
+
## 🚀 Démarrage rapide
|
| 4 |
+
|
| 5 |
+
### **Pour l'organisateur (host)**
|
| 6 |
+
|
| 7 |
+
1. **Créer un Codespace** :
|
| 8 |
+
```bash
|
| 9 |
+
# Via GitHub web : bouton "Code" → "Codespaces" → "Create codespace"
|
| 10 |
+
# Ou via CLI :
|
| 11 |
+
gh codespace create --repo YOUR_USERNAME/research-article-template
|
| 12 |
+
```
|
| 13 |
+
|
| 14 |
+
2. **Lancer l'environnement collaboratif** :
|
| 15 |
+
```bash
|
| 16 |
+
./scripts/setup-collaboration.sh
|
| 17 |
+
```
|
| 18 |
+
|
| 19 |
+
3. **Démarrer Live Share** :
|
| 20 |
+
- `Ctrl+Shift+P` → `Live Share: Start Collaborative Session`
|
| 21 |
+
- Copier le lien généré et l'envoyer aux collaborateurs
|
| 22 |
+
|
| 23 |
+
### **Pour les collaborateurs (guests)**
|
| 24 |
+
|
| 25 |
+
1. **Rejoindre via le lien Live Share** :
|
| 26 |
+
- Cliquer sur le lien reçu
|
| 27 |
+
- Se connecter avec GitHub/Microsoft
|
| 28 |
+
- VS Code s'ouvre automatiquement dans le navigateur
|
| 29 |
+
|
| 30 |
+
2. **Ou via VS Code local** :
|
| 31 |
+
- Installer l'extension "Live Share"
|
| 32 |
+
- `Ctrl+Shift+P` → `Live Share: Join Collaborative Session`
|
| 33 |
+
- Coller le lien
|
| 34 |
+
|
| 35 |
+
## 🎯 Workflow collaboratif
|
| 36 |
+
|
| 37 |
+
### **Organisation des tâches**
|
| 38 |
+
```
|
| 39 |
+
📝 Rédaction:
|
| 40 |
+
├── Alice → chapters/introduction.mdx
|
| 41 |
+
├── Bob → chapters/methodology.mdx
|
| 42 |
+
└── Carol → chapters/results.mdx
|
| 43 |
+
|
| 44 |
+
🎨 Visualisations:
|
| 45 |
+
├── David → embeds/d3-charts.html
|
| 46 |
+
└── Eve → src/content/assets/data/
|
| 47 |
+
|
| 48 |
+
📚 Références:
|
| 49 |
+
└── Frank → bibliography.bib
|
| 50 |
+
```
|
| 51 |
+
|
| 52 |
+
### **Bonnes pratiques**
|
| 53 |
+
|
| 54 |
+
✅ **Coordination** :
|
| 55 |
+
- Utiliser le chat intégré Live Share
|
| 56 |
+
- Annoncer sur quel fichier vous travaillez
|
| 57 |
+
- Faire des pauses pour synchroniser
|
| 58 |
+
|
| 59 |
+
✅ **Sauvegarde** :
|
| 60 |
+
- Auto-save activé par défaut
|
| 61 |
+
- Commits fréquents par l'host
|
| 62 |
+
- Branches pour les gros changements
|
| 63 |
+
|
| 64 |
+
✅ **Prévisualisation** :
|
| 65 |
+
- Serveur dev sur `localhost:3000`
|
| 66 |
+
- Rechargement automatique
|
| 67 |
+
- Build final avec `npm run build`
|
| 68 |
+
|
| 69 |
+
## 🔧 Commandes utiles
|
| 70 |
+
|
| 71 |
+
```bash
|
| 72 |
+
# Démarrer le serveur de dev
|
| 73 |
+
npm run dev
|
| 74 |
+
|
| 75 |
+
# Build pour production
|
| 76 |
+
npm run build
|
| 77 |
+
|
| 78 |
+
# Exporter en PDF
|
| 79 |
+
npm run export:pdf
|
| 80 |
+
|
| 81 |
+
# Exporter en LaTeX
|
| 82 |
+
npm run export:latex
|
| 83 |
+
|
| 84 |
+
# Voir la preview
|
| 85 |
+
npm run preview
|
| 86 |
+
```
|
| 87 |
+
|
| 88 |
+
## 🛠️ Résolution de problèmes
|
| 89 |
+
|
| 90 |
+
### **Live Share ne fonctionne pas ?**
|
| 91 |
+
```bash
|
| 92 |
+
# Redémarrer l'extension
|
| 93 |
+
Ctrl+Shift+P → "Developer: Reload Window"
|
| 94 |
+
|
| 95 |
+
# Vérifier la connexion
|
| 96 |
+
Ctrl+Shift+P → "Live Share: Show Session Details"
|
| 97 |
+
```
|
| 98 |
+
|
| 99 |
+
### **Serveur Astro planté ?**
|
| 100 |
+
```bash
|
| 101 |
+
# Redémarrer le serveur
|
| 102 |
+
Ctrl+C # Arrêter
|
| 103 |
+
npm run dev # Relancer
|
| 104 |
+
```
|
| 105 |
+
|
| 106 |
+
### **Conflits Git ?**
|
| 107 |
+
```bash
|
| 108 |
+
# L'host gère les commits
|
| 109 |
+
git status
|
| 110 |
+
git add .
|
| 111 |
+
git commit -m "Collaboration session: [description]"
|
| 112 |
+
git push
|
| 113 |
+
```
|
| 114 |
+
|
| 115 |
+
## 📱 URLs importantes
|
| 116 |
+
|
| 117 |
+
- **Développement** : `http://localhost:3000`
|
| 118 |
+
- **Preview** : `http://localhost:8080`
|
| 119 |
+
- **Repository** : `https://github.com/YOUR_USERNAME/research-article-template`
|
| 120 |
+
- **Live Space** : `https://huggingface.co/spaces/YOUR_USERNAME/research-template`
|
| 121 |
+
|
| 122 |
+
## 🎉 Après la session
|
| 123 |
+
|
| 124 |
+
1. **Host** : Commit et push les changements
|
| 125 |
+
2. **Tous** : Sync avec `git pull`
|
| 126 |
+
3. **Deploy** : Push vers HF Space pour mise à jour
|
| 127 |
+
|
| 128 |
+
---
|
| 129 |
+
|
| 130 |
+
**💡 Astuce** : Gardez le chat Live Share ouvert pour la coordination en temps réel !
|
app/src/styles/components/_button.css
CHANGED
|
@@ -32,12 +32,12 @@ button, .button {
|
|
| 32 |
}
|
| 33 |
|
| 34 |
/* Ghost/Muted button: subtle outline, primary color text/border */
|
| 35 |
-
.button
|
| 36 |
background: transparent !important;
|
| 37 |
color: var(--primary-color) !important;
|
| 38 |
border-color: var(--primary-color) !important;
|
| 39 |
}
|
| 40 |
-
.button
|
| 41 |
color: var(--primary-color-hover) !important;
|
| 42 |
border-color: var(--primary-color-hover) !important;
|
| 43 |
filter: none;
|
|
|
|
| 32 |
}
|
| 33 |
|
| 34 |
/* Ghost/Muted button: subtle outline, primary color text/border */
|
| 35 |
+
.button--ghost {
|
| 36 |
background: transparent !important;
|
| 37 |
color: var(--primary-color) !important;
|
| 38 |
border-color: var(--primary-color) !important;
|
| 39 |
}
|
| 40 |
+
.button--ghost:hover {
|
| 41 |
color: var(--primary-color-hover) !important;
|
| 42 |
border-color: var(--primary-color-hover) !important;
|
| 43 |
filter: none;
|
scripts/setup-collaboration.sh
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
#!/bin/bash
|
| 2 |
+
|
| 3 |
+
# 🚀 Script de setup pour collaboration GitHub Codespaces
|
| 4 |
+
# Usage: ./scripts/setup-collaboration.sh
|
| 5 |
+
|
| 6 |
+
echo "🔧 Configuration de l'environnement collaboratif..."
|
| 7 |
+
|
| 8 |
+
# Aller dans le dossier app
|
| 9 |
+
cd app
|
| 10 |
+
|
| 11 |
+
# Installer les dépendances si pas déjà fait
|
| 12 |
+
if [ ! -d "node_modules" ]; then
|
| 13 |
+
echo "📦 Installation des dépendances..."
|
| 14 |
+
npm install
|
| 15 |
+
fi
|
| 16 |
+
|
| 17 |
+
# Démarrer le serveur de développement en arrière-plan
|
| 18 |
+
echo "🌟 Démarrage du serveur Astro..."
|
| 19 |
+
npm run dev -- --host 0.0.0.0 --port 3000 &
|
| 20 |
+
DEV_PID=$!
|
| 21 |
+
|
| 22 |
+
# Attendre que le serveur démarre
|
| 23 |
+
sleep 5
|
| 24 |
+
|
| 25 |
+
echo "✅ Configuration terminée !"
|
| 26 |
+
echo ""
|
| 27 |
+
echo "🎯 URLs disponibles :"
|
| 28 |
+
echo " • Développement: http://localhost:3000"
|
| 29 |
+
echo " • Preview: http://localhost:8080"
|
| 30 |
+
echo ""
|
| 31 |
+
echo "👥 Pour collaborer :"
|
| 32 |
+
echo " 1. Ouvrez la palette de commandes (Ctrl+Shift+P)"
|
| 33 |
+
echo " 2. Tapez 'Live Share: Start Collaborative Session'"
|
| 34 |
+
echo " 3. Partagez le lien généré avec vos collaborateurs"
|
| 35 |
+
echo ""
|
| 36 |
+
echo "📝 Fichiers principaux à éditer :"
|
| 37 |
+
echo " • src/content/article.mdx"
|
| 38 |
+
echo " • src/content/chapters/*.mdx"
|
| 39 |
+
echo " • src/content/bibliography.bib"
|
| 40 |
+
echo ""
|
| 41 |
+
echo "🔄 Le serveur se recharge automatiquement à chaque modification !"
|
| 42 |
+
|
| 43 |
+
# Garder le script en vie pour maintenir le serveur
|
| 44 |
+
wait $DEV_PID
|