Skip to content

Commit

Permalink
initial project setup
Browse files Browse the repository at this point in the history
  • Loading branch information
akollegger committed Aug 28, 2020
0 parents commit cf3463b
Show file tree
Hide file tree
Showing 12 changed files with 4,285 additions and 0 deletions.
18 changes: 18 additions & 0 deletions .github/workflows/main.yml
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
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
.DS_Store
build
node_modules/
46 changes: 46 additions & 0 deletions README.adoc
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.

23 changes: 23 additions & 0 deletions antora.yml
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
2 changes: 2 additions & 0 deletions modules/ROOT/nav.adoc
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^]
87 changes: 87 additions & 0 deletions modules/ROOT/pages/index.adoc
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.
Loading

0 comments on commit cf3463b

Please sign in to comment.