hibbitts-design/grav-skeleton-learn2-with-git-sync

Grav Learn2 with Git Sync, a sample Markdown-based documentation site using the Learn2 Git Sync theme. Includes Admin Panel, Git Sync and TNTSearch Plugins along with RSS/Atom Feeds.

Learn2 with Git Sync Skeleton

Learn2 with Git Sync Learn2 with Git Sync, a sample documentation site using the Learn2 Git Sync theme. Includes Admin Panel and TNTSearch Plugins along with RSS/Atom Feeds. Built with the open source modern file-based Grav CMS.

📚 Information and Documentation

https://learn.hibbittsdesign.org/learn2withgitsync

🚀 Quick Install Instructions

Pre-flight Checklist

1. Confirm Web server PHP version (PHP 8.0.2 or higher)
2. Web server login credentials (username and password)

Installation Steps

1. Download the ready-to-run Learn2 with Git Sync Skeleton Package
2. Unzip the package onto your desktop
3. Copy the entire expanded folder to your Web server
4. Point your browser to the Web server folder
5. Create your site administrator account when prompted
6. And you're done! (press the icon in the Admin Panel to preview site)

💻 Grav Learn2 with Git Sync Screenshot

✅ Learn2 Theme with Git Sync Features

• Integrated support for Git Sync (i.e. view/edit pages in GitHub)
• Support for RSS feed (great for getting documentation updates)
• Custom Theme visual styles
• Support for Taxonomy 'tag' searching with TNTSearch Plugin
• Enhanced support for the Presentation Plugin

Base 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

📄 Supported Page Templates

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

Video Walkthrough of Learn2 with Git Sync Configuration

Video 1. Learn2 with Git Sync Configuration

🔧 Configuration

top_level_version: false
home_url:
github:
    enabled: true
    position: top
    tree: https://github.com/getgrav/grav-skeleton-rtfm-site/blob/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.

Basic Setup for a New Grav Site

The simplest way to install the Learn2 Git Sync theme with sample content for Grav is to download and install the Learn2 with Git Sync Skeleton package:

1. Download Learn2 with Git Sync 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.

💬 Share Your Feedback

• Complete the Learn2 with Git Sync Survey

grav-skeleton-learn2-with-git-sync's Issues

'Top Level Version'= TRUE causes simple search to stop displaying page in menu

After implementing 'Top Level Version'= TRUE succesfully my users have noticed that Simple Search does not show the right page in the menu (and does not expand the menu)

Below the behavior with 'Top Level Version'= FALSE

How to assign a landing page with different template - also maintenance mode bug

I'm having a hard time to understand how to create and apply a template (I created a theme with inheritance) to the page grav starts up with. Assigning a different template to the start page doesn't work because start is actually the second page and not the first. No matter what I do the login window appears with the navigation already visible.

If I un-publish the start page the login frame vanishes but the navigation is still visible.

If I activate the maintenance plugin the navigation still shows up albeit in a scrambled way. Actually, this must be a bug because if I do the same with the learn2 theme the menu is visible as normal. Anyway, the desired effect in maintenance mode is that you see only the maintenance mode announcement and NOTHING from the site, not even the navigation.

What I'm trying to achieve:

1. open grav with a landing page that offers a link to login. Alternatively open grav with only the login window visible.
2. show any learn2 content (incl. navigation) only to authorized users. Show nothing to unauthorized users.

Can you please point me in the right direction? Where did you define the navigation part in a way that it can't be hidden no matter what I (or other plugins) do?

Unable to remove tag

Installed skeleton learn2 v1.1.7 (PHP Version 7.0.30)
After adding a tag to a page (template Docs), I cannot remove it (it returns automatically).
Tried FF and Chrome.
See attachment:

'Top Level Version'= TRUE causes every page to be displayed in the menu

When I enable 'Top Level Version' the menu displays pages that are (published = FALSE and Visible = FALSE and have Folder Numeric Prefix FALSE)
When I disable 'Top Level Version' these pages are skipped (as intended).
I would like to have the 'callapse-behaviour' without the pages/folders that are not intended for publication.

Can't customize skeleton

Hello!

Just install this skeleton, set theme to mytheme and tried to delete some unuseful plugins for me like presentation etc.
Got an error grav The installed package learn2-git-sync depends on this package. Please remove it first.

Ok, theme removed. After that I see another error, whole site with admin panel don't work:

How to customize? )

Admin plugin is not available in the skeleton

Thanks for this skeleton. I think the admin plugin is missing from the skeleton.