gitbook-plugin-cdc

Este é um plugin do Gitbook, uma ferramenta para geração de livros.

Instalação

Pré-requisitos

Você vai precisar instalar:

Node.js
- Instalação: http://nodejs.org/download/
- OBS: Testado na versão 0.10.35
Gitbook 1.5.0
- Utilizado para transformar .md em .html, gerando site ou ebooks
- Instalação: sudo npm install -g gitbook@1.5.0
PDFtk
- Utilizado para extrair sumário e mesclar PDFs.
- Instalação (Ubuntu): sudo apt-get install pdftk
- Instalação (Mac .pkg): https://www.pdflabs.com/tools/pdftk-server
- OBS: Testado na versão 2.0.1
Ghostscript
- Utilizado para modificar página inicial de um PDF.
- Instalação (Ubuntu): sudo apt-get install ghostscript
- Instalação (Mac): brew install ghostscript
- OBS: Testado na versão 9.10
Calibre
- Utilizado para gerar ebooks nos formatos .pdf, .mobi e .epub
- Instalação (Ubuntu e Mac): instruções em http://calibre-ebook.com/download
  - (Ubuntu) Para instalar o Calibre você precisa ter instalado: xdg-utils, wget e python 2.6+
  - (Ubuntu) Para rodar o Calibre, você precisa ter instalado: GLIBC 2.13+ e libstdc++.so.6.0.17 (from gcc 4.7.0), qt-sdk e python3-pyqt5

Configurando seu livro

Configure o package.json do seu livro da seguinte maneira:

{
"name": "livro",
"version": "0.0.1",
"description": "livro",
"private": true,
"dependencies": {
    "gitbook-plugin-cdc": "casadocodigo/gitbook-plugin-cdc",
    "gitbook-plugin-cdc-tema": "casadocodigo/gitbook-plugin-cdc-tema"
 }
}

Execute npm install para baixar este plugin e as outras dependências.

Configure o arquivo book.json do seu livro, definindo title, description, author e publisher. Defina também em plugins, o valores cdc e cdc-tema.

{
	"title": "Título do Livro",
	"description": "Descrição do Livro.",
	"author": "Fulano Silva & Ciclano Souza",
	"publisher": "Minha Editora",
	"plugins": ["cdc", "cdc-tema"]
}

Outras opções possíveis estão definidas abaixo.

Fizemos um patch para adicionar algumas funcionalidades no Gitbook que não podem ser feitas com plugins. Substitua o arquivo /usr/local/lib/node_modules/gitbook/lib/generate/ebook/index.js, pelo conteúdo do patch.

Gerando livros

Pronto! Agora podemos gerar o nosso livro. Temos algumas opções:

Para gerar um site no diretório _book:

gitbook build
Para gerar um arquivo book.pdf:

$ gitbook pdf
Para gerar um arquivo book.epub:

$ gitbook epub
Para gerar um arquivo book.mobi:

$ gitbook mobi

Mantendo os arquivos intermediários

Para ver os arquivos intermediários, você pode utilizar os comandos abaixo.

Para gerar um PDF, mantendo os arquivos intermediários, no diretório book.pdf, execute:

$ gitbook build -f ebook -o book.pdf

O arquivo PDF final é o index-with-toc-bookmarks-and-page-numbers.pdf.

O PDF também pode ser gerado com o comando $ gitbook build -f ebook. Serão mantidos os arquivos auxiliares no diretório _book.
Para gerar um MOBI, no diretório book.mobi, execute:

$ gitbook build -f ebook -o book.mobi

O arquivo MOBI gerado é o index.mobi.
Para gerar um EPUB, no diretório book.epub, execute:

$ gitbook build -f ebook -o book.epub

O arquivo EPUB gerado é o index.epub.

Mais opções

É possível mudar os valores de algumas opções através do arquivo book.json.

