From 1661da22a1fdfda6bd865d7bf60987eb8137ff3b Mon Sep 17 00:00:00 2001 From: Ivan Lanin Date: Thu, 20 Mar 2014 16:13:52 +0700 Subject: [PATCH] Documentation updates --- README.md | 181 ++++++++++++++++++++++++++-------------- docs/images/phpword.png | Bin 0 -> 14493 bytes 2 files changed, 117 insertions(+), 64 deletions(-) create mode 100644 docs/images/phpword.png diff --git a/README.md b/README.md index 80a6aab1..d16e2998 100755 --- a/README.md +++ b/README.md @@ -1,11 +1,32 @@ -![PHPWord](https://raw.github.com/PHPOffice/PHPWord/master/samples/resources/PHPWord.png "PHPWord") - -# PHPWord +![PHPWord](https://raw.github.com/PHPOffice/PHPWord/develop/docs/images/phpword.png "PHPWord") [![Build Status](https://travis-ci.org/PHPOffice/PHPWord.png?branch=master)](https://travis-ci.org/PHPOffice/PHPWord) [![Latest Stable Version](https://poser.pugx.org/phpoffice/phpword/v/stable.png)](https://packagist.org/packages/phpoffice/phpword) [![Total Downloads](https://poser.pugx.org/phpoffice/phpword/downloads.png)](https://packagist.org/packages/phpoffice/phpword) [![Latest Unstable Version](https://poser.pugx.org/phpoffice/phpword/v/unstable.png)](https://packagist.org/packages/phpoffice/phpword) [![License](https://poser.pugx.org/phpoffice/phpword/license.png)](https://packagist.org/packages/phpoffice/phpword) -## Introduction + +# Contents + +- [Introduction](#introduction) +- [Installing](#installing) +- [General usage](#general-usage) +- [Containers](#containers) + - [Sections](#sections) + - [Headers](#headers) + - [Footers](#footers) +- [Elements](#elements) + - [Texts](#texts) + - [Breaks](#breaks) + - [Lists](#lists) + - [Tables](#tables) + - [Images](#images) + - [Objects](#images) + - [Table of contents](#toc) + - [Footnotes](#footnotes) +- [Templates](#templates) +- [References](#references) + + +# Introduction PHPWord is a library written in pure PHP that provides a set of classes to write to and read from different document file formats. The current version of PHPWord supports Microsoft [Office Open XML](http://en.wikipedia.org/wiki/Office_Open_XML) (OOXML or OpenXML), OASIS [Open Document Format for Office Applications](http://en.wikipedia.org/wiki/OpenDocument) (OpenDocument or ODF), and [Rich Text Format](http://en.wikipedia.org/wiki/Rich_Text_Format) (RTF). @@ -15,7 +36,7 @@ PHPWord is an open source project licensed under [LGPL](license.md). PHPWord is __Want to contribute?__ [Fork us](https://github.com/PHPOffice/PHPWord/fork) or [submit](https://github.com/PHPOffice/PHPWord/issues) your bug reports or feature requests to us. -### Features +## Features * Set document properties, e.g. title, subject, and creator. * Create document sections with different settings, e.g. portrait/landscape, page size, and page numbering @@ -35,11 +56,11 @@ __Want to contribute?__ [Fork us](https://github.com/PHPOffice/PHPWord/fork) or * Use XSL 1.0 style sheets to transform main document part of OOXML template * ... and many more features on progress -### File formats +## File formats Below are the supported features for each file formats. -#### Writers +### Writers | No | Element | DOCX | ODT | RTF | |----|---------------|:----:|:---:|:---:| @@ -61,7 +82,7 @@ Below are the supported features for each file formats. | 16 | Footer | v | | | | 17 | Footnote | v | | | -#### Readers +### Readers | No | Element | DOCX | ODT | RTF | |----|---------------|:----:|:---:|:---:| @@ -84,9 +105,10 @@ Below are the supported features for each file formats. | 17 | Footnote | | | | -## Installing + +# Installing/Configuring -### Requirements +## Requirements Mandatory: @@ -100,11 +122,11 @@ Optional PHP extensions: * [XMLWriter](http://php.net/manual/en/book.xmlwriter.php) * [XSL](http://php.net/manual/en/book.xsl.php) -### Installation +## Installation There are two ways to install PHPWord, i.e. via [Composer](http://getcomposer.org/) or manually by downloading the library. -#### Composer +### Using Composer To install via Composer, add the following lines to your ``composer.json``: @@ -116,7 +138,7 @@ To install via Composer, add the following lines to your ``composer.json``: } ``` -#### Manual installation +### Manual install To install manually, [download PHPWord package from github](https://github.com/PHPOffice/PHPWord/archive/master.zip). Extract the package and put the contents to your machine. To use the library, include `Classes/PHPWord.php` in your script like below. @@ -124,32 +146,14 @@ To install manually, [download PHPWord package from github](https://github.com/P require_once '/path/to/PHPWord/Classes/PHPWord.php'; ``` -### Using samples +## Using samples After installation, you can browse and use the samples that we've provided, either by command line or using browser. If you can access your PHPWord library folder using browser, point your browser to the `samples` folder, e.g. `http://localhost/PHPWord/samples/`. -## User manual - -- [General usage](#general-usage) -- [Containers](#containers) - - [Sections](#sections) - - [Headers](#headers) - - [Footers](#footers) -- [Elements](#elements) - - [Texts](#texts) - - [Breaks](#breaks) - - [Lists](#lists) - - [Tables](#tables) - - [Images](#images) - - [Objects](#images) - - [Table of contents](#toc) - - [Footnotes](#footnotes) -- [Templates](#templates) - -## General usage +# General usage -### Basic example +## Basic example The following is a basic example of the PHPWord library. More examples are provided in the [samples folder](samples/). @@ -187,7 +191,7 @@ $objWriter = PHPWord_IOFactory::createWriter($PHPWord, 'Word2007'); $objWriter->save('helloWorld.docx'); ``` -### Default font +## Default font By default, every text appears in Arial 10 point. You can alter the default font by using the following two functions: @@ -196,7 +200,7 @@ $phpWord->setDefaultFontName('Times New Roman'); $phpWord->setDefaultFontSize(12); ``` -### Document properties +## Document properties You can set the document properties such as title, creator, and company name. Use the following functions: @@ -215,7 +219,7 @@ $properties->setKeywords('my, key, word'); ``` -### Measurement units +## Measurement units The base length unit in Open Office XML is twip. Twip means "TWentieth of an Inch Point", i.e. 1 twip = 1/1440 inch. @@ -235,10 +239,13 @@ $sectionStyle->setMarginLeft(PHPWord_Shared_Font::inchSizeToTwips(.5)); $sectionStyle->setMarginRight(PHPWord_Shared_Font::centimeterSizeToTwips(2)); ``` -## Containers + +# Containers + +Containers are objects where you can put elements (texts, lists, tables, etc). There are 3 main containers, i.e. sections, headers, and footers. There are 3 elements that can also act as containers, i.e. textruns, table cells, and footnotes. -### Sections +## Sections Every visible element in word is placed inside of a section. To create a section, use the following code: @@ -255,7 +262,7 @@ $sectionSettings = array( ); ``` -#### Section settings +### Section settings Below are the available settings for section: @@ -283,18 +290,37 @@ The following two settings are automatically set by the use of the `orientation` * `pageSizeW` Page width in twips * `pageSizeH` Page height in twips - -#### Section page numbering + +### Page number -You can change a section page numbering. +You can change a section page number by using the `pageNumberingStart` property of the section. ```php +// Method 1 +$section = $phpWord->createSection(array('pageNumberingStart' => 1)); + +// Method 2 $section = $phpWord->createSection(); $section->getSettings()->setPageNumberingStart(1); ``` + +### Multicolumn + +You can change a section layout to multicolumn (like in a newspaper) by using the `breakType` and `colsNum` property of the section. + +```php +// Method 1 +$section = $phpWord->createSection(array('breakType' => 'continuous', 'colsNum' => 2)); + +// Method 2 +$section = $phpWord->createSection(); +$section->getSettings()->setBreakType('continuous'); +$section->getSettings()->setColsNum(2); +``` + -### Headers +## Headers Each section can have its own header reference. To create a header use the `createHeader` method: @@ -305,7 +331,7 @@ $header = $section->createHeader(); Be sure to save the result in a local object. You can use all elements that are available for the footer. See "Footer" section for detail. Additionally, only inside of the header reference you can add watermarks or background pictures. See "Watermarks" section. -### Footers +## Footers Each section can have its own footer reference. To create a footer, use the `createFooter` method: @@ -323,11 +349,16 @@ Be sure to save the result in a local object to add elements to a footer. You ca See the "Elements" section for the detail of each elements. + +## Other containers + +Textruns, table cells, and footnotes are elements that can also act as containers. See the corresponding "Elements" section for the detail of each elements. + -## Elements +# Elements -### Texts +## Texts Text can be added by using `addText` and `createTextRun` method. `addText` is used for creating simple paragraphs that only contain texts with the same style. `createTextRun` is used for creating complex paragraphs that contain text with different style (some bold, other italics, etc) or other elements, e.g. images or links. The syntaxes are as follow: @@ -336,6 +367,8 @@ $section->addText($text, [$fontStyle], [$paragraphStyle]); $textrun = $section->createTextRun([$paragraphStyle]); ``` +### Text styles + You can use the `$fontStyle` and `$paragraphStyle` variable to define text formatting. There are 2 options to style the inserted text elements, i.e. inline style by using array or defined style by adding style definition. Inline style examples: @@ -400,7 +433,7 @@ Available paragraph styles: * ``tabs`` Set of custom tab stops -#### Titles +### Titles If you want to structure your document or build table of contents, you need titles or headings. To add a title to the document, use the `addTitleStyle` and `addTitle` method. @@ -412,7 +445,7 @@ $section->addTitle($text, [$depth]); Its necessary to add a title style to your document because otherwise the title won't be detected as a real title. -#### Links +### Links You can add Hyperlinks to the document by using the function addLink: @@ -425,7 +458,7 @@ $section->addLink($linkSrc, [$linkName], [$fontStyle], [$paragraphStyle]); * ``$fontStyle`` See "Font style" section. * ``$paragraphStyle`` See "Paragraph style" section. -#### Preserve texts +### Preserve texts The `addPreserveText` method is used to add a page number or page count to headers or footers. @@ -434,9 +467,9 @@ $footer->addPreserveText('Page {PAGE} of {NUMPAGES}.'); ``` -### Breaks +## Breaks -#### Text breaks +### Text breaks Text breaks are empty new lines. To add text breaks, use the following syntax. All paramaters are optional. @@ -448,7 +481,7 @@ $section->addTextBreak([$breakCount], [$fontStyle], [$paragraphStyle]); * ``$fontStyle`` See "Font style" section. * ``$paragraphStyle`` See "Paragraph style" section. -#### Page breaks +### Page breaks There are two ways to insert a page breaks, using the `addPageBreak` method or using the `pageBreakBefore` style of paragraph. @@ -457,7 +490,7 @@ $section->addPageBreak(); ``` -### Lists +## Lists To add a list item use the function `addListItem`. @@ -472,7 +505,7 @@ $section->addListItem($text, [$depth], [$fontStyle], [$listStyle], [$paragraphSt * ``$paragraphStyle`` See "Paragraph style" section. -### Tables +## Tables To add tables, rows, and cells, use the `addTable`, `addRow`, and `addCell` methods: @@ -495,6 +528,8 @@ $PHPWord->addTableStyle('myTable', $tableStyle, $firstRowStyle); $table = $section->addTable('myTable'); ``` +### Table, row, and cell styles + Table styles: * ``$width`` Table width in percent @@ -519,17 +554,19 @@ Cell styles: * ``$gridSpan `` Number of columns spanned * ``$vMerge `` _restart_ or _continue_ -#### Cell Span +### Cell span -You can span a cell on multiple columms. +You can span a cell on multiple columns by using `gridSpan` or multiple rows by using `vMerge`. ```php $cell = $table->addCell(200); $cell->getStyle()->setGridSpan(5); ``` +See `Sample_09_Tables.php` for more code sample. + -### Images +## Images To add an image, use the `addImage` or `addMemoryImage` method. The first one is used when your source is stored locally, the later is used when your source is a remote URL, either another script that create image or an image on the internet. @@ -559,7 +596,7 @@ $section->addMemoryImage('http://example.com/image.php'); $section->addMemoryImage('http://php.net/logo.jpg'); ``` -#### Image styles +### Image styles Available image styles: @@ -570,7 +607,7 @@ Available image styles: * ``marginLeft`` Left margin in inches, can be negative * ``wrappingStyle`` Wrapping style, _inline_, _square_, _tight_, _behind_, or _infront_ -#### Watermarks +### Watermarks To add a watermark (or page background image), your section needs a header reference. After creating a header, you can use the `addWatermark` method to add a watermark. @@ -581,7 +618,7 @@ $header->addWatermark('resources/_earth.jpg', array('marginTop' => 200, 'marginL ``` -### Objects +## Objects You can add OLE embeddings, such as Excel spreadsheets or PowerPoint presentations to the document by using `addObject` method. @@ -590,7 +627,7 @@ $section->addObject($src, [$style]); ``` -### Table of contents +## Table of contents To add a table of contents (TOC), you can use the `addTOC` method. Your TOC can only be generated if you have add at least one title (See "Titles"). @@ -603,7 +640,7 @@ $section->addTOC([$fontStyle], [$tocStyle]); * ``indent`` The indent factor of the titles in twips. -### Footnotes +## Footnotes You can create footnotes in texts or textruns, but it's recommended to use textrun to have better layout. @@ -625,7 +662,8 @@ $footnote = $section->createFootnote(); $footnote->addText('Footnote text.'); ``` -## Templates + +# Templates You can create a docx template with included search-patterns that can be replaced by any value you wish. Only single-line values can be replaced. To load a template file, use the `loadTemplate` method. After loading the docx template, you can use the `setValue` method to change the value of a search pattern. The search-pattern model is: `${search-pattern}`. It is not possible to add new PHPWord elements to a loaded template file. @@ -636,3 +674,18 @@ $template = $PHPWord->loadTemplate('Template.docx'); $template->setValue('Name', 'Somebody someone'); $template->setValue('Street', 'Coming-Undone-Street 32'); ``` + +See `Sample_07_TemplateCloneRow.php` for more code sample, including how to create multirow from a single row in a template by using `cloneRow`. + + +# References + +## Formal specifications + +* [Office Open XML (OOXML) (ECMA-376) Schema](http://www.schemacentral.com/sc/ooxml/ss.html) +* [Oasis OpenDocument Standard Version 1.2](http://docs.oasis-open.org/office/v1.2/os/OpenDocument-v1.2-os.html) +* [Rich Text Format (RTF) Specification, version 1.9.1](http://www.microsoft.com/en-us/download/details.aspx?id=10725) + +## Other resources + +* [DocumentFormat.OpenXml.Wordprocessing Namespace on MSDN](http://msdn.microsoft.com/en-us/library/documentformat.openxml.wordprocessing%28v=office.14%29.aspx) \ No newline at end of file diff --git a/docs/images/phpword.png b/docs/images/phpword.png new file mode 100644 index 0000000000000000000000000000000000000000..3acbdfaf36d2668673e6cf3976b8e5d97ed7ab90 GIT binary patch literal 14493 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 literal 0 HcmV?d00001