pdfbox-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From msahy...@apache.org
Subject [1/3] pdfbox-docs git commit: PDFBOX-3330: Style consistancy and copy edits
Date Mon, 06 Feb 2017 17:18:32 GMT
Repository: pdfbox-docs
Updated Branches:
  refs/heads/master 35ae1d69a -> 970090103


PDFBOX-3330: Style consistancy and copy edits


Project: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/commit/51beaa7f
Tree: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/tree/51beaa7f
Diff: http://git-wip-us.apache.org/repos/asf/pdfbox-docs/diff/51beaa7f

Branch: refs/heads/master
Commit: 51beaa7ff97a56cebe68c8e873ac99092c8b8610
Parents: 03016d0
Author: David Russo <el.quotho@gmail.com>
Authored: Wed Dec 7 22:58:11 2016 +0000
Committer: David Russo <el.quotho@gmail.com>
Committed: Wed Dec 7 22:58:11 2016 +0000

----------------------------------------------------------------------
 _config.yml                                 |  2 +-
 content/1.8/architecture.md                 |  2 +-
 content/1.8/commandline.md                  | 84 ++++++++++++------------
 content/1.8/cookbook/documentcreation.md    |  4 +-
 content/1.8/cookbook/encryption.md          | 14 ++--
 content/1.8/cookbook/pdfacreation.md        | 17 ++---
 content/1.8/cookbook/rendering.md           |  2 +-
 content/1.8/cookbook/textextraction.md      | 12 ++--
 content/1.8/cookbook/workingwithfonts.md    | 10 +--
 content/1.8/cookbook/workingwithmetadata.md | 10 +--
 content/1.8/dependencies.md                 | 62 +++++++++--------
 content/1.8/faq.md                          |  8 +--
 content/2.0/commandline.md                  | 79 +++++++++++-----------
 content/2.0/cookbook/encryption.md          | 14 ++--
 content/2.0/dependencies.md                 | 58 ++++++++--------
 content/2.0/faq.md                          | 10 +--
 content/2.0/getting-started.md              | 22 ++++---
 content/2.0/migration.md                    |  2 +-
 content/_layouts/default.html               |  6 +-
 content/codingconventions.md                | 24 +++----
 content/ideas.md                            | 17 +++--
 content/index.md                            |  2 +-
 content/references.md                       |  2 +-
 content/siteupdate.md                       | 34 +++++-----
 content/support.md                          | 43 ++++++------
 25 files changed, 277 insertions(+), 263 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/_config.yml
----------------------------------------------------------------------
diff --git a/_config.yml b/_config.yml
index 9b94f33..7ea88f1 100644
--- a/_config.yml
+++ b/_config.yml
@@ -4,7 +4,7 @@ description: > # this means to ignore newlines until "baseurl:"
   The Apache PDFBox™ library is an open source Java tool for working with PDF documents.
   This project allows creation of new PDF documents, manipulation of existing documents
   and the ability to extract content from documents. Apache PDFBox also includes several
-  command line utilities. Apache PDFBox is published under the Apache License v2.0.
+  command-line utilities. Apache PDFBox is published under the Apache License v2.0.
 baseurl: ""
 url: "http://pdfbox.apache.org/"
 

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/architecture.md
----------------------------------------------------------------------
diff --git a/content/1.8/architecture.md b/content/1.8/architecture.md
index c8bb0fd..80af4f4 100644
--- a/content/1.8/architecture.md
+++ b/content/1.8/architecture.md
@@ -73,7 +73,7 @@ As outlined above the basic PDF objects are represented in PDFBox in the org.apa
 | Stream | A stream of data, typically compressed. This is used for page contents, images and embedded font streams. | 12 0 obj << /Type /XObject >> stream 030004040404040404 endstream | org.apache.pdfbox.cos.COSStream | 7.3.8 |
 | Object | A wrapper to any of the other objects, this can be used to reference an object multiple times. An object is referenced by using two numbers, an object number and a generation number. Initially the generation number will be zero unless the object got replaced later in the stream. | 12 0 obj << /Type /XObject >> endobj | org.apache.pdfbox.cos.COSObject | |
 
