Nota a piè di pagina in Discourse

:discourse2: Riepilogo Discourse Footnote consente agli utenti di creare note a piè di pagina in formato Markdown nei post.
:open_book: Guida all’installazione Questo plugin è incluso nel nucleo di Discourse. Non è necessario installarlo separatamente.

Abilitazione delle note a piè di pagina

Il plugin Footnote è abilitato per impostazione predefinita, ma può essere disabilitato/abilitato dalla pagina admin/plugins:

abilita nota a piè di pagina

Funzionalità

Una volta abilitato, puoi aggiungere note a piè di pagina ai tuoi post digitandole in questo modo:

Una frase che richiede una nota a piè di pagina. ^[La nota a piè di pagina] 
Un'altra frase che richiede una nota a piè di pagina. ^[La seconda nota a piè di pagina]

O in questo modo:

Una frase che richiede una nota a piè di pagina. [^1] 
Un'altra frase che richiede una nota a piè di pagina. [^2]

[^1]: La nota a piè di pagina
[^2]: La seconda nota a piè di pagina

Puoi combinare entrambi gli stili all’interno di un post, oltre a utilizzare ancoraggi non numerati.

Esistono due modi per visualizzare le note a piè di pagina, controllati dall’impostazione amministrativa display footnotes inline:

\u003e Non inline:
\u003e
\u003e

\u003e Inline:
\u003e
\u003e Una frase che richiede una nota a piè di pagina[1]
\u003e Un’altra frase che richiede una nota a piè di pagina[2]

Le versioni inline sono entrambe compatibili con le citazioni e con i dispositivi mobili.

Impostazioni

Nome Descrizione
abilita note a piè di pagina markdown abilita le note a piè di pagina in Markdown su questo sito
visualizza note a piè di pagina inline abilita l’espansione inline delle note a piè di pagina

\u003e :discourse2: Ospitato da noi? Questo plugin è disponibile su tutti i nostri livelli di hosting Footnote | Discourse - Civilized Discussion

Cronologia dello sviluppo

Discourse Footnote ricomprime l’estensione footnote markdown.it di @Vitaly come plugin per Discourse.


  1. La nota a piè di pagina ↩︎

  2. La seconda nota a piè di pagina ↩︎

73 Mi Piace

Solo un avviso che l’estensione non sembra consentire il normale markdown per le note a piè di pagina usando [^1]. Non ottengo note a piè di pagina formattate a meno che non usi la formattazione “inline”, così:

Abilitare le note a piè di pagina usando la formattazione inline delle note a piè di pagina si traduce in note a piè di pagina numerate automaticamente che appaiono in fondo al post insieme, mentre abilitare anche l’espansione inline abilita l’esperienza simile a un tooltip con ellissi senza note a piè di pagina che appaiono in fondo al post. Se hai l’opzione di espansione inline abilitata, la finestra di anteprima del tuo post apparirà come note a piè di pagina numerate tradizionali, ma vedrai l’effetto di espansione inline dopo la pubblicazione.

Apprezzo le note a piè di pagina numerate automaticamente usando la formattazione inline, mi ci sono voluti solo alcuni tentativi per capire come formattare correttamente il markdown e quali opzioni avrebbero fatto sì che si comportassero come desiderato. Spero che questo commento aiuti qualcun altro a evitare la stessa confusione.

Modifica per aggiungere: L’opzione di espansione inline è come appariranno le tue note a piè di pagina sui dispositivi mobili, indipendentemente dal fatto che tale opzione sia abilitata (anche per desktop).

5 Mi Piace

Ricetta per consentire ai tuoi utenti di creare contenuti popup inline utilizzando questo plugin per note a piè di pagina di Discourse:

Combina questo plugin con il Componente tema del pulsante per note a piè di pagina del compositore [1] (fornisce un pulsante nel compositore/editor per creare note a piè di pagina)

Puoi inserire qualsiasi cosa all’interno dei popup, incluso l’HTML.

Esempi:

Testo [2]


Caricamento di testo e immagini [3]


Contenuto HTML [4]


  1. (installali entrambi) ↩︎

  2. Testo normale qui. ↩︎

  3. Caricamento di testo e immagini

    ↩︎

  4. Quando incontri un gruppo open source per la prima volta, può essere un’esperienza sconcertante. Sia che tu stia pubblicando per la prima volta su una mailing list, scrivendo un post sul blog sul progetto che stai intraprendendo o frequentando un canale IRC, il modo in cui le persone interagiscono e ciò che si aspettano l’una dall’altra è piuttosto diverso rispetto all’aula o con amici e familiari.


    Apertura e Condivisione

    La comunicazione open source può variare molto. Un valore fondamentale condiviso è che la condivisione del codice è buona. Indipendentemente dalla licenza, dalla lingua o dallo stile di indentazione, gli sviluppatori open source creano, condividono e modificano il codice sorgente insieme.

    ↩︎

