Go to file
Serafeim Chatzopoulos 6dd690b4d0 Restructuring PID and identifiers page 2023-04-04 15:16:41 +03:00
blog initial commit 2022-09-01 10:26:04 +03:00
docs Restructuring PID and identifiers page 2023-04-04 15:16:41 +03:00
src Change footer 2022-12-20 15:20:50 +02:00
static Update graph name, logo, and badges 2023-02-23 13:50:36 +02:00
versioned_docs Fix broken links 2023-03-15 20:31:12 +02:00
versioned_sidebars Update url path for graph-production-workflow; add more details in indictors ingestion page 2023-03-15 20:19:49 +02:00
.env Fix links from impact measures page to specific properties/objects in the result 2022-12-27 21:22:30 +02:00
.gitignore ignore intellij project file 2022-11-23 14:33:34 +01:00
Dockerfile Add deployment with docker 2022-10-13 20:52:52 +03:00
README.md integrating Scholexplorer Bio Entity Datasource documentation (PR#48) 2023-03-09 15:00:45 +01:00
babel.config.js initial commit 2022-09-01 10:26:04 +03:00
docusaurus.config.js Update graph name, logo, and badges 2023-02-23 13:50:36 +02:00
package-lock.json added new relationships 2022-12-27 12:51:52 +01:00
package.json added new relationships 2022-12-27 12:51:52 +01:00
release.properties Update 'release.properties' 2022-12-20 15:16:23 +01:00
sidebars.js Update url path for graph-production-workflow; add more details in indictors ingestion page 2023-03-15 20:19:49 +02:00
versions.json created version 5.2.0, updated changelog 2023-03-01 15:32:36 +01:00

README.md

OpenAIRE Graph Documentation

This website is built using Docusaurus 2; please check here the requirements to run the project.

Clone repository

$ git clone https://code-repo.d4science.org/D-Net/openaire-graph-docs.git

Local installation and deployment

From https://docusaurus.io/docs/installation#requirements

Node.js version 16.14 or above (which can be checked by running node -v)

To install the required packages use:

$ npm install

The following command starts a local development server and opens up a browser window. Note that most changes are reflected live without having to restart the server.

$ npm run start

Generate the static content into the build directory using the command tha follows. Then this directory can be served using any static contents hosting service.

$ npm run build

Deployment using Docker

Development

Build docker container for development and run on port 3000:

docker build --target development -t docs:dev .
sudo docker run -d -p 3000:3000 docs:dev

Production

Build docker container for production and run on port 80:

docker build -t docs:latest .
docker run -d -p 80:80 docs:latest

Documentation versioning

The versioning documentation of Docusaurus can be found here. Specifically, a new version can be created with the following command:

npm run docusaurus docs:version <versionName>

When tagging a new version, the document versioning mechanism will:

  • Copy the full docs/ folder contents into a new versioned_docs/version-<versionName>/ folder.
  • Create a versioned sidebars file based from your current sidebar configuration, saved as versioned_sidebars/version-<versionName>-sidebars.json.
  • Append the new version number to versions.json.

Therefore, when previewing the compiled site locally with npm run start, ensure to visualise the Next version on the browser as it shows the changes under /docs. To change a version that was already versioned, the source files to be modified are in the versioned_docs/version-<versionName>/ folder.