personotes/QUICK_START_PUBLIC.md

🚀 Quick Start - Notes Publiques

Comment ça marche ?

Les notes publiques sont générées en fichiers HTML statiques. Vous pouvez les copier et les héberger n'importe où !

📝 Publier une note

1. Ouvrez une note dans l'éditeur
2. Cliquez sur le bouton 🔒 Privé
3. Le bouton devient 🌐 Public ✅

Que se passe-t-il ?

• Un fichier HTML est généré dans public/notes/
• Le fichier public/index.html est mis à jour
• Les CSS sont copiés dans public/static/

🌐 Accéder aux notes publiques

Lister les notes publiques (CLI)

./server list-public

Cette commande affiche toutes les notes exportées avec leurs chemins source et public.

Sur le serveur Personotes

http://localhost:8080/public/

Structure générée

public/
├── index.html              # Liste de toutes vos notes publiques
├── ma-note.html           # Vos notes en HTML (structure plate)
├── autre.html
└── static/
    ├── theme.css          # Styles
    └── themes.css

📤 Exporter vers un autre serveur

Méthode 1 : Copie simple

# Copier tout le dossier public/
cp -r public/ /var/www/html/notes/

Méthode 2 : SCP (serveur distant)

scp -r public/ user@server.com:/var/www/html/notes/

Méthode 3 : GitHub Pages (gratuit)

cd public/
git init
git add .
git commit -m "Public notes"
git remote add origin https://github.com/username/notes.git
git push -u origin main

Activez GitHub Pages dans les settings du repo → vos notes sont en ligne !

Méthode 4 : Netlify Drop

1. Allez sur https://app.netlify.com/drop
2. Glissez-déposez le dossier public/
3. C'est en ligne !

🔧 Configuration serveur web

Apache

<VirtualHost *:80>
    ServerName notes.example.com
    DocumentRoot /var/www/html/notes
</VirtualHost>

Nginx

server {
    listen 80;
    server_name notes.example.com;
    root /var/www/html/notes;
    index index.html;
}

✨ Avantages

• ✅ Portable : Fonctionne sur n'importe quel serveur web
• ✅ Rapide : HTML pré-généré = chargement instantané
• ✅ Gratuit : Hébergez sur GitHub Pages, Netlify, etc.
• ✅ SEO : Google peut indexer vos notes
• ✅ Sécurisé : Pas de code serveur, juste du HTML

🔄 Workflow typique

1. Écrire dans Personotes (Markdown)
2. Publier (bouton Public)
3. Copier le dossier public/ vers votre serveur
4. Profit ! Vos notes sont en ligne

📖 Plus d'infos

Voir EXPORT_GUIDE.md pour le guide complet.