Hello cloud developers,
This is the github.io source code page for azure.github.io. Please feel free to fork and submit a pull request if you want to correct or add some content.
Cheers!
Get Started
-
Install Ruby and the Ruby DevKit on your system of choice.
Note If you're running Ruby on a Windows machine, make sure your DevKit path variables are setup using the Dev Kit quickstart instructions.
-
Install Node/NPM
-
Run
bundle install
from the root of the project. Note: If you do not have Bundler installed, rungem install bundler
beforehand. -
Run
npm install
from the root of the project. -
Run
npm install gulp -g
Usage
- To build the site, run
gulp
. - If you would like to see draft posts, you need to add
--drafts
gulpfile.js line 73- TODO: automatically show drafts locally
Authoring a Blog posts
To create a new post, check out https://jekyllrb.com/docs/posts/. After reading the aforementioned link, you will have a better understanding of how to create a post, but not the FrontMatter yaml supported by default. We support the following FrontMatter yaml by default:
- title: is the title of the post and shown as the large header for the post
- subtitle: is the subtitle of the post and shown as subtext to the main header
- tags: an array of categories for the post. Each tag produces an index of tagged pages
- bigimg: an array of images which will rotate behind the title of the post
- comments: allow disqus comments on the post
Sample FrontMatter
title: Deploying a Resource Manager Template
subtitle: Building infrastructure with Ruby on Azure
tags:
- Ruby
- IaaS
bigimg:
- /images/hero-partners.png
- https://udemy-images.udemy.com/course/750x422/8082_e627_11.jpg
- https://images7.alphacoders.com/679/thumb-1920-679140.png
comments: true
Sample Draft
You can find a sample draft in the _drafts folder.
Ready to Post?
Open a pull request with your changes and upon merge, your post will be deployed to https://azure.github.io.
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request that targets the Jekyll branch. The master branch is intended for generated html only, not contributions.
License and Copyright
azure.github.io is free software released under the MIT License.