summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--README.md24
1 files changed, 19 insertions, 5 deletions
diff --git a/README.md b/README.md
index dafc2ac..3ff0654 100644
--- a/README.md
+++ b/README.md
@@ -6,22 +6,31 @@ This is a simple python library for parsing the TEI-XML structured documents
returned by [GROBID](https://github.com/kermitt2/grobid), a machine learning
tool for extracting text and bibliographic metadata from research article PDFs.
-TEI-XML is a standard format, and there are other libraries to parse entire
+TEI-XML is a standard format, and there exist other libraries to parse entire
documents and work with annotated text. This library is focused specifically on
extracting "header" metadata from document (eg, title, authors, journal name,
volume, issue), content in flattened text form (full abstract and body text as
single strings, for things like search indexing), and structured citation
metadata.
+
+## Quickstart
+
`grobid_tei_xml` works with Python 3, using only the standard library. It does
not talk to the GROBID HTTP API or read files off disk on it's own, but see
-examples below.
+examples below. The library is packaged on [pypi.org](https://pypi.org).
+
+Install using `pip`, usually within a `virtualenv`:
-In the near future, it should be possible to install `grobid_tei_xml` from
-[pypi.org](https://pypi.org) using `pip`.
+ pip install grobid_tei_xml
+The main entry points are the function `process_document_xml(xml_text)` and
+`process_citations_xml(xml_text)`, which return python dataclass objects. The
+helper method `.to_dict()` can be useful for, eg, serializing these objects to
+JSON.
-## Use Examples
+
+## Usage Examples
Read an XML file from disk, parse it, and print to stdout as JSON:
@@ -101,6 +110,11 @@ python object or, eg, JSON.
[GROBID Documentation](https://grobid.readthedocs.io/en/latest/)
+[s2orc-doc2json](https://github.com/allenai/s2orc-doc2json): Python library
+from AI2 which includes a similar Python library for extracting both
+bibliographic metadata and (structured) full text from GROBID TEI-XML. Has nice
+features like resolving references to bibliography entry.
+
[delb](https://github.com/funkyfuture/delb): more flexible/powerful interface
to TEI-XML documents. would be a better tool for working with structured text
(body, abstract, etc)