-A page in a pdf document is represented with a COSDictionary. The entries that are available for a page can be seen in the PDF Reference and an example of a page looks like this:
+A page in a PDF document is represented with a COSDictionary. The entries that are available for a page can be seen in the PDF Reference and an example of a page looks like this:
 
 ```text
 <<

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/commandline.md
----------------------------------------------------------------------
diff --git a/content/1.8/commandline.md b/content/1.8/commandline.md
index 8fc3b63..74f8b6d 100644
--- a/content/1.8/commandline.md
+++ b/content/1.8/commandline.md
@@ -17,30 +17,30 @@ license: Licensed to the Apache Software Foundation (ASF) under one
          under the License.
 
 layout:  default
-title:   Command Line Tools
+title:   Command-Line Tools
 ---
 
-# Command Line Tools
+# Command-Line Tools
 
-PDFBox comes with a series of command line utilities. They are available as standard Java applications.
+PDFBox comes with a series of command-line utilities. They are available as standard Java applications.
 
 See the [Dependencies](/1.8/dependencies.html) page for instructions on how to set your classpath in order to run
 PDFBox tools as Java applications.
 
-**Table of Contents**  
-[Decrypt](#decrypt)
-[Encrypt](#encrypt)
-[ExtractImages](#extractimages)
-[ExtractText](#extracttext)
-[OverlayPDF](#overlaypdf)
-[PrintPDF](#printpdf)
-[PDFDebugger](#pdfdebugger)
-[PDFReader](#pdfreader)
-[PDFMerger](#pdfmerger)
-[PDFSplit](#pdfsplit)
-[PDFToImage](#pdftoimage)
-[TextToPDF](#texttopdf)
-[WriteDecodedDoc](#writedecodeddoc)
+**Table of Contents**
+ - [Decrypt](#decrypt)
+ - [Encrypt](#encrypt)
+ - [ExtractImages](#extractimages)
+ - [ExtractText](#extracttext)
+ - [OverlayPDF](#overlaypdf)
+ - [PrintPDF](#printpdf)
+ - [PDFDebugger](#pdfdebugger)
+ - [PDFReader](#pdfreader)
+ - [PDFMerger](#pdfmerger)
+ - [PDFSplit](#pdfsplit)
+ - [PDFToImage](#pdftoimage)
+ - [TextToPDF](#texttopdf)
+ - [WriteDecodedDoc](#writedecodeddoc)
 
 ## Decrypt ##
 
@@ -48,9 +48,9 @@ This application will decrypt a PDF document.
 
 NOTE: You must have the owner password to decrypt the document!
 
-usage: ``java -jar pdfbox-app-x.y.z.jar Decrypt [OPTIONS] <inputfile> [outputfile]``
+Usage: ``java -jar pdfbox-app-x.y.z.jar Decrypt [OPTIONS] <inputfile> [outputfile]``
 
-| Command Line Parameter 	| Description |
+| Command-Line Parameter 	| Description |
 | ------------------------- | ----------- |
 | -password | Password to the PDF or certificate in keystore. |
 | -keyStore | Path to keystore that holds certificate to decrypt the document. This is only required if the document is encrypted with a certificate, otherwise only the password is required. |
@@ -62,9 +62,9 @@ usage: ``java -jar pdfbox-app-x.y.z.jar Decrypt [OPTIONS] <inputfile> [outputfil
 
 This application will encrypt a PDF document.
 
-usage: ``java -jar pdfbox-app-x.y.z.jar Encrypt [OPTIONS] <password> <inputfile>``
+Usage: ``java -jar pdfbox-app-x.y.z.jar Encrypt [OPTIONS] <password> <inputfile>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -O | | The owner password to the PDF, ignored if -certFile is specified. |
 | -U | | The user password to the PDF, ignored if -certFile is specified. |
@@ -85,9 +85,9 @@ usage: ``java -jar pdfbox-app-x.y.z.jar Encrypt [OPTIONS] <password> <inputfile>
 
 This application will extract all images from the given PDF document.
 
-usage: ``java -jar pdfbox-app-x.y.z.jar ExtractImages [OPTIONS] <inputfile> ``
+Usage: ``java -jar pdfbox-app-x.y.z.jar ExtractImages [OPTIONS] <inputfile> ``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password |  | The password to the PDF document. |
 | -prefix | PDF name | Image prefix to use. |
@@ -97,9 +97,9 @@ usage: ``java -jar pdfbox-app-x.y.z.jar ExtractImages [OPTIONS] <inputfile> ``
 
 This application will extract all text from the given PDF document.
 
-usage: ``java -jar pdfbox-app-x.y.z.jar ExtractText [OPTIONS] <inputfile> [Text file] ``
+Usage: ``java -jar pdfbox-app-x.y.z.jar ExtractText [OPTIONS] <inputfile> [Text file] ``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password |  | The password to the PDF document. |
 | -encoding | default encoding | The encoding type of the text file, e.g. ISO-8859-1, UTF-8, UTF-16BE. |
@@ -117,9 +117,9 @@ usage: ``java -jar pdfbox-app-x.y.z.jar ExtractText [OPTIONS] <inputfile> [Text
 
 This application will overlay one document with the content of another document
 
-usage: ``java -jar pdfbox-app-x.y.z.jar OverlayPDF <input.pdf> [OPTIONS] <output.pdf>``
+Usage: ``java -jar pdfbox-app-x.y.z.jar OverlayPDF <input.pdf> [OPTIONS] <output.pdf>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | inputfile | | The PDF file to be overlayed. |
 | defaultOverlay.pdf  | | Default overlay file. |
@@ -144,9 +144,9 @@ This application will send a pdf document to the printer.
 
 <p class="alert alert-info">You must have the correct permissions to print the document!</p>
 
-usage: ``java -jar pdfbox-app-x.y.z.jar PrintPDF [OPTIONS] <inputfile>``
+Usage: ``java -jar pdfbox-app-x.y.z.jar PrintPDF [OPTIONS] <inputfile>``
 
-| Command Line Parameter | Description |
+| Command-Line Parameter | Description |
 | --- | --- |
 | -password | The password to decrypt the PDF. |
 | -silentPrint | Print the PDF without prompting for a printer. |
@@ -156,9 +156,9 @@ usage: ``java -jar pdfbox-app-x.y.z.jar PrintPDF [OPTIONS] <inputfile>``
 
 This application will take an existing PDF document and allows to analyze and inspect the internal structure
 
-usage: ``java -jar pdfbox-app-x.y.z.jar PDFDebugger [inputfile] ``
+Usage: ``java -jar pdfbox-app-x.y.z.jar PDFDebugger [inputfile] ``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password | | The password to the PDF document. |
 | -nonSeq | false | Use the new non sequential parser.
@@ -168,9 +168,9 @@ usage: ``java -jar pdfbox-app-x.y.z.jar PDFDebugger [inputfile] ``
 
 An application to read PDF documents. This will provide Acrobat Reader like functionality.
 
-usage: ``java -jar pdfbox-app-x.y.z.jar PDFReader [PDF file]``
+Usage: ``java -jar pdfbox-app-x.y.z.jar PDFReader [PDF file]``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password | | The password to the PDF document.|
 | -nonSeq | false | Use the new non sequential parser.|
@@ -180,7 +180,7 @@ usage: ``java -jar pdfbox-app-x.y.z.jar PDFReader [PDF file]``
 
 This application will take a list of pdf documents and merge them, saving the result in a new document.
 
-usage: ``java -jar pdfbox-app-x.y.z.jar PDFMerger <Source PDF files (2 ..n)> <Target PDF file>``
+Usage: ``java -jar pdfbox-app-x.y.z.jar PDFMerger <Source PDF files (2 ..n)> <Target PDF file>``
 
 ## PDFSplit ##
 
@@ -189,9 +189,9 @@ This application will take an existing PDF document and split it into a number o
 Per default the resulting files will be named after the original filenmame with `-<nr>` appended before the suffix.
 To override the filename use the `outputPrefix` option.
 
-usage: ``java -jar pdfbox-app-x.y.z.jar PDFSplit [OPTIONS] <PDF file>``
+Usage: ``java -jar pdfbox-app-x.y.z.jar PDFSplit [OPTIONS] <PDF file>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password | | The password to the PDF document. |
 | -split | | Number of pages of every splitted part of the pdf.|
@@ -212,9 +212,9 @@ Examples:
 
 This application will create an image for every page in the PDF document.
 
-usage: ``java -jar pdfbox-app-x.y.z.jar PDFToImage [OPTIONS] <PDF file>``
+Usage: ``java -jar pdfbox-app-x.y.z.jar PDFToImage [OPTIONS] <PDF file>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password | | The password to the PDF document.|
 | -imageType | jpg | The image type to write to. Currently only jpg or png. |
@@ -227,9 +227,9 @@ usage: ``java -jar pdfbox-app-x.y.z.jar PDFToImage [OPTIONS] <PDF file>``
 
 This application will create a PDF document from a text file.
 
-usage: ``java -jar pdfbox-app-x.y.z.jar TextToPDF [OPTIONS] <outputfile> <textfile>``
+Usage: ``java -jar pdfbox-app-x.y.z.jar TextToPDF [OPTIONS] <outputfile> <textfile>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -standardFont | Helvetica | The font to use for the text. Either this or -ttf should be specified but not both. |
 | -ttf | | The TTF font to use for the text. Either this or -standardFont should be specified but not both. |
@@ -256,9 +256,9 @@ The following font names can be used for the parameter ``standardFont``:
 
 An application to decompress PDF documents.
 
-usage: ``java -jar pdfbox-app-x.y.z.jar WriteDecodedDoc <input-file> <output-file>``
+Usage: ``java -jar pdfbox-app-x.y.z.jar WriteDecodedDoc <input-file> <output-file>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password |  | The password to the PDF document. |
 | -nonSeq 	| false | Use the new non sequential parser. |

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/cookbook/documentcreation.md
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/documentcreation.md b/content/1.8/cookbook/documentcreation.md
index 825dac0..56cd1f3 100644
--- a/content/1.8/cookbook/documentcreation.md
+++ b/content/1.8/cookbook/documentcreation.md
@@ -22,7 +22,7 @@ title:   Cookbook - Document Creation
 
 # Document Creation
 
-## Create a blank PDF
+## Create a Blank PDF
 
 This small sample shows how to create a new PDF document using PDFBox.
 
@@ -42,7 +42,7 @@ document.save("BlankPage.pdf");
 document.close();
 ~~~
 
-## Hello World using a PDF base font
+## Hello World Using a PDF Base Font
 
 This small sample shows how to create a new document and print the text "Hello World" using one of the PDF base fonts.
 

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/cookbook/encryption.md
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/encryption.md b/content/1.8/cookbook/encryption.md
index 15c107b..8f7267f 100644
--- a/content/1.8/cookbook/encryption.md
+++ b/content/1.8/cookbook/encryption.md
@@ -17,19 +17,19 @@ license: Licensed to the Apache Software Foundation (ASF) under one
          under the License.
          
 layout:  default
-title:   Cookbook - Encrypting a file
+title:   Cookbook - Encrypting a File
 ---
 
-Encrypting a file
+Encrypting a File
 =================
 
 PDF encryption requires two passwords: the "user password" to open and view the file with restricted permissions, the "owner password" to access the file with all permission.
 
 
-Load and save encrypted
+Load and Save Encrypted
 -----------------------
 
-This small sample shows how to encrypt a file so that it can be viewed, but not printed..
+This small sample shows how to encrypt a file so that it can be viewed, but not printed.
 
 ~~~java
 PDDocument doc = PDDocument.load("filename.pdf");
@@ -40,11 +40,11 @@ int keyLength = 128;
 
 AccessPermission ap = new AccessPermission();
 
-// disable printing, everything else is allowed
+// Disable printing, everything else is allowed
 ap.setCanPrint(false);
 
-// owner password (to open the file with all permissions) is "12345"
-// user password (to open the file but with restricted permissions, is empty here) 
+// Owner password (to open the file with all permissions) is "12345"
+// User password (to open the file but with restricted permissions, is empty here) 
 StandardProtectionPolicy spp = new StandardProtectionPolicy("12345", "", ap);
 spp.setEncryptionKeyLength(keyLength);
 spp.setPermissions(ap);

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/cookbook/pdfacreation.md
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/pdfacreation.md b/content/1.8/cookbook/pdfacreation.md
index dd2b93a..79c5ded 100644
--- a/content/1.8/cookbook/pdfacreation.md
+++ b/content/1.8/cookbook/pdfacreation.md
@@ -17,18 +17,18 @@ license:   Licensed to the Apache Software Foundation (ASF) under one
            under the License.
 
 layout:    default
-title:     Create a valid PDF/A document
+title:     Create a Valid PDF/A Document
 ---
 
 # PDF/A Creation
 
-The Apache PDFBox API can be used to create a PDF/A File. PDF/A is a PDF file with some constraints to ensure its 
+The Apache PDFBox API can be used to create a PDF/A file. PDF/A is a PDF file with some constraints to ensure its 
 long time conservation. These constraints are described in ISO 19005.
 
 This small sample shows what should be added during creation of a PDF file to transform it in a valid PDF/A 
 document. The current example creates a valid PDF/A-1b document.
 
-## Load all the fonts used in document
+## Load All Fonts Used in the Document
 
 The PDF/A specification enforces that the fonts used in the document are present in the PDF File. You
 have to load them. As an example:
@@ -37,10 +37,11 @@ have to load them. As an example:
 InputStream fontStream = CreatePDFA.class.getResourceAsStream("/org/apache/pdfbox/resources/ttf/ArialMT.ttf");
 PDFont font = PDTrueTypeFont.loadTTF(doc, fontStream);
 ~~~
-## Including XMP metadata block
 
-It is imposed to have xmp metadata defined in the PDF. At least, the PDFA Schema (giving details on the version
-of PDF/A specification reached by the document) must be present. These lines create the xmp metadata for a
+## Include XMP Metadata Block
+
+It is required to have XMP metadata defined in the PDF. At least, the PDFA Schema (giving details on the version
+of PDF/A specification reached by the document) must be present. These lines create the XMP metadata for a
 PDF/A-1b document:
 
 ~~~java
@@ -53,13 +54,13 @@ pdfaid.setAbout("");
 metadata.importXMPMetadata(xmp);
 ~~~
 
-## Including color profile
+## Include Color Profile
 
 It is mandatory to include the color profile used by the document. Different profiles can be used. This 
 example takes one present in pdfbox:
 
 ~~~java
-// create output intent
+// Create output intent
 InputStream colorProfile = CreatePDFA.class.getResourceAsStream("/org/apache/pdfbox/resources/pdfa/sRGB Color Space Profile.icm");
 PDOutputIntent oi = new PDOutputIntent(doc, colorProfile); 
 oi.setInfo("sRGB IEC61966-2.1"); 

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/cookbook/rendering.md
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/rendering.md b/content/1.8/cookbook/rendering.md
index f98addb..d6e99d2 100644
--- a/content/1.8/cookbook/rendering.md
+++ b/content/1.8/cookbook/rendering.md
@@ -23,7 +23,7 @@ title:   Cookbook - Rendering
 Document Rendering
 ==================
 
-Convert a document to images
+Convert a Document to Images
 ----------------------------
 
 This small sample shows how to render (convert to images) a PDF document using PDFBox.

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/cookbook/textextraction.md
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/textextraction.md b/content/1.8/cookbook/textextraction.md
index c933503..755e715 100644
--- a/content/1.8/cookbook/textextraction.md
+++ b/content/1.8/cookbook/textextraction.md
@@ -17,16 +17,16 @@ license: Licensed to the Apache Software Foundation (ASF) under one
          under the License.
 
 layout:  default
-title:   Cookbook - Textextraction
+title:   Cookbook - Text Extraction
 ---
 
-# Textextraction
+# Text Extraction
 
 ## Extracting Text
 
-See class:org.apache.pdfbox.util.PDFTextStripper  
-See class:org.apache.pdfbox.searchengine.lucene.LucenePDFDocument  
-See command line app:ExtractText  
+See class: org.apache.pdfbox.util.PDFTextStripper  
+See class: org.apache.pdfbox.searchengine.lucene.LucenePDFDocument  
+See command-line app: ExtractText  
 
 One of the main features of PDFBox is its ability to quickly and accurately extract text 
 from a variety of PDF documents. This functionality is encapsulated in the 
@@ -57,7 +57,7 @@ line application nor the LucenePDFDocument will be able to fulfill those require
 It is possible for users to utilize or extend the PDFTextStripper class to meet some of 
 these requirements.
 
-### Limiting The Extracted Text
+### Limiting the Extracted Text
 
 There are several ways that we can limit the text that is extracted during the extraction 
 process. The simplest is to specify the range of pages that you want to be extracted. 

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/cookbook/workingwithfonts.md
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/workingwithfonts.md b/content/1.8/cookbook/workingwithfonts.md
index 08918a3..9c4fe75 100644
--- a/content/1.8/cookbook/workingwithfonts.md
+++ b/content/1.8/cookbook/workingwithfonts.md
@@ -43,7 +43,7 @@ The PDF specification states that a standard set of 14 fonts will always be avai
 | PDType1Font.SYMBOL | Symbol Set |
 | PDType1Font.ZAPF_DINGBATS | Dingbat Typeface |
 
-## Hello World using a PDF base font
+## Hello World Using a PDF Base Font
 
 This small sample shows how to create a new document and print the text "Hello World" using one of the PDF base fonts.
 
@@ -74,7 +74,7 @@ document.save( "Hello World.pdf");
 document.close();
 ~~~
 
-## Hello World using a TrueType font
+## Hello World Using a TrueType Font
 
 This small sample shows how to create a new document and print the text "Hello World" using a TrueType font.
 
@@ -114,9 +114,9 @@ names to TTF font files. The UNKNOWN_FONT property in that file will tell PDFBox
 use when no mapping exists. 
 
 
-## Hello World using a Postscript Type1 font
+## Hello World Using a PostScript Type1 Font
 
-This small sample shows how to create a new document and print the text "Hello World" using a Postscript Type1 font.
+This small sample shows how to create a new document and print the text "Hello World" using a PostScript Type1 font.
 
 ~~~java
 // Create a document and add a page to it
@@ -124,7 +124,7 @@ PDDocument document = new PDDocument();
 PDPage page = new PDPage();
 document.addPage( page );
 
-// Create a new font object by loading a Postscript Type 1 font into the document
+// Create a new font object by loading a PostScript Type 1 font into the document
 PDFont font = new PDType1AfmPfbFont(doc,"cfm.afm");
 
 // Start a new content stream which will "hold" the to be created content

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/cookbook/workingwithmetadata.md
----------------------------------------------------------------------
diff --git a/content/1.8/cookbook/workingwithmetadata.md b/content/1.8/cookbook/workingwithmetadata.md
index b4d09ce..6f082e3 100644
--- a/content/1.8/cookbook/workingwithmetadata.md
+++ b/content/1.8/cookbook/workingwithmetadata.md
@@ -50,9 +50,9 @@ System.out.println( "Trapped=" + info.getTrapped() );
 
 ## Accessing PDF Metadata
 
-See class:org.apache.pdfbox.pdmodel.common.PDMetadata  
-See example:AddMetadataFromDocInfo  
-See Adobe Documentation:XMP Specification  
+See class: org.apache.pdfbox.pdmodel.common.PDMetadata  
+See example: AddMetadataFromDocInfo  
+See Adobe Documentation: XMP Specification  
 
 PDF documents can have XML metadata associated with certain objects within a PDF document.
 For example, the following PD Model objects have the ability to contain metadata:
@@ -73,10 +73,10 @@ PDDocument doc = PDDocument.load( ... );
 PDDocumentCatalog catalog = doc.getDocumentCatalog();
 PDMetadata metadata = catalog.getMetadata();
 
-//to read the XML metadata
+// To read the XML metadata
 InputStream xmlInputStream = metadata.createInputStream();
 
-//or to write new XML metadata
+// Or to write new XML metadata
 InputStream newXMPData = ...;
 PDMetadata newMetadata = new PDMetadata(doc, newXMLData, false );
 catalog.setMetadata( newMetadata );

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/dependencies.md
----------------------------------------------------------------------
diff --git a/content/1.8/dependencies.md b/content/1.8/dependencies.md
index c32d3ca..ca0ed46 100644
--- a/content/1.8/dependencies.md
+++ b/content/1.8/dependencies.md
@@ -22,15 +22,15 @@ title:   Dependencies
 
 # Dependencies
 
-PDFBox consists of a three related components and depends on a few external libraries. This page describes what these libraries are and how to include them in your application.
+PDFBox consists of three related components and depends on a few external libraries. This page describes what these libraries are and how to include them in your application.
 
-## Core components
+## Core Components
 
 <p class="alert alert-info">These components are needed during runtime, development and testing dependent on the details below.</p>
 
 The three PDFBox components are named ```pdfbox```, ```fontbox``` and ```jempbox```. The Maven groupId of all PDFBox components is org.apache.pdfbox.
 
-### Minimum Requirement
+### Minimum Requirements
 
 - Java 1.5
 - [commons-logging](http://commons.apache.org/logging/)
@@ -51,15 +51,17 @@ To support XMP metadata the jembox component is needed.
 To add the pdfbox, fontbox, jempbox and commons-logging jars to your application, the easiest thing is to declare the Maven dependency shown below. This gives you the main
 pdfbox library directly and the other required jars as transitive dependencies.
 
-    <dependency>
-      <groupId>org.apache.pdfbox</groupId>
-      <artifactId>pdfbox</artifactId>
-      <version>...</version>
-    </dependency>
+```xml
+<dependency>
+  <groupId>org.apache.pdfbox</groupId>
+  <artifactId>pdfbox</artifactId>
+  <version>...</version>
+</dependency>
+```
 
 Set the version field to the latest stable PDFBox version.
 
-## Optional dependencies
+## Optional Dependencies
 
 Some features in PDFBox depend on optional external libraries. You can enable these features simply by including the required libraries in the classpath of your application.
 
@@ -78,34 +80,36 @@ To write **TIFF** images a JAI ImageIO Core library will be needed.
 The most notable such optional feature is support for PDF encryption. Instead of implementing its own encryption algorithms, PDFBox uses libraries from the 
 [Legion of the Bouncy Castle](http://www.bouncycastle.org/). Both the bcprov and bcmail libraries are needed and can be included using the Maven dependencies shown below.
 
-    <dependency>
-      <groupId>org.bouncycastle</groupId>
-      <artifactId>bcprov-jdk15</artifactId>
-      <version>1.44</version>
-    </dependency>
-    <dependency>
-      <groupId>org.bouncycastle</groupId>
-      <artifactId>bcmail-jdk15</artifactId>
-      <version>1.44</version>
-    </dependency>
- 
-<br/>
-
-#### Support for bidirectional languages
+```xml
+<dependency>
+  <groupId>org.bouncycastle</groupId>
+  <artifactId>bcprov-jdk15</artifactId>
+  <version>1.44</version>
+</dependency>
+<dependency>
+  <groupId>org.bouncycastle</groupId>
+  <artifactId>bcmail-jdk15</artifactId>
+  <version>1.44</version>
+</dependency>
+```
+
+#### Support for Bidirectional Languages
 Another important optional feature is support for bidirectional languages like Arabic. PDFBox uses the ICU4J library from the 
 [International Components for Unicode](http://site.icu-project.org/) (ICU) project to support such languages in PDF documents. To add the ICU4J jar to your project, 
 use the following Maven dependency.
 
-    <dependency>
-      <groupId>com.ibm.icu</groupId>
-      <artifactId>icu4j</artifactId>
-      <version>3.8</version>
-    </dependency>
+```xml
+<dependency>
+  <groupId>com.ibm.icu</groupId>
+  <artifactId>icu4j</artifactId>
+  <version>3.8</version>
+</dependency>
+```
 
 PDFBox also contains extra support for use with the [Lucene](http://lucene.apache.org/) and [Ant](http://ant.apache.org/) projects. Since in these cases PDFBox is just an
 add-on feature to these projects, you should first set up your application to use Lucene or Ant and then add PDFBox support as described on this page.
 
-## Dependencies for Ant builds
+## Dependencies for Ant Builds
 
 The above instructions expect that you're using [Maven](http://maven.apache.org/) or another build tool like [Ivy](http://ant.apache.org/ivy/) that supports Maven dependencies.
 If you instead use tools like [Ant](http://ant.apache.org/) where you need to explicitly include all the required library jars in your application, you'll need to do

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/1.8/faq.md
----------------------------------------------------------------------
diff --git a/content/1.8/faq.md b/content/1.8/faq.md
index a9de45c..ba7a2c1 100644
--- a/content/1.8/faq.md
+++ b/content/1.8/faq.md
@@ -20,7 +20,7 @@ layout:  default
 title:   Frequently Asked Questions (FAQ)
 ---
 
-# Frequently asked questions
+# Frequently Asked Questions
 
 ### General Questions
 
@@ -41,7 +41,7 @@ title:   Frequently Asked Questions (FAQ)
 <a name="log4j"></a>
 ### I am getting the below Log4J warning message, how do I remove it? ###
 
-```java
+```
 log4j:WARN No appenders could be found for logger (org.apache.pdfbox.util.ResourceLoader).
 log4j:WARN Please initialize the log4j system properly.
 ```
@@ -51,13 +51,13 @@ See the [log4j documentation](http://logging.apache.org/log4j/1.2/manual.html) f
 
 PDFBox comes with a sample log4j configuration file.  To use it you set a system property like this
 
-```java
+```
 java -Dlog4j.configuration=log4j.xml org.apache.pdfbox.ExtractText <PDF-file> <output-text-file>
 ```
 
 If this is not working for you then you may have to specify the log4j config file using a URL path, like this:
 
-```java
+```
 log4j.configuration=file:///<path to config file>
 ```
 

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/2.0/commandline.md
----------------------------------------------------------------------
diff --git a/content/2.0/commandline.md b/content/2.0/commandline.md
index 1a638f6..08efeca 100644
--- a/content/2.0/commandline.md
+++ b/content/2.0/commandline.md
@@ -17,28 +17,29 @@ license: Licensed to the Apache Software Foundation (ASF) under one
          under the License.
 
 layout:  default
-title:   Command Line Tools
+title:   Command-Line Tools
 ---
-# Command Line Tools
 
-PDFBox comes with a series of command line utilities. They are available as standard Java applications.
+# Command-Line Tools
+
+PDFBox comes with a series of command-line utilities. They are available as standard Java applications.
 
 See the [Dependencies](/2.0/dependencies.html) page for instructions on how to set your classpath in order to run
 PDFBox tools as Java applications.
 
-**Table of Contents**  
-[Decrypt](#decrypt)
-[Encrypt](#encrypt)
-[ExtractImages](#extractimages)
-[ExtractText](#extracttext)
-[OverlayPDF](#overlaypdf)
-[PDFDebugger](#pdfdebugger)
-[PDFMerger](#pdfmerger)
-[PDFSplit](#pdfsplit)
-[PDFToImage](#pdftoimage)
-[PrintPDF](#printpdf)
-[TextToPDF](#texttopdf)
-[WriteDecodedDoc](#writedecodeddoc)
+**Table of Contents**
+ - [Decrypt](#decrypt)
+ - [Encrypt](#encrypt)
+ - [ExtractImages](#extractimages)
+ - [ExtractText](#extracttext)
+ - [OverlayPDF](#overlaypdf)
+ - [PDFDebugger](#pdfdebugger)
+ - [PDFMerger](#pdfmerger)
+ - [PDFSplit](#pdfsplit)
+ - [PDFToImage](#pdftoimage)
+ - [PrintPDF](#printpdf)
+ - [TextToPDF](#texttopdf)
+ - [WriteDecodedDoc](#writedecodeddoc)
 
 ## Decrypt ##
 
@@ -46,9 +47,9 @@ This application will decrypt a PDF document.
 
 NOTE: You must have the owner password to decrypt the document!
 
-usage: ``java -jar pdfbox-app-2.y.z.jar Decrypt [OPTIONS] <inputfile> [outputfile]``
+Usage: ``java -jar pdfbox-app-2.y.z.jar Decrypt [OPTIONS] <inputfile> [outputfile]``
 
-| Command Line Parameter 	| Description |
+| Command-Line Parameter 	| Description |
 | ------------------------- | ----------- |
 | -password | Password to the PDF or certificate in keystore. |
 | -keyStore | Path to keystore that holds certificate to decrypt the document. This is only required if the document is encrypted with a certificate, otherwise only the password is required. |
@@ -60,9 +61,9 @@ usage: ``java -jar pdfbox-app-2.y.z.jar Decrypt [OPTIONS] <inputfile> [outputfil
 
 This application will encrypt a PDF document.
 
-usage: ``java -jar pdfbox-app-2.y.z.jar Encrypt [OPTIONS] <password> <inputfile>``
+Usage: ``java -jar pdfbox-app-2.y.z.jar Encrypt [OPTIONS] <password> <inputfile>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -O | | The owner password to the PDF, ignored if -certFile is specified. |
 | -U | | The user password to the PDF, ignored if -certFile is specified. |
@@ -83,9 +84,9 @@ usage: ``java -jar pdfbox-app-2.y.z.jar Encrypt [OPTIONS] <password> <inputfile>
 
 This application will extract all images from the given PDF document.
 
-usage: ``java -jar pdfbox-app-2.y.z.jar ExtractImages [OPTIONS] <inputfile> ``
+Usage: ``java -jar pdfbox-app-2.y.z.jar ExtractImages [OPTIONS] <inputfile> ``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password |  | The password to the PDF document. |
 | -prefix | PDF name | Image prefix to use. |
@@ -95,9 +96,9 @@ usage: ``java -jar pdfbox-app-2.y.z.jar ExtractImages [OPTIONS] <inputfile> ``
 
 This application will extract all text from the given PDF document.
 
-usage: ``java -jar pdfbox-app-2.y.z.jar ExtractText [OPTIONS] <inputfile> [Text file] ``
+Usage: ``java -jar pdfbox-app-2.y.z.jar ExtractText [OPTIONS] <inputfile> [Text file] ``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password |  | The password to the PDF document. |
 | -encoding | default encoding | The encoding type of the text file, e.g. ISO-8859-1, UTF-8, UTF-16BE. |
@@ -114,9 +115,9 @@ usage: ``java -jar pdfbox-app-2.y.z.jar ExtractText [OPTIONS] <inputfile> [Text
 
 This application will overlay one document with the content of another document
 
-usage: ``java -jar pdfbox-app-2.y.z.jar OverlayPDF <input.pdf> [OPTIONS] <output.pdf>``
+Usage: ``java -jar pdfbox-app-2.y.z.jar OverlayPDF <input.pdf> [OPTIONS] <output.pdf>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | inputfile | | The PDF file to be overlayed. |
 | defaultOverlay.pdf  | | Default overlay file. |
@@ -139,9 +140,9 @@ Examples:
 This application will take an existing PDF document and allows to analyze and inspect the internal structure.
 It is used as replacement for the PDFReader which was removed in 2.0.0.
 
-usage: ``java -jar pdfbox-app-2.y.z.jar PDFDebugger [inputfile] ``
+Usage: ``java -jar pdfbox-app-2.y.z.jar PDFDebugger [inputfile] ``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password | | The password to the PDF document. |
 | -viewstructure | | Activates the "view structure" view on startup. |
@@ -151,7 +152,7 @@ usage: ``java -jar pdfbox-app-2.y.z.jar PDFDebugger [inputfile] ``
 
 This application will take a list of pdf documents and merge them, saving the result in a new document.
 
-usage: ``java -jar pdfbox-app-2.y.z.jar PDFMerger <Source PDF files (2 ..n)> <Target PDF file>``
+Usage: ``java -jar pdfbox-app-2.y.z.jar PDFMerger <Source PDF files (2 ..n)> <Target PDF file>``
 
 ## PDFSplit ##
 
@@ -160,9 +161,9 @@ This application will take an existing PDF document and split it into a number o
 Per default the resulting files will be named after the original filenmame with `-<nr>` appended before the suffix.
 To override the filename use the `outputPrefix` option.
 
-usage: ``java -jar pdfbox-app-2.y.z.jar PDFSplit [OPTIONS] <PDF file>``
+Usage: ``java -jar pdfbox-app-2.y.z.jar PDFSplit [OPTIONS] <PDF file>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password | | The password to the PDF document. |
 | -split | | Number of pages of every splitted part of the pdf.|
@@ -182,9 +183,9 @@ Examples:
 
 This application will create an image for every page in the PDF document.
 
-usage: ``java -jar pdfbox-app-2.y.z.jar PDFToImage [OPTIONS] <PDF file>``
+Usage: ``java -jar pdfbox-app-2.y.z.jar PDFToImage [OPTIONS] <PDF file>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password | | The password to the PDF document.|
 | -imageType | jpg | The image type to write to. Currently only jpg or png. |
@@ -198,9 +199,9 @@ This application will send a pdf document to the printer.
 
 <p class="alert alert-info">You must have the correct permissions to print the document!</p>
 
-usage: ``java -jar pdfbox-app-2.y.z.jar PrintPDF [OPTIONS] <inputfile>``
+Usage: ``java -jar pdfbox-app-2.y.z.jar PrintPDF [OPTIONS] <inputfile>``
 
-| Command Line Parameter | Description |
+| Command-Line Parameter | Description |
 | --- | --- |
 | -password | The password to decrypt the PDF. |
 | -silentPrint | Print the PDF without prompting for a printer. |
@@ -210,9 +211,9 @@ usage: ``java -jar pdfbox-app-2.y.z.jar PrintPDF [OPTIONS] <inputfile>``
 
 This application will create a PDF document from a text file.
 
-usage: ``java -jar pdfbox-app-2.y.z.jar TextToPDF [OPTIONS] <outputfile> <textfile>``
+Usage: ``java -jar pdfbox-app-2.y.z.jar TextToPDF [OPTIONS] <outputfile> <textfile>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -standardFont | Helvetica | The font to use for the text. Either this or -ttf should be specified but not both. |
 | -ttf | | The TTF font to use for the text. Either this or -standardFont should be specified but not both. |
@@ -239,9 +240,9 @@ The following font names can be used for the parameter ``standardFont``:
 
 An application to decompress PDF documents.
 
-usage: ``java -jar pdfbox-app-2.y.z.jar WriteDecodedDoc <input-file> <output-file>``
+Usage: ``java -jar pdfbox-app-2.y.z.jar WriteDecodedDoc <input-file> <output-file>``
 
-| Command Line Parameter | Default | Description |
+| Command-Line Parameter | Default | Description |
 | --- | --- | --- |
 | -password |  | The password to the PDF document. |
 | <input-file> |  | The PDF file to decompress |

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/2.0/cookbook/encryption.md
----------------------------------------------------------------------
diff --git a/content/2.0/cookbook/encryption.md b/content/2.0/cookbook/encryption.md
index 6959592..a512540 100644
--- a/content/2.0/cookbook/encryption.md
+++ b/content/2.0/cookbook/encryption.md
@@ -17,21 +17,21 @@ license: Licensed to the Apache Software Foundation (ASF) under one
          under the License.
 
 layout:  default
-title:   Cookbook - Encrypting a file
+title:   Cookbook - Encrypting a File
 ---
 
-Encrypting a file
+Encrypting a File
 =================
 
 PDF encryption requires two passwords: the "user password" to open and view the file with restricted permissions, the "owner password" to access the file with all permission.
 
 
-Load and save encrypted
+Load and Save Encrypted
 -----------------------
 
-This small sample shows how to encrypt a file so that it can be viewed, but not printed..
+This small sample shows how to encrypt a file so that it can be viewed, but not printed.
 
-``` java
+```java
 PDDocument doc = PDDocument.load("filename.pdf");
 
 // Define the length of the encryption key.
@@ -43,8 +43,8 @@ AccessPermission ap = new AccessPermission();
 // disable printing, everything else is allowed
 ap.setCanPrint(false);
         
-// owner password (to open the file with all permissions) is "12345"
-// user password (to open the file but with restricted permissions, is empty here) 
+// Owner password (to open the file with all permissions) is "12345"
+// User password (to open the file but with restricted permissions, is empty here) 
 StandardProtectionPolicy spp = new StandardProtectionPolicy("12345", "", ap);
 spp.setEncryptionKeyLength(keyLength);
 spp.setPermissions(ap);

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/2.0/dependencies.md
----------------------------------------------------------------------
diff --git a/content/2.0/dependencies.md b/content/2.0/dependencies.md
index 4da7fee..c1031e4 100644
--- a/content/2.0/dependencies.md
+++ b/content/2.0/dependencies.md
@@ -22,13 +22,13 @@ title:   Dependencies
 
 # Dependencies
 
-## Core components
+## Core Components
 
 <p class="alert alert-info">These components are needed during runtime, development and testing dependent on the details below.</p>
 
 The three PDFBox components are named ```pdfbox```, ```fontbox``` and ```xmpbox```. The Maven groupId of all PDFBox components is org.apache.pdfbox.
 
-### Minimum Requirement
+### Minimum Requirements
 
 PDFBox has the following basic dependencies:
 
@@ -47,18 +47,20 @@ For font handling the fontbox component is needed.
 ### XMP Metadata
 To support XMP metadata the xmpbox component is needed.
 
-### Include Dependencies using Maven
+### Include Dependencies Using Maven
 To add the pdfbox, fontbox, xmpbox and commons-logging jars to your application, the easiest thing is to declare the Maven dependency shown below. This gives you the main pdfbox library directly and the other required jars as transitive dependencies.
 
-    <dependency>
-      <groupId>org.apache.pdfbox</groupId>
-      <artifactId>pdfbox</artifactId>
-      <version>...</version>
-    </dependency>
+```xml
+<dependency>
+    <groupId>org.apache.pdfbox</groupId>
+    <artifactId>pdfbox</artifactId>
+    <version>...</version>
+</dependency>
+```
 
 Set the version field to the latest stable PDFBox version.
 
-## Optional components
+## Optional Components
 
 PDFBox does not ship with all features enabled. Third party components are necessary to get full support for certain functionality.
 
@@ -79,23 +81,25 @@ Maven dependencies for these components can be found in [parent/pom.xml](https:/
 
 Encrypting and sigining PDFs requires the *bcprov*, *bcmail* and *bcpkix* libraries from the [Legion of the Bouncy Castle](http://www.bouncycastle.org/). These can be included in your Maven project using the following dependencies:
 
-    <dependency>
-        <groupId>org.bouncycastle</groupId>
-        <artifactId>bcprov-jdk15on</artifactId>
-        <version>1.54</version>
-    </dependency>
-
-    <dependency>
-        <groupId>org.bouncycastle</groupId>
-        <artifactId>bcmail-jdk15on</artifactId>
-        <version>1.54</version>
-    </dependency>
-
-    <dependency>
-        <groupId>org.bouncycastle</groupId>
-        <artifactId>bcpkix-jdk15on</artifactId>
-        <version>1.54</version>
-    </dependency>
+```xml
+<dependency>
+    <groupId>org.bouncycastle</groupId>
+    <artifactId>bcprov-jdk15on</artifactId>
+    <version>1.54</version>
+</dependency>
+
+<dependency>
+    <groupId>org.bouncycastle</groupId>
+    <artifactId>bcmail-jdk15on</artifactId>
+    <version>1.54</version>
+</dependency>
+
+<dependency>
+    <groupId>org.bouncycastle</groupId>
+    <artifactId>bcpkix-jdk15on</artifactId>
+    <version>1.54</version>
+</dependency>
+```
 
 ### Java Cryptography Extension (JCE)
 
@@ -103,7 +107,7 @@ Encrypting and sigining PDFs requires the *bcprov*, *bcmail* and *bcpkix* librar
 
     JCE unlimited strength jurisdiction policy files are not installed
 
-## Dependencies for Ant builds
+## Dependencies for Ant Builds
 
 The above instructions expect that you're using [Maven](http://maven.apache.org/) or another build tool like
 [Ivy](http://ant.apache.org/ivy/) that supports Maven dependencies.

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/2.0/faq.md
----------------------------------------------------------------------
diff --git a/content/2.0/faq.md b/content/2.0/faq.md
index d42750f..2b18789 100644
--- a/content/2.0/faq.md
+++ b/content/2.0/faq.md
@@ -20,7 +20,7 @@ layout:  default
 title:   Frequently Asked Questions (FAQ)
 ---
 
-# Frequently asked questions
+# Frequently Asked Questions
 
 ### General Questions
 
@@ -44,7 +44,7 @@ title:   Frequently Asked Questions (FAQ)
  - [Why do I get "You do not have permission to extract text" on some documents?](#permission)
  - [Can't we just extract the text without parsing the whole document or extract text as it is parsed?](#partially)
 
-### PDF rendering
+### PDF Rendering
 
  - [A drop shadow is missing or at the wrong position when rendering a page](#dropshadow)  
 
@@ -54,7 +54,7 @@ title:   Frequently Asked Questions (FAQ)
 
 ### I am getting the below Log4J warning message, how do I remove it? ###
 
-```java
+```
 log4j:WARN No appenders could be found for logger (org.apache.pdfbox.util.ResourceLoader).
 log4j:WARN Please initialize the log4j system properly.
 ```
@@ -64,13 +64,13 @@ See the [log4j documentation](http://logging.apache.org/log4j/1.2/manual.html) f
 
 PDFBox comes with a sample log4j configuration file.  To use it you set a system property like this
 
-```java
+```
 java -Dlog4j.configuration=log4j.xml org.apache.pdfbox.ExtractText <PDF-file> <output-text-file>
 ```
 
 If this is not working for you then you may have to specify the log4j config file using a URL path, like this:
 
-```java
+```
 log4j.configuration=file:///<path to config file>
 ```
 

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/2.0/getting-started.md
----------------------------------------------------------------------
diff --git a/content/2.0/getting-started.md b/content/2.0/getting-started.md
index b6c441e..8d829b8 100644
--- a/content/2.0/getting-started.md
+++ b/content/2.0/getting-started.md
@@ -28,21 +28,23 @@ This content is under construction.
 
 To use the latest 2.0 snapshot release from the SVN trunk, you'll need to add the following dependency:
 
-    <dependency>
-      <groupId>org.apache.pdfbox</groupId>
-      <artifactId>pdfbox</artifactId>
-      <version>2.0.0</version>
-    </dependency>
+```xml
+<dependency>
+  <groupId>org.apache.pdfbox</groupId>
+  <artifactId>pdfbox</artifactId>
+  <version>2.0.0</version>
+</dependency>
+```
 
 ## PDFBox and Java 8 ##
 
-<p class="alert alert-warning">Important notice when using PDFBox with Java 8
-</p>
+<p class="alert alert-warning">Important notice when using PDFBox with Java 8</p>
+
 Due to the change of the java color management module towards "LittleCMS", users can experience slow performance in color operations.
-Solution: disable LittleCMS in favour of the old KCMS (Kodak Color Management System):
+A solution is to disable LittleCMS in favor of the old KCMS (Kodak Color Management System) by:
 
-- start with ``-Dsun.java2d.cmm=sun.java2d.cmm.kcms.KcmsServiceProvider``or call
-- ``System.setProperty("sun.java2d.cmm", "sun.java2d.cmm.kcms.KcmsServiceProvider");``
+ - Starting with ``-Dsun.java2d.cmm=sun.java2d.cmm.kcms.KcmsServiceProvider`` or
+ - Calling ``System.setProperty("sun.java2d.cmm", "sun.java2d.cmm.kcms.KcmsServiceProvider")``
 
 Sources:  
 http://www.subshell.com/en/subshell/blog/Wrong-Colors-in-Images-with-Java8-100.html  

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/2.0/migration.md
----------------------------------------------------------------------
diff --git a/content/2.0/migration.md b/content/2.0/migration.md
index 8c35aa1..bea25d9 100644
--- a/content/2.0/migration.md
+++ b/content/2.0/migration.md
@@ -34,7 +34,7 @@ There are some significant changes to the package structure of PDFBox:
 - all debugger related stuff was moved to the new package "pdfbox-debugger"
 - the new package "debugger-app" provides a standalone pre built binary for the debugger
 
-## Dependency updates
+## Dependency Updates
 All libraries on which PDFBox depends are updated to their latest stable versions:
 
 - Bouncy Castle 1.53

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/_layouts/default.html
----------------------------------------------------------------------
diff --git a/content/_layouts/default.html b/content/_layouts/default.html
index 74bd641..15790fe 100644
--- a/content/_layouts/default.html
+++ b/content/_layouts/default.html
@@ -89,7 +89,7 @@
                                     <li><a href="/2.0/cookbook/encryption.html">Document Encryption</a></li>
                                 </ul>
                             </li>
-                            <li><a href="/2.0/commandline.html">Command Line Tools</a></li>
+                            <li><a href="/2.0/commandline.html">Command-Line Tools</a></li>
                             <li><a href="/2.0/faq.html">FAQ</a></li>
                             <li><a href="/docs/2.0.3/javadocs/">API Docs</a></li>
                         </ul>
@@ -109,10 +109,10 @@
                                     <li><a href="/1.8/cookbook/workingwithmetadata.html">Working with Metadata</a></li>
                                     <li><a href="/1.8/cookbook/workingwithattachments.html">Working with Attachments</a></li>
                                     <li><a href="/1.8/cookbook/pdfavalidation.html">PDF/A Validation</a></li>
-                                    <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A document</a></li>
+                                    <li><a href="/1.8/cookbook/pdfacreation.html">Creating a PDF/A Document</a></li>
                                 </ul>
                             </li>
-                            <li><a href="/1.8/commandline.html">Command Line Tools</a></li>
+                            <li><a href="/1.8/commandline.html">Command-Line Tools</a></li>
                             <li><a href="/docs/1.8.12/javadocs/">API Docs</a></li>
                             <li><a href="/1.8/faq.html">FAQ</a></li>
                         </ul>

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/codingconventions.md
----------------------------------------------------------------------
diff --git a/content/codingconventions.md b/content/codingconventions.md
index 7f977a9..f626234 100644
--- a/content/codingconventions.md
+++ b/content/codingconventions.md
@@ -117,23 +117,25 @@ Over the years the PDFBox project has come to adopt a number of coding conventio
 
 Here's an example of PDFBox's formatting style:
 
-    public class Foo extends Bar
+```java
+public class Foo extends Bar
+{
+    public static void main(String args[])
     {
-        public static void main(String args[])
+        try
         {
-            try
+            for (int i = 0; i < args.length; i++)
             {
-                for (int i = 0; i < args.length; i++)
-                {
-                    System.out.println(Integer.parseInt(args[i]));
-                }
-            }
-            catch (NumberFormatException e)
-            {
-                e.printStackTrace();
+                System.out.println(Integer.parseInt(args[i]));
             }
         }
+        catch (NumberFormatException e)
+        {
+            e.printStackTrace();
+        }
     }
+}
+```
 
 ## Eclipse Formatter
 

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/ideas.md
----------------------------------------------------------------------
diff --git a/content/ideas.md b/content/ideas.md
index 8e38445..3873264 100644
--- a/content/ideas.md
+++ b/content/ideas.md
@@ -39,10 +39,9 @@ This is an ongoing effort and most/all deprecated methods will be removed in PDF
 In addition to the PDF parsing pdfbox does not always handle large PDF files well as some 
 of the references are implemented as int instead of long
 
-
 ## <span class="complete">Switch to Java 1.6</span>
 
-<span class="complete">PDFBox 2.0.0 has Java 6 as minimum requirement.</span>
+<span class="complete">PDFBox 2.0.0 has Java 6 as a minimum requirement.</span>
 
 ## <span class="complete">Break PDFBox into modules</span>
 
@@ -61,15 +60,15 @@ e.g. remove AWT from PDDocument.
 a PDF from top to bottom instead of respecting the XRef information.</span> The NonSequentialParser
 enhanced that situation but there is a need to have a cleaner foundation broken into several levels
 
-- io
-- tokenization
-- parsing according to structure
+- I/O
+- Tokenization
+- Parsing according to structure
 - COS level document
 - PD level document
-- add some self healing mechanism to process corrupt files
+- Add some self-healing mechanism to process corrupt files
 
-In addition handling documents which are not conforming shouldn't be part of the core parser
-but of a extentable approach e.g. by adding hooks to allow for handling parsing exceptions.
+In addition, handling documents which are not conforming shouldn't be part of the core parser
+but of an extensible approach, e.g. by adding hooks to allow for handling parsing exceptions.
 
 ## <span class="complete">Add the ability to create PDFs using unicode encoded text</span>
 
@@ -98,8 +97,8 @@ this is beneficial e.g. rendering, debugging ...
 - the caching parser would support applications such a PDFDebugger or PDFReader 
 
 ## Handling of PDF versions
+
 The current implementation is a mix of PDF 1.4 and some adhoc additions without a clear 
 distinction what is and is not supported. We could ad some support for explicitly handling
 versions in PDFBox e.g. my marking certain methods and properties to the PDF version support
 level. This could in addition be a good basis for PDF/A and other compliance checks. 
-

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/index.md
----------------------------------------------------------------------
diff --git a/content/index.md b/content/index.md
index 51ff6a7..7f561e6 100644
--- a/content/index.md
+++ b/content/index.md
@@ -25,7 +25,7 @@ title:   A Java PDF Library
     PDF documents. This project allows creation of new PDF documents, manipulation of existing
     documents and the ability to extract content from documents.
 
-    Apache PDFBox also includes several command line utilities.
+    Apache PDFBox also includes several command-line utilities.
     Apache PDFBox is published under the Apache License v2.0.</p>
 
 {% for post in site.categories.news limit:1 %}

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/references.md
----------------------------------------------------------------------
diff --git a/content/references.md b/content/references.md
index 287cf54..71c6a76 100644
--- a/content/references.md
+++ b/content/references.md
@@ -25,7 +25,7 @@ title:   External Links
 This page lists projects that utilize PDFBox and articles that have been written about PDFBox. 
 Please file an [improvement issue](https://issues.apache.org/jira/browse/PDFBOX) to get new projects or articles added to this page, or to update the information on existing links.
 
-## Projects using PDFBox
+## Projects Using PDFBox
 
 | Project Name | License | Project Description |
 | --- | --- | --- |

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/siteupdate.md
----------------------------------------------------------------------
diff --git a/content/siteupdate.md b/content/siteupdate.md
index ca05ad0..dd73ae9 100644
--- a/content/siteupdate.md
+++ b/content/siteupdate.md
@@ -22,9 +22,9 @@ title:   Updating the Website
 
 # Updating the PDFBox Website
 
-The content for the PDFBox website is kept in a [git repository](https://git-wip-us.apache.org/repos/asf/pdfbox-docs) which is also mirrored to [GitHub](https://github.com/apache/pdfbox-docs). The site is split into two parts: the static content and the Javadoc for the PDFBox API. Both parts are build independently as further described below.
+The content for the PDFBox website is kept in a [Git repository](https://git-wip-us.apache.org/repos/asf/pdfbox-docs) which is also mirrored to [GitHub](https://github.com/apache/pdfbox-docs). The site is split into two parts: the static content and the Javadoc for the PDFBox API. Both parts are build independently as further described below.
 
-## Project info
+## Project Info
 The site is based on [Jekyll](http://jekyllrb.com). So you have to be familiar with the [Markdown](http://daringfireball.net/projects/markdown/syntax) template language and have Jekyll (ver. 2+) installed to contribute to the project.
 
 ## Contribute
@@ -35,14 +35,14 @@ If you would like to enhance the website content you can submit a patch. To do s
 ### Install Jekyll
 Follow the instructions available on the [Jekyll](http://jekyllrb.com) website.
 
-### Check out from the git repository
-Before you can edit the site, you need to check it out from the git repository:
+### Checkout from the Git Repository
+Before you can edit the site, you need to check it out from the Git repository:
 
 ~~~
 git clone https://git-wip-us.apache.org/repos/asf/pdfbox-docs
 ~~~
 
-### Local changes
+### Local Changes
 You can now do the changes and additions to the sources of the PDFBox website. To test these locally use
 
 ~~~
@@ -55,24 +55,26 @@ which will compile the changes and run a local webserver at
 http://localhost:4000
 ~~~
 
-### Publish the website (for comitters only)
+### Publish the Website (For Comitters Only)
 After you have done the local changes follow these steps to publish the content:
 
 Add the following server configuration in your ~/.m2/settings.xml file
 
-	<server>
-	  <id>pdfbox-site</id>
-	  <username>** USERNAME **</username>
-	  <password>** PASSWORD **</password>
-	</server>
+~~~xml
+<server>
+  <id>pdfbox-site</id>
+  <username>** USERNAME **</username>
+  <password>** PASSWORD **</password>
+</server>
+~~~
 
 `pdfbox-site` is referenced from the PDFBox pom.xml file.
 
 <p class="alert alert-warning">The password should be encrypted following <a href="https://maven.apache.org/guides/mini/guide-encryption.html">Maven Password Encryption</a></p>
 
-Ensure that the new website content is build locally
+Ensure that the new website content can build locally
 
-~~~~
+~~~
 jekyll build
 ~~~
 
@@ -80,7 +82,7 @@ This will read the sources and generate the new content in the ``./staging`` dir
 
 When you are happy with the new content update the source repository
 
-~~~~
+~~~
 git commit -m "..."
 git push origin master
 ~~~
@@ -94,7 +96,7 @@ mvn scm-publish:publish-scm
 This will checkout the current content into the ``./target``directory, apply the changes from ``./staging`` and publish
 the changes to the PDFBox production website.
 
-### Update the JavaDocs for PDFBOX 2.x
+### Update the JavaDocs for PDFBox 2.x
 To publish the javadocs follow these steps:
 
 Run
@@ -105,4 +107,4 @@ from the `<SVN_ROOT>/../pdfbox` directory.
 
 It uses the same `pdfbox-site` settings from above to connect to the repository.
 
-<p class="alert alert-info">As <code>mvn clean</code> will delete the javadoc files download from the Apache CMS it's advised to configure <code>${svn.scmJavadocCheckoutDirectory}</code> to a local directory not below <code>./target</code>.</p>
\ No newline at end of file
+<p class="alert alert-info">As <code>mvn clean</code> will delete the javadoc files download from the Apache CMS it's advised to configure <code>${svn.scmJavadocCheckoutDirectory}</code> to a local directory not below <code>./target</code>.</p>

http://git-wip-us.apache.org/repos/asf/pdfbox-docs/blob/51beaa7f/content/support.md
----------------------------------------------------------------------
diff --git a/content/support.md b/content/support.md
index 2ddf4b1..f782abb 100644
--- a/content/support.md
+++ b/content/support.md
@@ -22,7 +22,7 @@ title:   Support
 
 # Support
 
-## Questions about How to use PDFBox
+## Questions About How to Use PDFBox
 
 If you have questions about how to use PDFBox do ask on the [Users Mailing List](/mailinglists.html "Subscribe to Mailing List"). This will get you help from the entire community.
 
@@ -31,39 +31,38 @@ The PDFBox examples and the test code in the sources will also provide additiona
 And there are additonal resources available on sites such as [Stack Overflow](http://stackoverflow.com/search?q=pdfbox "Stack Overflow").
 
 
-## Filing a bug report or enhancement request
+## Filing a Bug Report or Enhancement Request
 
 <p class="alert alert-info">Please refrain from immediately opening a ticket in the JIRA issue tracker unless
-you are really certain it's a problem in the PDFBox software. Try using the Mailing Lists
-before.</p>
+you are really certain it's a problem in the PDFBox software. Try using the Mailing Lists first.</p>
 
-If you are sure you have found a bug the please report the problem in our
+If you are sure you have found a bug then please report the problem in our
 [JIRA Issue Tracker](https://issues.apache.org/jira/browse/PDFBOX).
 
 **Before you submit a bug there are several things you can try first**
 
- - for **PDFBOX 1.8.x** try using the non-sequential parser (``PDDocument.loadNonSeq`` instead of ``PDDocument.load``, and "-nonSeq" with the command line applications)
- - for issues with text extraction try if Adobe Reader can extract the text
- - try the latest SNAPSHOT to see if it's fixed in the pre-release
- - search the mailing list to see if has been discussed before
- - check the JIRA issue tracker to see if the issue has already been reported
+ - For **PDFBOX 1.8.x** try using the non-sequential parser (``PDDocument.loadNonSeq`` instead of ``PDDocument.load``, and "-nonSeq" with the command-line applications)
+ - For issues with text extraction try if Adobe Reader can extract the text
+ - Try the latest SNAPSHOT to see if it's fixed in the pre-release
+ - Search the mailing list to see if has been discussed before
+ - Check the JIRA issue tracker to see if the issue has already been reported
 
-**To help us resolving a bug quicker**
+**To help us resolve a bug quicker**
 
- - attach the PDF that makes trouble by using "More", "Attach files" in the JIRA issue tracker
- - if your file is too large, upload it to a sharehoster, or use the PDFSplit application to isolate the troublesome page
- - mention the PDFBox version you are using.
- - attach the shortest possible code that reproduces the problem. Insert java code between {code}...{code}. Or try to reproduce the problem with the command line applications.
- - mention what you were doing, what was the expected behaviour, and what happened instead
- - provide a stack trace of an exception if there is one
+ - Attach the PDF that makes trouble by using "More", "Attach files" in the JIRA issue tracker
+ - If your file is too large, upload it to a sharehoster, or use the PDFSplit application to isolate the troublesome page
+ - Mention the PDFBox version you are using.
+ - Attach the shortest possible code that reproduces the problem. Insert java code between {code}...{code}. Or try to reproduce the problem with the command-line applications.
+ - Mention what you were doing, what was the expected behaviour, and what happened instead
+ - Provide a stack trace of an exception if there is one
  - Be patient: all the people here are unpaid volunteers who work for you in their free time
 
 **And please DON'T**
 
- - upload files to a hoster that requires registration to read the file.
- - create an issue in the JIRA issue tracker and then go on vacation so you won't repond to our questions / suggestions.
- - ask "how to" questions in JIRA issue tracker. Ask such questions on the mailing lists, on stackoverflow.com, and look at the sample and the test code in the sources.
- - attach PDF files with confidential and/or personal data (name, DoB, bank data, health data, SSN) without getting permission from the client and/or the people mentioned on the PDF
- - create issues about obsolete PDFBox versions
+ - Upload files to a host that requires registration to read the file.
+ - Create an issue in the JIRA issue tracker and then go on vacation so you won't repond to our questions / suggestions.
+ - Ask "how to" questions in the JIRA issue tracker. Ask such questions on the mailing lists, on stackoverflow.com, and look at the sample and the test code in the sources.
+ - Attach PDF files with confidential and/or personal data (name, DoB, bank data, health data, SSN) without getting permission from the client and/or the people mentioned on the PDF
+ - Create issues about obsolete PDFBox versions
 
 <p class="alert alert-info">We can sometimes solve problems without having the PDF, but it is difficult.</p>


Mime
View raw message