-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
0 parents
commit cf3463b
Showing
12 changed files
with
4,285 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,18 @@ | ||
name: Trigger Publish | ||
|
||
on: | ||
push: | ||
branches: | ||
- publish | ||
|
||
jobs: | ||
trigger_publish: | ||
runs-on: ubuntu-latest | ||
|
||
steps: | ||
- name: Trigger Developer Event | ||
uses: peter-evans/repository-dispatch@master | ||
with: | ||
token: ${{ secrets.BUILD_ACCESS_TOKEN }} | ||
repository: neo4j-documentation/docs-refresh | ||
event-type: labs |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,3 @@ | ||
.DS_Store | ||
build | ||
node_modules/ |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,46 @@ | ||
= Neo4j Labs Pages | ||
|
||
image::https://github.com/neo4j-documentation/labs-pages/workflows/Trigger%20Publish/badge.svg[Trigger Publish] | ||
image::https://github.com/neo4j-documentation/docs-refresh/workflows/Publish%20Labs/badge.svg[Publish Labs] | ||
|
||
Built with link:https://antora.org/[Antora^]. | ||
|
||
- link:https://docs.antora.org/antora/2.3/standard-directories/[Standard File and Directory Set^] | ||
- link:https://docs.antora.org/antora/2.3/module-directories/[Module Directories and Modules^] | ||
== Installation | ||
|
||
To build these docs locally you will need link:https://nodejs.org/en/download/package-manager/[Node & NPM^] installed. | ||
|
||
To install the dependencies run: | ||
|
||
[source,sh] | ||
npm install | ||
|
||
|
||
== Live Preview | ||
|
||
To preview the docs, run: | ||
|
||
[source,sh] | ||
npm run dev | ||
|
||
|
||
This will build a set of HTML files in `build/site` and then serve them through an express server at http://localhost:8000. | ||
The dev script will also listen for changes and automatically rebuild the files automatically. | ||
You'll still need to refresh the page to view the changes. | ||
|
||
|
||
== Publishing | ||
|
||
Pushing to the `publish` branch of this repo will trigger a rebuild of the HTML and CSS files in the link:https://github.com/neo4j-documentation/docs-refresh[Docs Refresh^] repo using a Github Action. | ||
|
||
|
||
[source,sh] | ||
git clone https://github.com/neo4j-documentation/labs-pages | ||
git add . | ||
git commit -m "My changes" | ||
git push origin HEAD:publish | ||
|
||
At the end of the build process, the files are uploaded to the `static-content.neo4j.com` S3 Bucket. From there, they are synced up to the Neo4j.com server once an hour, on the hour by a cronjob. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
name: labs | ||
version: master | ||
title: Neo4j Labs | ||
start_page: ROOT:index.adoc | ||
nav: | ||
- modules/ROOT/nav.adoc | ||
- modules/apoc/nav.adoc | ||
- modules/etl-tool/nav.adoc | ||
- modules/grandstack-graphql/nav.adoc | ||
# - modules/graph-algorithms/nav.adoc | ||
- modules/halin/nav.adoc | ||
- modules/neo4j-helm/nav.adoc | ||
- modules/neosemantics/nav.adoc | ||
- modules/kafka/nav.adoc | ||
|
||
asciidoc: | ||
attributes: | ||
page-theme: labs | ||
|
||
community-name: Neo4j Community Site | ||
community-url: https://community.neo4j.com/ | ||
neosemantics-category-name: Linked Data, RDF, Ontology | ||
neosemantics-category-url: https://community.neo4j.com/c/integrations/linked-data-rdf-ontology/162 |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,2 @@ | ||
* xref:index.adoc[Labs Home] | ||
* link:/developer/graph-algorithms[Graph Algorithms Library^] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,87 @@ | ||
= Neo4j Labs | ||
:description: Incubating the next generation of graph developer tooling. GraphQL and GRANDstack, Algorithms, APOC, Kafka, ETL Tool, neovis.js, and more. | ||
:page-layout: labs | ||
:page-theme: labs | ||
:page-herotitle: Neo4j Labs | ||
:page-herosubtitle: Incubating the Next Generation of Graph Developer Tooling | ||
|
||
[.secondary] | ||
== What is Neo4j Labs? | ||
Neo4j Labs is a collection of the latest innovations in graph technology. | ||
These projects are designed and developed by the Neo4j team as a way to test functionality and extensions of our link:https://neo4j.com/product/?ref=labs[product offerings]. | ||
A project typically either graduates to being maintained as a formal Neo4j project or is deprecated with source made available publicly. | ||
|
||
These Labs are supported via the link:https://community.neo4j.com/?_ga=2.65967848.79768660.1594637016-1548419832.1589810895[online community]. | ||
They are actively developed and maintained, but we don't provide any SLAs or guarantees around backwards compatibility and deprecation. | ||
|
||
|
||
== Current Projects | ||
|
||
=== link:https://neo4j.com/developer/graph-algorithms/[Graph Algorithms Library] | ||
|
||
To enable large scale graph analytics and to support machine learning pipelines, we developed the link:https://neo4j.com/developer/graph-algorithms/[Neo4j Graph Algorithms^] library, which covers many widely used algorithms. | ||
The library offers highly parallelized implementation that works well with large scale graphs. | ||
|
||
[#goals.incremental] | ||
=== xref:grandstack-graphql:index.adoc[GraphQL and GRANDstack] | ||
GraphQL has become a comprehensive stack for API development and consolidation. | ||
Our link:https://www.grandstack.io[GRANDstack^] and Neo4j-GraphQL-js offerings combine the most common tools and frameworks: GraphQL, React, Apollo and Neo4j Database. | ||
|
||
|
||
=== xref:apoc:index.adoc[Awesome Procedures on Cypher (APOC)] | ||
|
||
As the most comprehensive developer toolkit for Neo4j, the xref:apoc:index.adoc[APOC library] provides a wide range of procedures and functions that make your life as a Neo4j user easier. | ||
APOC includes data integration, graph refactoring, data conversion, operational functionality and more. | ||
|
||
=== xref:halin:index.adoc[Halin Monitoring App] | ||
|
||
The link:https://neo4j.com/labs/halin[Halin Monitoring App] allows you to monitor your Neo4j deployment and identify bottlenecks or incorrect configurations, with insights into currently running queries and workloads. | ||
The app also provides access to metrics and logs. | ||
|
||
|
||
=== xref:kafka:index.adoc[Kafka Integration] | ||
|
||
Streaming event data is an integral part of most modern data architectures. | ||
With xref:kafka:index.adoc[Neo4j Kafka Integration] you can integrate Neo4j both as a sink or source into your setup. | ||
The integration is available as a Kafka Connect plugin and Neo4j Server extension.. | ||
|
||
|
||
=== xref:etl-tool:index.adoc[ETL Tool] | ||
|
||
Having an easy way of loading data from relational databases into Neo4j is one of the first steps many users take. | ||
The xref:etl-tool:index.adoc[Neo4j-ETL Tool] makes this easy by inferring a graph model from the relational meta model that you can then adapt to fit your needs. | ||
Given that transformation, this tool also handles the actual import for you. | ||
|
||
=== xref:neosemantics:index.adoc[Neosemantics] | ||
|
||
xref:neosemantics:index.adoc[Neosemantics] integrates RDF and Linked Data with Neo4j. | ||
It allows to import a wide variety of RDF formats and to expose Neo4j property graphs as Linked Data. | ||
Ontology and Inference are also partially supported. | ||
|
||
=== xref:neo4j-helm:index.adoc[Neo4j-Helm] | ||
|
||
xref:neo4j-helm:index.adoc[Neo4j-Helm] is a tool for configuring and deploying Neo4j instances on Kubernetes. By using the Helm | ||
package manager for Kubernetes, it makes it simple to specify advanced configurations of Neo4j, both standalone and cluster, and | ||
run them with Kubernetes across many cloud platforms. | ||
|
||
=== Other Active Projects | ||
|
||
* link:https://github.com/neo4j-contrib/neovis.js/[Neovis.js^], a graph visualization toolkit for the web | ||
* link:https://github.com/neo4j-contrib/neo4j-spark-connector/[The Neo4j-Spark-Connector^], library to exchange graph data between Neo4j and Apache Spark | ||
|
||
[.secondary] | ||
== Frequently Asked Questions | ||
|
||
=== Are these safe to use in production? | ||
Current Neo4j Labs projects are being actively worked on by our engineers, and may be rough around the edges, with changing APIs, as they push the edge of the envelope. Therefore, we cannot provide official commercial support for these projects or guarantee longevity. However, some Neo4j customers and users still love the functionality of these projects and choose to continue using them in production environments. | ||
|
||
=== How do I contribute? | ||
We welcome contributions for those labs which are open source projects. You'll find links to GitHub repositories - feel free to submit PRs. We've also created a discussion category for Labs on link:https://community.neo4j.com[community.neo4j.com^] | ||
|
||
=== Which Neo4j Labs projects have graduated? | ||
The link:https://hub.docker.com/_/neo4j[Neo4j Docker containers] started off as a Labs project to explore how well Neo4j would run in a containerized environment. They quickly gained popularity and are heavily used by both Neo4j and customers, so we've graduated them to be officially part of the Neo4j release distribution. | ||
|
||
We've also had features originally implemented as plugins and extensions moved into the core product. This includes link:https://neo4j.com/graphconnect-2018/session/neo4j-spatial-mapping[spatial functionality^] and APOC link:https://neo4j.com/docs/operations-manual/3.5/reference/procedures/[meta graph^] plus link:https://neo4j.com/docs/operations-manual/current/performance/index-configuration/fulltext/[full text indexing^]. | ||
|
||
=== Which Neo4j Labs projects have been deprecated? | ||
The MongoDB Doc Manager and Cassandra Connector have both been deprecated. The source is still available on GitHub, but we found most developers could accomplish similiar goals by using APOC, Kafka and other technologies. |
Oops, something went wrong.