Создайте файл sidecar.xml, содержащий пути к исходным файлам. Этот файл должен иметь имя sidecar.xml.
Последнее обновление
21 мая 2021 г.
Есть два основных способа импорта статей.
Импорт статей из папки. При использовании данного способа выберите «Импорт одной статьи» или «Импорт нескольких статей» в диалоговом окне «Импорт статьи», а затем укажите папку с исходными файлами. При использовании этого способа папки должны быть структурированы, а имена файлов должны соответствовать определенным правилам. При выборе варианта «Импорт нескольких статей» можно также указать файл sidecar.xml, содержащий метаданные статей; классический файл sidecar.xml должен находиться на том же уровне, что и подпапки со статьями. Сведения об импорте статей этим способом см. в разделе Структурирование папок для импорта статей.
Импорт статей, указанных в файле sidecar.xml. Выберите в диалоговом окне «Импорт статьи» вариант «Импорт с использованием sidecar.xml» и укажите файл sidecar.xml, содержащий полные пути к исходным файлам. Этот параметр особенно полезен для импорта документов InDesign с альтернативными макетами и для импорта файлов из разных мест. Этот способ подходит только для InDesign CS6 и более поздних версий.
Примечание.
При использовании варианта «Импорт с использованием sidecar.xml» нельзя выбрать классический файл sidecar.xml для импорта документов. Необходимо использовать файл sidecar.xml, содержащий полные пути к файлам.
Образец файла sidecar.xml, содержащего пути к файлам
Ниже приводится пример файла sidecar.xml, содержащего пути к файлам, для фолио с двойной ориентацией. Этот пример содержит три разных типа статей: статью InDesign с альтернативными макетами, пару документов InDesign с горизонтальной и вертикальной ориентацией (с суффиксами _h и _v) и статью HTML.
К сожалению, инструмент для создания файла sidecar.xml не поддерживает новый формат с путями к файлам. Рекомендуем загрузить образец файла sidecar.xml и редактировать его у себя. Добавляйте и удаляйте элементы.
Загрузить
Создание файла sidecar.xml, содержащего пути к файлам
Записи в файле sidecar.xml, содержащем пути к файлам, включают элементы <contentSource>, определяющие местоположение исходных файлов. Для импорта статей InDesign необходимо указать местоположение и ориентацию исходных файлов. Для импорта статей HTML необходимо указать папку, содержащую ресурсы HTML.
Каждый раздел <entry> определяет местоположение и метаданные статьи.
Информация о полных путях к файлам (InDesign)
В разделе <contentSource> указываются тип и местоположение исходных файлов статьи.
В разделе <sourceFormat> можно использовать значение indd для исходных файлов InDesign и html для исходных файлов HTML.
В разделе <customTocIcon> можно указать полный путь к файлу с изображением оглавления. Если требуется создать изображение оглавления автоматически, опустите этот элемент или не вводите никакого значения. Используйте элемент <customTocIcon> только для файлов InDesign, но не для файлов HTML. Для файлов HTML можно просто поместить файл PNG с изображением оглавления в целевой папке на том же уровне, что и файл HTML.
Создайте разделы <sourceFile_v> для статей фолио с вертикальной ориентацией и <sourceFile_h> для статей фолио с горизонтальной ориентацией, а для фолио с двойной ориентацией создайте оба раздела. Укажите полный путь к файлу InDesign в элементе <location>. Для документов с альтернативными макетами укажите имя макета (например, iPad V) в элементе <layoutName>, когда он появится на панели InDesign Pages (Страницы InDesign).
Элемент <layoutName> требуется только для документов InDesign с альтернативными макетами.
Допустимые форматы полного пути к файлу:
(Mac OS) /Users/johndoe/Documents/black box.indd
(Windows) C:\Users\johndoe\Documents\black box.indd
Примечание.
При использовании Mac OS рекомендуемый способ копирования пути к файлу — нажать правой кнопкой мыши файл, выбрать Get Info (Получить информацию) и скопировать путь на информационной панели. Вставьте путь к файлу, а затем введите или вставьте имя файла в конце пути. При использовании Windows сделайте следующее: удерживая клавишу Shift, нажмите правой кнопкой мыши файл в Проводнике и выберите Copy as path (Копировать как путь).
Информация о полном пути к файлу (HTML)
При импорте статьи HTML укажите путь к папке в элементе <sourceFolder>. Эта папка должна содержать файл .html, файл .png с изображением оглавления (необязательно) и другие ресурсы HTML в подпапках. Использование суффиксов _v и _h в именах файлов HTML требуется только в том случае, если нужно отображать разный контент HTML в горизонтальном и вертикальном макетах. Например, можно добавить файлы index_v.html и index_h.html в той же папке.
Дополнительные элементы
Допустимые значения для параметров <isAd>, <isFlattenedStack> и <isTrustedContent> — true и false. Значение параметра <isFlattenedStack> определяет, будет ли включен параметр «Только горизонтальное перелистывание», а значение параметра <isTrustedContent> — будет ли выбран параметр «Разрешить доступ к информации о правах» для статьи HTML.
Допустимые значения для параметра <smoothScrolling> — «always», «portrait», «landscape» и «never». По умолчанию параметр имеет значение «never» (прокрутка привязана к странице).
Допустимые значения для параметра <articleAccess> — «free», «metered» и «protected».
Для метаданных Byline можно использовать <byline> или <author>.
В элементах <section> введите строку символов, например Lifestyle.
Порядок разделов <entry> определяет порядок статей в фолио при его создании или обновлении. Порядок элементов в каждом разделе <entry> не имеет значения.
Импорт статей с помощью файла sidecar.xml, содержащего пути к файлам
-
-
В меню палитры Folio Builder выберите «Импорт статьи».
-
Выберите «Импорт с использованием sidecar.xml», укажите файл sidecar.xml, содержащий полные пути к исходным файлам, и нажмите «OK».
Примечание.
Если вы создаете несколько фолио на основе одного и того же набора документов с альтернативными макетами, один из способов — создать файл sidecar.xml, скопировать его в разные папки, а затем внести изменения в значения параметра <layoutName> скопированных экземпляров файла sidecar.xml.
Расшифровка сообщений об ошибке, связанных с файлом sidecar.xml
Недопустимый элемент contentSource в файле sidecar.xml
Это сообщение об ошибке появляется в следующих ситуациях.
- Исходные файлы недоступны или не могут быть открыты.
- Полный путь к файлу содержит недопустимые символы. Например, если использовать терминальную программу для копирования полного пути к файлу, то перед каждым пробелом появится обратная косая черта (\). Удалите эти обратные косые черты.
- В статье формата HTML был указан элемент <customTocIcon>.
Для импорта с использованием sidecar.xml элемент folderName недопустим.
При использовании варианта «Импорт с использованием sidecar.xml» был указан классический файл sidecar.xml вместо файла, содержащего полные пути к файлам. Укажите файл sidecar.xml, содержащий пути к файлам, либо воспользуйтесь вариантом «Импорт нескольких статей», как описано в разделе Структурирование папок для импорта статей.
Для импорта множества статей элемент contentSource в sidecar.xml недопустим.
Эта ошибка означает, что был выбран вариант «Импорт нескольких статей» для импорта папки фолио, в которой находится файл sidecar.xml, содержащий полные пути к файлам. Либо используйте вариант «Импорт нескольких статей» и классический файл sidecar.xml, либо выберите «Импорт с использованием sidecar.xml» и укажите файл sidecar.xml, содержащий полные пути к файлам.
В соответствующем документе InDesign не был найден макет книжной или альбомной ориентации для этой статьи
Элемент <layoutName> содержит недопустимое значение. Откройте документ InDesign и проверьте имя макета на панели Pages, а затем внесите изменения в файл sidecar.xml.
Использование файлов sidecar.xml, содержащих полные пути к файлам, для обновления метаданных
Можно включить элемент <metadataUpdateOnly/> как дочерний узел элемента <sidecar>, чтобы указать, что не нужно создавать новые статьи. Если элемент <metadataUpdateOnly/> присутствует, то при импорте файла sidecar.xml будут обновлены метаданные существующих статей (согласно значениям <articleName>).
Если определен элемент <metadataUpdateOnly/>, то элементы <sourceFile_v>, <sourceFile_h> и <sourceFolder> являются необязательными и игнорируются в случае их присутствия.
Чтобы обновить метаданные в существующих статьях, внесите изменения в файл sidecar.xml, вставьте элемент <metadataUpdateOnly/> сразу после элемента <sidecar>, а затем импортируйте файл sidecar.xml, выбрав вариант «Импорт с использованием sidecar.xml» в диалоговом окне «Импорт статьи».
