Home ru

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

Вики docxi: создание документов Word (.docx) на Ruby

docxi — это Ruby-гем, который создаёт файлы Microsoft Word .docx из кода. Он поддерживает абзацы, форматированный текст, таблицы, изображения, верхние и нижние колонтитулы, номера страниц, гиперссылки и простое оглавление. Ему не нужны Microsoft Word, LibreOffice или шаблон, и он работает как в обычном Ruby, так и в приложениях на Ruby on Rails.

README — это краткое введение. Эта вики описывает все параметры, содержит готовые рецепты для копирования, объясняет внутреннее устройство docxi и помогает, когда что-то идёт не так.

Текущая версия: 0.1.1, для Ruby 2.5 и новее. См. журнал изменений.

С чего начать

Если вы впервые используете docxi

• Начало работы: установите гем и создайте первый документ
• Установка: требования, Bundler и обновление с 0.0.x
• Примеры использования: отчёты, счета, письма и таблицы из данных, готовые к копированию

Создание документов

• Возможности: все элементы и их параметры
• Настройка: поля страницы, параметры страницы и единицы измерения
• Справочник API: классы и методы в одном месте
• Рекомендации: привычки, которые избавляют от типичных сюрпризов

Если что-то пошло не так

• Устранение неполадок: сообщения об ошибках и документы, которые выглядят неправильно
• Частые вопросы: короткие ответы на распространённые вопросы
• Безопасность: как сообщить о проблеме и как обращаться с недоверенными данными

Подробнее

• Архитектура: как вызовы Ruby превращаются в пакет .docx
• Интеграции: контроллеры Rails, приложения Rack и фоновые задачи
• Развёртывание: docxi в продакшене и порядок публикации версий
• Участие в разработке и Среда разработки
• Планы, Журнал изменений и Благодарности

Что docxi умеет и чего не умеет

docxi создаёт новые документы. Он не может открыть или изменить существующий .docx, заполнить шаблон Word или выполнить слияние. В нём нет нумерованных списков, стилей заголовков и автоматического оглавления, а страницы всегда имеют формат US Letter в книжной ориентации. Известные проблемы, которые планируется исправить в 0.2.0, перечислены в разделе Планы.

Благодарности

Сопровождением docxi занимается Hammad Maqbool в Phaedra Solutions. Проект появился в 2016 году на основе docxer — гема, автор которого Timur Gabdrakipov. Подробности — на странице Благодарности.

Языки

Эталонной версией этой вики является английская. Ссылки на переводы есть на боковой панели и в начале каждой страницы.

---

README · RubyGems · Сообщить о проблеме