Apache OpenWhisk Website
Apache OpenWhisk is a cloud-first distributed event-based programming service. It provides a programming model to upload event handlers to a cloud service, and register the handlers to respond to various events.
Quickstart for Local Development
- Download and install Node.js: see https://nodejs.org/
- Download and install Ruby: see https://www.ruby-lang.org/en/documentation/installation/
# Verify Node and Node Package Manager are installed node -v npm -v # Verify Ruby is installed ruby -v # Install Jekyll, which is used to build the site gem install jekyll bundler
Clone and start development server
# Clone the repository (and correct branch). git clone https://github.com/apache/incubator-openwhisk-website.git # Move into the cloned repo. cd incubator-openwhisk-website # Install gem dependencies bundle install # Start the development server default location http://127.0.0.1:4000 bin/develop
Validate HTML, links and more
To make sure nothing is broken on the website we use html-proofer, it checks to see if any of the links 404s, if the HTML is valid, images have alt tags and more.
Run the following command to run html-proofer:
How to Build Jekyll to Output Static Files
If you need to generate static files, run the following:
# NOTE: Make sure you have already cloned the repository and moved into the directory. # Build the site. bundle exec jekyll build
This will build static files to a directory called
_site/ in the project root. This can be used for manual deployment to a static server or with build tools like Jenkins.
If you get an error 'bundle: command not found' attempting to build the site, you may need to manually install the 'bundler' package:
gem install bundler
The OpenWhisk.org website is automatically built and published to Apache at: http://openwhisk.incubator.apache.org/
Current Jenkins build status can be checked here: https://builds.apache.org/job/OpenWhisk-website/
Report bugs, ask questions and request features here on GitHub.
You can also join our slack channel and chat with developers. To get access to our slack channel, please see the instructions here.
Licensed under the Apache License, Version 2.0 (the "License").
Unless required by applicable law or agreed to in writing, software distributed under the license is distributed on an "as is" basis, without warranties or conditions of any kind, either express or implied. See the license for the specific language governing permissions and limitations under the license.