|
|
|
@@ -0,0 +1,100 @@ |
|
|
|
## What is DocX? |
|
|
|
|
|
|
|
DocX is a .NET library that allows developers to manipulate Word 2007/2010/2013 files, in an easy and intuitive manner. DocX is fast, lightweight and best of all it does not require Microsoft Word or Office to be installed. |
|
|
|
|
|
|
|
DocX is available on [Codeplex](https://docx.codeplex.com/) and [GitHub](https://github.com/WordDocX/DocX). We will try to update both. |
|
|
|
|
|
|
|
## DocX Author |
|
|
|
|
|
|
|
DocX was written by a PhD student **Cathal Coffey** studying at the National University of Ireland Maynooth. |
|
|
|
If you have found DocX useful and would like to buy Cathal lunch then you can do so via a paypal [donation](https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=GHSZDFX6JHS2A&lc=GB&item_name=DocX%20library¤cy_code=EUR&bn=PP%2dDonationsBF%3abtn_donateCC_LG_global%2egif%3aNonHosted). |
|
|
|
|
|
|
|
To connect with Cathal on LinkedIn please follow: http://ie.linkedin.com/in/cathalcoffey |
|
|
|
For Cathal's personal website follow: http://www.cathalcoffey.ie |
|
|
|
|
|
|
|
## DocX Maintenance |
|
|
|
|
|
|
|
Currently the development of DocX is mostly done by great support of community with project being maintained by Przemysław Kłys (MadBoy). |
|
|
|
|
|
|
|
To connect with Przemek on LinkedIn please follow http://www.linkedin.com/in/pklys |
|
|
|
For Przemek own little company website visit [Evotec](http://evotec.pl/) |
|
|
|
|
|
|
|
## Cutting Edge |
|
|
|
|
|
|
|
If you do not wish to wait for the next stable release of DocX.dll, you can build your own copy from the [latest source code](http://docx.codeplex.com/SourceControl/list/changesets#). |
|
|
|
|
|
|
|
## What else do I need? |
|
|
|
|
|
|
|
All that you need to install in order to use DocX is the [.NET framework 4.0](http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9cfb2d51-5ff4-4491-b0e5-b386f32c0992&displaylang=en) and [Visual Studio 2010](http://www.microsoft.com/express/Downloads/) or later, both of which are free. |
|
|
|
|
|
|
|
## What are the main features of DocX? |
|
|
|
|
|
|
|
1. Insert, Remove or [Replace](http://cathalscorner.blogspot.com/2009/02/docx-net-library-for-manipulating-word.html) text in a document. |
|
|
|
All standard [text formatting](http://cathalscorner.blogspot.com/2009/08/docx-v1008-released.html) is available: |
|
|
|
1. Font {Family, Size, Color}, |
|
|
|
2. Bold, |
|
|
|
3. Italic, |
|
|
|
4. Underline, |
|
|
|
5. Strikethrough, |
|
|
|
6. Script {Sub, Super}, |
|
|
|
7. Highlight |
|
|
|
2. Here’s a [cool example](http://cathalscorner.blogspot.com/2010/12/replace-text-across-many-documents-in.html) of replacing text across many documents in Parallel |
|
|
|
3. Paragraph properties are exposed: |
|
|
|
1. Direction LeftToRight or RightToLeft, |
|
|
|
2. Indentation, |
|
|
|
3. Alignment |
|
|
|
4. DocX also supports: |
|
|
|
1. [Pictures](http://cathalscorner.blogspot.com/2009/04/docx-version-1002-released.html), |
|
|
|
2. [Hyperlinks](http://cathalscorner.blogspot.com/2010/06/docx-version-1009.html), |
|
|
|
3. [Tables](http://cathalscorner.blogspot.com/2010/06/docx-and-tables.html), |
|
|
|
4. [Headers & Footers](http://cathalscorner.blogspot.com/2010/06/docx-version-10010.html), |
|
|
|
5. [Custom Properties](http://cathalscorner.blogspot.com/2009/02/docx-net-library-for-manipulating-word.html) |
|
|
|
|
|
|
|
## Why would I use DocX? |
|
|
|
|
|
|
|
DocX makes creating and manipulating documents a simple task. It does not use COM libraries nor does it require Microsoft Office to be installed. |
|
|
|
|
|
|
|
The following [blog post](http://cathalscorner.blogspot.com/2010/06/cathal-why-did-you-create-docx.html) compares the code used to create a HelloWorld document using: |
|
|
|
1. Office Interop libraries, |
|
|
|
2. OOXML SDK, |
|
|
|
3. DocX |
|
|
|
|
|
|
|
## How can I learn more? |
|
|
|
|
|
|
|
I have dedicated a blog to DocX. I regularly post new code examples [here](http://cathalscorner.blogspot.com/). The below videos are also excellent tutorials on how to use DocX. |
|
|
|
|
|
|
|
[<img alt="Getting started" src="http://i3.codeplex.com/download?ProjectName=DocX&DownloadId=83768" />](http://docx.codeplex.com/Release/ProjectReleases.aspx?ReleaseId=32117#DownloadId=83636) |
|
|
|
[<img alt="Paragraphs and text formatting" src="http://i3.codeplex.com/download?ProjectName=DocX&DownloadId=83995">](http://docx.codeplex.com/Release/ProjectReleases.aspx?ReleaseId=32117#DownloadId=83996) |
|
|
|
|
|
|
|
## Advanced Examples |
|
|
|
|
|
|
|
1. Step by step guide to create an invoice for a company. http://cathalscorner.blogspot.com/2009/08/docx-v1007-released.html |
|
|
|
2. Replace text across many documents in Parallel. http://cathalscorner.blogspot.com/2010/12/replace-text-across-many-documents-in.html |
|
|
|
3. Programmatically manipulate an Image imbedded inside a document. http://cathalscorner.blogspot.com/2010/12/programmatically-manipulate-image.html |
|
|
|
4. Converting DocX into (.doc, .pdf, .html) http://cathalscorner.blogspot.com/2009/10/converting-docx-into-doc-pdf-html.html |
|
|
|
|
|
|
|
Do you have an interesting or informative example that you would like to share? |
|
|
|
If you do, please email me. |
|
|
|
|
|
|
|
## What do other people think? |
|
|
|
|
|
|
|
<img alt="Testimonials" src="http://download.codeplex.com/download?ProjectName=DocX&DownloadId=192124"> |
|
|
|
|
|
|
|
## How can I send feedback! |
|
|
|
|
|
|
|
If you have found DocX useful at work or in a personal project, I would love to hear about it. Equally if you have decided not to use DocX, please send me and email stating why this is so. I will use this feedback to improve DocX in future releases. My email address is coffey.cathal@gmail.com. |
|
|
|
|
|
|
|
## Other Projects |
|
|
|
|
|
|
|
Cathal has another open source project [sql4csv](https://github.com/ccoffey/sql4csv/wiki). |
|
|
|
sql4csv is a python library that offers an SQL "like" interface for .csv files. |
|
|
|
|
|
|
|
Cathal also has [3 android applications](https://play.google.com/store/apps/developer?id=Cathal+Coffey&hl=en) on GooglePlay. |
|
|
|
|
|
|
|
Happy coding, |
|
|
|
|
|
|
|
Cathal |
|
|
|
|
|
|
|
*** |
|
|
|
|
|
|
|
Last edited 23/11/2015 by [CPonty](https://github.com/CPonty), version 88 |