Files
docx-js/README.md

108 lines
4.4 KiB
Markdown
Raw Normal View History

2017-03-07 23:10:35 +00:00
<p align="center">
2018-09-12 21:19:33 +01:00
<img alt="clippy the assistant" src="https://i.imgur.com/37uBGhO.gif">
2017-03-07 23:10:35 +00:00
</p>
<p align="center">
2018-08-21 22:29:40 +01:00
Easily generate .docx files with JS/TS. Works for Node and on the Browser.
2017-03-07 23:10:35 +00:00
</p>
2017-03-10 11:27:48 +00:00
2018-02-13 02:08:28 +00:00
---
2017-03-07 23:10:35 +00:00
2018-01-23 01:36:27 +00:00
[![NPM version][npm-image]][npm-url]
[![Downloads per month][downloads-image]][downloads-url]
2018-01-23 01:36:27 +00:00
[![Build Status][travis-image]][travis-url]
[![Dependency Status][daviddm-image]][daviddm-url]
2018-01-23 01:36:27 +00:00
[![Known Vulnerabilities][snky-image]][snky-url]
[![Chat on Gitter][gitter-image]][gitter-url]
2018-04-21 00:04:14 +01:00
[![PRs Welcome][pr-image]][pr-url]
2018-10-26 20:22:33 +01:00
[![codecov][codecov-image]][codecov-url]
2017-03-07 23:12:08 +00:00
2018-08-09 03:13:16 +01:00
<p align="center">
2019-12-31 15:49:34 +00:00
<img src="https://i.imgur.com/TCH0YzD.png" alt="drawing" width="800"/>
2018-08-09 03:13:16 +01:00
</p>
2016-07-04 09:03:25 +01:00
2018-08-09 11:51:27 +01:00
# Demo
2018-02-13 02:08:28 +00:00
2018-09-10 22:44:44 +01:00
## Browser
2019-03-05 13:29:36 +00:00
Here are examples of `docx` being used with basic `HTML/JS` in a browser environment:
2018-09-10 22:44:44 +01:00
* https://codepen.io/anon/pen/dqoVgQ
* https://jsfiddle.net/3xhezb5w/2
2018-10-21 05:14:14 +01:00
Here is an example of `docx` working in `Angular`:
* https://stackblitz.com/edit/angular-afvxtz
2018-09-10 22:44:44 +01:00
## Node
2018-02-13 02:07:56 +00:00
Press `endpoint` on the `RunKit` website:
2017-03-12 21:37:36 +00:00
2018-04-10 21:42:21 +01:00
![RunKit Instructions](https://user-images.githubusercontent.com/2917613/38582539-f84311b6-3d07-11e8-90db-5885ae02c3c4.png)
2018-08-04 04:03:08 +01:00
* https://runkit.com/dolanmiu/docx-demo1 - Simple paragraph and text
* https://runkit.com/dolanmiu/docx-demo2 - Advanced Paragraphs and text
* https://runkit.com/dolanmiu/docx-demo3 - Bullet points
* https://runkit.com/dolanmiu/docx-demo4 - Simple table
* https://runkit.com/dolanmiu/docx-demo5 - Images
* https://runkit.com/dolanmiu/docx-demo6 - Margins
* https://runkit.com/dolanmiu/docx-demo7 - Landscape
2018-09-10 22:44:44 +01:00
* https://runkit.com/dolanmiu/docx-demo8 - Header and Footer
2018-08-04 04:03:08 +01:00
* https://runkit.com/dolanmiu/docx-demo10 - **My CV generated with docx**
2018-02-13 02:07:56 +00:00
2018-09-10 22:44:44 +01:00
More [here](https://docx.js.org/#/examples) and [here](https://github.com/dolanmiu/docx/tree/master/demo)
2018-08-09 11:51:27 +01:00
# How to use & Documentation
2017-03-13 00:54:05 +00:00
2018-08-09 11:52:47 +01:00
Please refer to the [documentation at https://docx.js.org/](https://docx.js.org/) for details on how to use this library, examples and much more!
2016-07-04 09:03:25 +01:00
2018-08-09 11:51:27 +01:00
# Examples
2018-02-13 02:08:28 +00:00
2018-08-09 03:13:16 +01:00
Check the `examples` section in the [documentation](https://docx.js.org/#/examples) and the [demo folder](https://github.com/dolanmiu/docx/tree/master/demo) for examples.
2016-07-04 09:03:25 +01:00
2018-08-09 11:51:27 +01:00
# Contributing
2018-08-04 04:03:08 +01:00
Read the contribution guidelines [here](https://docx.js.org/#/contribution-guidelines).
2018-12-05 20:11:46 +00:00
# Used by
2019-08-08 01:55:48 +01:00
[<img src="https://i.imgur.com/zy5qWmI.png" alt="drawing" height="50"/>](https://hfour.com/)
[<img src="https://i.imgur.com/OYP5tgS.png" alt="drawing" height="50"/>](https://fuzzproductions.com/)
[<img src="https://i.imgur.com/zUDMfZ3.png" alt="drawing" height="50"/>](https://www.mettzer.com/)
[<img src="https://i.imgur.com/wtNB1uq.png" alt="drawing" height="50"/>](https://www.wisedoc.net/)
[<img src="https://i.imgur.com/suiH2zc.png" alt="drawing" height="50"/>](https://www.dabblewriter.com/)
[<img src="https://i.imgur.com/1LjuK2M.png" alt="drawing" height="50"/>](https://turbopatent.com/)
[<img src="https://i.imgur.com/dHMg0wF.gif" alt="drawing" height="50"/>](http://www.madisoncres.com/)
2019-11-23 01:21:25 +00:00
[<img src="https://i.imgur.com/QEZXU5b.png" alt="drawing" height="50"/>](https://www.beekast.com/)
[<img src="https://imgur.com/XVU6aoi.png" alt="drawing" height="50"/>](https://herraizsoto.com/)
2018-12-05 20:11:46 +00:00
2019-08-08 01:56:31 +01:00
...and many more!
2018-02-13 02:08:28 +00:00
---
2017-03-10 11:27:48 +00:00
2019-01-16 13:26:26 +00:00
[![patreon][patreon-image]][patreon-url]
2019-03-12 20:26:39 +00:00
[![browserstack][browserstack-image]][browserstack-url]
2019-01-16 13:26:26 +00:00
2017-03-11 16:05:20 +00:00
Made with 💖
2017-03-10 11:27:48 +00:00
2016-07-19 19:02:44 +01:00
[npm-image]: https://badge.fury.io/js/docx.svg
[npm-url]: https://npmjs.org/package/docx
[downloads-image]: https://img.shields.io/npm/dm/docx.svg
[downloads-url]: https://npmjs.org/package/docx
2016-07-19 19:02:44 +01:00
[travis-image]: https://travis-ci.org/dolanmiu/docx.svg?branch=master
2016-07-19 18:32:41 +01:00
[travis-url]: https://travis-ci.org/dolanmiu/docx
2016-07-19 19:02:44 +01:00
[daviddm-image]: https://david-dm.org/dolanmiu/docx.svg?theme=shields.io
[daviddm-url]: https://david-dm.org/dolanmiu/docx
[snky-image]: https://snyk.io/test/github/dolanmiu/docx/badge.svg
2017-03-10 11:24:41 +00:00
[snky-url]: https://snyk.io/test/github/dolanmiu/docx
2017-03-13 12:30:22 +00:00
[gitter-image]: https://badges.gitter.im/dolanmiu/docx.svg
[gitter-url]: https://gitter.im/docx-lib/Lobby
2018-04-21 00:04:14 +01:00
[pr-image]: https://img.shields.io/badge/PRs-welcome-brightgreen.svg
[pr-url]: http://makeapullrequest.com
2018-10-26 20:22:33 +01:00
[codecov-image]: https://codecov.io/gh/dolanmiu/docx/branch/master/graph/badge.svg
[codecov-url]: https://codecov.io/gh/dolanmiu/docx
2019-01-16 13:26:26 +00:00
[patreon-image]: https://user-images.githubusercontent.com/2917613/51251459-4e880480-1991-11e9-92bf-38b96675a9e2.png
[patreon-url]: https://www.patreon.com/dolanmiu
2019-03-12 20:26:39 +00:00
[browserstack-image]: https://user-images.githubusercontent.com/2917613/54233552-128e9d00-4505-11e9-88fb-025a4e04007c.png
[browserstack-url]: https://www.browserstack.com