Estendi la nota a piè di pagina per includere 'annotazioni'

Testing… L’editor mostra sempre qualcosa di diverso da ciò che viene visualizzato nel thread dell’argomento [1] markdown: [^nota] + [^note]: Questa dovrebbe essere una nota a piè di pagina..

In un post di prova su discourse.python.org, posizionare il cursore all’interno O all’esterno delle parentesi quadre produce entrambe una nota inline [2] markdown: ^[questa è codificata come nota inline].

…e la stessa cosa accade qui. Ha un bell’aspetto nel riquadro di anteprima dell’editor, ma non viene visualizzato come previsto nel thread. (Anche se i collegamenti ipertestuali sono molto scuri e piccoli nel tema scuro attualmente attivo su discourse.python.org.)

Penso che userò i menu a discesa a scomparsa <1>.

<1>

Perché posso metterli immediatamente dopo il paragrafo che si collega alle informazioni aggiuntive e potrebbero, quando compressi, occupare anche meno righe di quanto farebbe una lunga nota a piè di pagina. (Ho provato a usare le parentesi quadre attorno all’ ‘1’ ma non sono riuscito a capire come sfuggire alle parentesi quadre per evitare che confondessero l’interprete markdown.)


  1. Questa dovrebbe essere una nota a piè di pagina. ↩︎

  2. Questa è codificata come nota inline ↩︎

1 Mi Piace

Stiamo riscontrando difficoltà con questo su discuss.python.org.

Queste opzioni per la notazione supplementare possono migliorare la profonda ricchezza di Discourse. Ci sono però alcuni aspetti chiave per un’implementazione di successo.

La principale deviazione dall’ideale è l’uso del termine “nota a piè di pagina” per qualcosa che palesemente è qualcos’altro. Una nota inline è inline mentre una nota a piè di pagina si trova in fondo/in basso alla pagina (nel nostro caso, in fondo al messaggio).

E questo evidenzia la seconda deviazione: le note a piè di pagina e le note inline sono due tipi distinti di note con casi d’uso apparentemente diversi e diverse best practice per il loro uso efficace. Pertanto, dovrebbero essere funzionalità separate e probabilmente controllate da set separati di variabili di configurazione.

Attraverso l’opzione di cambiare la posizione del caret, l’utente può decidere se utilizzare un’espansione in situ (nota inline) o un riferimento remoto (nota a piè di pagina). Al momento, entrambe le costruzioni producono una nota inline. L’abbiamo trovato un po’ sconcertante, anche se è utile posizionare testi di note voluminosi in fondo a un messaggio piuttosto che farli interferire con il testo del corpo nell’editor di composizione.

In ogni caso, noi di discuss.python.org ci piacerebbe molto poter utilizzare sia note inline che note a piè di pagina. Estenderebbe la natura coinvolgente di un post di argomento ben composto.

Un’opzione è avere la posizione del caret come due interruttori diversi:
^[testo] per creare una nota inline.
[^etichetta] per creare una nota a piè di pagina.
^[^etichetta] per creare una nota inline con il testo della nota posizionato remotamente dalla sua posizione di visualizzazione.

Un nome comune per questi due elementi di testo supplementari è “Annotazioni”.

2 Mi Piace

Penso che questo sarebbe probabilmente meglio risolto prima come parte delle specifiche CommonMark. Vedi How should footnotes behave? - Extensions - CommonMark Discussion come collegato sopra.

3 Mi Piace

D’accordo, Matthew. E grazie per aver evidenziato i riferimenti. Sfortunatamente, quei riferimenti sono un po’ leggeri e non ho trovato argomenti migliori qui. Forse CommonMark.org ha discussioni più recenti.

Risolto, sì. Devo prima capire cosa e come presentare la situazione a CommonMark. Ho postato qui poiché altri input degli utenti informeranno la discussione quando l’argomento verrà inoltrato a CommonMark. Discourse è anche il nostro “genitore” immediato come utenti e Sam et al probabilmente vorranno sapere quanto bene l’implementazione dell’estensione delle note a piè di pagina sta funzionando per i suoi utenti.

Quindi per favore condividi i tuoi pensieri, e fallo in fretta perché c’è uno “smaltimento della spazzatura” su questo argomento che mangia i post dopo 30 giorni!

1 Mi Piace

@mlgtechuser, se ho capito bene, questo potrebbe essere un esempio di:

Se provi invece discussion.fedoraproject.org/new-topic e inserisci:

[^1]

[^1]: Content

…potresti vedere un risultato più atteso, poiché la nota a piè di pagina viene visualizzata come una citazione bibliografica (invece di una casella inline, visibile solo selezionando il suo riferimento numerico inline).

Altrimenti, se stai chiedendo che entrambe le modalità coesistano, visualizzando alcune “annotazioni” come note a piè di pagina bibliografiche aggiunte alla fine del documento, mentre altre rimangono inline, concordo pienamente sul fatto che sarebbe fenomenale.