[3/4] lucene-solr:branch_7_6: Ref Guide: accidentally back-ported 8.0 changes to 7.x branches

[ct...@apache.org]

Ref Guide: accidentally back-ported 8.0 changes to 7.x branches


Project: http://git-wip-us.apache.org/repos/asf/lucene-solr/repo
Commit: http://git-wip-us.apache.org/repos/asf/lucene-solr/commit/f0d7d73e
Tree: http://git-wip-us.apache.org/repos/asf/lucene-solr/tree/f0d7d73e
Diff: http://git-wip-us.apache.org/repos/asf/lucene-solr/diff/f0d7d73e

Branch: refs/heads/branch_7_6
Commit: f0d7d73e5bde72c56be57a7115e7915c887ceab5
Parents: e99fef1
Author: Cassandra Targett <ct...@apache.org>
Authored: Tue Nov 13 08:17:52 2018 -0600
Committer: Cassandra Targett <ct...@apache.org>
Committed: Tue Nov 13 08:21:47 2018 -0600

----------------------------------------------------------------------
 ...g-data-with-solr-cell-using-apache-tika.adoc | 27 ++++++++------------
 1 file changed, 10 insertions(+), 17 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/lucene-solr/blob/f0d7d73e/solr/solr-ref-guide/src/uploading-data-with-solr-cell-using-apache-tika.adoc
----------------------------------------------------------------------
diff --git a/solr/solr-ref-guide/src/uploading-data-with-solr-cell-using-apache-tika.adoc b/solr/solr-ref-guide/src/uploading-data-with-solr-cell-using-apache-tika.adoc
index 7acc709..af9e781 100644
--- a/solr/solr-ref-guide/src/uploading-data-with-solr-cell-using-apache-tika.adoc
+++ b/solr/solr-ref-guide/src/uploading-data-with-solr-cell-using-apache-tika.adoc
@@ -26,23 +26,16 @@ If you want to supply your own `ContentHandler` for Solr to use, you can extend
 
 When using the Solr Cell framework, it is helpful to keep the following in mind:
 
-* Tika will automatically attempt to determine the input document type (e.g., Word, PDF, HTML) and extract the content appropriately.
-If you like, you can explicitly specify a MIME type for Tika with the `stream.type` parameter.
-See http://tika.apache.org/{ivy-tika-version}/formats.html for the file types supported.
-* Briefly, Tika internally works by synthesizing an XHTML document from the core content of the parsed document which is passed to a configured http://www.saxproject.org/quickstart.html[SAX] ContentHandler provided by Solr Cell.
-Solr responds to Tika's SAX events to create one or more text fields from the content.
-Tika exposes document metadata as well (apart from the XHTML).
-* Tika produces metadata such as Title, Subject, and Author according to specifications such as the DublinCore.
-The metadata available is highly dependent on the file types and what they in turn contain.
-Solr Cell supplies some metadata of its own too.
-* Solr Cell concatenates text from the internal XHTML into a `content` field.
-You can configure which elements should be included/ignored, and which should map to another field.
-* Solr Cell maps each piece of metadata onto a field.
-By default it maps to the same name but several parameters control how this is done.
-* When Solr Cell finishes creating the internal `SolrInputDocument`, the rest of the Lucene/Solr indexing stack takes over.
-The next step after any update handler is the <<update-request-processors.adoc#update-request-processors,Update Request Processor>> chain.
-
-[NOTE]
+* Tika will automatically attempt to determine the input document type (Word, PDF, HTML) and extract the content appropriately. If you like, you can explicitly specify a MIME type for Tika with the `stream.type` parameter.
+* Tika works by producing an XHTML stream that it feeds to a SAX ContentHandler. SAX is a common interface implemented for many different XML parsers. For more information, see http://www.saxproject.org/quickstart.html.
+* Solr then responds to Tika's SAX events and creates the fields to index.
+* Tika produces metadata such as Title, Subject, and Author according to specifications such as the DublinCore. See http://tika.apache.org/{ivy-tika-version}/formats.html for the file types supported.
+* Tika adds all the extracted text to the `content` field.
+* You can map Tika's metadata fields to Solr fields.
+* You can pass in literals for field values. Literals will override Tika-parsed values, including fields in the Tika metadata object, the Tika content field, and any "captured content" fields.
+* You can apply an XPath expression to the Tika XHTML to restrict the content that is produced.
+
+[TIP]
 ====
 While Apache Tika is quite powerful, it is not perfect and fails on some files. PDF files are particularly problematic, mostly due to the PDF format itself. In case of a failure processing any file, the `ExtractingRequestHandler` does not have a secondary mechanism to try to extract some text from the file; it will throw an exception and fail.
 ====