Este é um repositório para livros sobre software livre com conteúdo produzido pelos participantes do Fórum de Tecnologia em Software Livre de Curitiba.
Para cada do evento, iniciando em 2017, vamos produzir um livro, no qual os capítulos serão produzidos por palestrantes e instrutores.
Baixe o livro de 2017.
O projeto está aberto para os contribuidores não somente enviem seus textos, mas possam ver em suas próprias máquinas como o livro todo até o ponto em que foi produzido.
Esse repositório também está disponível como git-ssb (%Zom1k68PFw1UW5pLXfiJfQ1mvyN2sVLJZ8ifk7OPZ5o=.sha256). Se estiver demorando demais para baixar os blobs direto do ssb, os mais pesados estao aqui (md5: 98c0650a66896f7df30e26b5ce4e2bec) e aqui (md5: c367d313c80d752c246f0dab0db1b7fc) Use sbot blobs.add para adiciona-los.
Procedimentos iniciais:
- Abra uma issue;
- Como título da issue coloque o nome do capítulo que irá escrever: Capítulo N;
- Faça um commit inicial criando a pasta do capítulo com o arquivo README.md dentro;
Estes procedimentos irão "marcar território" - todos saberão que alguém vai escrever aquele capítulo e assim não criarão (intencionalmente) uma pasta igual. A partir desse commit, pode fazer a escrita localmente e escolher se vai subindo as alterações aos poucos ou quando terminar tudo.
Se tiver dúvidas sobre GIT, o Guia de Roger Dudler é uma boa referência.
A construção dos capítulos deverá seguir as regras abaixo. É essencial lê-las.
- Um livro (pelo menos) será produzido por ano, a partir de 2017;
- Cada livro estará em uma pasta com o nome ftsl[ano];
- A estrutura de cada livro segue este modelo :
SUMMARY.md
chapter01
--README.md
chapter02
--images
--chapter02.01
...
--chapter02.mm
--README.md
...
chapterNN
--README.md
Onde cada capítulo está em uma pasta chapter[numero] que contém um arquivo README.md com o conteúdo do capítulo.
- O arquivo SUMMARY.md contém o índice do livro. Cada capítulo adicionado deve ser referido neste arquivo;
- Os arquivos README.md deverão conter no mínimo 2500 caracteres e no máximo 5000, excluindo imagens, mini-biografia e referências bibliográficas;
- As imagens usadas no capítulo deverão estar em uma pasta images dentro da pasta do capítulo;
- O nome dos arquivos de imagens deverá seguir o modelo chapterNN.mm onde NN é o numero do capítulo e mm é a sequência da imagem no capítulo;
- Todo capítulo deverá terminar com as referências bibliográficas das citações usadas no capítulo;
- Antes das referências bibliográficas deverá haver uma mini-biografia do autor, com no máximo 500 caracteres, em terceira pessoa;
- O capítulo deverá obrigatoriamente conter o título e o nome do autor;
Para gerar o livro localmente e vê-lo em seu navegador, você pode usar o Gitbook, seguindo as instruções abaixo.
Instalar GitBook é fácil. Seu sistema apenas precisa atender a este dois requisitos:
- NodeJS (v4.0.0 e superior é recomendado)
- Windows, Linux, Unix, ou Mac OS X
O melhor modo de instalar GitBook é via NPM. No prompt do terminal, simplesmente rode o seguinte comando para instalar Gitbook:
$ npm install gitbook-cli -g
gitbook-cli é um utilitário para instalar e usar múltiplas verões de GitBook sobre o mesmo sistema. Ele automaticamente instalará a versão requerida de Gitbook para construir um livro.
GitBook pode iniciar uma estrutura de livro:
$ gitbook init
Se você deseja criar o livro em um novo diretório, você pode fazer isso rodando gitbook init ./directory
Para visualizar e publicar seu livro use:
$ gitbook serve
Ou construa o website estático usando:
$ gitbook build
Os comandos anteriores devem ser executados dentro da pasta de cada livro. Não execute na raiz do projeto.
GitBook pode gerar um website, mas também pode gerar conteúdo como ebook (ePub, Mobi, PDF).
$ gitbook pdf ./ ./mybook.pdf
$ gitbook epub ./ ./mybook.epub
$ gitbook mobi ./ ./mybook.mobi
ebook-convert é requerido para gerar ebooks (epub, mobi, pdf).
Instale e aplicação Calibre.
$ sudo aptitude install calibre
Em algumas distribuições GNU/Linux node é instalado como nodejs, então você precisa criar manualmente um link simbólico:
$sudo ln -s /usr/bin/nodejs /usr/bin/node
Baixe a aplicação Calibre. Depois de mover calibre.app para sua pasta Applications crie um link simbólico para a ferramenta ebook-convert:
$ sudo ln -s ~/Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin
Você pode substituir /usr/bin com qualquer diretório que está em seu $PATH.
A capa do livro é definida por um arquivo cover.jpg no diretório raiz do livro. Uma miniatura da capa é definida pelo arquivo cover_small.jpg. O arquivo da capa deve estar no formato JPEG. A capa é decidida por democracia em consenso com os que puderem contribuir com a produção gráfica, respeitando os seguintes requisitos:
- Tamanho de 1800x2360 para cover.jpg e 200x262 para cover_small.jpg;
- Sem borda;
- Título do livro claramente visível;
- Qualquer texto importante deve estar visível na miniatura.
Copyright (C) FÓRUM DE TECNOLOGIA EM SOFTWARE LIVRE DE CURITIBA. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the license is included in the section entitled "GNU Free Documentation License".