diff options
Diffstat (limited to 'content/sections')
-rw-r--r-- | content/sections/00-intro/intro.md | 25 | ||||
-rw-r--r-- | content/sections/05-workflow/funcionamento.md | 14 | ||||
-rw-r--r-- | content/sections/10-structure/structure.md | 38 | ||||
-rw-r--r-- | content/sections/15-installation/installation.md | 14 |
4 files changed, 45 insertions, 46 deletions
diff --git a/content/sections/00-intro/intro.md b/content/sections/00-intro/intro.md index c32674c..2fa235b 100644 --- a/content/sections/00-intro/intro.md +++ b/content/sections/00-intro/intro.md @@ -1,22 +1,21 @@ -# Introdução {#intro} +# Introduction {#intro} -Bookup^[@bookup] é um conjunto de templates, programas e fluxos de trabalho -para a autoria de livros em formatos HTML, PDF e EPUB. +Bookup^[@bookup] is a set of templates, scripts and workflows for book +authoring in HTML, PDF and other formats. -Ele é um componente de software modular baseado em [Bookdown][]. +It's a modular software component based on [Bookdown][]. -Foi criado para resolver o problema de editar muitos livros simultaneamente: -Bookup ajuda a manter um esquema uniforme, ao invés de ter que implementar e -corrigir funcionalidades paralelamente em muitos repositórios. +It was created to solve the problem of editing many books simultaneously: +Bookup helps to keep an uniform scheme instead of having to implement and fix +funcionalities across many repositories in parallel. -Com ele, a produção de conteúdo fica parecida com o trabalho com outros -códigos. +[Bookup][] makes book production similar to working with other codebases. -Não foi priorizado investir tempo em generalizar tudo ao máximo. O mais -importante foi criar uma base comum para os meus livros, e talvez aos poucos -generalizar para que possa ser usado por outras iniciativas. +But [Bookup][] is very opinionated. +You can understand it as an specific setup of [Bookdown][] and other software, +plus conventions and heuristics tuned to an specific use case. -O código do Bookup está disponível em [https://0xacab.org/rhatto/bookup][]. +[Bookup][] code is available at [https://0xacab.org/rhatto/bookup][]. [Bookdown]: https://bookdown.org [https://0xacab.org/rhatto/bookup]: https://0xacab.org/rhatto/bookup diff --git a/content/sections/05-workflow/funcionamento.md b/content/sections/05-workflow/funcionamento.md index b3ce0fe..16f0c72 100644 --- a/content/sections/05-workflow/funcionamento.md +++ b/content/sections/05-workflow/funcionamento.md @@ -1,11 +1,11 @@ -# Funcionamento {#funcionamento} +# Workflow {#workflow} -Bookup opera através da _compilação_ de arquivos: +Bookup works through _compiling_ files from source: ``` - \ .--> Livro PDF -Layout (LaTeX e HTML) \ / -Texto fonte (Markdown) >---> Compilação ----< -Bibliografia (BibTeX) / \ - / `--> Livro HTML + \ .--> PDF book +Layout (LaTeX and HTML) \ / +Source text (Markdown) >---> Compilation ----< +Bibliography (BibTeX) / \ + / `--> HTML book ``` diff --git a/content/sections/10-structure/structure.md b/content/sections/10-structure/structure.md index 98b2f91..f43dc4a 100644 --- a/content/sections/10-structure/structure.md +++ b/content/sections/10-structure/structure.md @@ -1,21 +1,21 @@ -# Estrutura de pastas {#estrutura} +# Folder structure {#structure} -A estrutura de pastas de um projeto usando Bookup é a seguinte: +A Bookup project folder structure looks like this: -* `archive`: armazena versões antigas do livro. -* `content`: o conteúdo do livro. - * `drafts`: deixe aqui os textos que ainda estão em composição. - * `sections`: aqui vai todo o material a ser compilado em livro. - * `notes`: caderno de anotações a ser incluído no material público. -* `slides`: slides no formato Markdown. -* `site`: HTML opcional usado para o sítio base; se existir, o livro será - colocado dentro da pasta `public/book` ou algo assim. -* `build`: o livro compilado (HTML, PDF e outros formatos): - * `notes`: caderno de notas compilado. - * `book`: o livro compilado, se houver uma pasta `site`, caso contrário o - conteúdo dolivro será colocado na pasta raíz do diretório `public`. -* `biblio`: bibliografia. -* `images`: pasta de imagens. -* `vendor/bookup`: - * `content`: documentação do Bookup. - * `vendor/{Fuse.js,}`: dependências. +* `archive`: stores old book versions. +* `content`: the actual content: + * `drafts`: you can leave here texts still being composed. + * `sections`: here goes the material to be compiled in book format. + * `notes`: keep texts here to be compiled as a notebook companion. +* `slides`: slides in Markdown format. +* `site`: an optional website used as base; if that exists, the book will be + place inside the `build/book` folder. +* `build`: the compiled book (HTML, PDF and other formats): + * `notes`: the compiled notebook. + * `book`: the compiled book, if there's a `site` folder available, + otherwise the book content will be placed in the toplevel `build` folder. +* `biblio`: bibliography (BibTeX). +* `images`: image folder. +* `vendor/bookup`: where the Bookup codebase actually resides: + * `content`: Bookup documentation. + * `vendor/{Fuse.js,}`: dependencies. diff --git a/content/sections/15-installation/installation.md b/content/sections/15-installation/installation.md index 810e30f..44445c5 100644 --- a/content/sections/15-installation/installation.md +++ b/content/sections/15-installation/installation.md @@ -1,24 +1,24 @@ -# Instalação {#instalacao} +# Installation {#installation} -Procedimento de instalação do Bookup. +Bookup installation procedure. -## Vendorização +## Vendorization -* Vendorização (repositórios `bookup` e de bibliografia). +* Vendorization (`bookup` and bibliography repositories). -## Links simbólicos +## Symbolic links * `_bookdown.yml`. * `output.yml`. -## Arquivos requeridos +## Requiser files * `.gitignore`. -* `images/cover.png`. * `_common.yml`. * `_book.yml`. * `_notes.yml`. * `_biblio.yml`. * `LICENSE`. * `DISCLAIMER`. +* `images/cover.png`. * `snippets/{contact,cover,keywords,project,url,volume}.txt`. |