|
| 1 | +# RTFM Skeleton |
| 2 | + |
| 3 | + |
| 4 | + |
| 5 | +This is a sample skeleton site that mimics the official Grav documentation: http://learn.getgrav.org. This skeleton uses the [learn2 theme](https://github.com/getgrav/grav-theme-learn2) |
| 6 | + |
| 7 | +# Features |
| 8 | + |
| 9 | +* Lightweight and minimal for optimal performance |
| 10 | +* Fully responsive with off-page mobile navigation |
| 11 | +* SCSS based CSS source files for easy customization |
| 12 | +* Built specifically for providing easy to read documentation |
| 13 | +* [Font Awesome](http://fontawesome.io/) icon support |
| 14 | +* Viewed page tracking |
| 15 | +* Integrated support for documentation content sourced/maintained via GitHub |
| 16 | + |
| 17 | +>> If you want more information about using Grav with GitHub, check out [part 1](http://getgrav.org/blog/developing-with-github-part-1) and [part 2](http://getgrav.org/blog/developing-with-github-part-2) of our guide called *Grav Development with Github*. |
| 18 | +
|
| 19 | +# Supported Page Templates |
| 20 | + |
| 21 | +* "Docs" template |
| 22 | +* "Chapter" template |
| 23 | +* Error view template |
| 24 | + |
| 25 | +# Configuration |
| 26 | + |
| 27 | +``` |
| 28 | +top_level_version: false |
| 29 | +home_url: |
| 30 | +github: |
| 31 | + enabled: true |
| 32 | + position: top |
| 33 | + tree: https://github.com/getgrav/grav-skeleton-rtfm-site/blob/develop/ |
| 34 | + commits: https://github.com/getgrav/grav-skeleton-rtfm-site/commits/develop/ |
| 35 | +``` |
| 36 | + |
| 37 | +| Setting | Child Setting | Description | |
| 38 | +| :----- | :----- | :----- | |
| 39 | +| top_level_version | | When set to `true`, displays level icons and numbered lists. | |
| 40 | +| home_url | | Enables you to enter a different URL link from the logo (ex: http://google.com) | |
| 41 | +| 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. | |
| 42 | +| github | position | Sets the position for the GitHub edit link. Can be set to `top` or `bottom`. | |
| 43 | +| github | tree | Sets the tree by which your site's content is based. Generally the repo your site's content is pulled from. | |
| 44 | +| github | commits | Sets the link to the commits page for the site's content repo. | |
| 45 | + |
| 46 | +## Basic Setup for a New Grav Site |
| 47 | + |
| 48 | +The simplest way to install the learn2 theme with RTFM content for Grav is to download and install the RTFM Skeleton package: |
| 49 | + |
| 50 | +1. [Download RTFM Skeleton](http://getgrav.org/downloads/skeletons#extras) |
| 51 | +2. Unzip the package into your web root folder. |
| 52 | +3. Point your browser at the folder. |
| 53 | +4. Job done! |
| 54 | + |
| 55 | +**TIP:** Check out the [general Grav Installation Instructions](http://learn.getgrav.org/basics/installation) for more details on this process. |
| 56 | + |
| 57 | +--- |
| 58 | + |
| 59 | + |
0 commit comments