Nota de rodapé do Discourse

:discourse2: Resumo Discourse Footnote permite que os usuários criem notas de rodapé em markdown nos posts.
:open_book: Guia de Instalação Este plugin vem bundled com o núcleo do Discourse. Não há necessidade de instalar o plugin separadamente.

Habilitando a Nota de Rodapé

O plugin Footnote está habilitado por padrão, mas pode ser desabilitado/habilitado na página admin/plugins:

habilitar nota de rodapé

Recursos

Uma vez habilitado, você pode adicionar notas de rodapé aos seus posts digitando-as assim:

Uma frase que precisa de uma nota de rodapé. ^[A nota de rodapé]
Outra frase que precisa de uma nota de rodapé. ^[A segunda nota de rodapé]

Ou assim:

Uma frase que precisa de uma nota de rodapé. [^1]
Outra frase que precisa de uma nota de rodapé. [^2]

[^1]: A nota de rodapé
[^2]: A segunda nota de rodapé

Você pode combinar ambos os estilos dentro de um post, bem como usar âncoras não numeradas.

Existem duas maneiras de exibir as notas de rodapé, controladas pela configuração de administrador display footnotes inline:

Não em linha:

Em linha:

Uma frase que precisa de uma nota de rodapé[1]
Outra frase que precisa de uma nota de rodapé[2]

As versões em linha são amigáveis tanto para citações quanto para dispositivos móveis.

Configurações

Nome Descrição
enable markdown footnotes habilitar markdown de nota de rodapé neste site
display footnotes inline habilitar expansão em linha das notas de rodapé

:discourse2: Hospedado por nós? Este plugin está disponível em todos os nossos níveis de hospedagem Footnote | Discourse - Civilized Discussion

Histórico de Desenvolvimento

O Discourse footnote reempacota a extensão footnote markdown.it de @Vitaly como um plugin do Discourse.


  1. A nota de rodapé ↩︎

  2. A segunda nota de rodapé ↩︎

73 curtidas

[quote=“Sam Saffron, post:1, topic:84533, username:sam”]O consenso geral é que a extensão deve permitir sintaxe como:\n\n\nsome deep thought who needs a reference[^1]\n\n[^1]: Here's the reference. \n\n[/quote]\n\nApenas um aviso de que a extensão não parece permitir a marcação regular para notas de rodapé usando [^1]. Não obtenho notas de rodapé formatadas, a menos que eu use a formatação “inline”, assim:\n\n[quote=“Sam Saffron, post:1, topic:84533, username:sam”]Você também pode usar notas de rodapé “inline” — não a expansão inline, mas a própria nota. Assim:\n\n\nMore wise sayings ^[Lincoln, or Einstein, or something]\n\n[/quote]\n\nHabilitar notas de rodapé usando a formatação de nota de rodapé inline resulta em notas de rodapé numeradas automaticamente que aparecem abaixo da postagem juntas, enquanto habilitar a expansão inline também permite a experiência semelhante a uma dica de expansão com reticências, sem notas de rodapé aparecendo abaixo da postagem. Se você tiver a opção de expansão inline habilitada, sua janela de visualização de postagem parecerá notas de rodapé numeradas tradicionais, mas você verá o efeito de expansão inline após a publicação.\n\nAgradeço as notas de rodapé numeradas automaticamente usando a formatação inline, apenas levei algumas tentativas para descobrir como eu deveria realmente formatar a marcação e quais opções as fariam se comportar como desejado. Espero que este comentário ajude outra pessoa a evitar a mesma confusão.\n\nEditar para adicionar: A opção de expansão inline é como suas notas de rodapé aparecerão no celular, independentemente de essa opção estar habilitada (também para desktop).

5 curtidas

Receita para permitir que seus usuários criem conteúdo de popup inline usando este Plugin de Nota de Rodapé do Discourse:

Combine este Plugin com o Componente de Tema de Botão de Nota de Rodapé do Composer [1] (ele fornece um botão no Composer/Editor para criar notas de rodapé)

Você pode colocar qualquer coisa dentro dos popups, incluindo HTML.

Exemplos:

Texto [2]


Texto e Upload de Imagem [3]


