Nota al pie en Discourse

:discourse2: Resumen Discourse Footnote permite a los usuarios crear notas al pie en formato Markdown en las publicaciones.
:open_book: Guía de instalación Este plugin viene incluido en el núcleo de Discourse. No es necesario instalarlo por separado.

Activar las notas al pie

El plugin de notas al pie está activado de forma predeterminada, pero puede desactivarse/activarse desde la página admin/plugins:

activar nota al pie

Características

Una vez activado, puedes agregar notas al pie a tus publicaciones escribiéndolas así:

Una oración que necesita una nota al pie. ^[La nota al pie]
Otra oración que necesita una nota al pie. ^[La segunda nota al pie]

O así:

Una oración que necesita una nota al pie. [^1]
Otra oración que necesita una nota al pie. [^2]

[^1]: La nota al pie
[^2]: La segunda nota al pie

Puedes combinar ambos estilos dentro de una publicación, así como usar anclas sin numerar.

Hay dos formas de mostrar las notas al pie, controladas por la configuración de administrador display footnotes inline:

No en línea:

En línea:

Una oración que necesita una nota al pie[1]
Otra oración que necesita una nota al pie[2]

Las versiones en línea son compatibles con citas y dispositivos móviles.

Configuración

Nombre Descripción
enable markdown footnotes habilitar notas al pie en formato Markdown en este sitio
display footnotes inline habilitar la expansión en línea de las notas al pie

:discourse2: ¿Alojado por nosotros? Este plugin está disponible en todos nuestros niveles de alojamiento: Footnote | Discourse - Civilized Discussion

Historial de desarrollo

Discourse Footnote reempaqueta la extensión footnote de markdown-it de @Vitaly como un plugin de Discourse.


  1. La nota al pie ↩︎

  2. La segunda nota al pie ↩︎

73 Me gusta

[quote=“Sam Saffron, post:1, topic:84533, username:sam”]El consenso general es que la extensión debería permitir sintaxis como:\n\n\nalgún pensamiento profundo que necesita una referencia[^1]\n\n[^1]: Aquí está la referencia.\n\n[/quote]\n\nSolo una advertencia de que la extensión no parece permitir el markdown regular para notas al pie usando [^1]. No obtengo notas al pie formateadas a menos que use el formato “inline”, así:\n\n[quote=“Sam Saffron, post:1, topic:84533, username:sam”]También puedes usar notas al pie “inline” — no la expansión inline, sino la nota en sí. Así:\n\n\nMás dichos sabios ^[Lincoln, o Einstein, o algo así]\n\n[/quote]\n\nHabilitar las notas al pie usando el formato de nota al pie inline da como resultado notas al pie auto-numeradas que luego aparecen juntas debajo de la publicación, mientras que habilitar también la expansión inline permite la experiencia similar a un tooltip de elipsis sin que aparezcan notas al pie debajo de la publicación. Si tienes habilitada la opción de expansión inline, tu ventana de vista previa de la publicación se verá como notas al pie numeradas tradicionales, pero verás el efecto de expansión inline después de publicar.\n\nAprecio las notas al pie numeradas automáticamente usando el formato inline, solo me tomó algunos intentos averiguar cómo debería formatear el markdown y qué opciones harían que se comportaran como se desea. Espero que este comentario ayude a alguien más a evitar la misma confusión.\n\nEditar para agregar: La opción de expansión inline es cómo aparecerán tus notas al pie en el móvil, independientemente de si esa opción está habilitada (también para escritorio).

5 Me gusta

Receta para permitir a tus usuarios crear contenido emergente en línea usando este Plugin de Notas al Pie de Discourse:

Combina este Plugin con el Componente Temático del Botón de Notas al Pie del Compositor [1] (proporciona un botón en el Compositor/Editor para crear notas al pie)

Puedes poner cualquier cosa dentro de los emergentes, incluyendo HTML.

Ejemplos:

Texto [2]


Texto y Carga de Imagen [3]


Contenido HTML [4]


  1. (instálalos ambos) ↩︎

  2. Texto plano aquí. ↩︎

  3. Texto y Carga de Imagen

    ↩︎

  4. Cuando te encuentras con un grupo de código abierto por primera vez, puede ser una experiencia desconcertante. Ya sea publicando en una lista de correo por primera vez, escribiendo sobre el proyecto que estás emprendiendo o pasando el rato en un canal de IRC, la forma en que las personas interactúan y lo que esperan unas de otras es bastante diferente a lo que se experimenta en el aula o con amigos y familiares.


    Apertura y Compartir

    La comunicación de código abierto puede variar mucho. Un valor central compartido es que compartir código es bueno. Independientemente de la licencia, el idioma o el estilo de sangría, los desarrolladores de código abierto crean, comparten y modifican código fuente juntos.

    ↩︎