"pdf": {
	"margin": {
		"right": 56, //Number
		"left": 56, //Number
		"top": 56, //Number
		"bottom": 56 //Number
	},
	"customSize": "210x280", //String no formato largura x altura
	"fontSize": 11 //Number
	"headerTemplate": "<p>_SECTION_</p>", //String com um template html para o cabeçalho de cada página 
	"footerTemplate": "<p>_PAGENUM_</p>", //String com um template html para o rodapé de cada página  
	"summary": {
		"headerTemplate": "<p>Sumário</p>", //String com template do cabeçalho do sumário
		"footerTemplate": "<p>Casa do Código</p>" //String com template do rodapé do sumário
	}
}

Tanto para o headerTemplate como para o footerTemplate, podem ser usadas as seguintes variáveis:

_PAGENUM_, que contém o número da página atual
_SECTION, que contém o nome da seção atual
_TITLE_, que contém o título do livro
_AUTHOR_, que contém o nome do autor

Os valores padrão das propriedades são os seguintes:

pdf.fontSize: tamanho do texto. O padrão, definido pelo Gitbook, é 12.
pdf.margin.left: define a margem esquerda do pdf em pts. O padrão, definido pelo Gitbook, é 62.
pdf.margin.right: define a margem direita do pdf em pts. O padrão, definido pelo Gitbook, é 62.
pdf.margin.top: define a margem de cima do pdf em pts. O padrão, definido pelo Gitbook, é 36.
pdf.margin.bottom: define a margem de baixo do pdf em pts. O padrão, definido pelo Gitbook, é 36.

Inserindo conteúdo antes do sumário

Existem alguns conteúdos que não fazem parte do texto do livro em si.

Alguns são conteúdos estáticos como copyright e propagandas.

Outros são conteúdos dinâmicos como prefácio, apresentação dos autores e agradecimentos. Estes conteúdos são parte do livro, mas vem antes do sumário.

Conteúdo estático antes do sumário

Conteúdos estáticos como copyright e propagandas, que são sempre iguais para todos os livros, devem ser colocados em arquivos .pdf no diretório configurado pela variável de ambiente EXTRAS_DIR.

Os .pdf de EXTRAS_DIR serão ordenados por nome e inseridos logo depois da capa do livro.

Também é possível definir arquivos .pdf dentro do diretório do livro, no sub-diretório extras. Se o EXTRAS_DIR já estiver configurado, os .pdf de extras virão logo depois.

Conteúdo dinâmico antes do sumário

Conteúdos do livro como prefácio, apresentação dos autores e agradecimentos devem ser colocados em arquivos .md dentro do diretório intro.

Ao gerar um pdf, cada arquivo .md do diretório intro será transformado em um .pdf e inserido logo antes do sumário (mas depois dos extras).

Os .md serão ordenados pelo nome do arquivo antes de serem renderizados e inseridos.

Código

Este plugin está organizado em dois sub-módulos:

ebook: manipula conteúdo do livro como nomes das seções, legenda de imagens, etc...
pre-content: insere conteúdo no início do livro como copyright, propagandas, apresentação dos autores, etc...

index.js

Configura hooks do gitbook.

Os hooks configurados são:

page: disparado logo depois ter renderizado o .md de cada página em um .html, chama a função handlePage do sub-módulo ebook
page:after: disparado depois do gitbook manipular o .html de cada página, chama a função handlePageAfter do sub-módulo ebook
ebook:before: hook customizado, criado a partir de um patch. É disparado logo antes da chamada do calibre para a geração do ebook. Chama a função handleEbookBefore do sub-módulo ebook
finish: disparado ao fim da geração do ebook ou site, chama a função finish do sub-módulo pre-content

As funções acima são chamadas com código do tipo funcao.call(this, argumento), para que o this do gitbook seja propagado para cada função.

util.js

Contém as funções comuns:

obtainExtension

Função que obtém a extensão do livro a ser gerado.

Parâmetros:

