This repository contains the AsciiDoc and other sources to build the Neo4j Driver Manual.
The examples for each of the driver languages are generated out of each driver’s source code repository:
-
Clone the repository and checkout the branch you want to build.
-
npm installto install the required node.js packages -
To build and view the HTML:
npm start
This repo mostly functions in the same way as any other Antora repo, such as docs-getting-started, docs-java-reference.
The key difference with driver-documentation is that it includes remote content from the Neo4j Driver repos. To do this, the repo uses the neo4j-documentation/remote-include package as an asciidoc extension.
Code from the driver repos is included by adding attributes to the antora.yml file.
The antora.yml file contains an attribute that contains a path to the examples.
Note that from Antora 3.1.0, attributes can be referenced by other attributes, allowing the following configuration:
asciidoc:
attributes:
dotnet-driver-apidoc-version: '4.4'
dotnet-examples: https://raw.githubusercontent.com/neo4j/neo4j-dotnet-driver/{dotnet-driver-apidoc-version}/Neo4j.Driver/Neo4j.Driver.Tests.IntegrationIn the driver code repo, include example code, with a start and end tag:
// tag::transaction-function[]
public void AddPerson(string name)
{
using (var session = Driver.Session())
{
session.WriteTransaction(tx => tx.Run("CREATE (a:Person {name: $name})", new {name}).Consume());
}
}
// end::transaction-function[]In a page, to include the transaction-function code, use the {dotnet-examples} attribute, adding the tag to the options:
[source, csharp, indent=0]
----
include::{dotnet-examples}/Examples.cs[tags=transaction-function]
----
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent