docs.getcloudify.org

documentation web site for cloudify 3.3

• Master

IMPORTANT! - We are using Hugo 0.14! Otherwise it won't work.

how to contribute?

to run this project you need to make sure the following is installed:

• nodejs - version 0.10 and above is fine
• grunt - sudo npm install -g grunt-cli
• bower - sudo npm install -g bower
• gohugo - version 0.14!
• clone this repository (the content repository)
• clone docs.getcloudify.org-site repository (the framework around the content)

now do the following steps:

• create a configuration file under docs.getcloudify.org-site/dev/config.json
  • alternatively, you can write the file wherever you want and export CONFIG_JSON variable that will point to its location
• go to root of docs.getcloudify.org-site and run:
  • bower cache clean && bower install
  • sudo npm cache clean && npm install (first command as sudo and second not)

the config file looks like this:

{
    "content" :
    {
        "root" : "/full/path/to/content/clone/root/folder"
    }
}

and you're done. these things should be done only on the first time you setup your environment.

from time to time, you might need to run the bower and npm commands again in case the framework has changed. if you get errors in the next step, running these commands and try again.

now, to start writing documentation, every time you will need to

• go to docs.getcloudify.org-site clone and run grunt server

from now on, you work on the docs.getcloudify.org clone and push/pull changes from there. the framework will auto-sync

content organization

• the pages are now divided to directories (e.g. 'plugins', 'intro'), where each directory represents a section on the site's left sidebar. Once a file is within a directory, it's automatically listed under the corresponding section

• the order of pages in a section is determined by the 'weight' parameter, which is stored in each page metadata (Front Matter.) Remember, lower weight == higher priority

• If there's a page you don't want to publish online, you can set 'draft: true' in the page metadata

• To add a new section (directory,) you have to add it to the sidebar menu in the site project's config.toml. Currently, this is a site-wide file located at the docs.getcloudify.org-site repo, and cannot be configured per version.

page fields

You can add custom fields to the page metadata and use these fields within the page.

Example:

page metadata (Front Matter):

---
title: my page

favorite_food: icecream
---

page content:

I love {{< field "favorite_food" >}}!

how to add a hyperlink

To add a link on a markdown page:

[some text]({{< relref "path/to/page.md" >}})

where path/to/page.md is relative to the /content/ dir

how to add an image

• copy the image to /static/images/some/path/img.png
• on the markdown page:

![some alt text]({{< img "some/path/img.png" >}})