FAQ ru

English · 简体中文 · 繁體中文 · Español · العربية · Français · Português (Brasil) · Deutsch · हिन्दी · 日本語 · 한국어 · Русский · Bahasa Indonesia · Türkçe · Italiano · Tiếng Việt

Частые вопросы о docxi: документы Word в Ruby и Rails

Короткие ответы на самые частые вопросы. Каждый ответ ссылается на более подробное объяснение.

Нужно ли устанавливать Microsoft Word или LibreOffice? Нет. docxi сам записывает XML и zip-архив.

Нужен ли docxi Rails? Нет. Он работает в любой программе на Ruby. Тесты также запускаются с загруженными Rails от 5.2 до 8.1. См. Интеграции.

Как создать документ Word в Ruby on Rails? Соберите его в контроллере или фоновой задаче и отправьте word.render.string через send_data. См. Интеграции.

Какие версии Ruby и Rails поддерживаются? Ruby 2.5 и новее. Rails необязателен, а CI проверяет Rails от 5.2 до 8.1. См. Установка.

Может ли docxi редактировать существующий .docx или заполнять шаблон Word? Нет, он только создаёт новые документы. Для шаблонов с полями слияния используйте гем на основе шаблонов, например sablon.

Строится ли оглавление по заголовкам? Нет. Каждый пункт и номер его страницы вы добавляете сами. См. Возможности.

Можно ли использовать нумерованные списки или стили заголовков? Не в 0.1.0. Абзацы могут быть элементами маркированного списка (ul: true), а заголовки можно оформить параметрами текста, например size: и bold:.

Можно ли изменить размер или ориентацию страницы? Пока нет. Страницы имеют формат US Letter в книжной ориентации, и изменить можно только поля. См. Настройка.

Какие форматы изображений работают? PNG. Каждое изображение сохраняется как часть PNG.

Можно ли добавить изображение по URL? Да. add_media принимает URL http, https и ftp и скачивает их при вызове render. Не передавайте URL от пользователей без проверки. См. Безопасность.

Можно ли записать документ сразу в файл? render возвращает StringIO. Запишите его .string через File.binwrite("out.docx", word.render.string).

Умеет ли docxi выдавать очень большие документы потоком? Нет. Весь документ собирается в памяти при вызове render. См. Развёртывание.

Можно ли задать абзацы с направлением справа налево? В 0.1.0 нет параметров для письма справа налево. Текст записывается так, как вы его передаёте.

Где перечислены известные проблемы? В разделе Планы и в разделе README «Limitations and known issues» (ограничения и известные проблемы).

Связанные страницы

• Устранение неполадок
• Возможности
• Начало работы

---

← Главная вики · README