The Asterinas Website is a static Website hosted by Github Pages and powered by Jekyll.
Before you begin, you'll need to set up your development environment. This involves installing two critical pieces of software:
- Bundler: Bundler manages Ruby gem dependencies, ensuring that you have all the necessary components for Jekyll. Install it from bundler.io.
- Jekyll: Jekyll is the engine behind your GitHub Pages site. It transforms plain text into static websites and blogs. Get it from jekyllrb.com.
For detailed installation instructions, refer to the GitHub Pages guide.
To see your changes in action before they go live, test the site locally. Here's how:
Step 1: Download the source code and install all dependencies.
git clone https://github.com/asterinas/asterinas.github.io
cd asterinas.github.io
bundle install
Step 2: Build the site and start a Web server.
bundle exec jekyll serve
By default, the server will listent on http://localhost:4000.
Step 3: Now open your favorite browser to view the site.
Make modifications to your local copy of the Git repository and then push the changes or submit a pull request to the main repository. Once the modifications are accepted, the latest version of the site will be deployed automatically. You can view the live site at https://asterinas.github.io/.
The project is released under the Apache License, version 2.0.