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.
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.
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.
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:
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 repositorygit 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/
└── ...
└── ...
-
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
Favicons were generated with https://realfavicongenerator.net/