2017-08-28 20:56:18 -05:00
|
|
|
**gooxml** is a library for creation of OpenOffice documents (.docx, .xlsx and
|
|
|
|
|
.pptx).
|
|
|
|
|
|
|
|
|
|
[](https://travis-ci.org/baliance/gooxml)
|
2017-08-30 19:47:02 -05:00
|
|
|
[](https://godoc.org/baliance.com/gooxml)
|
2017-08-28 20:56:18 -05:00
|
|
|
|
|
|
|
|
## Status ##
|
|
|
|
|
|
|
|
|
|
The current focus is on documents (.docx). Some other code exists for
|
2017-08-28 23:28:38 -05:00
|
|
|
spreadsheets and presentations, but it is even less complete. The current plan
|
2017-08-28 20:56:18 -05:00
|
|
|
is to get documents working well, then spreadsheets, and finally presentations.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## Installation ##
|
|
|
|
|
|
|
|
|
|
go get baliance.com/gooxml/
|
2017-08-29 16:54:24 -05:00
|
|
|
go build baliance.com/gooxml/...
|
2017-08-28 20:56:18 -05:00
|
|
|
|
|
|
|
|
## Raw Types ##
|
|
|
|
|
|
|
|
|
|
The OOXML specification is large and creating a friendly API to cover the entire
|
|
|
|
|
specification is a very time consuming endeavor. This library attempts to
|
|
|
|
|
provide an easy to use API for common use cases in creating OOXML documents
|
|
|
|
|
while allowing users to fall back to raw document manipulation should the
|
|
|
|
|
library's API not cover a specific use case.
|
|
|
|
|
|
|
|
|
|
The raw XML based types reside in the ```schema/``` directory. These types are
|
|
|
|
|
accessible from the wrapper types via a ```X()``` method that returns the raw
|
|
|
|
|
type.
|
|
|
|
|
|
|
|
|
|
For example, the library currently doesn't have an API for setting a document
|
|
|
|
|
background color. However it's easy to do manually via editing the
|
|
|
|
|
```CT_Background``` element of the document.
|
|
|
|
|
|
|
|
|
|
dox := document.New()
|
|
|
|
|
doc.X().Background = wordprocessingml.NewCT_Background()
|
|
|
|
|
doc.X().Background.ColorAttr = &wordprocessingml.ST_HexColor{}
|
|
|
|
|
doc.X().Background.ColorAttr.ST_HexColorRGB = color.RGB(50, 50, 50).AsRGBString()
|
|
|
|
|
|
|
|
|
|
### Contribution guidelines ###
|
|
|
|
|
|
|
|
|
|
[](https://cla-assistant.io/baliance/gooxml)
|
|
|
|
|
|
|
|
|
|
All contributors are must sign a contributor license agreement before their code
|
|
|
|
|
will be reviewed and merged.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
### Licensing ###
|
|
|
|
|
|
|
|
|
|
This library is offered under a dual license. It is freely available for use
|
|
|
|
|
under the terms of AGPLv3. If you would like to use this library for a closed
|
|
|
|
|
source project, please contact sales@baliance.com.
|
|
|
|
|
|
|
|
|
|
There are no differences in functionality between the open source and commercial
|
|
|
|
|
versions. You are encouraged to use the open source version to evaluate the library
|
|
|
|
|
before purchasing a commercial license.
|
|
|
|
|
|
|
|
|
|
### Consulting ###
|
|
|
|
|
|
|
|
|
|
Baliance also offers consulting services related to enhancing the gooxml library
|
2017-08-29 16:54:24 -05:00
|
|
|
on a case by case basis. Please contact consulting@baliance.com if interested.
|
