1 Star 0 Fork 0

tully / quarkusio.github.io

Create your Gitee Account
Explore and code with more than 6 million developers,Free private repositories !:)
Sign up
This repository doesn't specify license. Without author's permission, this code is only for learning and cannot be used for other purposes.
Clone or download
Notice: Creating folder will generate an empty file .keep, because not support in Git

Quarkus.io Website Based on Jekyll

Getting Started

These instructions will get you a copy of the Quarkus.io website up and running on your local machine for development and testing purposes.


Jekyll static site generator docs.

  1. Install a full Ruby development environment

  2. Install bundler gems

     gem install bundler
  3. Fork the project repository, then clone your fork.

     git clone git@github.com:YOUR_USER_NAME/quarkusio.github.io.git
  4. Change into the project directory:

     cd quarkusio.github.io
  5. Use bundler to fetch all required gems in their respective versions

     bundle install
  6. Build the site and make it available on a local server

     bundle exec jekyll serve
  7. Now browse to http://localhost:4000

If you encounter any unexpected errors during the above, please refer to the troubleshooting page or the requirements page, as you might be missing development headers or other prerequisites.

For more regarding the use of Jekyll, please refer to the Jekyll Step by Step Tutorial.

Writing a blog

To write a blog:

  • create an author entry in _data/authors.yaml
    • emailhash is used to fetch your picture form the Gravatar service
  • create an blog entry under _posts -the file name is yyyy-mm-dd-slug.adoc
  • tags should be used with some care as an archive page is created for of them. Below are some basic rules to try follow:
    • quarkus-release used for Quarkus release blogs
    • announcement used for general announcement with some impact.
    • extension used for blogs related to a specific extension.
    • user-story used for stories from users/companies adopting Quarkus.
    • development-tips used for blogs with tips to develop using Quarkus or Quarkus itself.
    • add a tech specific, like kafka, if your post has a significant mention/relevance to that technology.
    • tags is space separated list tags:extension grpc
  • it's in asciidoc format, there is an example as shown with 2019-06-05-quarkus-and-web-ui-development-mode.adoc
  • send a pull request against the develop branch and voilà


Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Important: the guides are maintained in the main Quarkus repository and pull requests should be submitted there: https://github.com/quarkusio/quarkus/tree/master/docs/src/main/asciidoc.


This website is licensed under the Creative Commons Attribution 3.0.

Comments ( 0 )

Sign in for post a comment


No release




load more
can not load any more


103611 48b8ff67 1899542 103622 4d02230c 1899542