Metadados do livro

O título, o autor e o idioma de um livro são gravados no arquivo, e cada formato tem um lugar diferente para eles, ou nenhum. Metadados do livro, nas Opções avançadas de conversão, reúne Título do ComicInfo, Idioma do EPUB e Manter o ComicInfo.xml. O título, o autor e o idioma de cada livro são definidos por item, na ação de detalhes do livro na fila, como descrito em Adicionando mangás, e Nomear o livro como .epub fica junto do dispositivo. Esta página lê de volta cada um deles de um livro de verdade.

Os exemplos convertem três páginas de Pepper&Carrot, episódio 6, guardadas numa pasta chamada Pepper and Carrot 06, para um EPUB do Kindle Paperwhite 6, a menos que a linha diga outra coisa. Pepper&Carrot não tem ComicInfo.xml, então a pasta recebeu um, escrito para os exemplos, com o título, o número da série e o autor do próprio quadrinho:

<ComicInfo>
  <Title>The Potion Contest</Title>
  <Series>Pepper&amp;Carrot</Series>
  <Number>6</Number>
  <Volume>1</Volume>
  <Writer>David Revoy</Writer>
  <LanguageISO>en</LanguageISO>
</ComicInfo>

Onde cada formato guarda

As três linhas foram convertidas com o mesmo título, autor e idioma: --title, --author e --language.

Medido com o mangaprep 0.9.0: cada valor é lido de volta do livro que ele gravou.

Opção	No terminal	Título do livro	Autor	Idioma
EPUB	--title "Pepper & Carrot 6" --author "D. Revoy" --language ja	Pepper & Carrot 6	D. Revoy	ja
PDF	--title "Pepper & Carrot 6" --author "D. Revoy" --language ja	Pepper & Carrot 6	D. Revoy	não consta do livro
CBZ	--title "Pepper & Carrot 6" --author "D. Revoy" --language ja	não consta do livro	não consta do livro	não consta do livro

• Um EPUB guarda os três no arquivo de pacote.
• Um PDF guarda o título e o autor nas propriedades do documento, e o mangaprep não grava idioma nele.
• Um CBZ feito pelo mangaprep contém só as páginas, e um ComicInfo.xml quando você pede, como abaixo. O título, o autor e o idioma não estão nele, então o livro é conhecido pelo nome do arquivo.

Título e autor do livro

Sem eles, o título é montado a partir do ComicInfo.xml quando a entrada tem um, e é o nome da entrada quando não tem. O autor é o Writer do ComicInfo.xml, ou Unknown. --title e --author os substituem, e -t e -a são as formas curtas.

Medido com o mangaprep 0.9.0: cada valor é lido de volta do livro que ele gravou.

Opção	No terminal	Título do livro	Autor
Nada informado, e sem ComicInfo.xml	sem flag	Pepper and Carrot 06	Unknown
Nada informado, com um ComicInfo.xml	sem flag	Pepper&Carrot Vol. 01 #006	David Revoy
Título informado	--title "Pepper & Carrot 6"	Pepper & Carrot 6	David Revoy
Autor informado	--author "D. Revoy"	Pepper&Carrot Vol. 01 #006	D. Revoy
Os dois informados	--title "Pepper & Carrot 6" --author "D. Revoy"	Pepper & Carrot 6	D. Revoy

No app, o título e o autor de um livro vêm de Título da série ou Título do livro e de Autor nos seus detalhes. --title e --author só chegam a um EPUB ou a um PDF; num CBZ não mudam nada.

Título do ComicInfo

Qual título um ComicInfo.xml dá é a escolha de Título do ComicInfo. O padrão o monta a partir da série, do volume e do número; Acrescentar o título do ComicInfo acrescenta o Title do próprio ComicInfo depois dele; Usar só o título do ComicInfo usa esse Title sozinho, e então nem um título que você der é usado. --metadatatitle aceita series-only, combine ou title-only.

Medido com o mangaprep 0.9.0: cada valor é lido de volta do livro que ele gravou.

