UserFrosting Documentation

https://learn.userfrosting.com

This is the repository for the documentation for UserFrosting 5. It is built with the flat-file CMS Grav, using their RTFM skeleton.

Getting started

This site is built using Grav CMS, which like UserFrosting v4 has combined framework and project skeleton code. To permit easier content management, this repository only includes Grav's user/ directory, which is where all of our custom content, themes, and assets live. See Grav Development with GitHub - Part 2 for more on this approach.

Syntax

Grav uses Markdown to format text. Additionally, this site uses the Grav Shortcode Core Plugin plugin to enable more non-standard Markdown code, like [notice].

See Grav Shortcode Plugin for a list of available markdown code.

Installation

Complete Local Installation

This branch contains the documentation associated with the branch of the same name from userfrosting/userfrosting. See Website Installation Guide to install a complete instance of the docs with all versions available.

To install a single copy of this branch (without multiple versions available), multiple installation methods are available:

Local Installation
Docker

Local Installation

This guide does not cover setting up the webserver and assumes your host is already setup.

Install Grav and replace the user directory with this repository

git clone https://github.com/getgrav/grav.git userfrosting-learn
cd userfrosting-learn
rm -r user
git clone https://github.com/userfrosting/learn.git user

Install Grav
```
bin/grav install
```

When you're done, the directory structure should look like this:

htdocs/
└── userfrosting-learn/
   ├── assets/
   ├── ...
   ├── user/
       ├── .git
       ├── accounts/
       ├── assets/
       ├── config/
       └── ...
   └── ...

Docker

Clone repo

git clone https://github.com/userfrosting/learn.git userfrosting-learn
cd userfrosting-learn

Build Grav container
```
docker build -t learn:latest .
```

Start Grav container

docker run -d --rm --name=learn -p 8888:80 -v "$(pwd):/var/www/grav/user" learn:latest

It will take a couples of second for the site to be up and running while the base Grav installation is done. Once this is complete, you can access the documentation at http://localhost:8888/.

To stop the container:

docker stop learn

To access Grav command line utility or gpm, you can use :

docker exec -it learn bash
chmod +x bin/gpm # This is only needed if permissions are acting up
bin/grav install

Credits

Favicons were generated with https://realfavicongenerator.net/