Home pt BR

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

Wiki do docxi: gere documentos do Word (.docx) com Ruby

O docxi é uma gem Ruby que gera arquivos .docx do Microsoft Word a partir de código. Ele oferece parágrafos, texto formatado, tabelas, imagens, cabeçalhos e rodapés, números de página, hiperlinks e um sumário simples. Não precisa do Microsoft Word, do LibreOffice nem de um modelo, e funciona tanto em Ruby puro quanto em aplicações Ruby on Rails.

O README é a introdução curta. Esta wiki cobre todas as opções, traz receitas prontas para copiar, explica como o docxi funciona por dentro e ajuda quando algo dá errado.

Versão atual: 0.1.1, para Ruby 2.5 ou mais recente. Consulte o registro de alterações.

Comece por aqui

Primeiro contato com o docxi

• Primeiros passos: instale a gem e crie seu primeiro documento
• Instalação: requisitos, Bundler e atualização a partir da 0.0.x
• Exemplos de uso: relatórios, faturas, cartas e tabelas geradas a partir de dados, prontos para copiar

Criando documentos

• Recursos: cada elemento e as opções que ele aceita
• Configuração: margens, configuração de página e unidades
• Referência da API: classes e métodos em resumo
• Boas práticas: hábitos que evitam as surpresas mais comuns

Quando algo dá errado

• Solução de problemas: mensagens de erro e documentos que não aparecem como deveriam
• Perguntas frequentes: respostas curtas para dúvidas comuns
• Segurança: como relatar problemas e lidar com entradas não confiáveis

Para ir além

• Arquitetura: como chamadas Ruby se tornam um pacote .docx
• Integrações: controllers do Rails, aplicações Rack e jobs em segundo plano
• Implantação: o docxi em produção e como as versões são publicadas
• Como contribuir e Ambiente de desenvolvimento
• Roteiro, Registro de alterações e Créditos

O que o docxi faz e o que ele não faz

O docxi cria documentos novos. Ele não abre nem edita um .docx existente, não preenche um modelo do Word e não faz mala direta. Não há listas numeradas, estilos de título nem sumário automático, e as páginas são sempre US Letter em orientação retrato. Os problemas conhecidos previstos para a 0.2.0 estão no roteiro.

Créditos

A manutenção do docxi é feita por Hammad Maqbool, na Phaedra Solutions. O projeto começou em 2016 a partir do docxer, de Timur Gabdrakipov. Veja os Créditos para mais detalhes.

Idiomas

A versão em inglês é a versão de referência desta wiki. As traduções têm links na barra lateral e no topo de cada página.

---

README · RubyGems · Relatar um problema