publish staging
1 file changed
tree: b049931a65aea1f4c16c910b6e8bef6f8964ef2c
  1. .github/
  2. blog/
  3. docs/
  4. source/
  5. src/
  6. static/
  7. .asf.yaml
  8. .gitignore
  9. babel.config.js
  10. CONTRIBUTING.md
  11. docusaurus.config.js
  12. LICENSE
  13. package.json
  14. README.md
  15. tsconfig.json
  16. yarn.lock
README.md

Apache CloudStack Official Website

This project keeps all sources used for building up Apache CloudStack official website which's served at https://cloudstack.apache.org/.

Contributing

For contributing changes such as adding/editing blogs, please see the:

CONTRIBUTING.md

Prerequisite

Apache CloudStack website is powered by Docusaurus 2. Please install Node.js v16 or later and yarn.

Local Development

Install dependencies:

$ yarn install

Start local app server on localhost:3000:

$ yarn 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.

Building and Publishing

To build the website run the following:

$ yarn build

This command generates static content into the build directory and can be served using any static contents hosting service. We've GitHub Actions based automation that can publish changes merged to ‘main’ branch being automatically published to the ‘asf-site’.

temporary blog only publishing mech

This procedure is obsolete as soon as the site is migrated to docusaurus completely

  1. Build the docusaruas branch locally:
   # checkout the right branch:
   git checkout old-style-blogs
   yarn clear
   yarn install
   yarn build
  1. Then move the build directory to some other place, like mv build ..
  2. git checkout -- . and then checkout git checkout asf-site branch
  3. cd content/ to manually copy artifacts from ../build/ path.
  4. Generally I copy the assets, blog, img and files directory in the content directory from ../../build/
  5. git add and commit/push to asf-site branch