story-research-zapwall/docs/publishing-guide.md

Guide de publication d'articles

Ce guide vous explique comment publier un article sur Nostr Paywall avec un aperçu gratuit et un contenu payant.

Prérequis

Avant de publier un article, vous devez avoir :

1. ✅ Un portefeuille Nostr (pour vous connecter et signer les événements)
2. ✅ Alby installé (pour créer l'invoice Lightning)
3. ✅ Des fonds dans votre portefeuille Lightning (optionnel, mais recommandé pour tester)

Étapes de publication

1. Se connecter avec Nostr

1. Cliquez sur "Connect with Nostr" en haut à droite
2. Autorisez la connexion avec votre portefeuille Nostr
3. Vérifiez que votre profil s'affiche correctement

2. Accéder à la page de publication

1. Cliquez sur "Publish Article" dans le menu principal
2. Vous serez redirigé vers la page /publish

3. Remplir le formulaire

Le formulaire contient 4 champs :

Titre (obligatoire)

• Le titre de votre article
• Visible par tous dans la liste des articles
• Exemple : "Introduction à Nostr"

Preview / Aperçu (obligatoire)

• Le contenu gratuit visible par tous
• C'est ce que les lecteurs verront avant de payer
• Doit être suffisamment intéressant pour inciter à payer
• Exemple : "Découvrez les bases du protocole Nostr et comment il révolutionne les réseaux sociaux décentralisés..."

Content / Contenu complet (obligatoire)

• Le contenu complet qui sera débloqué après paiement
• Envoyé via message privé chiffré (NIP-04) après paiement
• Peut contenir du texte, des images (liens), etc.
• Exemple : "Nostr est un protocole de réseau social décentralisé basé sur des clés cryptographiques..."

Price / Prix (optionnel, défaut : 800 sats)

• Le prix en sats (satoshi)
• 1 BTC = 100 000 000 sats
• Par défaut : 800 sats (environ 0,000008 BTC)
• Vous pouvez définir n'importe quel prix

4. Publier l'article

1. Cliquez sur le bouton "Publish"
2. Si Alby n'est pas installé, vous serez invité à l'installer
3. Autorisez la création de l'invoice Lightning dans Alby
4. L'invoice sera créée automatiquement
5. Votre article sera publié sur le relay Nostr

5. Confirmation

Une fois publié, vous verrez :

• ✅ Un message de confirmation "Article Published!"
• Vous serez automatiquement redirigé vers la page d'accueil après 2 secondes
• Votre article apparaîtra dans la liste des articles

Comment ça fonctionne techniquement

1. Publication de l'aperçu

L'aperçu est publié comme un événement Nostr de type 1 (note textuelle) avec les tags suivants :

• title : Le titre de l'article
• preview : L'aperçu gratuit
• zap : Le prix en sats
• content-type : "article"
• invoice : L'invoice Lightning (BOLT11)
• payment_hash : Le hash de l'invoice

2. Création de l'invoice

L'invoice Lightning est créée via Alby/WebLN lors de la publication :

• Montant : Le prix défini par l'auteur
• Description : "Payment for article: {titre}"
• Expiration : 24 heures

3. Stockage du contenu complet

Le contenu complet est stocké localement dans votre navigateur (IndexedDB) :

• Associé à l'ID de l'article
• Expire après 30 jours
• Utilisé pour envoyer le contenu après paiement

4. Envoi du contenu après paiement

Quand un lecteur paie :

1. Le paiement est vérifié via les reçus de zap Nostr (NIP-57)
2. Le contenu complet est envoyé via message privé chiffré (NIP-04)
3. Le message privé contient :
   • Le contenu chiffré
   • Un tag e liant à l'article
   • Un tag p avec la clé publique du destinataire

Conseils pour bien publier

Écrire un bon aperçu

L'aperçu est crucial pour inciter les lecteurs à payer :

• ✅ Donnez un avant-goût du contenu complet
• ✅ Posez une question ou créez de la curiosité
• ✅ Mentionnez les points clés qui seront développés
• ❌ Ne révélez pas tout le contenu
• ❌ Ne soyez pas trop vague

Exemple d'aperçu efficace :

"Découvrez comment Nostr révolutionne les réseaux sociaux en éliminant les serveurs centralisés. Dans cet article, nous explorerons l'architecture du protocole, les avantages de la décentralisation, et comment créer votre première application Nostr. Vous apprendrez également à implémenter des paiements Lightning directement dans vos applications."

Définir le bon prix

• 800 sats (par défaut) : Bon pour la plupart des articles
• 400-600 sats : Pour des articles courts ou des tutoriels
• 1000-2000 sats : Pour des articles longs ou très techniques
• 5000+ sats : Pour du contenu premium ou des guides complets

Contenu de qualité

Le contenu complet doit :

• ✅ Être substantiel et apporter de la valeur
• ✅ Respecter le prix demandé
• ✅ Être bien formaté et lisible
• ✅ Inclure des exemples ou des illustrations si pertinent

Gestion des articles publiés

Voir vos articles

1. Cliquez sur votre profil (nom/avatar en haut à droite)
2. La section "My Articles" affiche tous vos articles
3. Vous pouvez rechercher et filtrer vos articles

Statistiques

Actuellement, vous pouvez voir :

• Le nombre d'articles publiés
• Les notifications de paiements reçus

Note

: Des statistiques plus détaillées (vues, revenus, etc.) seront ajoutées dans une future version.

Édition et suppression

Note

: L'édition et la suppression d'articles ne sont pas encore disponibles. Les événements Nostr sont immutables, donc une fois publié, un article ne peut pas être modifié. Cette fonctionnalité sera ajoutée dans une future version.

Dépannage

Je ne peux pas publier

Vérifiez :

• ✅ Que vous êtes connecté avec Nostr
• ✅ Que votre portefeuille Nostr peut signer des événements
• ✅ Que Alby est installé et activé
• ✅ Que tous les champs sont remplis

L'invoice ne se crée pas

Vérifiez :

• ✅ Que Alby est installé
• ✅ Que vous avez autorisé l'application dans Alby
• ✅ Que votre portefeuille Lightning a des fonds (optionnel)
• ✅ Votre connexion internet

L'article ne s'affiche pas après publication

Vérifiez :

• ✅ Que le relay Nostr est accessible
• ✅ Rafraîchissez la page
• ✅ Vérifiez la console du navigateur pour les erreurs

Je ne reçois pas les paiements

Vérifiez :

• ✅ Que les lecteurs paient effectivement
• ✅ Vos notifications (badge en haut à droite)
• ✅ Votre portefeuille Lightning
• ✅ Que l'invoice n'a pas expiré

Bonnes pratiques

Fréquence de publication

• Publiez régulièrement pour maintenir l'engagement
• Ne publiez pas trop souvent (risque de spam)
• Qualité > Quantité

Promotion

• Partagez vos articles sur d'autres plateformes Nostr
• Mentionnez vos articles dans vos notes Nostr
• Créez une communauté autour de votre contenu

Engagement avec les lecteurs

• Répondez aux commentaires (si cette fonctionnalité est ajoutée)
• Créez du contenu de qualité qui mérite d'être payé
• Écoutez les retours de vos lecteurs

---

Dernière mise à jour : Décembre 2024