Conteúdo HTML [4]


  1. (instale ambos) ↩︎

  2. Texto simples aqui. ↩︎

  3. Texto e Upload de Imagem

    ↩︎

  4. Quando você encontra um grupo de código aberto pela primeira vez, pode ser uma experiência desconcertante. Seja postando em uma lista de e-mails pela primeira vez, escrevendo sobre o projeto que você está assumindo ou passando tempo em um canal IRC - a maneira como as pessoas interagem e o que elas esperam umas das outras é bem diferente da sala de aula ou com amigos e familiares.


    Abertura e Compartilhamento

    A comunicação de código aberto pode variar muito. Um valor central em comum é que compartilhar código é bom. Independentemente da licença, linguagem ou estilo de indentação, os desenvolvedores de código aberto criam, compartilham e modificam código-fonte juntos.

    ↩︎

14 curtidas

O plugin de nota de rodapé também funciona em páginas públicas? No meu caso específico, quero que ele NÃO funcione em páginas públicas e que seja visível apenas na visualização normal do tópico (para usá-lo para anotações internas, etc.)

@jrgong – não…

No entanto, existe esta abordagem alternativa para a qual estou desenvolvendo um Componente de Tema… no Github.

2 curtidas

Parece que isso foi movido para o core há 17 horas.

Deixarei que outra pessoa atualize isso apropriadamente.

Tradução em falta: en. O plugin discourse-footnote foi integrado ao core do discourse. Por favor, remova o plugin do seu app.yml e reconstrua seu container.
3 curtidas

Após a migração para o core,

Excluí o plugin de app.yml e executei ./launcher rebuild app,

mas as configurações permanecem na página do plugin. Tudo bem deixá-lo assim?

Essa é a nova. :+1: Aqui está uma foto de ambas para comparação:

old one

new one

4 curtidas

Esse é um som muito bom! :+1: Obrigado por compartilhar. :smiling_face_with_three_hearts:

Obrigado por mencionar isso, acabei de enviar uma correção.

3 curtidas

O outro problema é que você não precisa mais instalar o plugin e, se o tiver instalado, não precisará incluir o git clone no seu arquivo yml.

2 curtidas

Fui muito lento para atualizar o tópico com as novas informações e você o fez antes de mim. :slight_smile:

Vou adicionar minha parte agora de qualquer maneira…


:information_source: O Discourse Footnote agora foi incluído no core do Discourse, portanto, este plugin não precisará mais ser instalado separadamente. :partying_face:

Se você auto-hospeda, deverá ver algumas informações no seu painel sobre como removê-lo do seu app.yml.

\u003e:discourse2: Hospedado por nós? Esta alteração não o afetará de forma alguma. :+1: Você pode continuar aproveitando este plugin e não se preocupar com nada.

4 curtidas

Sim. Desculpe por isso.

Isso é incrível! Eu sabia que você tinha um plano. Eu deveria ter esperado, pois a outra coisa que apontei era, de fato, um problema que foi, de fato, resolvido por outra pessoa, e eu deveria ter sido paciente, já que sabia que você iria lidar com isso. (E é tão bonito também!).

Ainda não se passaram 24 horas, então, sabe, isso também é muito bom.

Obrigado.

4 curtidas

3 posts foram divididos em um novo tópico: Opção de adicionar nota de rodapé ao menu de engrenagem do compositor

Existe uma maneira de fazer a nota de rodapé ser formatada normalmente? Para que não fique em linha com os três pontos, assim?[1]

E em vez disso, ter a aparência assim?


  1. Isso parece estranho, para mim ↩︎

É esta configuração?

1 curtida

Sim, mas eu quis dizer como um usuário comum, não um administrador alterando uma configuração.

Não, não há uma configuração de usuário para isso. Apenas uma global.

1 curtida

Notei que a criação de notas de rodapé não permite o uso de muita sintaxe markdown comum dentro dos colchetes da nota de rodapé[1]\n\nNã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 nota de rodapé, mas o layout quebra sempre que introduzo parágrafos, cabeçalhos, listas, etc.\n\nAqui está uma quebra de parágrafo. ↩︎

Você pode, certifique-se de recuar com pelo menos 4 espaços.

Por exemplo:


Aqui está uma referência de nota de rodapé[^1], e outra[^longnote].

[^1]: Aqui está a nota de rodapé.

[^longnote]: Aqui está uma com vários blocos.

    Parágrafos subsequentes são recuados para mostrar que eles
pertencem à nota de rodapé anterior.

    * item1
    * item 2

    **Mais** texto

    *itálico*

Aqui está uma referência de nota de rodapé[1], e outra[2].

Renderiza para:


  1. Aqui está a nota de rodapé. ↩︎

  2. Aqui está uma com vários blocos.

    Parágrafos subsequentes são recuados para mostrar que eles
    pertencem à nota de rodapé anterior.

    • item1
    • item 2

    Mais texto

    itálico ↩︎