Jekyll template for creating modern HTML5/WAI-ARIA/RDFa websites.
Ruby CSS
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_includes
_layouts
_plugins
css
.gitignore
COPYING.CC_BY_30
Makefile
README.md
_config.yml

README.md

The website-template project is a foundation for creating modern websites. It uses the Jekyll static site generator and supports the following standards:

  • HTML5
  • WAI-ARIA
  • CSS3
  • RDFa

It includes layouts and plugins to support creating content-specific pages modelled around domain-specific RDF schemas:

  • person descriptions (FOAF metadata)
  • projects and releases (DOAP metadata)
  • schemas/ontologies (RDFS/OWL metadata)

It also includes schema.org metadata for all documents and content to support search engine structured data/rich snippets such as:

  • web pages
  • blog posts
  • breadcrumb navigation

Customising Your Site

Customisation is as easy as:

  1. Changing the title property in _config.yml to match your website name;
  2. Modifying the _includes/banner.html file to use your own custom banner;
  3. Modifying the CSS styling in css/main.css to match your website design.

Building

To build the website, simply run:

make

This will create a _site directory containing the generated static HTML pages.

Deploying Locally

To deploy the website to a locally running Apache webserver, run:

sudo make install

This will copy the site content to /var/www, which you can then display by navigating to http://127.0.0.1.

Deploying to the Web

To deploy the site to the web, you need to use an ftp program like lftp that supports recursively uploading files.

First, you need to log into the FTP upload location for your site as given by your service provider:

cd _site
lftp <ftp-address> -p <port> -u <username>

Then, after entering your password, you can then upload the content of the site using:

mirror -c -R . .

Once everything is uploaded, you can exit by running:

quit

License

The following files/directories are licensed under the CC-BY 3.0 license:

_includes/
_layouts/
README.md

The files in the _plugins and css directories specify their license terms in the files themselves.

The following files are licensed under the CC0 and Public Domain licenses:

_config.yml
Makefile

Any other files are not part of the website-template project and are governed by the license specified in the downstream project.