# docs-aws-glue-connector **Repository Path**: mirrors_neo4j/docs-aws-glue-connector ## Basic Information - **Project Name**: docs-aws-glue-connector - **Description**: Docs for the Neo4j Connector for AWS Glue - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: main - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-11-16 - **Last Updated**: 2025-12-06 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README = Neo4j Connector for AWS Glue Docs This repo contains the files that you need to start a new Neo4j documentation project. == Prereqs - link:https://nodejs.org/en/download/[Node.js] - npm == Installation To install the required packages: ---- npm i ---- == Generating HTML output To convert asciidoc source to HTML: ---- npm run build ---- == Viewing HTML output To view the built site, launch a local server: 1. `npm start` 2. In a browser tab, go to `localhost:8000` == Live preview When you run `npm start`, the project is monitored for updates to asciidoc files. If a change to an asciidoc file is detected the site is automatically rebuilt. == Generating asciidoc source files If you are creating new documentation from scratch, creating all the asciidoc files can be time-consuming. This repo contains a script that you can use to save time by generating skeleton asciidoc files from your navigation. To use the script, first create your navigation file, or files if your doc set has more than one component. To use the script, all navigation files should have the filename `content-nav.adoc`. Then, to create the asciidoc source files, run `npm run adoc-gen`. For every file that is included as a list item entry in a `content-nav.adoc` file, an asciidoc file is created in the location specified. For example, if _modules/ROOT/content-nav.adoc_ includes `+++* xref:installation/introduction.adoc[]+++`, a file is created at _modules/ROOT/pages/installation/introduction.adoc_. The file contents consist of a comment to indicate that the file was generated by the script, and a top level title element. If title text is specified in the entry in the navigation file, that value will be used for the title in the generated file. If no title text is specified, the default title text is taken from the filename, formatted with sentence capitalization. == Configuring your project Update the following files to configure your project: * `antora.yml` * `preview.yml` * `publish.yml` === antora.yml Update the following values: `name`:: Replace `docs-template` with the name of the project as it will appear in the URL https://neo4j.com/docs/`, for example 'getting-started', 'cypher-manual'. `title`:: Provide the title of the manual, for example Getting Started Guide, Cypher Manual. This value is displayed in the breadcrumbs above each page. `version`:: Provide the version number or name for the content that is generated from the branch containing this `antora.yml` file. Optionally, you can also add the following attributes: `display_version`:: Use this attribute when you want the version that is displayed in your content and in the UI to be different from the version that appears in the URL. For example, you might want to use _/2.0/_ in URLs, but display the version as `2.0-beta` in the version selector drop-down. `prerelease`:: if you publish multiple versions of this project, you can mark a version as being a prerelease, by adding `prerelease: true`. The content is published alongside the other versions, and will still be displayed in the version selector, but is not included when Antora is calculating the current (or 'latest') version of any docs content. The version that is considered to be current is used in our build and publish pipeline in several ways: to resolve links between pages; to generate a sitemap for the current documentation; to ensure each published page specifies the correct canonical URL. For more information about versions in Antora, see link:https://docs.antora.org/antora/latest/component-prerelease/[Antora // Docs -> Identify a Prerelease Version] === preview.yml Antora uses a link:https://docs.antora.org/antora/latest/playbook/[playbook] to determine what content is included in a site, and the appearance of that content. In our projects, we use `preview.yml` as the default playbook name for local builds and PR verification builds. Update the `start_page` attribute to match the value of the `name` attribute in your `antora.yml` file. ---- site: start_page: docs-template:ROOT:index.adoc ---- === publish.yml In our projects, we use `publish.yml` as the default playbook name for builds that generate publishable HTML output. Note the key differences between `preview.yml` and `publish.yml`: * In `preview.yml`, in content sources, the only branch listed is `HEAD`, which is the working branch whenever you are making changes to source files. In `publish.yml`, multiple branches can be listed, to generate HTML for multiple versions of the content. * The `neo4j-base-uri` and `neo4j-docs-base-uri` attributes are different in the two playbooks, so that when you use the `link:` macro to link to neo4j.com URLs that are not part of the docset you are building, the links resolve correctly in local preview and in the published documentation. Make the same update the `start_page` attribute as in `preview.yml`. === [Optional] Add a 'Raise an issue' link If your repo is public, you can add a `Raise an issue` link to your pages to encourage external contributors, and to provide a quick way for users to suggest changes. Update the following attribute in your playbook: ---- asciidoc: attributes: page-origin-private: false ----