2.9 KiB
2.9 KiB
RTFM Skeleton
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:
- Download RTFM Skeleton
- Unzip the package into your web root folder.
- Point your browser at the folder.
- Job done!
TIP: Check out the general Grav Installation Instructions for more details on this process.