Skip to content

slambour/www.warp10.io

 
 

Repository files navigation

Warp10's site

The static, markdown based, Jekyll powered Warp10's site

So what is Jekyll, exactly?

Jekyll is a simple, blog-aware, static site generator. It takes a template directory containing raw text files in various formats, runs it through Markdown and Liquid converters, and spits out a complete, ready-to-publish static website suitable for serving with your favorite web server. Jekyll also happens to be the engine behind GitHub Pages.

How to use

The full doc on Jekyll is available on Jekyll's doc site.

Install Jekyll engine.

Using ruby gems:

gem install jekyll

Note: the version of Jekyll on Ubuntu repositories isn't up to date and shouldn't be used

Development mode

To serve the site in preview mode, use:

jekyll serve

The preview mode automatically updates after any modification.

To build the static version of the site, use:

jekyll build

If you want it to rebuild the static site after each modification, add the --watchflag:

jekyll build --watch

In watch mode, Jekyll will scan the source file and re-generate the blog when files changes.

Write a new page

To write a new page, you add a markdown file to corresponding folder.

Filename must respect the naming convention:

title-with-dashes.markdown

The markdown files must include a normalized header:

---
layout:     "function"
title:      "A nice title"
subtitle:   "And the explanation thats follows it"
---    

The content of the page is written in markdown.

Images should be placed on a directory inside img, following this structure:

──img
   └──page-filename-without-.md
       └──img01.jpg
       └── img02.jpg

Publish your pages

As usual, you should fork the repository, push to your fork and do a pull request.

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 59.1%
  • CSS 22.0%
  • HTML 18.9%