Skeleton downloaded but can't install

Support
1

I downloaded and installed two themes then realized that I really wanted a skeleton.

There’s nothing in the Admin menu that addresses the installation of a skeleton - only plugins and themes.

I downloaded the Deliver skeleton .zip but see no way to install it.

Note: I’m working on this in Truecharts - version (grav 1.7.18_4.0.21)

image

NOTE: The instructions say to create “default.md” in “user/pages/03.mypage/”
The only place I found a folder called “user” was under /app/grav-admin/ - is that correct?
I also keep seeing references to web root (some write it “web-root”) but I’ve no idea where that might be found in a TrueNAS-SCALE TrueCharts system.

ALSO: Why do the docs not even mention skeleton? Basics | Grav Documentation

2

@kd4e,

Admin plugin:
Grav is a flat-file CMS which means everything can be done via the command-line. The Admin plugin is an add-on to make life easier for user who feel uncomfortable using the command-line. However, not everything can be done by Admin.

Skeletons:
Skeletons are pre-packaged Grav installations containing a fully functional website including pages, theme, plugins and configs. The zip file downloaded from Skeletons | Grav CMS should be unzipped into the root of the webserver, or in any subdirectory if preferred.
The folder should be cleared first.

Skeletons cannot be installed through Admin.

NOTE: The instructions say to create “default.md” in “user/pages/03.mypage/”

Which instructions?

The only place I found a folder called “user” was under /app/grav-admin/ - is that correct?

Folder /user is located in the root of your Grav installation. Folder /…/grav-admin/ looks like a correct root folder of Grav when file grav-admin-v1.7.x.zip has been unzipped.

I also keep seeing references to web root (some write it “web-root”) but I’ve no idea where that might be found in a TrueNAS-SCALE TrueCharts system.

Neither do I… :wink: But webroot, web-root, root of web, is all the same to me.

ALSO: Why do the docs not even mention skeleton?

Section Basics / Installation of the docs says:

There are Skeleton-packages available, which include the core Grav system, sample pages, plugins, and configuration. They are a great way to get started; all you have to do is download the Skeleton-package you prefer, and follow the steps above.

3

NOTE: The instructions say to create “default.md” in “user/pages/03.mypage/”

Which instructions?

The instructions on the default Grav page when you open it in TrueNAS-SCALE TrueCharts.

Skeletons cannot be installed through Admin.

OK, so I go to /app/grav-admin/user

root@grav-5d68f8d4b5-hpzqb:/app/grav-admin/user# ls
accounts config data pages plugins themes

Copy then unzip grav-skeleton-deliver-site+admin-1.2.0.zip

Then restart Grav?

4

OK, I figured out what I was doing wrong with datasets and shares then got the skeleton .zip copied over into the ~/user folder for Grav.

Unzipped the skeleton .zip - no errors.

Stopped, Started, Opened Grav.

