mainpage | title | description | permalink | mermaid |
---|---|---|---|---|
true |
ReadMe |
The ReadMe of CloudDocs. |
/about/ |
true |
Organisation thinking about moving to the Cloud can use this website as a starting point. We have collected and combined information from different public available sources and have tried to make it readable. By placing all infromation into a Github project, you can clone and extend the infromation needed. Read this document if you want to use CloudDocs for your own or want to contribute.
We use Markdown to write our documents and use the GitHub support of Jekyll for this site. If you would like to know a bit more about the Jekyll functions look here.
Here are some advanced markdowns you can use
- [x] this is a complete item
- [ ] this is an incomplete item
- [x] @mentions, #refs, [links](), **formatting**, and <del>tags</del> supported
- [x] list syntax required (any unordered or ordered list supported)
We support emoji :+1: :sparkles: :camel: :tada::rocket: :metal: :octocat:
- this is a complete item
- this is an incomplete item
- @mentions, #refs, links, formatting, and
tagssupported - list syntax required (any unordered or ordered list supported)
We support emoji:+1: :sparkles: :camel: :tada::rocket: :metal: :octocat:
To install this theme, jekyll is required to be installed on your system or you have to clone this project on GitHub. Head over to the docs and install the four requirements (Ruby, RubyGems, Node.js and Python 2.7). If you're on a Mac system, it's likely the only package you'll need to install is Node.js
Once you've installed the requirements, run this command in your terminal:
$ sudo gem install jekyll
You'll also need to install the bundler package:
$ sudo gem install bundler
Download the theme
Unzip it and use it as a regular jekyll folder.
$ unzip master.zip
Get inside the newly extracted folder
$ cd master
Install the dependencies
$ bundle install
Use it!
$ jekyll serve
We have added some addons which can be helpfull.
With for example mermaid you can draw images. To make it work just add mermaid: true
to you .md header and in you text field add <div class="mermaid">Mermiad tags here</div>
<div class="mermaid">
graph TD;
A-->B;
A-->C;
B-->D;
C-->D;
</div>
We support https://www.algolia.com as search engine please configure it and ensure to run the main index after every update
ALGOLIA_API_KEY='Your Admin Api Key' bundle exec jekyll algolia
Some important configuration can be done in the file _config.yml
. Please, check the Setup section in that file and uncomment the parts you require.
baseurl
parameter is required in the case the site doesn't sit on the root of the domain. For example:
In the case the site sits in the root, you can leave baseurl
as empty "".
For more details read about Jekyll on its web page.
Bug reports and pull requests are welcome on GitHub at https://github.com/sjhoeksma/sjhoeksma.github.io.
To set up your environment to develop this theme, run bundle install
.
You theme is setup just like a normal Jelyll site! To test your theme, run bundle exec jekyll serve
and open your browser at http://localhost:4000
. This starts a Jekyll server using your theme. Add pages, documents, data, etc. like normal to test your theme's contents. As you make modifications to your theme and to your content, your site will regenerate and you should see the changes in the browser after a refresh, just like normal.
We used a lot of content from public available sources, for which we have included a link to the orignal materials as reference. Any other material or the Jekyll templateis licensed under a Creative Commons Attribution 4.0 International.