options - Object com as configurações do book.json do gitbook.

Retorno:

uma String com a extensão do livro a ser gerado (pdf, mobi ou epub).

Se não houver como descobrir a extensão do livro e o formato for ebook, é considerado o "pdf".

Se o formato for site, o retorno é "", uma String vazia.

ebook/index.js

Manipula conteúdo do livro.

Dependências externas:

cheerio, uma implementação enxuta do jQuery para Node.js.

handlePage

Função que manipula conteúdo da página renderizada.

Parâmetros:

page - Object com as informações sobre a página que será renderizada.

Retorno:

um Objectcom a page com conteúdo manipulado.

Se o título capítulo começar com números, será lançada uma exceção. Essa limitação tem a ver com a maneira com que é feito o cabeçalho das páginas no calibre (pdf.headerTemplate do book.json).

O gitbook/calibre não coloca números antes das seções (p. ex.: 1.2 Integração com tecnologias do JavaEE). Por isso, para cada h2 de cada seção da página, é inserido o número do capítulo seguido por um número sequencial para cada seção.

Para cada img da página, é extraído do alt configurações de largura da imagem (ex.: {w=60%}). Se a extensão do livro for pdf e houver largura configurada, é colocado um width no img. Além disso, é inserido um div com um p que serve como legenda para a imagem.

Todos os comentários html são removidos do livro.

handlePageAfter

Função que manipula conteúdo da página renderizada.

Parâmetros:

page - Object com as informações sobre a página que será renderizada.

Retorno:

um Objectcom a page com conteúdo manipulado.

Antes de cada h1 que contém o título do capítulo, é inserido um div com o número do capítulo (ex.: Capítulo 1).

handleEbookBefore

Função que altera opções do ebook-convert do calibre

Parâmetros:

options - Object com configurações que vão ser passadas para o calibre.

Retorno:

um Objectcom as opções do calibre alteradas.

Essa função é chamada no hook ebook:before, que não é padrão do gitbook. Esse hook foi criado a partir de um patch.

É disparado logo antes da chamada do calibre para a geração do ebook.

Não é chamado na geração de site.

São alteradas configurações do ebook-convert do calibre que não são inseridas pelo gitbook como:

--publisher: nome da editora, obtido a partir da propriedade publisher do book.json
--chapter-mark: colocado para none, para que não sejam colocadas quebras de página no início de cada capítulo. As quebras de página devem ser controladas por css.
--level2-toc: configura a detecção de seções para considerar h2. Utilizado na geração do sumário pelo calibre.
--level2-toc: setado para null, de maneira a desconsiderar títulos (na verdade, h3) na geração do sumário pelo calibre.

Se a extensão do livro a ser gerado for mobi, são configuradas as seguintes opções:

--mobi-keep-original-images: setada para true, fazendo com que o calibre não comprima as imagens
--toc-title: modificado para Sumário

Se a extensão do livro a ser gerado for pdf, são configuradas também as seguintes opções:

--pdf-page-numbers: setado para null
--disable-font-rescaling: setado para true
--paper-size: setado para null
--custom-size: utilizado o valor da propriedade pdf.customSize do book.json
--unit: setada para millimeter

pre-content/index.js

Insere conteúdo no início do livro.

Dependências externas:

fs-extra, métodos extras para o módulo de sistemas de arquivo do Node.js.
Q, biblioteca de promises para Node.js.

finish

Função associada ao hook de finish do gitbook, que é chamada no fim da geração de um site ou ebook pelo gitbook.

Se a extensão do livro a ser gerado não for pdf, não faz nada.

Agora, se for pdf, faz os seguintes passos:

cria sumário utilizando a função renderTocPDF
adiciona conteúdo antes do sumário através da função handlePreContent
junta conteúdos em um pdf só utilizando a função join do módulo pdftk, gerando o arquivo index-with-pre-content.pdf
atualiza índice do pdf usando a função updateBookmarkInfo do módulo pdftk, gerando o arquivo index-with-pre-content-and-bookmarks.pdf
atualiza informações de número das páginas do pdf com a função updatePageNumberInfo do módulo gs, gerando o arquivo index-with-pre-content-bookmarks-and-page-numbers.pdf
há um passo final, se o comando executado for gitbook pdf. Os arquivos intermediários são gerados no diretório /tmp e logo em seguida apagados. Por isso, copiamos o /tmp/index-with-pre-content-bookmarks-and-page-numbers.pdf para /tmp/index.pdf. O gitbook se encarrega de transformá-lo no arquivo, chamado book.pdf.

renderTocPDF

Função privada de pre-content/index.js que é responsável por gerar um pdf com o sumário, a partir do pdf original do gitbook/calibre.

Parâmetros:

outputDir - String com o caminho do diretório de saída
originalPDF - String com o caminho do pdf gerado pelo gitbook/calibre
pdfInfo - Object com informações do livro como autor, editora e título, além das opções do gitbook.

Retorno:

String com o caminho do pdf gerado que contém o sumário

Os passos para gerar o pdf com o sumário são os seguintes:

extrair do índice do pdf original, através do função extractTOC do módulo pdftk.js, um Object com capítulos e seções com suas respectivas páginas.
atualizar as páginas do Object obtida no passo anterior, utilizando a função update do módulo toc.js, para que o primeiro capítulo comece na página 1. Nas informações extraídas pelo pdftk, o primeiro capítulo começa na página 3, porque é considerada a capa e uma página com o sumário original (e incompleto) gerado pelo gitbook.
com o Object com as páginas atualizadas, é renderizado um html através da função render do módulo htmlRenderer.js. Para isso, é passado o template book/templates/toc.tpl.html.
a String com o html renderizado no passo anterior é salva em um arquivo
para gerar um pdf com o sumário é chamada a função generate do módulo calibre passando o caminho do arquivo html, o caminho onde o arquivo pdf deve ser gerado e opções para geração do pdf. As opções do calibre vem do objeto pdfInfo, que são obtidas do book.json. São definidas as seguintes opções:
- --pdf-page-numbers fica como null porque será usado o --pdf-footer-template
- --disable-font-rescaling fica como true para desabilitar mudança nas fontes
- --paper-size fica com null porque será usado o --custom-size
- --unit fica com millimeter
- --chapter fica com / para desligar a detecção de capítulos
- --page-breaks-before fica com / para desabilitar quebras de página.
- --custom-size é obtido de pdf.customSize do book.json
- --margin-left é obtido de pdf.margin.left do book.json
- --margin-right é obtido de pdf.margin.right do book.json
- --margin-top é obtido de pdf.margin.top do book.json
- --margin-bottom é obtido de pdf.margin.bottom do book.json
- --pdf-default-font-size é obtido de pdf.fontSize do book.json
- --pdf-mono-font-size é obtido de pdf.fontSize do book.json
- --pdf-header-template é obtido de pdf.summary.headerTemplate do book.json
- --pdf-footer-template é obtido de pdf.summary.footerTemplate do book.json

No fim desses passos, temos um pdf com o sumário do livro com capítulos e seções e as respectivas páginas.

handlePreContent

Função privada de pre-content/index.js responsável por gerar pdfs com todo o conteúdo que precede o primeiro capítulo: conteúdo fixo como pdfs com copyright e propagandas, conteúdo .md que precisa ser renderizado e o pdf do sumário.

Parâmetros:

inputDir - String com o caminho do diretório de entrada
outputDir - String com o caminho do diretório de saída
tocPDF - String com o caminho do pdf do sumário
pdfInfo - Object com informações do livro como autor, editora e título, além das opções do gitbook.

Retorno:

Array com todos os caminhos de pdfs que devem ser inseridos antes do primeiro capítulo

Os passos para gerar o pdfs são os seguintes:

obter todos os arquivos .pdf ordenados por nome do diretório apontado pela variável de ambiente EXTRAS_DIR, se presente
verificar se existe um diretório extras no livro e obter todos os arquivos .pdf desse diretório ordenados por nome
obter todos os arquivos .md, ordenados por nome, do diretório intro
renderizar os .md, transformado-os em .pdf
extrair a soma dos número de páginas de todos os .pdf encontrados no EXTRAS_DIR, no extras ou gerados a partir do .md de intro
atualizar o objeto pdfInfo com um objeto preContent que tem a propriedade numberOfPages com a soma do número de páginas obtida anteriormente

Após a execução da função, é retornado um array com os caminhos dos .pdf de EXTRAS_DIR, extras e intro (renderizados). Além disso, o objeto pdfInfo terá o número de páginas desses .pdf.

pre-content/pdftk.js

Contém código de invocação da ferramenta pdftk.

Dependências externas:

Q, biblioteca de promises para Node.js.

extractTOC

Função que usa o pdftk para extrair o índice de um pdf.

Parâmetros:

pdfFile - String com o caminho de um pdf

Retorno:

Array de Objects com informações dos capítulos (title, pageNumber e sections).

É executado o comando pdftk arquivo.pdf dump_data.

Cada linha da resposta do comando anterior é lida, buscando a página através do BookmarkPageNumber, se é seção ou capítulo através do BookmarkLevel e o título através do BookmarkTitle .

Então, é retornado um Array que contém objetos com as informações de cada capítulo. O retorno será algo como:

[
{  title: "Capítulo 1", 
    pageNumber: 1, 
    sections: [ 
        { title: "Seção 1.1", pageNumber: 1},
        { title: "Seção 1.2", pageNumber: 3}
    ] 
}, 
{  title: "Capítulo 2", 
    pageNumber: 5, 
    sections: [ 
        { title: "Seção 2.1", pageNumber: 6}
    ] 
}
]

Em pre-content/test/integration/pdftk-test.js, há um teste de que executa a extração do índice em um pdf de exemplo.

extractNumberOfPagesFromFiles

Função que retorna a soma do número de páginas dos arquivos pdf passados como parâmetro, usando o pdftk.

Parâmetros:

files - Array com o caminho de arquivos pdf

Retorno:

Number com a soma do número de páginas dos pdfs.

Para extrair o número de páginas, é executado o comando pdftk arquivo.pdf dump_data e lida a informação NumberOfPages.

Como o comando pdftk é executado várias vezes, é criado um array de promises e são utilizadas as funções all e spread da biblioteca Q, para gerenciar a execução das promises.

Em pre-content/test/integration/pdftk-test.js, há um teste de que executa a extração do número de páginas de pdfs de exemplo.

join

Função que mescla vários arquivos pdf usando o pdftk.

Parâmetros:

pdfFile - String com o caminho de um pdf principal
files - Array com o caminho de arquivos pdf a serem inseridos no começo do pdf principal
outputFile - String com caminho do pdf de saída

Os arquivos pdf no array files são colocados logo depois da página 1 do arquivo principal (que contém a capa do livro). Depois de todos os arquivos pdf extras, é inserido o conteúdo do pdf principal.

Obs.: Na verdade, é retirada a página 2 do pdf principal, porque essa página contém um sumário incompleto que é gerado pelo gitbook.

É utilizada o comando cat do pdftk. Um exemplo de chamada é o seguinte:

pdftk A="input.pdf" B="copyright.pdf" C="ads.pdf" D="toc.pdf" cat A1 B C D A3-end output out.pdf

Em pre-content/test/unit/pdftk-join-test.js, há um teste de unidade com exemplos.

updateBookmarkInfo

Função que, dado um pdf de entrada e um objeto com as páginas iniciais e títulos dos capítulos e seções, gera um pdf de saída com as informações atualizadas.

Parâmetros:

