Skip to content

getgrav/grav-skeleton-rtfm-site

Repository files navigation

RTFM Skeleton

RTFM Screenshot

This is a sample skeleton site that mimics the official Grav documentation: http://learn.getgrav.org. This skeleton uses the learn2 theme

Features

  • Lightweight and minimal for optimal performance
  • Fully responsive with off-page mobile navigation
  • SCSS based CSS source files for easy customization
  • Built specifically for providing easy to read documentation
  • Font Awesome icon support
  • Viewed page tracking
  • Integrated support for documentation content sourced/maintained via GitHub

If you want more information about using Grav with GitHub, check out part 1 and part 2 of our guide called Grav Development with Github.

Supported Page Templates

  • "Docs" template
  • "Chapter" template
  • Error view template

Configuration

top_level_version: false
home_url:
github:
    enabled: true
    position: top
    tree: https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/
    commits: https://github.com/getgrav/grav-skeleton-rtfm-site/commits/develop/
Setting Child Setting Description
top_level_version When set to true, displays level icons and numbered lists.
home_url Enables you to enter a different URL link from the logo (ex: http://google.com)
github enabled Can be set to true or false. When set to true, it generates the Edit this page link to GitHub for each page.
github position Sets the position for the GitHub edit link. Can be set to top or bottom.
github tree Sets the tree by which your site's content is based. Generally the repo your site's content is pulled from.
github commits Sets the link to the commits page for the site's content repo.

Basic Setup for a New Grav Site

The simplest way to install the learn2 theme with RTFM content for Grav is to download and install the RTFM Skeleton package:

  1. Download RTFM Skeleton
  2. Unzip the package into your web root folder.
  3. Point your browser at the folder.
  4. Job done!

TIP: Check out the general Grav Installation Instructions for more details on this process.