Where are all the files?

[michaelgwelch]

Am I supposed to have the layout structure as written up in the README?

I started my site by using the getting started guide at GitHub https://docs.github.com/en/pages/setting-up-a-github-pages-site-with-jekyll/creating-a-github-pages-site-with-jekyll

Looks like minima is the default.

I read the README and see the list of dirs and files. But I don't have most of those in my setup.

Here's what I see:

✗ ls -l 
total 56
-rw-r--r--  1 mgwelch  staff   419 Jan 31 21:03 404.html
-rw-r--r--  1 mgwelch  staff  1391 Jan 31 21:13 Gemfile
-rw-r--r--  1 mgwelch  staff  7479 Jan 31 21:13 Gemfile.lock
-rw-r--r--  1 mgwelch  staff  2364 Jan 31 21:27 _config.yml
drwxr-xr-x@ 3 mgwelch  staff    96 Jan 31 21:04 _posts
drwxr-xr-x@ 8 mgwelch  staff   256 Jan 31 21:23 _site
-rw-r--r--  1 mgwelch  staff   539 Jan 31 21:03 about.markdown
-rw-r--r--  1 mgwelch  staff   175 Jan 31 21:03 index.markdown

So for example, I wanted to play around with the social media links. I added

minima:
  social_links:
    - { platform: github,  user_url: "https://github.com/jekyll/my_kl" }
    - { platform: twitter, user_url: "https://twitter.com/jekyllrb" }
    - { platform: mastodon, user_url: "https://mast.mmwelch.net/@michael" }

to the _config.yml file and served up the site. But the page doesn't reflect any changes to the social links I made. I think this is because I don't have any of the _includes.

Should I start over with different instructions than the GitHub Pages instructions?

Am I missing the obvious documentation for using this theme?

Thanks

This is macOS 13.2, ruby 3.1.3, and minima 2.5.1 (I think based on the Gemfile.lock) (and I'm not sure what else is relevant).

[michaelgwelch]

Ok, I guess I have my original question answered:

https://jekyllrb.com/docs/themes/#understanding-gem-based-themes

So I understand I'm seeing the files I'm supposed to see.

But that doesn't explain why the social media links don't render as advertised. I'll head back to the README. Perhaps there's another flag I need to set.

[michaelgwelch]

Ok, I think I have answer #2: https://github.com/jekyll/minima#social-networks

I don't have minima 3.

[michaelgwelch]

Rather than upgrading to 3 which doesn't seem possible see #656 I switched the repo to look at the 2.5 branch and found out how to use social media there.

[michaelgwelch]

And that worked!

[DidierMalenfant]

I was able to use the latest master branch (which is apparently where v3 is located) by modifying my Gemfile like so:

gem "minima", :github => 'jekyll/minima'

[MMagicoder]

I don't see Gemfiles.
I'm brand new to all of this, so I'm not working from the command line, only on the website.
Which instructions should I follow to get the latest version of Minima?

[jekyllbot]

This issue has been automatically marked as stale because it has not been commented on for at least two months.

The resources of the Jekyll team are limited, and so we are asking for your help.

If this is a bug and you can still reproduce this error on the master/main branch, please reply with all of the information you have about it in order to keep the issue open.

If this is a feature request, please consider whether it can be accomplished in another way. If it cannot, please elaborate on why it is core to this project and why you feel more than 80% of users would find this beneficial.

This issue will automatically be closed in two months if no further activity occurs. Thank you for all your contributions.