https://github.com/cxn03651/write_xlsx

Rubygem for create excel xlsx file
https://github.com/cxn03651/write_xlsx

Last synced: 3 months ago
JSON representation

Rubygem for create excel xlsx file

• Host: GitHub
• URL: https://github.com/cxn03651/write_xlsx
• Owner: cxn03651
• License: mit
• Created: 2011-12-10T03:28:20.000Z (about 13 years ago)
• Default Branch: main
• Last Pushed: 2024-04-12T18:08:30.000Z (10 months ago)
• Last Synced: 2024-04-14T02:42:30.271Z (10 months ago)
• Language: Ruby
• Homepage: http://cxn03651.github.io/write_xlsx/
• Size: 13.6 MB
• Stars: 280
• Watchers: 10
• Forks: 63
• Open Issues: 44
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-ruby-toolbox - write_xlsx - write_xlsx is a gem to create a new file in the Excel 2007+ XLSX format. (Documents & Reports / Reports & Spreadsheets)

README

        
# write_xlsx

[![Gem Version](https://badge.fury.io/rb/write_xlsx.png)](http://badge.fury.io/rb/write_xlsx)

[![Build Status](https://travis-ci.org/cxn03651/write_xlsx.svg?branch=master)](https://travis-ci.org/cxn03651/write_xlsx)

gem to create a new file in the Excel 2007+ XLSX format, and you can use the

same interface as writeexcel gem. write_xlsx is converted from Perl's module

[Excel::Writer::XLSX](https://github.com/jmcnamara/excel-writer-xlsx)

## Description

Reference doc : https://cxn03651.github.io/write_xlsx/

The WriteXLSX supports the following features:

* Multiple worksheets

* Strings and numbers

* Unicode text

* Cell formatting

* Formulas (including array formats)

* Images

* Charts

* Autofilters

* Data validation

* Conditional formatting

* Macros

* Tables

* Shapes

* Sparklines

* Hyperlinks

* Rich string formats

* Defined names

* Grouping/Outlines

* Cell comments

* Panes

* Page set-up and printing options

write_xlsx uses the same interface as writeexcel gem.

## Installation

Add this line to your application's Gemfile:

    gem 'write_xlsx'

And then execute:

    $ bundle

Or install it yourself as:

    $ gem install write_xlsx

## Synopsis

To write a string, a formatted string, a number and a formula to

the first worksheet in an Excel XML spreadsheet called ruby.xlsx:

    require 'rubygems'

    require 'write_xlsx'

    # Create a new Excel workbook

    workbook = WriteXLSX.new('ruby.xlsx')

    # Add a worksheet

    worksheet = workbook.add_worksheet

    # Add and define a format

    format = workbook.add_format # Add a format

    format.set_bold

    format.set_color('red')

    format.set_align('center')

    # Write a formatted and unformatted string, row and column notation.

    col = row = 0

    worksheet.write(row, col, "Hi Excel!", format)

    worksheet.write(1,   col, "Hi Excel!")

    # Write a number and a formula using A1 notation

    worksheet.write('A3', 1.2345)

    worksheet.write('A4', '=SIN(PI()/4)')

    workbook.close

## Copyright

Original Perl module was written by John McNamara([email protected]).

Converted to ruby by Hideo NAKAMURA([email protected])

Copyright (c) 2012-2024 Hideo NAKAMURA.

See LICENSE.txt for further details.

## Contributing to write_xlsx

* repsitory: https://github.com/cxn03651/write_xlsx

* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet

* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it

* Fork the project

* Start a feature/bugfix branch

* Commit and push until you are happy with your contribution

* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.

* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.