Perguntas frequentes
Mostre seus livros no seu perfil
A aba Biblioteca de um perfil público lista os livros que você escreve em um arquivo do repositório do projeto. Você adiciona o arquivo com um pull request e o perfil lê o arquivo de lá.
- Mantenha seu perfil público (é o padrão) e entre com a conta do GitHub que vai dar nome ao arquivo.
- Faça um fork do repositório do projeto no GitHub.
- No seu fork, crie este arquivo, usando seu login do GitHub em minúsculas:
public/books/your-login.md - Preencha com um bloco de linhas por livro, como no exemplo abaixo.
- Abra um pull request. Uma verificação confere se o autor do pull request é o dono do arquivo.
- Depois do merge, seus livros aparecem na aba Biblioteca em até cerca de 15 minutos.
---
title: Designing Data-Intensive Applications
url: https://dataintensive.net/
pages: 616
cover: https://covers.openlibrary.org/b/isbn/9781449373320-L.jpg
comment: Explains why data systems work the way they do.
comment: The chapters on replication and consistency are worth a second read.
---
---
title: Clean Code
url: https://www.oreilly.com/library/view/clean-code-a/9780136083238/
pages: 464
---As regras
- title, url e pages são obrigatórios. cover e comment são opcionais.
- Coloque cada livro entre duas linhas ---, como os metadados no topo de um concept. Uma linha em branco também encerra um livro.
- pages é o total de páginas, de 1 a 5000. Ele define a espessura do livro na estante.
- cover é o endereço da imagem da capa. Sem ela, o livro mostra o título numa capa lisa.
- comment é texto simples, mostrado com o título quando o livro é aberto. Cada linha de comment é um parágrafo, até 4 linhas de 500 caracteres. Links e formatação aparecem como foram digitados, nunca são interpretados.
- url e cover precisam começar com https://. Um livro que quebra uma regra é ignorado; os outros continuam aparecendo.
- No máximo 200 livros por arquivo.
Prefere uma tabela?
Uma tabela também funciona, uma linha por livro: o título como link, as páginas e a capa (pode ficar vazia). Ela não tem coluna de comentário, e o título não pode ter o caractere |. Você pode misturar tabelas e blocos no mesmo arquivo.
| Book | Pages | Cover |
| --- | --- | --- |
| [Designing Data-Intensive Applications](https://dataintensive.net/) | 616 | https://covers.openlibrary.org/b/isbn/9781449373320-L.jpg |
| [Clean Code](https://www.oreilly.com/library/view/clean-code-a/9780136083238/) | 464 | |O arquivo é público e leva seu login do GitHub, então qualquer pessoa pode ligar os livros do seu perfil à sua conta do GitHub.