Querida Comunidade do Discourse, aqui está meu pequeno presente de Natal 
para todos vocês 
. É simples, mas útil, e foi criado puramente porque eu quis.
Inspirado no ótimo blog do Simon Willison sobre o uso de LLMs para desenvolvimento, eu “vibe-coded” (desenvolvi de forma intuitiva e assistida por IA) isso durante o Natal, entre eventos sociais, assistindo a filmes e embrulhando presentes! Eu escrevi nenhuma linha de código, mas revisei o código e supervisionei o LLM. Tudo foi impulsionado por spec.md e roadmap.md.
Para que serve?
Eu uso um Discourse auto-hospedado e pessoal como Caderno de Notas, Diário, Blog, Currículo, Wiki, ferramenta de IA e base de conhecimento de desenvolvimento. Frequentemente, eu me vejo querendo “recortar” (clip) conteúdo da web e colocá-lo diretamente no meu Discourse, de onde posso incorporá-lo em uma Nota ou em uma entrada do Diário.
O Clip To Discourse agora suporta quatro estilos de recorte: Título da Página + URL, Título + URL + Trecho, Texto da Página Inteira e texto selecionado.
Privacidade
- O desenvolvedor não coleta dados do seu uso da extensão.
- O conteúdo recortado e as credenciais são enviados diretamente do seu navegador para a instância do Discourse que você configurar.
- Nenhum serviço intermediário do Clip To Discourse está envolvido.
- Perfis e credenciais são armazenados localmente no armazenamento de extensões do Chrome no seu dispositivo.
- Código aberto. Repositório no GitHub: GitHub - koloki-co/clip-to-discourse-chromium-extension: A Chromium Browser extension which clips web content to your private Discourse. · GitHub
Recursos
- Recorte uma página como Título + URL, Título + URL + Trecho, Texto da Página Inteira ou Seleção de Texto.
- Crie novos Tópicos com cada recorte, ou anexe recortes como respostas a um Tópico existente.
- Autorize-se através da API de Usuário do Discourse sem precisar que um administrador crie uma chave de API. Uma chave de API fornecida por um administrador, com escopo de usuário, continua disponível como alternativa.
- Suporta múltiplos perfis para diferentes instâncias do Discourse, usuários, credenciais, modelos e padrões. Perfis podem ser renomeados, duplicados ou excluídos.
- Escolha uma categoria de destino entre as categorias disponíveis para a conta conectada.
- Personalize os modelos de título e corpo usando metadados da página, trechos, texto completo, texto selecionado e placeholders de data.
- Escolha a aparência Sistema, Clara ou Escura.
- Opcionalmente, altere o ícone da barra de ferramentas do Clip To Discourse para o favicon do site do perfil selecionado, para que você possa facilmente saber para onde está recortando.
- Abra o pop-up usando
Ctrl+Shift+K(Command+Shift+Kno macOS), configurável emchrome://extensions/shortcuts.
Limitações
- O site do Discourse deve permitir chaves de API de Usuário e permitir que o grupo da sua conta as autorize. Se a autorização via API de Usuário não estiver disponível, um administrador do site pode fornecer uma chave de API de usuário único com permissões granulares.
- Claro, se a capacidade de Clip To Discourse fosse habilitada para muitos usuários, isso poderia gerar muitas publicações de baixa qualidade em uma instância do Discourse compartilhada ou pública. Portanto, eu destino principalmente esta Extensão àqueles de vocês que, assim como eu, usam o Discourse como um caderno pessoal.
Como Instalar
- Instale no Chrome ou em outro navegador compatível baseado em Chromium, versão 127 ou superior, via Chrome Web Store: https://chromewebstore.google.com/detail/clip-to-discourse/copdhiejkkdblhdcdjapcoalldkondhi
- Opcionalmente, “Fixe” a extensão na barra de ferramentas do navegador.
- Clique no ícone da extensão, abra Configurações e insira a URL Base do seu Discourse.
- Selecione API de Usuário e clique em Autorizar Clip To Discourse. Faça login na sua conta do Discourse, insira o código do dispositivo exibido, se solicitado, e aprove o acesso.
- Se a autorização via API de Usuário não estiver disponível, use a aba Chave de API do Administrador com uma chave de API de usuário único fornecida por um administrador. Evite chaves de API globais.
- Escolha seu estilo de recorte padrão, destino, categoria ou ID de Tópico existente, e opcionalmente personalize os modelos.
- Salve as configurações e opcionalmente teste a conexão.
- Feche as Configurações e recorte coisas para testar!
Autorizando o Clip To Discourse
Recortando para o Discourse
Mapa da Estrada (Roadmap)
- Eu não planejo criar uma extensão para Firefox ou Safari (como não uso esses navegadores), mas ficaria feliz se alguém assumisse a tarefa de portar esta extensão. Poderíamos colaborar para manter tudo em um único repositório e manter a paridade de recursos.
- Adições futuras possíveis incluem tags, atalhos de teclado adicionais e refinamentos adicionais no fluxo de trabalho de recorte.
Discussões relacionadas
Solicitação para basicamente esta ferramenta: Chrome/Firefox extension “Share to discourse” - #28 by supermathie
Um post relacionado, sugerindo recursos adicionais ao recortar um post do Discourse: Need Web Clipper for Discourse Post
Social Share é um conceito relacionado, mas usa URLs simples: Social Share
Feedback, Ideias e Contribuições
Este tópico é um bom lugar para colocar qualquer feedback que você tenha. Estou aberto a ideias de melhorias, desde que não tornem a extensão complicada e/ou menos útil para mim!
Se você quiser abrir issues ou fazer PRs, o repositório no GitHub está aqui:
Esta extensão é uma ferramenta gratuita, de código aberto e com foco em privacidade, criada para a comunidade do Discourse pela minha empresa Koloki.co