inputFile - String com o caminho do pdf de entrada
info - Object com informações atualizadas das páginas e títulos
infoFile - String com o caminho onde deve ser gravado o arquivo com informações do novo índice no formato do pdftk
outputFile - String com caminho do pdf de saída

Vamos supor que invocamos essa função com o objeto info, conforme a seguir:

{
    "toc":[
        {
        "title":"1 Introdu&#231;&#227;o",
        "pageNumber":3,
        "sections":[
            {
           "title":"1.1 Mantendo o hist&#243;rico do c&#243;digo",
           "pageNumber":3
            }
        ]
        }
    ],
    "preContent": { "numberOfPages": 9 }
};

Se o parâmetro infoFile for info.txt, esse arquivo será gerado com o seguinte conteúdo:

BookmarkBegin
BookmarkTitle: 1 Introdu&#231;&#227;o
BookmarkLevel: 1
BookmarkPageNumber: 13
BookmarkBegin
BookmarkTitle: 1.1 Mantendo o hist&#243;rico do c&#243;digo
BookmarkLevel: 2
BookmarkPageNumber: 13

Então, é invocada a opção update_info do comando pdftk da seguinte maneira:

pdftk input.pdf update_info info.txt output output.pdf

Depois dessa invocação, o índice do output.pdf estará com as páginas atualizadas de acordo com as informações de info.

Em pre-content/test/unit/pdftk-bookmarkInfo-test.js, há um teste de unidade com exemplos dos parâmetros e do tipo de arquivo que é gerado.

pre-content/toc.js

Atualiza páginas do sumário.

update

Função que atualiza a informação do número da página dos capítulo e seções, de maneira que o primeiro capítulo comece na página 1. Para isso, são descontadas 2 páginas: 1 para a capa e outra para o sumário original do gitbook.

Parâmetros:

toc - Object com informações dos capítulos (title, pageNumber e sections).

Retorno:

Object com número das páginas dos capítulos e seções atualizados

pre-content/htmlRenderer.js

Renderiza um html.

Dependências externas:

Q, biblioteca de promises para Node.js.
swig, uma engine de templates para Node.js.

render

Função que renderiza um html utilizando a template engine swig, dados um conteúdo e um template.

Parâmetros:

content - Object com o conteúdo a ser renderizado.
templateLocation - String com o caminho de um template compatível com o swig

Retorno:

uma String que contém o html renderizado

pre-content/calibre.js

Renderiza um pdf utilizando o comando ebook-convert do calibre.

Dependências externas:

Q, biblioteca de promises para Node.js.

generate

Função que gera um pdf a partir de um html, utilizando o ebook-convert do calibre.

Parâmetros:

inputFilename - String com o caminho do html de entrada
outputFilename - String com o caminho do pdf de saída
options - Object com opções do ebook-convert

É gerada um chamada do tipo:

ebook-convert input.html output.pdf --disable-font-rescaling --chapter="/" --page-breaks-before="/"

O comando é executado através da função exec do módulo child_process do Node.js.

pre-content/dir.js

Lista os arquivos de um diretório.

Dependências externas:

Q, biblioteca de promises para Node.js.

listFilesByName

Função que retorna os caminhos de todos os arquivos de uma determinada extensão de um diretório, ordenados pelo nome do arquivo.

Parâmetros:

dir - String com o caminho de um diretório.
extension - String com uma extensão de arquivos

Retorno:

Array com os caminhos dos arquivos da extensão, ordenados por nome.

pre-content/mdRenderer.js

Renderiza arquivos md em pdf.

Dependências externas:

Q, biblioteca de promises para Node.js.
kramed, parser de Markdown para Node.js.

renderPdfs

Função que renderiza uma lista de arquivos md em pdf.

Parâmetros:

files - Array com caminhos de arquivos .md
template - String com o caminho de um template compatível com swig
pdfOptions - Object com opções do ebook-convert

