- Um pacote que permite adicionar automaticamente manchas de café a documentos LaTeX, simplificando o processo que antes exigia inserir imagens manualmente
- Oferece quatro formatos de manchas (A~D), com ajuste detalhado de transparência, tamanho, ângulo de rotação e posição
- Após a instalação, declare
\usepackage{coffeestains} e use cada comando de mancha (\coffeestainA~\coffeestainD) para posicioná-las na página
- Pode ser distribuído livremente sem restrições de copyright, e todas as imagens das manchas foram produzidas, fotografadas e editadas diretamente
- Desde a primeira versão em 2009, foi continuamente aprimorado e, na versão 0.5.1 de 2021, a referência de rotação da mancha mudou do centro da página para o centro da própria mancha
Introdução (Introduction)
- Este pacote fornece a função de adicionar efeitos de manchas de café a documentos LaTeX
- Ao imprimir as manchas diretamente no documento, economiza o tempo de inserção manual
- Fornece quatro tipos de manchas
- Tipo A: mancha circular de 270° e duas pequenas marcas de respingo
- Tipo B: mancha circular de 60°
- Tipo C: duas marcas de respingo em cor clara
- Tipo D: respingos gêmeos multicoloridos
Uso (Usage)
- Coloque o arquivo
coffeestains.sty no diretório do projeto LaTeX ou instale-o na distribuição e, em seguida, adicione o seguinte ao cabeçalho do documento
\usepackage{coffeestains}
- Cada mancha é inserida com os seguintes comandos
\coffeestainA{alpha}{scale}{angle}{xoff}{yoff}
\coffeestainB{alpha}{scale}{angle}{xoff}{yoff}
\coffeestainC{alpha}{scale}{angle}{xoff}{yoff}
\coffeestainD{alpha}{scale}{angle}{xoff}{yoff}
- Explicação dos parâmetros
- alpha: transparência (0~1)
- scale: fator de escala/tamanho (padrão 1)
- angle: ângulo de rotação da mancha (0~360 graus)
- xoff, yoff: deslocamento de posição com base no centro da página (recomenda-se especificar a unidade)
- Comandos de exemplo
\coffeestainA{0.9}{0.85}{-25}{5cm}{1.3cm}\coffeestainB{0.7}{1}{-30}{18pt}{-135pt}\coffeestainC{1}{1}{180}{0}{-5mm}\coffeestainD{0.4}{0.5}{90}{3cm}{4cm}
Copyright
- Distribuição livre permitida, pois não acredita no conceito de “propriedade imaginária (imaginary property)”
- Todas as manchas foram produzidas e fotografadas pelo próprio Hanno Rein e processadas com GIMP e Inkscape
- Doações são aceitas apenas na forma de café, e o endereço é indicado para Hanno Rein no campus Scarborough da Universidade de Toronto, no Canadá
Melhorias desejadas (Desired improvements)
- Atualmente só há suporte para manchas de café, mas no futuro seria necessário expandir o alvo de impressão automática para latte, chá, gaspacho e manchas de óleo
- Também é mencionada a necessidade de a comunidade LaTeX desenvolver ferramentas para automatizar até manchas que hoje são aplicadas manualmente em oficinas de encadernação e lugares semelhantes
Histórico de alterações (Change Log)
- 3 de abril de 2009: Hanno Rein publica a primeira versão (0.1)
- 23 de novembro de 2010: Evan Sultanik desenvolve a versão compatível com pdflatex (0.2)
- 24 de março de 2011: Luis Randez adiciona funções de ajuste de tamanho, rotação e transparência (0.3)
- 25 de maio de 2012: Adrian Robson adiciona suporte a manchas descentralizadas (0.4)
- 1º de maio de 2021: Patrick Bideault publica a versão do repositório git (0.5) e altera a referência de rotação da mancha de centro da página → centro da mancha
Motos eternos (Eternal mottos)
- “Coffee is great.”
- “Coffee will save the world.”
Outros
- A última página do documento inclui a frase: “Esta página foi deixada em branco intencionalmente, mas foi arruinada ao avisar isso”
- A versão mais recente é 0.5.1 (25 de junho de 2021)
1 comentários
Comentários do Hacker News
Se LaTeX não fosse o padrão na academia ou em periódicos relacionados a manchas, eu provavelmente já teria migrado para Typst
Claro, também dá para fazer manchas de café em HTML, mas em Markdown não dá
Antigamente, um colega da universidade às vezes adicionava esse tipo de mancha aos documentos como uma marca de “comprovadamente lido”
Também compartilho threads anteriores do HN relacionadas: coleção de posts anteriores, discussão relacionada 1, discussão relacionada 2
Fico curioso se daria para gerar proceduralmente manchas de café que pareçam reais
Se essas coisas fossem impressas direto na página, daria para economizar bastante tempo de trabalho manual
Dá para versionar, não tem a bagunça de formatação do Word, e é totalmente determinístico (deterministic), então o resultado é sempre consistente
Hoje em dia também dá para usar LLMs para converter facilmente e até corrigir avisos automaticamente. Mesmo sem tomar café, recomendo muito currículo em LaTeX
Convertíamos páginas da web para PDF com várias fontes e adicionávamos desfoque com o ImageMagick
E, claro, também usávamos este programa de manchas de café