This repository includes the website and documentation of Apache StreamPipes on https://streampipes.apache.org. Two different technologies are used to create both sites:
Both parts are merged to a single directory during the CI process.
Node.js(at most v18) and npm are required to build the documentation.
npm install from the website-v2 directory by first running cd ./website-v2.npm run start to start the documentation for debugging purposes. The content will be served on http://localhost:3000npm run build to build the documentation This will create a folder website-v2/build that includes all required static files.npm run ds-version NEW_VERSION to release a new docs version.update-python-docs workflow only refreshes docs-python/dev. For a release, copy the built docs to docs-python/NEW_VERSION, add the version to docs-python/versions.json with the latest alias, and replace both docs-python/latest and the unversioned files in docs-python/ with a copy of the new version (every page's canonical URL points to latest).update-extensions-docs; run node scripts/add-pe-descriptions.js in website-v2 afterwards to restore the meta descriptions.docs-python to the website-v2/build folder into a subdirectory named python.The deployment step is done automatically using the asf.yaml process. Code must be merged into the master branch in order to trigger an update of the website.