Markdown documentation added

Author: yevgen-nykytenko

.gitignore

@@ -0,0 +1 @@
+deploy_key

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "Docs/docs-common"]
+	path = Docs/docs-common
+	url = https://github.com/groupdocs/docs-common.git

.travis.yml

@@ -0,0 +1,40 @@
+git:
+  submodules: false
+
+branches:
+  only:
+  - master
+  
+env:
+  global:
+    - PRODUCT=comparison
+    - PLATFORM=java
+    - ROOT_DIR=Docs/docs-common
+    - SRC_DIR=Docs/docs-common/public
+    - DEST_DIR=/var/www/docs.groupdocs.com/html
+
+before_install:
+- openssl aes-256-cbc -K $encrypted_dfdcfd5172af_key -iv $encrypted_dfdcfd5172af_iv
+  -in deploy_key.enc -out ./deploy_key -d
+- sed -i 's/git@github.com:/https:\/\/github.com\//' .gitmodules
+- git submodule update --init --recursive Docs
+- git submodule foreach git pull origin master
+- eval "$(ssh-agent -s)"
+- chmod 600 ./deploy_key
+- echo -e "Host $HOST\n\tStrictHostKeyChecking no\n" >> ~/.ssh/config
+- ssh-add ./deploy_key
+
+install:
+- curl -LO https://github.com/gohugoio/hugo/releases/download/v0.67.1/hugo_extended_0.67.1_Linux-64bit.deb
+- sudo dpkg -i hugo_extended_0.67.1_Linux-64bit.deb
+
+script:
+- cp -r Docs/content/* $ROOT_DIR/content/
+- hugo --source $ROOT_DIR --minify --config config.toml,ignore-total-config.toml
+- mkdir -p $SRC_DIR/search-json
+- mv $SRC_DIR/index.json $SRC_DIR/search-json/$PRODUCT-$PLATFORM.json
+
+after_success:
+- scp -i ./deploy_key -r $SRC_DIR/$PRODUCT $USER@$HOST:$DEST_DIR
+- scp -i ./deploy_key -r $SRC_DIR/product-sitemap.xml $USER@$HOST:$DEST_DIR/sitemaps/$PRODUCT-$PLATFORM.xml
+- scp -i ./deploy_key -r $SRC_DIR/search-json/$PRODUCT-$PLATFORM.json $USER@$HOST:$DEST_DIR/search-json/$PRODUCT-$PLATFORM.json

Docs/README.md

@@ -0,0 +1,3 @@
+## GroupDocs.Comparison for Java Docs
+
+[![Build Status](https://travis-ci.com/groupdocs-comparison/GroupDocs.Comparison-for-Java.svg?branch=master)](https://travis-ci.com/groupdocs-comparison/GroupDocs.Comparison-for-Java)

Docs/content/comparison/java/_index.md

@@ -0,0 +1,25 @@
+---
+id: home
+url: comparison/java
+title: GroupDocs.Comparison for Java
+weight: 1
+description: ""
+keywords: 
+productName: GroupDocs.Comparison for Java
+hideChildren: True
+---
+{{< alert style="info" >}}Welcome to the GroupDocs.Comparison for JavaIt is a Difference Checker and Documents Merging API. Supported are all industry standard document formats: PDF, OpenDocument, HTML, Microsoft Word, Excel, PowerPoint and Text files. It compares both Content and Styles of the documents. Supported with out-of-box ‘Track Changes’ functionality producing a summary file listing the source files with the changes made.{{< /alert >}}
+
+## GroupDocs.Comparison for Java Resources
+
+Following are the links to some useful resources you may need to accomplish your tasks.
+
+*   [GroupDocs.Comparison for Java Online Documentation]({{< ref "comparison/java" >}})
+*   [GroupDocs.Comparison for Java Features]({{< ref "comparison/java/getting-started/features-overview.md" >}})
+*   [GroupDocs.Comparison for Java Limitations]({{< ref "comparison/java/getting-started/evaluation-limitations-and-licensing-of-groupdocs.comparison.md" >}})
+*   [GroupDocs.Comparison for Java Release Notes]({{< ref "comparison/java/release-notes/_index.md" >}})
+*   [GroupDocs.Comparison for Java Product Page](https://products.groupdocs.com/comparison/java)
+*   [Download GroupDocs.Comparison for Java](https://repository.groupdocs.com/webapp/#/artifacts/browse/tree/General/repo/com/groupdocs/groupdocs-comparison)
+*   [GroupDocs.Comparison for Java API Reference Guide](https://apireference.groupdocs.com/java/comparison)
+*   [GroupDocs.Comparison for Java Free Support Forum](https://forum.groupdocs.com/c/comparison)
+*   [GroupDocs.Comparison for Java Paid Support Helpdesk](https://helpdesk.groupdocs.com/)

Docs/content/comparison/java/developer-guide/_index.md

@@ -0,0 +1,11 @@
+---
+id: developer-guide
+url: comparison/java/developer-guide
+title: Developer Guide
+weight: 3
+description: ""
+keywords: 
+productName: GroupDocs.Comparison for Java
+hideChildren: False
+---
+{{< alert style="info" >}}This section describes some basic and advanced use cases of GroupDocs.Comparison for Java. Please refer to GitHub repository for more examples and samples.{{< /alert >}}

Docs/content/comparison/java/developer-guide/advanced-usage/_index.md

@@ -0,0 +1,13 @@
+---
+id: advanced-usage
+url: comparison/java/advanced-usage
+title: Advanced Usage
+weight: 2
+description: ""
+keywords: 
+productName: GroupDocs.Comparison for Java
+hideChildren: False
+---
+Along with the ability to compare documents using a couple lines of code **[ GroupDocs.Comparison](https://products.groupdocs.com/comparison/java)** API allows to fine tune the whole comparison process from start to end - like loading compared documents in different ways, selecting desired comparison sensitivity and detalisation level, accepting or rejecting detected changes, saving results in different ways, generate source and target documents preview in image form and many other. 
+
+Learn more about advanced GroupDocs.Comparison features from the guides below.

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/_index.md

@@ -0,0 +1,30 @@
+---
+id: comparison
+url: comparison/java/comparison
+title: Comparison
+weight: 2
+description: ""
+keywords: 
+productName: GroupDocs.Comparison for Java
+hideChildren: False
+---
+[**GroupDocs.Comparison**](https://products.groupdocs.com/comparison/java) provides many ways to customize changes detection algorithm logic and produced results via changing [CompareOptions](https://apireference.groupdocs.com/comparison/net/groupdocs.comparison.options/compareoptions) class properties.   
+Here are the list of settings that can be customized during comparison process:
+
+*   CalculateCoordinates - Indicates whether to calculate coordinates for changed components;
+*   ChangedItemStyle - Describes style for changed components;
+*   DeletedItemStyle - Describes style for deleted components;
+*   DetalisationLevel - Gets of sets the comparison detalisation level;
+*   DetectStyleChanges - Indicates whether to detect style changes or not;
+*   DiagramMasterSetting - Gets or sets the path value for master or use compare without path of master (this option only for Diagram);
+*   GenerateSummaryPage - Indicates whether to add summary page with detected changes statistics to resultant document or not;
+*   InsertedItemStyle - Describes style for inserted components;
+*   MarkChangedContent - Indicates whether to use frames for shapes in Word Processing and for rectangles in Image documents;
+*   MarkNestedContent - Indicates whether to accept inserted/deleted styles for all children of inserted/deleted components;
+*   OriginalSize - Get or sets the original sizes of comparing documents;
+*   PasswordSaveOption - Gets or sets the password save option. More details [here]({{< ref "comparison/java/developer-guide/advanced-usage/saving/set-password-for-resultant-document.md" >}});
+*   SensitivityOfComparison - Gets or sets the comparison sensitivity. More details [here]({{< ref "comparison/java/developer-guide/advanced-usage/comparison/adjusting-comparison-sensitivity.md" >}});
+*   ShowDeletedContent - Indicates whether to show deleted components in resultant document or not;
+*   WordsSeparatorChars - Sets an array of delimiters to split text into words;
+
+For more details about described options please refer to the following guides:

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/accept-or-reject-document-changes.md

@@ -0,0 +1,70 @@
+---
+id: accept-or-reject-document-changes
+url: comparison/java/accept-or-reject-document-changes
+title: Accept or Reject document changes
+weight: 1
+description: ""
+keywords: 
+productName: GroupDocs.Comparison for Java
+hideChildren: False
+---
+**[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java)** provides an ability to apply or discard specific changes between source and target files and save result with (or without) selected changes. 
+
+The following are the steps to apply/reject changes to resultant file.
+
+*   Instantiate [Comparer](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison/Comparer) objectwith source document path or stream;
+*   Call [add](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison/Comparer#add(java.lang.String)) method  and specify path target document path or stream;
+*   Call [compare](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison/Comparer#compare(java.lang.String)) method;
+*   Call [getChanges](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison/Comparer#getChanges()) method and obtain detected changes list;
+*   Set [ComparisonAction](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/ComparisonAction) of needed change object to [ComparisonAction.ACCEPT](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/ComparisonAction#ACCEPT) or [ComparisonAction.REJECT](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison.result/ComparisonAction#REJECT) value;
+*   Call [applyChanges](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison/Comparer#applyChanges(java.io.OutputStream,%20com.groupdocs.comparison.options.ApplyChangeOptions)) method and pass collection of changes to it;
+
+ApplyChangeOptions class:
+
+*   **getChanges** - List of changes that must be applied (or not) to the resulting document;
+
+The following code sample shows how to accept/reject detected changes.
+
+## Accept or Reject changes from local disk
+
+```java
+Comparer comparer = new Comparer("C:\\source.pdf");
+try {
+    comparer.add("C:\\target.pdf");
+    comparer.compare("C:\\result.pdf");
+} finally {
+    comparer.dispose();
+}
+```
+
+## Accept or Reject changes from stream
+
+```java
+Comparer comparer = new Comparer("C:\\source.pdf");
+try {
+    comparer.add("C:\\target.pdf");
+    comparer.compare();
+    ChangeInfo[] changes = comparer.getChanges();
+    changes[0].setComparisonAction(ComparisonAction.REJECT);
+    comparer.applyChanges(new FileOutputStream("C:\\result.pdf"), new ApplyChangeOptions(changes));
+} finally {
+    comparer.dispose();
+}
+```
+
+## More resources
+
+### GitHub Examples
+You may easily run the code above and see the feature in action in our GitHub examples:
+
+*   [GroupDocs.Comparison for Java examples, plugins, and showcase](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java)
+*   [GroupDocs.Comparison for .NET examples, plugins, and showcase](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET)
+*   [Document Comparison for Java App Dropwizard UI Modern Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java-Dropwizard)    
+*   [Document Comparison for Java Spring UI Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java-Spring)    
+*   [Document Comparison for .NET MVC UI Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-MVC)    
+*   [Document Comparison for .NET App WebForms UI Modern Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-WebForms)
+    
+
+### Free Online App
+Along with full-featured Java library we provide simple, but powerful free Apps.
+You are welcome to compare your DOC or DOCX, XLS or XLSX, PPT or PPTX, PDF, EML, EMLX, MSGand other documents with free to use online **[GroupDocs Comparison App](https://products.groupdocs.app/comparison)**.

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/adjusting-comparison-sensitivity.md

@@ -0,0 +1,80 @@
+---
+id: adjusting-comparison-sensitivity
+url: comparison/java/adjusting-comparison-sensitivity
+title: Adjusting comparison sensitivity
+weight: 2
+description: ""
+keywords: 
+productName: GroupDocs.Comparison for Java
+hideChildren: False
+---
+**[GroupDocs.Comparison](https://products.groupdocs.com/comparison/java)** allows to adjust comparison sensitivity to achieve the necessary balance between file comparison speed and accuracy. Possible comparison sensitivity values range is from **0** to **100**.
+
+*   **Minimal value** - the minimal value is **0**. Setting sensitivity to a minimal value provides the fastest comparison speed, but it may produce worst comparison quality.  
+    If there is at least one common letter in two compared words then these words will not be treated as fully inserted and deleted
+*   **Value by default**  - the default value is **75**. Comparison occurs when the percentage of deleted or inserted elements in relation to all elements does not exceed 75%.
+*   **Maximum value** - the maximum values is **100**. Comparison occurs at any length of a common sub-sequence of two compared objects. This option provides the best quality, but slowest comparison speed.    
+
+For better understanding about how comparison algorithms work let's suppose we have two strings:
+
+```java
+1. It is our equity poetry
+2. Jack is a glad calf
+```
+
+*Case 1.* If **SensitivityOfComparison = 80%** comparison of these two strings will produce the next result:We will highlight removed text parts with **red **and inserted parts with **blue** color. So, these strings have two common sub-sequences: **"is  "** word and 4 space symbols.  
+Common sub-sequence is - **"is   "** and its length is 6 symbols (there are 4 space symbols in it).  
+Length of inserted sub-sequence is 13 symbols - **Jackagladcalf** Removed sub-sequence length is 17 symbols - **Itourequitypoetry** Lets calculate percent of removed and inserted symbols: (17 + 13) / (17 + 13 + 6) \* 100 = 83%
+
+**Jack is a glad calf****It is our equity poetry**
+
+Because calculated percent of removed and inserted symbols equals **83%** and it is bigger than value of **SensitivityOfComparison** (equals **80%**) then this common sub-sequence will be not taken into account.  
+The first string considered completely removed and the second string considered completely inserted. The same results will be produced for any calculated percent less than **83%**.
+
+*Case 2. *If**SensitivityOfComparison = 85%**, comparison of these two strings will produce the next result:  
+**Jack****It**** is ****a****our****glad****equity****calf****poetry**
+
+Common sub-sequence was found, because **85% > 83%**. The same results will be produced for any calculated percent bigger than **83%**.
+
+Here are the steps to compare files with specific comparison sensitivity:
+
+*   Instantiate [Comparer](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison/Comparer) objectwith source file path or stream;    
+*   Call [add](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison/Comparer#add(java.lang.String)) method and specify target file path or stream.    
+*   Instantiate [CompareOptions](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/CompareOptions) object with desired [setSensitivityOfComparison](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/CompareOptions#getSensitivityOfComparison()) value;    
+*   Call [compare](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison/Comparer#compare(java.lang.String,%20com.groupdocs.comparison.options.CompareOptions)) method and pass [CompareOptions](https://apireference.groupdocs.com/comparison/java/com.groupdocs.comparison.options/CompareOptions) object to method;
+    
+
+The following code snippet demonstrates how compare files with specific sensitivity: 
+
+## Compare files with sensitivity adjustment
+
+```java
+Comparer comparer = new Comparer("C:\\source.pdf");
+try {
+    comparer.add("C:\\target.pdf");
+
+    CompareOptions compareOptions = new CompareOptions();
+    compareOptions.setSensitivityOfComparison(100);
+
+    comparer.compare("C:\\result.pdf", compareOptions);
+} finally {
+    comparer.dispose();
+}
+```
+
+## More resources
+
+### GitHub Examples
+You may easily run the code above and see the feature in action in our GitHub examples:
+
+*   [GroupDocs.Comparison for Java examples, plugins, and showcase](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java)
+*   [GroupDocs.Comparison for .NET examples, plugins, and showcase](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET)
+*   [Document Comparison for Java App Dropwizard UI Modern Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java-Dropwizard)    
+*   [Document Comparison for Java Spring UI Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-Java-Spring)    
+*   [Document Comparison for .NET MVC UI Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-MVC)    
+*   [Document Comparison for .NET App WebForms UI Modern Example](https://github.com/groupdocs-comparison/GroupDocs.Comparison-for-.NET-WebForms)
+    
+
+### Free Online App
+Along with full-featured Java library we provide simple, but powerful free Apps.
+You are welcome to compare your DOC or DOCX, XLS or XLSX, PPT or PPTX, PDF, EML, EMLX, MSGand other documents with free to use online **[GroupDocs Comparison App](https://products.groupdocs.app/comparison)**.