Opção	No terminal	Título do livro
Título do ComicInfo: Usar série, volume e número	--metadatatitle series-only	Pepper&Carrot Vol. 01 #006
Título do ComicInfo: Acrescentar o título do ComicInfo	--metadatatitle combine	Pepper&Carrot Vol. 01 #006: The Potion Contest
Título do ComicInfo: Usar só o título do ComicInfo	--metadatatitle title-only	The Potion Contest
Um título informado, com Usar série, volume e número	--title "Pepper & Carrot 6" --metadatatitle series-only	Pepper & Carrot 6
Um título informado, com Acrescentar o título do ComicInfo	--title "Pepper & Carrot 6" --metadatatitle combine	Pepper & Carrot 6
Um título informado, com Usar só o título do ComicInfo	--title "Pepper & Carrot 6" --metadatatitle title-only	The Potion Contest
Usar só o título do ComicInfo, e sem ComicInfo.xml	--metadatatitle title-only	Pepper and Carrot 06

Sem ComicInfo.xml na entrada não há título a aplicar, e a última linha é o nome da entrada. Um título que você dá vence em todas as linhas menos uma: Usar só o título do ComicInfo, porque é para isso que ela serve.

Manter o ComicInfo.xml

Um CBZ feito pelo mangaprep não tem ComicInfo.xml, a menos que isto esteja ligado. Com --keepcomicinfo, o da entrada é copiado como está, sem ser reescrito, mesmo quando você dá um título e um autor. Uma entrada sem ele não ganha nenhum. A opção vale para um CBZ e para mais nada, e o app a esmaece para um EPUB e um PDF; as duas últimas linhas dão a flag mesmo assim, para mostrar que ela não acrescenta nada a eles.

Medido com o mangaprep 0.9.0: cada valor é lido de volta do livro que ele gravou.

Opção	No terminal	ComicInfo.xml no livro
CBZ, Manter o ComicInfo.xml: Off	sem flag	não
CBZ, Manter o ComicInfo.xml: On	--keepcomicinfo	sim, a da entrada, sem mudança
CBZ, Manter o ComicInfo.xml: On, com um título e um autor informados	--keepcomicinfo --title "Pepper & Carrot 6" --author "D. Revoy"	sim, a da entrada, sem mudança
CBZ, Manter o ComicInfo.xml: On, e sem ComicInfo.xml na entrada	--keepcomicinfo	não
EPUB, Manter o ComicInfo.xml: On	--keepcomicinfo	não
PDF, Manter o ComicInfo.xml: On	--keepcomicinfo	não

Idioma do EPUB

O idioma é gravado no arquivo de pacote do EPUB, e en-US é usado quando nenhum é dado. Um CBZ e um PDF não recebem idioma, como a primeira tabela mostrou. --language recebe o código do idioma.

Medido com o mangaprep 0.9.0: cada valor é lido de volta do livro que ele gravou.

Opção	No terminal	Idioma
Idioma do EPUB: não informado	sem flag	en-US
Idioma do EPUB: ja	--language ja	ja
Idioma do EPUB: pt-BR	--language pt-BR	pt-BR
PDF, com ja	--language ja	não consta do livro
CBZ, com ja	--language ja	não consta do livro

A configuração pede um código que não esteja vazio, e os detalhes de um livro indicam o idioma na forma pt-BR; um livro cujos detalhes indicam um idioma usa esse, e não o da configuração. Veja Adicionando mangás.

Nomear o livro como .epub

O leitor próprio de um Kobo procura o nome .kepub.epub, então o mangaprep dá esse nome ao EPUB que faz para um perfil Kobo, quando monta o nome a partir da entrada. Nomear o livro como .epub, --nokepub, mantém o .epub simples. Só o nome muda: o livro por dentro é o mesmo arquivo. Um tamanho de tela personalizado faz o mangaprep deixar de tratar o dispositivo como um Kobo, um livro para qualquer outro dispositivo já se chama .epub, e um CBZ é sempre .cbz.

Medido com o mangaprep 0.9.0: cada valor é lido de volta do livro que ele gravou.

Opção	No terminal	Nome do arquivo
Kobo Libra Colour, EPUB	sem flag	Pepper and Carrot 06.kepub.epub
Kobo Libra Colour, EPUB, Nomear o livro como .epub: On	--nokepub	Pepper and Carrot 06.epub
Kobo Libra Colour, EPUB, com um Largura personalizada	--customwidth 1000	Pepper and Carrot 06.epub
Kobo Libra Colour, CBZ	sem flag	Pepper and Carrot 06.cbz
Kindle Paperwhite 6, EPUB	sem flag	Pepper and Carrot 06.epub