Para cada arquivo .md do parâmetro files, são feitos os seguintes passos:

renderizar um html a partir do md utilizando a biblioteca kramed
é utilizada a função render do módulo htmlRenderer.js passando o parâmetro template, para melhorar o html gerado no passo anterior.
é criado um arquivo com o conteúdo html com o mesmo nome do md, só que com extensão .html
é utilizada a função generate do módulo calibre.js para gerar um pdf a partir do arquivo html. São utilizadas as seguintes opções:
- --pdf-page-numbers fica como null porque será usado o --pdf-footer-template
- --disable-font-rescaling fica como true para desabilitar mudança nas fontes
- --paper-size fica com null porque será usado o --custom-size
- --unit fica com millimeter
- --chapter fica com / para desligar a detecção de capítulos
- --page-breaks-before fica com / para desabilitar quebras de página.
- --custom-size é obtido de pdf.customSize do book.json
- --margin-left é obtido de pdf.margin.left do book.json
- --margin-right é obtido de pdf.margin.right do book.json
- --margin-top é obtido de pdf.margin.top do book.json
- --margin-bottom é obtido de pdf.margin.bottom do book.json
- --pdf-default-font-size é obtido de pdf.fontSize do book.json
- --pdf-mono-font-size é obtido de pdf.fontSize do book.json
- --pdf-header-template fica como null, para não ter cabeçalho
- --pdf-footer-template fica como null, para não ter rodapé

pre-content/gs.js

Código de chamada do ghostscript.

Dependências externas:

Q, biblioteca de promises para Node.js.

updatePageNumberInfo

Função que configura o pdf para usar números romanos (i, ii, iii, iv, ...) até antes do capítulo 1 e algarismos arábicos (1, 2, 3, 4, ...) do capítulo 1 em diante.

Parâmetros:

inputFile - String com o caminho do pdf de entrada
pageInfo - Object com informações do livro como título, autores, editora e número de páginas de pré-conteúdo
pageInfoFile - String com o caminho onde gravar o arquivo que será usado o gs
outputFile - String com o caminho do pdf de saída

Suponha que passamos o objeto pageInfo, conforme abaixo:

{
    "book": {
        "title": "Git e GitHub",
        "author": "Alexandre",
        "publisher": "Casa do Código"
    },
    "preContent": { "numberOfPages": 9 }
};

O arquivo gerado teria o seguinte conteúdo:

[ /Title (Git e GitHub)
/Author (Alexandre)
/Creator (Casa do Código)
/Producer (Casa do Código)
/DOCINFO pdfmark
[/_objdef {pl} /type /dict /OBJ pdfmark
[{pl} <</Nums [ 
0 << /S /r >> 
10 << /S /D /St 1 >> 
]>> /PUT pdfmark
[{Catalog} <</PageLabels {pl}>> /PUT pdfmark

O conteúdo do arquivo anterior informa para o Ghostscript que da página 0 a 9 devem ser utilizados números romanos e da página 10 em diante devem ser usados algarismos arábicos.

Então, será chamado o Ghostscript de maneira parecida com:

gs -q -o output.pdf -sDEVICE=pdfwrite input.pdf info.txt

Em pre-content/test/unit/gs-pageInfo-test.js, há um teste de unidade.

Files

README.md

Latest commit

History

README.md

File metadata and controls

gitbook-plugin-cdc

Instalação

Pré-requisitos

Configurando seu livro

Gerando livros

Mantendo os arquivos intermediários

Mais opções

Inserindo conteúdo antes do sumário

Conteúdo estático antes do sumário

Conteúdo dinâmico antes do sumário

Código

obtainExtension

handlePage

handlePageAfter

handleEbookBefore

finish

renderTocPDF

handlePreContent

extractTOC

extractNumberOfPagesFromFiles

join

updateBookmarkInfo

update

render

generate

listFilesByName

renderPdfs

updatePageNumberInfo