Crie um arquivo sidecar.xml que inclua nomes de caminho para arquivos de origem. Esse arquivo deve ser nomeado como “sidecar.xml”.
Há dois métodos principais para a importação de artigos:
Importar artigos de uma pasta — ao usar este método, você especifica “Importar um único artigo” ou “Importar vários artigos” na caixa de diálogo Importar artigo e aponta para uma pasta que contém os arquivos de origem. Com este método, os nomes de arquivo e pastas estruturados corretamente são essenciais. Ao selecionar “Importar vários artigos”, a especificação de um arquivo sidecar.xml que inclua os metadados do artigo é opcional; o arquivo clássico sidecar.xml precisa estar no mesmo nível das subpastas do artigo. Para obter mais informações sobre como importar arquivos usando esse método, consulte Estruturar pastas para importar artigos.
Importar artigos especificados em sidecar.xml — ao selecionar “Importar usando o sidecar.xml” na caixa de diálogo Importar artigo, especifique um arquivo sidecar.xml que inclua nomes de caminho para arquivos. Essa opção é especialmente útil para importar documentos do InDesign com layouts alternativos ou importar arquivos de locais diferentes. Este método funciona apenas para InDesign CS6 e posterior.
ao usar “Importar usando o sidecar.xml”, você não pode selecionar o arquivo clássico sidecar.xml para importar documentos. Use o formato sidecar.xml que inclua nomes de caminho para seus arquivos.
Amostra de arquivo sidecar.xml baseado em caminho
Veja um exemplo de um arquivo sidecar.xml baseado em caminho para um fólio de orientação dupla. Este exemplo inclui três tipos diferentes de artigos: um artigo do InDesign com layouts alternativos, um par de documentos do InDesign _h e _v, e um artigo HTML.
Infelizmente, a ferramenta gerador sidecar.xml não oferece suporte à criação do novo formato de arquivo sidecar.xml baseado em caminho. É recomendável que você baixe e edite o arquivo sidecar.xml de amostra. Adicione e remova elementos conforme necessário.
Download
Configurar o arquivo sidecar.xml baseado em caminho
As entradas no arquivo sidecar.xml baseado em caminho incluem elementos <contentSource> que definem o local dos arquivos de origem. Para artigos do InDesign, especifique o local e o layout dos arquivos de origem. Para artigos HTML, especifique a pasta que contém os ativos HTML.
Cada seção <entry> define o local e os metadados de um artigo.
Informações sobre nome de caminho (InDesign)
A seção <contentSource> é o local onde você especifica o tipo e o local dos arquivos de origem do artigo.
Para <sourceFormat>, os valores válidos incluem “indd” para arquivos de origem do InDesign e “html” para arquivos de origem HTML.
Para <customTocIcon>, especifique o nome de caminho do arquivo de imagem TOC, se desejar. Se você quiser que a imagem TOC seja gerada, omita esse elemento ou não inclua um valor. Use o elemento <customTocIcon> somente para arquivos do InDesign, e não para arquivos HTML. Para arquivos HTML, basta incluir somente o arquivo TOC .png na pasta de destino no mesmo nível do arquivo .html.
Crie seções <sourceFile_v> para artigos em fólios somente verticais, seções <sourceFile_h> para artigos em fólios somente horizontais ou ambas as seções para fólios de orientação dupla. Especifique o nome de caminho do arquivo do InDesign no elemento <location>. Para documentos com layouts alternativos, especifique o nome do layout (como “iPad V”) no elemento <layoutName> como ele aparece no painel Páginas do InDesign.
O elemento <layoutName> é necessário somente para documentos do InDesign com layouts alternativos.
Formatos válidos de nome de caminho:
(Mac OS) /Users/johndoe/Documents/black box.indd
(Windows) C:\Users\johndoe\Documents\black box.indd
No Mac OS, a opção recomendada para copiar o caminho é clicar com o botão direito do mouse no arquivo, escolher Obter informações e copiar o caminho para o painel Informações. Cole o nome de caminho e digite ou cole o nome de arquivo no fim do caminho. No Windows, mantenha pressionada a tecla Shift, clique com o botão direito do mouse no arquivo no Explorer e escolha Copiar como caminho.
Informações sobre nome de caminho (HTML)
Ao importar um artigo HTML, especifique o caminho da pasta no elemento <sourceFolder>. A pasta especificada deve incluir um arquivo .html, um arquivo TOC .png opcional e outros ativos HTML nas subpastas. O uso dos sufixos _v e _h em nomes de arquivo HTML será necessário somente se você quiser exibir um conteúdo HTML diferente em layouts horizontais e verticais. Por exemplo, você pode adicionar arquivos “index_v.html” e “index_h.html ” na mesma pasta.
Elementos adicionais
Os valores válidos para <isAd>, <isFlattenedStack> e <isTrustedContent> são “true” e “false”. O valor <isFlattenedStack> determina se a opção Troca horizontal somente está ativada, enquanto o valor <isTrustedContent> determina se a opção “Permitir acesso a informações de qualificação” está selecionada para um artigo HTML.
Os valores válidos para <smoothScrolling> incluem “always”, “portrait”, “landscape” e “never”. O padrão é “never”, o que significa que a rolagem se ajusta às páginas.
Os valores válidos de <articleAccess> são "gratuito", "medido" e "protegido".
É possível usar <byline> ou <author> para os metadados da Linha de identificação.
Para entradas <section>, especifique uma string de caracteres, como “Estilo de vida”.
A ordem das seções <entry> determina a ordem dos artigos no fólio quando você cria o fólio ou quando o atualiza. A ordem dos elementos dentro de cada <entry> não tem importância.
Importar artigos usando arquivos sidecar.xml baseados em caminho
-
-
No painel Folio Builder, escolha Importar artigo no menu do painel.
-
Selecione Importar usando o sidecar.xml, especifique o arquivo sidecar.xml baseado em caminho e escolha OK.
Se você estiver criando fólios com base no mesmo conjunto de documentos com layouts alternativos, uma abordagem recomendável é criar um arquivo sidecar.xml, copiá-lo para diferentes pastas e editar os valores <layoutName> do arquivo sidecar.xml copiado.
Resolver mensagens de erro do sidecar.xml
Elemento contentSource inválido em sidecar.xml
Esta mensagem de erro será exibida nas seguintes situações:
- Os arquivos de origem especificados não estão disponíveis ou não podem ser abertos corretamente.
- O nome de caminho contém um ou mais caracteres inválidos. Por exemplo, se você usar Terminal para copiar o nome de caminho, os espaços no nome de caminho serão precedidos por uma barra invertida (\). Remova as barras invertidas.
- Você especificou um elemento <customTocIcon> em um formato de artigo HTML.
Em Importar usando o sidecar.xml, o elemento folderName é inválido
Você especificou um arquivo sidecar.xml clássico, em vez de um arquivo sidecar.xml baseado em caminho, ao usar a opção “Importar usando o sidecar.xml”. Especifique um arquivo sidecar.xml baseado em caminho ou use a opção Importar vários artigos como descrito em Estruturar pastas para importar artigos.
Em Importar vários artigos, contentSource é inválido em sidecar.xml
Se esta mensagem de erro for exibida, você selecionou Importar vários artigos para importar uma pasta de fólio que contém um arquivo sidecar.xml baseado em caminho. Use um arquivo sidecar.xml clássico com a opção Importar vários artigos ou selecione “Importar usando o sidecar.xml” e especifique o arquivo sidecar.xml baseado em caminho.
O layout vertical/horizontal deste artigo não foi encontrado no documento do InDesign associado
O valor especificado para <layoutName> não é válido. Abra o documento do InDesign, verifique o nome do layout no painel Páginas e edite o arquivo sidecar.xml.
Usar arquivos sidecar.xml baseados em caminho para atualizar metadados
Você pode incluir o elemento <metadataUpdateOnly/> como um filho imediato do elemento <sidecar> para indicar que novos artigos não serão criados. Se o elemento <metadataUpdateOnly/> estiver presente, a importação do arquivo sidecar.xml atualizará os metadados dos artigos existentes (conforme identificado pelos valores <articleName>).
Quando <metadataUpdateOnly/> for especificado, os elementos <sourceFile_v>, <sourceFile_h> e <sourceFolder> serão opcionais, e serão ignorados se estiverem presentes.
Para atualizar metadados em artigos existentes, edite o arquivo sidecar.xml, insira o elemento <metadataUpdateOnly/> imediatamente após o elemento <sidecar> e importe o arquivo sidecar.xml usando a opção “Importar usando o sidecar.xml” na caixa de diálogo Importar artigo.