14 Me gusta

¿El plugin de notas al pie también funciona en páginas públicas? En mi caso específico, quiero que NO funcione en páginas públicas y solo sea visible en la vista normal del tema (para usarlo para notas internas, etc.)

@jrgong – no…

Sin embargo, existe este enfoque alternativo para el cual estoy desarrollando un Componente de Tema… en Github.

2 Me gusta

Parece que esto se movió al núcleo hace 17 horas.

Dejaré que alguien más actualice esto apropiadamente.

Falta la traducción: en.El plugin discourse-footnote se ha integrado en el núcleo de Discourse. Elimina el plugin de tu app.yml y reconstruye tu contenedor.
3 Me gusta

Después de moverlo al núcleo,

Eliminé el plugin de app.yml y ejecuté ./launcher rebuild app,

pero la configuración permanece en la página del plugin. ¿Está bien dejarlo así?

Esa es la nueva. :+1: Aquí hay una foto de ambas para comparar:

old one

new one

4 Me gusta

¡Ese es un sonido realmente agradable! :+1: Gracias por compartir. :smiling_face_with_three_hearts:

Gracias por mencionarlo, acabo de implementar una solución.

3 Me gusta

El otro problema es que ya no necesitas instalar el plugin, y si lo has instalado, no necesitas incluir ese git clone en tu archivo yml.

2 Me gusta

Llegué tarde a actualizar el tema con la nueva información y me ganaste. :slight_smile:

Aún así añadiré mi parte…


:information_source: Discourse Footnote ahora se ha incluido en el núcleo de Discourse, por lo que este plugin ya no necesitará instalarse por separado. :partying_face:

Si alojas tu propio servidor, deberías ver información en tu panel sobre cómo eliminarlo de tu app.yml.

:discourse2: ¿Alojado por nosotros? Este cambio no te afectará en absoluto. :+1: Puedes seguir disfrutando de este plugin y no preocuparte por nada.

4 Me gusta

Sí. Lamento eso.

¡Eso es genial! Sabía que tenías un plan. Debería haber esperado, ya que la otra cosa que señalé era, de hecho, un problema que fue, de hecho, resuelto por otra persona, y debería haber sido paciente ya que sabía que lo ibas a manejar. (¡Y también es muy bonito!).

Todavía no han pasado 24 horas, así que, ya sabes, eso también está bastante bien.

Gracias.

4 Me gusta

Se dividieron 3 publicaciones en un nuevo tema: Opción de agregar nota al pie al menú de engranaje del compositor

¿Hay alguna forma de que la nota al pie tenga un formato normal? Para que no esté en línea con los tres puntos, ¿así?[1]

¿Y que en su lugar se vea así?


  1. Esto se ve raro, para mí ↩︎

¿Es esta la configuración?

1 me gusta

Sí, pero me refería como un usuario normal, no como un administrador que cambia una configuración.

No, no hay configuración de usuario para eso. Solo la global.

1 me gusta

Noto que a anotação de rodapé não permite o uso de muita sintaxe markdown comum dentro dos colchetes do rodapé[1]

Não é um grande problema, mas certamente limita a funcionalidade do que você pode colocar na nota de rodapé!


  1. Ex: Isto está dentro de um colchete de rodapé, mas o layout quebra sempre que introduzo parágrafos, cabeçalhos, listas, etc.\n\nAqui está uma quebra de parágrafo. ↩︎

Puedes hacerlo, asegúrate de usar una sangría de al menos 4 espacios.

Por ejemplo:


Aquí hay una referencia de nota al pie[^1], y otra[^longnote].

[^1]: Aquí está la nota al pie.

[^longnote]: Aquí hay una con varios bloques.

    Los párrafos subsiguientes están indentados para mostrar que pertenecen a la nota al pie anterior.

    * elemento1
    * elemento 2

    **Más** texto

    *en cursiva*

Aquí hay una referencia de nota al pie[1], y otra[2].

Se renderiza como:


  1. Aquí está la nota al pie. ↩︎

  2. Aquí hay una con varios bloques.

    Los párrafos subsiguientes están indentados para mostrar que pertenecen a la nota al pie anterior.

    • elemento1
    • elemento 2

    Más texto

    en cursiva ↩︎