Escreva e-books com Ruby e Softcover

Henrique Fernandez
Feb 16, 2019 · 6 min read

Você tem idéias para escrever e-books, mas não sabe como começar e nem onde publicar?

Aqui vai uma excelente dica:

Softcover

Softcover é um framework escrito em Ruby que possibilita a conversão de arquivos Markdown em EPUB, MOBI, HTML, PDF e outros formatos, além de contar com 3 grandes diferenciais:

  • Podemos vincular screencasts ao e-book.
  • Softcover suporta uma versão extendida de Markdown, que nos permite incrementar o texto de forma bem mais ampla que outros frameworks. (veja aqui: http://manual.softcover.io/book/softcover_markdown)
  • Assim que o e-book estiver finalizado, podemos facilmente publicar uma página online para sua divulgação e venda, totalmente $$free$$ (softcover.io faz tudo para você).

Exemplos de e-books e suas páginas online:

Legal né? Você pode conferir como é simples e rápido desenvolver seu próprio e-book com Softcover! Através desse artigo lhe convido a fazer uma pequena “tour” pelo framework.

Lets go!

Instalação

Com o Ruby na sua máquina, instale a gem do softcover:

$ gem install softcover

Caso tenha problemas na instalação com o comando acima, utilize:

$ gem install softcover — — with-cppflags=-I/usr/local/opt/openssl/include

Criando o seu primeiro e-book

$ softcover new nome_do_seu_livro

Este comando prepara tudo o que você precisa para começar o seu trabalho!

Vamos conhecer um pouco sobre as principais pastas criadas pelo comando:

/config

Nesta pasta temos alguns arquivos .yml de configuração:

  • book.yml:

O arquivo book.yml é responsável pelos dados sobre o seu livro como o título, subtítulo, autor, nome do arquivo, descrição e etc…

Podemos inclusive configurar quantas páginas de preview teremos com “pdf_preview_page_range” e “epub_mobi_preview_chapter_range”!

Isso mesmo! Além de todos os formatos de exportação disponíveis, caso quisermos vender o ebook e disponibilizar uma versão de preview (amostra) também podemos!

  • lang.yml:

O arquivo lang.yml é responsável por configurar algumas palavras padrões do livro para a linguagem que quisermos. O padrão é em inglês, mas caso desejarmos ter nosso livro em português precisaremos apenas trocar estas palavras, “Chapter” para “Capítulo” por exemplo.

  • marketing.yml:

Este arquivo é responsável pelos textos de marketing que teremos caso publiquemos o livro junto a plataforma do softcover. Podemos adicionar nossa biografia, links para redes sociais, depoimentos e até screencasts!

/chapters

Nesta pasta é onde colocaremos todo o conteúdo do livro em Markdown. Veja como o softcover entende a estrutura de uma página:

O header ‘#’ é interpretado pelo softcover como sendo o nome do capítulo e os seguintes ‘##’ ou ‘###’ como sendo as seções desse capítulo, logo, o markdown acima seria interpretado da seguinte maneira:

/images

Nesta pasta estão as imagens do livro, que podem ser incluídas nos textos com:

![Descrição da imagem.](images/figures/arquivo_da_imagem.jpg)

As imagens na raiz da pasta com os nomes de “cover” representam as capas do livro nos seus diversos formatos. Logo, quando tivermos a capa do nosso livro feita, devemos inclui-la nessa pasta com o nome de “cover”.

/media

Esta pasta é onde adicionamos nossos screencasts, em qualquer formato de vídeo. Os screencasts poderão ser adicionados na página de marketing personalizada do seu livro quando o publicar ou vinculados ao arquivo do livro como conteúdo extra.

O arquivo Book.txt

Veja como a estrutura está definida através do arquivo Book.txt padrão:

  1. Capa (cover)
  2. Introdução com: título (maketitle), índice (tableofcontents) e o prefácio (preface.md)
  3. Conteúdo com: primeiro capítulo (a_chapter.md), segundo capítulo (another_chapter.md) e terceiro capítulo (yet_another_chapter.md)

Se invertemos a ordem dos capítulos como no exemplo abaixo:

“mainmatter:
yet_another_chapter.md
another_chapter.md
a_chapter.md”

“yet_another_chapter.md” será interpretado como o primeiro capítulo.

Rodando o e-book no browser

$ softcover serve

Ao acessar o endereço localhost:4000 no seu browser, terá um preview do seu livro já formatado!

Exportando para diversos formatos

$ softcover build:formato_escolhido

por exemplo, temos:

  • $ softcover build:epub
  • $ softcover build:html
  • $ softcover build:mobi
  • $ softcover build:pdf
  • $ softcover build:preview

Material extra sobre Softcover

  • Manual oficial:
  • Site oficial:
  • Repositório do GitHub:

Softcover vs Gitbook

Se você curtiu o post e deseja acompanhar mais sobre Elixir, Ruby e desenvolvimento web em geral você pode acompanhar meu blog pessoal ou me seguir aqui no Medium!

www.truehenrique.com.br

Valeu!

@truehenrique

/truehenrique.com/ desenvovlimento de software, meu dia a dia e uma “pitada” de filosofia.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store