14 Mi Piace

Il plugin per le note a piè di pagina funziona anche sulle pagine pubbliche? Nel mio caso specifico, vorrei che NON funzionasse sulle pagine pubbliche e fosse visibile solo nella vista normale dell’argomento (per usarlo per appunti interni, ecc.)

@jrgong – no…

Tuttavia, esiste questo approccio alternativo per il quale sto sviluppando un componente del tema… su Github.

2 Mi Piace

Sembra che questo sia stato spostato nel core 17 ore fa.

Lascerò che qualcun altro aggiorni questo in modo appropriato.

Translation missing: en.The discourse-footnote plugin has been integrated into discourse core. Please remove the plugin from your app.yml and rebuild your container.
3 Mi Piace

Dopo lo spostamento nel core,

ho eliminato il plugin da app.yml ed eseguito ./launcher rebuild app,

ma le impostazioni rimangono nella pagina dei plugin. Va bene lasciarlo così?

Questa è la nuova. :+1: Ecco uno scatto di entrambi a confronto:

vecchio

nuovo

4 Mi Piace

È un suono davvero bello! :+1: Grazie per averlo condiviso. :smiling_face_with_three_hearts:

Grazie per averlo menzionato, ho appena rilasciato una correzione.

3 Mi Piace

L’altro problema è che non è più necessario installare il plugin e, se lo si è installato, non è necessario includere quel git clone nel file yml.

2 Mi Piace

Sono stato troppo lento nell’aggiornare l’argomento con le nuove informazioni e mi hai anticipato. :slight_smile:

Aggiungerò comunque il mio contributo…


:information_source: Discourse Footnote è ora incluso nel core di Discourse, quindi questo plugin non dovrà più essere installato separatamente. :partying_face:

Se hai un’installazione self-hosted, dovresti vedere alcune informazioni nella tua dashboard su come rimuoverlo dal tuo app.yml.

:discourse2: Ospitato da noi? Questa modifica non ti influenzerà in alcun modo. :+1: Puoi continuare a goderti questo plugin senza preoccuparti di nulla.

4 Mi Piace

Sì. Mi dispiace per questo.

È fantastico! Sapevo che avevi un piano. Avrei dovuto solo aspettare, dato che l’altra cosa che ho segnalato era, di fatto, un problema che è stato, di fatto, gestito da qualcun altro, e avrei dovuto solo essere paziente dato che sapevo che te ne saresti occupato. (Ed è anche così bello!).

Sono ancora passate meno di 24 ore, quindi, sai, anche questo è abbastanza buono.

Grazie.

4 Mi Piace

3 post sono stati divisi in un nuovo argomento: Opzione Aggiungi Nota a piè di pagina al menu a ingranaggio della composizione

C’è un modo per far sì che la nota a piè di pagina venga formattata normalmente? In modo che non sia allineata con i tre puntini, così?[1]

E invece che assomigli a questo?


  1. Questo sembra strano, a me ↩︎

È questa l’impostazione?

1 Mi Piace

Sì, ma intendevo come utente normale, non come amministratore che modifica un’impostazione.

No, non esiste una impostazione utente per questo. Solo una globale.

1 Mi Piace

Noto che la nota a piè di pagina non consente l’uso di molta sintassi markdown comune tra le parentesi della nota a piè di pagina[1]

Non è un grosso problema, ma limita certamente la funzionalità di ciò che puoi inserire nella nota a piè di pagina!


  1. Es: Questo è all’interno di una parentesi di nota a piè di pagina, ma il layout si interrompe ogni volta che introduco paragrafi, intestazioni, elenchi, ecc.\n\nEcco una interruzione di paragrafo. ↩︎

Puoi, assicurati di indentare con almeno 4 spazi.

Per esempio:


Ecco un riferimento a una nota a piè di pagina[^1], e un altro[^longnote].

[^1]: Ecco la nota a piè di pagina.

[^longnote]: Eccone una con più blocchi.

    I paragrafi successivi sono indentati per mostrare che appartengono alla nota a piè di pagina precedente.

    * elemento1
    * elemento 2

    **Altro** testo

    *corsivo*

Ecco un riferimento a una nota a piè di pagina[1], e un altro[2].

Viene renderizzato come:


  1. Ecco la nota a piè di pagina. ↩︎

  2. Eccone una con più blocchi.

    I paragrafi successivi sono indentati per mostrare che appartengono alla nota a piè di pagina precedente.

    • elemento1
    • elemento 2

    Altro testo

    corsivo ↩︎