I’m seeing the same default layout (actually, some old html I copied into the default.md file in 03.mypages - there’s no indication that the skeleton files exist.

Not sure what to do next …

5

@kd4e, Are you sure you cleared the root of the Grav installation and unzipped grav-skeleton-deliver-site+admin-1.2.0.zip into the root of the Grav installation.

You should find the following /user/pages/ folder:

user/pages
├── 01.home
├── 02.portfolio
├── 03.about
├── 04.services
├── 05.archive
├── 06.blog
├── 07.contact
└── error
6

Mine looks nothing like that at all.

It is the grav-skeleton-deliver-site+admin-1.2.0.zip

And this is what it created …

root@grav-5d68f8d4b5-vdsxc:/app/grav-admin/user# ls -l
total 22583
-rw-rw-r--  1 abc abc   214704 Apr 25 22:14 CHANGELOG.md
-rw-rw-r--  1 abc abc     5476 Apr 25 22:14 CODE_OF_CONDUCT.md
-rw-rw-r--  1 abc abc     7098 Apr 25 22:14 CONTRIBUTING.md
-rw-rw-r--  1 abc abc     1071 Apr 25 22:14 LICENSE.txt
-rw-rw-r--  1 abc abc     7664 Apr 25 22:14 README.md
-rw-rw-r--  1 abc abc      996 Apr 25 22:14 SECURITY.md
drwxrwsr-x  3 abc abc        7 Jul 24 17:34 accounts
drwxrwsr-x  2 abc abc        3 Jul 24 23:21 assets
drwxrwsr-x  2 abc abc        3 Jul 24 23:21 backup
drwxrwsr-x  2 abc abc        6 Jul 24 23:21 bin
drwxrwsr-x  5 abc abc        6 Jul 24 23:21 cache
-rw-rw-r--  1 abc abc     4551 Apr 25 22:14 composer.json
-rw-rw-r--  1 abc abc   241015 Apr 25 22:14 composer.lock
drwxrwsr-x  3 abc abc        8 Jul 24 16:53 config
drwxrwsr-x  7 abc abc        9 Jul 24 14:15 data
-rwxrwxr-x  1 abc abc 23498333 Jul 24 23:11 grav-skeleton-deliver-site+admin-1.2.0.zip
drwxrwsr-x  2 abc abc        3 Jul 24 23:21 images
-rw-rw-r--  1 abc abc     1500 Apr 25 22:14 index.php
drwxrwsr-x  2 abc abc        3 Jul 24 23:21 logs
-rw-rw-r--  1 abc abc       72 Apr 25 22:14 now.json
drwxrwsr-x  5 abc abc        5 Jul 24 17:51 pages
drwxrwsr-x 10 abc abc       11 Jul 19  2021 plugins
-rw-rw-r--  1 abc abc      274 Apr 25 22:14 robots.txt
drwxrwsr-x 10 abc abc       13 Jul 24 23:21 system
drwxrwsr-x  5 abc abc        6 Jul 24 13:18 themes
drwxrwsr-x  2 abc abc        3 Jul 24 23:21 tmp
drwxrwsr-x 10 abc abc       15 Jul 24 23:21 user
drwxrwsr-x 29 abc abc       30 Jul 24 23:21 vendor
drwxrwsr-x  2 abc abc        8 Jul 24 23:21 webserver-configs
root@grav-5d68f8d4b5-vdsxc:/app/grav-admin/user# cd user
root@grav-5d68f8d4b5-vdsxc:/app/grav-admin/user/user# ls
CHANGELOG.md  LICENSE  README.md  accounts  assets  blueprints.yaml  config  data  pages  plugins  screenshot.jpg  themes
root@grav-5d68f8d4b5-vdsxc:/app/grav-admin/user/user# ls -l
total 218
-rw-rw-r--  1 abc abc    568 Apr 26 00:18 CHANGELOG.md
-rw-rw-r--  1 abc abc   1072 Apr 26 00:18 LICENSE
-rw-rw-r--  1 abc abc   2011 Apr 26 00:18 README.md
drwxrwsr-x  2 abc abc      3 Jul 24 23:21 accounts
drwxrwsr-x  2 abc abc      3 Jul 24 23:21 assets
-rw-rw-r--  1 abc abc    465 Apr 26 00:18 blueprints.yaml
drwxrwsr-x  3 abc abc      7 Jul 24 23:21 config
drwxrwsr-x  2 abc abc      4 Jul 24 23:21 data
drwxrwsr-x 10 abc abc     10 Apr 26 00:18 pages
drwxrwsr-x 15 abc abc     16 Jul 24 23:21 plugins
-rw-rw-r--  1 abc abc 171971 Apr 26 00:18 screenshot.jpg
drwxrwsr-x  3 abc abc      4 Jul 24 23:21 themes
root@grav-5d68f8d4b5-vdsxc:/app/grav-admin/user/user#
7

What do you mean it created? Skeletons doesn’t create anything by themselves. You just extract the contents where you want your page to be. So all these files you just posted, have to be in the root where you want your Grav to be. And as you posted, there’s a:

drwxrwsr-x 10 abc abc       15 Jul 24 23:21 user

And if you check that /user/pages, it should be as @pamtbaau also posted.

If your website root is /app, you should move everything from /app/grav-admin/user to /app. And you don’t need grav-skeleton-deliver-site+admin-1.2.0.zip in that folder

8

@kd4e,

  • It seems you did not clear the root of Grav
  • It also seems you’ve unzipped into folder /app/grav-admin/user, because folder /app/grav-admin/user/user now contains the skeleton.

@Karmalakas,

f your website root is /app , you should move everything from /app/grav-admin/user to /app .

That depends… some users want Grav to be installed in a subdirectory to keep the root clean. I myself have multiple folders inside the webroot to separate between Grav sites and non-Grav sites. That requires setting the documentroot to point to the correct subfolders though.

9

Maybe I should’ve phrased it like If your Grav website root is… :slight_smile:

10 
total 248
-rw-r--r--  1 abc abc 202133 Jul 19  2021 CHANGELOG.md
-rw-r--r--  1 abc abc   5476 Jul 19  2021 CODE_OF_CONDUCT.md
-rw-r--r--  1 abc abc   7098 Jul 19  2021 CONTRIBUTING.md
-rw-r--r--  1 abc abc   1071 Jul 19  2021 LICENSE.txt
-rw-r--r--  1 abc abc   7408 Jul 19  2021 README.md
-rw-r--r--  1 abc abc    996 Jul 19  2021 SECURITY.md
drwxr-xr-x  2 abc abc      3 Jul 19  2021 assets
lrwxrwxrwx  1 abc abc     18 Jul 24 23:23 backup -> /config/www/backup
drwxr-xr-x  2 abc abc      6 Jul 19  2021 bin
drwxr-xr-x  5 abc abc      7 Jul 24 23:24 cache
-rw-r--r--  1 abc abc   4258 Jul 19  2021 composer.json
-rw-r--r--  1 abc abc 236668 Jul 19  2021 composer.lock
drwxr-xr-x  2 abc abc      2 Jul 25 08:42 grav-admin
drwxr-xr-x  2 abc abc      3 Jul 19  2021 images
-rw-r--r--  1 abc abc   1933 Jul 19  2021 index.php
lrwxrwxrwx  1 abc abc     16 Jul 24 23:23 logs -> /config/www/logs
-rw-r--r--  1 abc abc     72 Jul 19  2021 now.json
-rw-r--r--  1 abc abc    274 Jul 19  2021 robots.txt
drwxr-xr-x 10 abc abc     13 Jul 19  2021 system
drwxr-xr-x  2 abc abc      3 Jul 19  2021 tmp
lrwxrwxrwx  1 abc abc     16 Jul 24 23:23 user -> /config/www/user
drwxr-xr-x 30 abc abc     31 Jul 19  2021 vendor
drwxr-xr-x  2 abc abc      8 Jul 19  2021 webserver-configs

Getting a 404 error, now … so I broke it.

11

@kd4e, Do you really want us to dig into the dump of your command lines?

Please be gently on the community and provide proper described/explained/formatted information.

When showing a folder listing please use $ ls -l /path/to/folder | clip.exe and paste the result between triple backticks in your post.

12
  • And the folder your are listing is???
  • What is content of /config/www/user?

It’s not quite a standard Grav install:

  • A Grav installation or skeleton does not come with symbolic links.
    • Why did you add these before even being able to get Grav up and running?
  • A Grav installation and skeleton do come with a .htaccess
1 Like
13

I was trying to follow his instructions.

Grav was running - I was trying to get a skeleton to load.

This is on a TrueNAS-SCALE TrueCharts install on a Dell server.

  • What is content of /config/www/user?
root@grav-5d68f8d4b5-vdsxc:/config/www/user# ls -l
total 294
-rw-rw-r--  1 abc abc 214704 Apr 25 22:14 CHANGELOG.md
-rw-rw-r--  1 abc abc   5476 Apr 25 22:14 CODE_OF_CONDUCT.md
-rw-rw-r--  1 abc abc   7098 Apr 25 22:14 CONTRIBUTING.md
-rw-rw-r--  1 abc abc   1071 Apr 25 22:14 LICENSE.txt
-rw-rw-r--  1 abc abc   7664 Apr 25 22:14 README.md
-rw-rw-r--  1 abc abc    996 Apr 25 22:14 SECURITY.md
drwxrwsr-x  3 abc abc      7 Jul 24 17:34 accounts
drwxrwsr-x  2 abc abc      3 Jul 24 23:21 assets
drwxrwsr-x  2 abc abc      3 Jul 24 23:21 backup
drwxrwsr-x  2 abc abc      6 Jul 24 23:21 bin
drwxrwsr-x  5 abc abc      6 Jul 24 23:21 cache
-rw-rw-r--  1 abc abc   4551 Apr 25 22:14 composer.json
-rw-rw-r--  1 abc abc 241015 Apr 25 22:14 composer.lock
drwxrwsr-x  3 abc abc      8 Jul 24 16:53 config
drwxrwsr-x  7 abc abc      9 Jul 24 14:15 data
drwxrwsr-x  2 abc abc      3 Jul 24 23:21 images
-rw-rw-r--  1 abc abc   1500 Apr 25 22:14 index.php
drwxrwsr-x  2 abc abc      3 Jul 24 23:21 logs
-rw-rw-r--  1 abc abc     72 Apr 25 22:14 now.json
drwxrwsr-x  5 abc abc      5 Jul 24 17:51 pages
drwxrwsr-x 10 abc abc     11 Jul 19  2021 plugins
-rw-rw-r--  1 abc abc    274 Apr 25 22:14 robots.txt
drwxrwsr-x 10 abc abc     13 Jul 24 23:21 system
drwxrwsr-x  5 abc abc      6 Jul 24 13:18 themes
drwxrwsr-x  2 abc abc      3 Jul 24 23:21 tmp
drwxrwsr-x 10 abc abc     15 Jul 24 23:21 user
drwxrwsr-x 29 abc abc     30 Jul 24 23:21 vendor
drwxrwsr-x  2 abc abc      8 Jul 24 23:21 webserver-configs

Note: If necessary, I can uninstall Grav, then reinstall clean. There’s nothing that needs to be saved.

14

Skeleton has all Grav files. Skeleton is not a plugin or a theme. It’s a full Grav package with ready to use theme, plugins and sample content pages. All you need to do, is extract skeleton files to your Grav page root

15

@kd4e, Well, it’s a mess. Grav installation inside /user folder…

As suggested before, please clear your webroot and install a fresh Grav or skeleton.

16

OK. I deleted Grav.
Then I re-installed Grav.
(It opens to the default Grav page.)
I copied the skeleton .zip to /app
I unzipped the skeleton .zip in /app
I closed then re-opened Grav.
I’m still seeing the original default Grav page.
What step did I miss, please?
Thanks

17

It seems that no one is successfully using Grav in TrueCharts/TrueNAS-SCALE - so I’ll delete it and choose a different app.