This site is rendered by Jekyll, so you will need some dependencies to run it.

bundle install

Once all dependencies are properly installed, run Jekyll.

bundle exec jekyll serve

This will render the site at http://127.0.0.1:4000

Text, images, icons and links are defined in yaml files in the _data directory. Each yaml file represents a region of the site.

• SVG files are located in the _includes/_icons directory.
• Rasterized images are located in the static/img directory.
• After adding or removing an image or icon file, register where they belong on the page using the yaml files in the _data directory.
• Rebuild the code by running Jekyll.

• While running the Jekyll server, edit the scss files in the _sass directory.
• ⚠️ Do not write changes directly on css files. They will be overwritten by the content in the scss files.

• The template files of each region are in the includes directory.
• Jekyll uses Liquid as its templating language.

• Subpages live in the _projects directory, each project containing a subdirectory with the project's name.
• The subdirectory must contain an index.md page as the landing page for the project.
• The data is written in the kramdown flavor or markdown.
• The files must include front matter to be rendered.

---
project: project-name
title: page-title
layout: page
order: 1
---

The name's project will group all files belonging to the same project in the navigation bar. It will also populate the header with the project's data located in _data/projects.yaml

This is the name of the page, as it will display on the navigation bar.

The "page" layout is the only one currently available for subpages. The page order will determine the sub-layout.

The page order in the navigation bar. "Order: 1" is reserved for the landing page and has an unique layout.

Name of project. Must match with the name on the project's markdown page's front matter. It's case sensitive. This entry is not optional.

The project's description.

Parameters github.user and github.project must match a github repository to display its stars and forks.

Name of project's icon svg file, found in _includes/_icons.

The twitter handle associated with the project.

Short information and instructions on the header's sidebar. It's divided in sections.

header:
  - section:
      title: section title
      icon: section-icon.svg
      content: > #
        section content text

Title of section.

Name of icon file to be on the left of the title.

An area that allows some markdown to indicate hyperlinks, buttons or a line of code.

.
├── _config.yml
├── _data
|   ├── contributions.yaml
|   ├── cta.yaml
|   └── ...
├── _includes
|   ├── _home
|   |   ├─ contributions.html
|   |   └─ ...
|   ├── _icons
|   |   ├─ icon-camera.svg
|   |   ├─ icon-cart.svg
|   |   └─ ...
|   ├── _pages
|   |   └─ ...
|   ├── footer.html
|   └── header.html
├── _layouts
|   ├── home.html
|   └── page.html
├── _plugins
|   └── ...
├── _projects
|   ├── project-name
|   |   ├─ documentation.md
|   |   ├─ faq.md
|   |   └─ index.md
|   └── ...
├── _sass
|   ├── base
|   |   ├─ __base.scss
|   |   └─ ...
|   ├── includes
|   |   ├─ __includes.scss
|   |   └─ ...
|   └── vendor
|       └─ ...
├── _site
├── static
|   ├── css
|   ├── img
|   |   ├─ favicon.ico
|   |   ├─ stats-1.png
|   |   └─ ...
|   └── js
├── _config.yml
├── Gemfile
├── Gemfile.lock
└── index.html