Website sources for Apache Cloudberry™️ (Incubating)

Clone this repo:

Branches

  1. 132f93e Proposal guide: follow the ASF voting rules by Dianjin Wang · 11 hours ago main
  2. 7d95cd0 Footer: name Apache Cloudberry and its logo in the trademark attribution by Dianjin Wang · 33 hours ago
  3. 35fd01b Doc: add extension modules reference (#422) by Dianjin Wang · 17 hours ago
  4. 4c10562 Doc: add upgrade within 2.x guide by Dianjin Wang · 5 days ago
  5. c68f7f6 Doc: add the remaining log_* parameters and correct log output descriptions by Abdullah Kaya · 5 weeks ago

Apache Cloudberry (Incubating) Website & Documentation

Website Documentation Slack Twitter Follow WeChat Youtube


Website Directory Structure

.
├── LICENSE
├── NOTICE
├── README.md
├── babel.config.js
├── blog
├── docs
├── docusaurus.config.ts
├── global.d.ts
├── package-lock.json
├── package.json
├── scripts
├── sidebars.ts
├── src
├── static
└── tsconfig.json

Notable directories Description:

  1. Blog

    The Blog post files are placed in the blog directory. You need to create one new folder for each new post and add the author information to the blog/authors.yml.

  2. Document

    The latest version of the document is under the docs (en) directory. Media including images, video can be placed in docs/media folder. You must add the new doc file name to sidebars.js to make it display on the website.

  3. Pictures

    All images are placed in the static/img directory.

Website Building

This website is built using Docusaurus 3, a modern static website generator. If you don't know Docusaurus, please learn more from Docusaurus website.

You can follow these steps to install and build the Apache Cloudberry website in your local environment.

  1. Clone website source
$ git clone https://github.com/apache/cloudberry-site.git
  1. Install dependencies

Before building the website, you need to install dependencies to make sure no errors when building.

$ npm install
  1. Initialize submodules (required for the PXF and Core Internals documentation)

Two sets of documentation live in other repositories and are pulled in as git submodules:

SubmoduleUpstreamServed at
pxfapache/cloudberry-pxf (docs/)/pxf
core-internalsapache/cloudberry (doc/core-internals/)/core-internals

After cloning, run:

$ ./scripts/setup-doc-submodules.sh

The script initializes both submodules and configures sparse checkout so that only the documentation directory of each one is written to disk. It clones shallow and blobless, which matters for core-internals: its upstream is the engine repository, so a full clone would cost about a gigabyte to read a few megabytes of Markdown.

Re-run the script after a git pull that moves either submodule pointer.

  1. Build and run
$ npm run build
$ npm run serve

This command generates static content into the build directory and can be served using any static contents hosting service.

Then you can visit localhost:3000 in the browser.

  1. (Option) If you want to run the local development environment, you can skip Step 3 to run the following command directly:
$ npm run start

This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.

Document Contribution

Our documents are still in construction, welcome to help. If you're interested in document contribution, you can submit the pull request here.

License

Apache License Version 2.0 (see LICENSE & NOTICE).