16  Capa e metadados

A capa aparece na primeira página do livro, como miniatura na barra lateral e nas pré-visualizações em redes sociais. Os metadados alimentam as mesmas pré-visualizações, o EPUB e a busca.

16.1 A capa

O padrão da casa é uma imagem de 1600 × 2500 px, em JPEG, com a mesma composição em todos os livros: nome da coleção no alto à esquerda, um emblema circular à direita, título grande em Playfair Display na parte inferior, subtítulo, uma etiqueta com a edição e uma barra de papel com o nome do autor na base.

A capa não é desenhada num programa gráfico: é uma página HTML, images/capa.html, que usa as fontes do próprio projeto, e é fotografada pelo Chrome em modo headless pelo script code/make_cover.sh:

./code/make_cover.sh                                   # macOS, Chrome instalado
CHROME=/caminho/para/chromium ./code/make_cover.sh     # outro binário

O resultado é images/capa.jpg. Editar a capa é editar o HTML (título, subtítulo, edição) e rodar o script de novo; o .html fica versionado ao lado do .jpg, e a capa de qualquer edição pode ser regenerada.

ImportanteImagens de terceiros

Uma fotografia de fundo só entra se a licença permitir (Unsplash License, domínio público, Creative Commons compatível), com o crédito na página de créditos. Na dúvida, a capa é tipográfica, como a deste manual.

16.2 Favicon e ícone para iOS

  • images/favicon.png, 256 × 256 px: o ícone da aba do navegador. É a foto do autor, a mesma em todos os livros; não se reaproveita a capa.
  • apple-touch-icon.png, 180 × 180 px, na raiz do projeto: o ícone que o iOS usa ao adicionar o livro à tela inicial. Precisa ser PNG opaco sobre o off-white do tema, porque o iOS não aceita SVG nem transparência. O arquivo é copiado para o site por project.resources e declarado pela tag em include-in-header.

16.3 Metadados em _quarto.yml

Metadados do livro
Campo Para que serve
title, subtitle, edition título da página, capa da barra lateral, metadados do EPUB
author (nome, ORCID, e-mail, afiliação) bloco de autoria e metadados
date: today com date-format data de publicação por extenso em português
description texto das pré-visualizações sociais e do EPUB
keyword palavras-chave dos metadados
cover-image, image capa na primeira página e miniatura na barra lateral e nas prévias
site-url endereço canônico, usado em links absolutos e no sitemap
repo-url, repo-branch link para o repositório

16.4 O endereço do livro

O GitHub Pages do autor usa domínio próprio, por isso cada livro é servido em henriquealvarenga.com/<repositório>/, e não em github.io. O site-url e a URL canônica da página de créditos precisam refletir isso.

NotaPontos-chave
  • A capa é um HTML de 1600 × 2500 px fotografado pelo Chrome; editar é mudar o HTML e rodar o script.
  • Favicon de 256 px com a foto do autor e ícone de 180 px para iOS, opaco.
  • Título, autor, descrição e imagem em _quarto.yml alimentam a página, as prévias e o EPUB.
  • O endereço é henriquealvarenga.com/<repositório>/.