Vai al contenuto
nectar Documentazione

Documentazione / Creare una pergamena

Creare una pergamena

Ecco come trasformare in pergamena qualcosa che ti interessa: scrivi le idee con un assistente IA o a mano, controllale e importa il file.

1. Scegli una fonte

Va bene qualsiasi contenuto che abbia idee interessanti: un articolo o un post di blog, un talk, un episodio di podcast, un video, un corso, i tuoi appunti o un libro. Usa una fonte che hai il diritto di usare, come un tuo lavoro, un testo la cui licenza lo consente o un testo di pubblico dominio.

L’assistente ha bisogno di testo. Per un podcast o un video ti serve prima la trascrizione: su molte piattaforme puoi copiare i sottotitoli, e gli strumenti di trascrizione trasformano l’audio in testo.

2. Scrivi il file con un assistente IA

Copia il prompt qui sotto in un assistente IA, compila le parti tra parentesi quadre e incolla alla fine il testo della fonte o la trascrizione.

Trasforma la fonte qui sotto in un file JSON per una pergamena di Nectar.

Titolo: [TITOLO]
Creatori: [AUTORI, CONDUTTORI O RELATORI]
Codice lingua della pergamena, come it o pt-BR: [LINGUA]
Traduci anche in: [CODICI LINGUA, oppure nessuna]

Usa solo la fonte. Non aggiungere fatti, affermazioni o esempi che non
sostiene. Scegli capitoli e idee in base alla fonte, senza un numero fisso.
Mantieni le sezioni della fonte se funzionano come capitoli; altrimenti
raggruppa le idee affini. Dai a ogni capitolo un titolo descrittivo senza
numero.

Scrivi ogni idea come un pensiero completo, comprensibile sulla propria
scheda, con parole tue, al massimo 400 caratteri. Esponi l’idea
direttamente: niente "l’autore dice", "in questo episodio" o avvertenze. Non
dividere un punto in più idee quasi uguali. Aggiungi un esempio solo se
chiarisce un’idea: breve, concreto e ipotetico, al massimo 400 caratteri.

Dai a ogni idea un tier: "important" per le idee che definiscono la fonte
(non più di circa un quarto), "good" per le idee di supporto solide,
"common" per il resto.

Scrivi una descrizione di due o tre frasi su ciò che si imparerà, al
massimo 600 caratteri, e da 3 a 5 tag tematici brevi in minuscolo.

Se sono richieste traduzioni, aggiungi un oggetto "translations" con una
versione completa per codice lingua: gli stessi capitoli, idee ed esempi
nello stesso ordine, ciascuna con i propri title, authors, description e
tags.

Rispondi solo con JSON valido, senza altro testo, in questa forma:
{"language": "...", "title": "...", "authors": ["..."], "description": "...",
 "tags": ["..."], "summaries": [{"title": "Titolo del capitolo", "ideas": [
 {"text": "Un’idea.", "tier": "good", "examples": ["Un esempio."]}]}]}
Ogni idea ha una lista "examples", vuota se non ne ha.

Fonte:
[TESTO DELLA FONTE O TRASCRIZIONE]

Salva la risposta in un file che termina con .json. Preferisci scriverlo a mano? Parti dal file di esempio e dal riferimento del file.

Fonti lunghe. Se la fonte è troppo lunga per il tuo assistente, lavora per parti: chiedi i capitoli di una parte alla volta, poi metti tutti i capitoli in un’unica lista summaries in un solo file.

3. Controlla il risultato

Gli assistenti IA sbagliano. Prima di importare, leggi qualche idea da sola e controlla che:

  • ogni idea si capisca senza quelle intorno e dica ciò che dice la fonte;
  • niente sia ripetuto, gonfiato o inventato;
  • important sia riservato alle idee che contano di più;
  • la descrizione parli di ciò che si impara, non del formato o dell’edizione della fonte;
  • ogni traduzione abbia gli stessi capitoli, idee ed esempi, nello stesso ordine.

4. Importala

Accedi e apri Importa una pergamena.

  1. Importa idee. Scegli il file .json, fino a 8 MB. Non viene ancora salvato nulla. Se il file ha un problema, il messaggio dice cosa correggere, per esempio il capitolo e l’idea troppo lunga.
  2. Rivedi i dettagli. Controlla ciò che il file ha compilato e aggiungi ciò che manca:
    • titolo, autori (uno per riga) e descrizione;
    • i tag, che aiutano a trovare la pergamena in Scopri;
    • URL originale, anno originale (un numero negativo per a.C.) o, se l’anno è sconosciuto, un periodo;
    • la copertina: l’immagine generata o una tua;
    • le lingue in questa pergamena, se il file ha traduzioni;
    • visibilità: Privato (solo tu), Solo amici o Pubblico.
  3. Salva pergamena. Condividendo con gli amici o con tutti, confermi di avere i diritti sul contenuto.

5. Dopo il salvataggio

Il salvataggio apre la pagina della pergamena e puoi iniziare a leggere subito. La trovi anche in Salvato, sotto Pergamene. Una pergamena privata è solo tua. Una pubblica può essere letta subito da chiunque abbia il link, ma compare in Scopri e nella ricerca solo dopo che un amministratore l’ha approvata; allora ricevi un’email. Puoi possedere fino a 200 pergamene.

Per cambiare i dettagli, la copertina o chi può vederla, o per sostituire le sue idee con un nuovo file, vedi Modificare, sostituire e condividere.