asterinas / asterinas.github.io

The source code of the Asterinas website

Asterinas Website

The Asterinas Website is a static Website hosted by Github Pages and powered by Jekyll.

Development Guide

Prerequisites

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.

Test the site locally

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.

Deploy the site officially

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/.

License

The project is released under the Apache License, version 2.0.

asterinas.github.io's Issues

Specify the title for each web page

Currently, the browser displays the default title for each web page, which is the URL. We should give a human-friendly title for each page.