Repository files navigation

This repository contains source code for a Libcloud website powered byJekyll.

• Ruby >= 3.1.1
• Jekyll >= 4.2.2
• Gems:bundler (gem install bundler)
• jpgoptim (optional, for compressing images)
• optipng (optional, for compressing images)
• Node.js (optional, needed for Grunt tasks)

You are strongly encouraged to utilize provided Dockerfile which containsall the dependencies which makes building the website a breeze.

Keep in mind that the initial image build may take a while since all thedependencies need to be installed and build, but subsequent runs should bemuch faster.

In case you want to install all the dependencies locally outside the Dockercontainer, you are encouraged to install and uservmand use rvm to install Ruby as shown below.

rvm install 3.1.1rvm use 3.1.1gem install bundler -v"2.3.0"

rvm use 3.1.1bundle install

npm install.

node_modules/.bin/grunt lint

./scripts/docker-run-dev-server.sh# Non-Docker versions#./scripts/run-dev-server.sh

This will start Docker container with local development server listening on port4000 available athttp://localhost:4000/.

./scripts/docker-build-site.sh# Non-Docker versions#./scripts/build-site.sh# asf-site for prod, asf-staging for staging./scripts/stage-changes.sh {asf-site,asf-staging}git push origin<branch>

To speed up local development, we offer pre-built version of theDocker imageused for local development -https://github.com/apache/libcloud-site/pkgs/container/libcloud-site-dev.

This image is used by default when using./scripts/docker-*.sh scripts.

If for some reason you want to use locally built Docker image (e.g. you havemade changes changes to the Dockerfile, Gemfile or similar), you can do that bysettingUSE_LOCAL_DOCKER_IMAGE=1 environment variable when using those scripts.

For example:

USE_LOCAL_DOCKER_IMAGE=1 ./scripts/docker-run-dev-server.sh

• master - Contains website source code without the generated content.
• asf-site - Contains generated website content for production environment (https://libcloud.apache.org)
• asf-staging - Contains generated website content for staging environment (https://libcloud.staged.apache.org).