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.

Installation

Jekyll static site generator docs.

Install a full Ruby development environment
Install Jekyll and bundler gems
```
 gem install jekyll bundler
```

Fork the project repository, then clone your fork.

 git clone git@github.com:YOUR_USER_NAME/quarkusio.github.io.git

Change into the project directory:
```
 cd quarkusio.github.io
```
Use bundler to fetch all required gems in their respective versions
```
 bundle install
```
Build the site and make it available on a local server
```
 bundle exec jekyll serve
```
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 ent ry 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
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à

Contributing

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.

License

This website is licensed under the Creative Commons Attribution 3.0.

mkouba / quarkusio.github.io-1