Question on how to properly generate site based on example

[damiannmm]

In this repo's /example/, with generated Gemfile and nothing else changed, I've tried

$ bundle install
$ bundle exec jekyll serve -V

but I can't reach any page from the link on the home (index.html). Now I'm clueless even on where I should start debug.

---

Gemfile:

source "https://rubygems.org"
# Hello! This is where you manage which Jekyll version is used to run.
# When you want to use a different version, change it below, save the
# file and run `bundle install`. Run Jekyll with `bundle exec`, like so:
#
#     bundle exec jekyll serve
#
# This will help ensure the proper Jekyll version is running.
# Happy Jekylling!
# gem "jekyll", "~> 4.2.0"
# This is the default theme for new Jekyll sites. You may change this to anything you like.
gem "minima", "~> 2.5"
# If you want to use GitHub Pages, remove the "gem "jekyll"" above and
# uncomment the line below. To upgrade, run `bundle update github-pages`.
gem "github-pages", group: :jekyll_plugins
# If you have any plugins, put them here!
group :jekyll_plugins do
  gem "jekyll-feed", "~> 0.12"
end

# Windows and JRuby does not include zoneinfo files, so bundle the tzinfo-data gem
# and associated library.
platforms :mingw, :x64_mingw, :mswin, :jruby do
  gem "tzinfo", "~> 1.2"
  gem "tzinfo-data"
end

# Performance-booster for watching directories on Windows
gem "wdm", "~> 0.1.1", :platforms => [:mingw, :x64_mingw, :mswin]

# Ruby 3.0 no longer comes with webrick
gem "webrick", "~> 1.7"

---

Shell output:

  Logging at level: debug
Configuration file: /Users/damiann/Developer/jekyll-datapage_gen/example/_config.yml
  Logging at level: debug
      GitHub Pages: github-pages v214
      GitHub Pages: jekyll v3.9.0
             Theme: jekyll-theme-primer
      Theme source: /usr/local/lib/ruby/gems/3.0.0/gems/jekyll-theme-primer-0.5.4
         Requiring: jekyll-github-metadata
Dotenv not found. Skipping
         Requiring: jekyll-seo-tag
         Requiring: jekyll-coffeescript
         Requiring: jekyll-commonmark-ghpages
         Requiring: jekyll-gist
         Requiring: jekyll-github-metadata
         Requiring: jekyll-paginate
         Requiring: jekyll-relative-links
         Requiring: jekyll-optional-front-matter
         Requiring: jekyll-readme-index
         Requiring: jekyll-default-layout
         Requiring: jekyll-titles-from-headings
   GitHub Metadata: Initializing...
            Source: /Users/damiann/Developer/jekyll-datapage_gen/example
       Destination: /Users/damiann/Developer/jekyll-datapage_gen/example/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
       EntryFilter: excluded /Gemfile
       EntryFilter: excluded /Gemfile.lock
        Generating: JekyllOptionalFrontMatter::Generator finished in 7.7e-05 seconds.
        Generating: JekyllReadmeIndex::Generator finished in 3.9e-05 seconds.
       Jekyll Feed: Generating feed for posts
        Generating: JekyllFeed::Generator finished in 0.001838 seconds.
        Generating: Jekyll::Paginate::Pagination finished in 2.7e-05 seconds.
        Generating: JekyllRelativeLinks::Generator finished in 0.000571 seconds.
        Generating: JekyllDefaultLayout::Generator finished in 0.003926 seconds.
        Generating: JekyllTitlesFromHeadings::Generator finished in 2.1e-05 seconds.
         Rendering: books.md
  Pre-Render Hooks: books.md
  Rendering Liquid: books.md
  Rendering Markup: books.md
         Requiring: kramdown-parser-gfm
  Rendering Layout: books.md
     Layout source: theme
   GitHub Metadata: No GitHub API authentication could be found. Some fields may be missing or have incorrect data.
   GitHub Metadata: Generating for avillafiorita/jekyll-datapage_gen
   GitHub Metadata: Calling @client.repository("avillafiorita/jekyll-datapage_gen", {:accept=>"application/vnd.github.drax-preview+json"})
         Rendering: index.html
  Pre-Render Hooks: index.html
  Rendering Liquid: index.html
  Rendering Markup: index.html
  Rendering Layout: index.html
         Rendering: assets/css/style.scss
  Pre-Render Hooks: assets/css/style.scss
  Rendering Markup: assets/css/style.scss
         Rendering: feed.xml
  Pre-Render Hooks: feed.xml
  Rendering Liquid: feed.xml
  Rendering Markup: feed.xml
  Rendering Layout: feed.xml
           Writing: /Users/damiann/Developer/jekyll-datapage_gen/example/_site/books.html
           Writing: /Users/damiann/Developer/jekyll-datapage_gen/example/_site/index.html
           Writing: /Users/damiann/Developer/jekyll-datapage_gen/example/_site/assets/css/style.css
           Writing: /Users/damiann/Developer/jekyll-datapage_gen/example/_site/feed.xml
                    done in 2.394 seconds.
         Requiring: jekyll-watch
           Watcher: Ignoring (?-mix:^_config\.yml)
           Watcher: Ignoring (?-mix:^_site\/)
           Watcher: Ignoring (?-mix:^Gemfile)
           Watcher: Ignoring (?-mix:^Gemfile\.lock)
 Auto-regeneration: enabled for '/Users/damiann/Developer/jekyll-datapage_gen/example'
[2021-05-29 09:34:28] INFO  WEBrick 1.7.0
[2021-05-29 09:34:28] INFO  ruby 3.0.1 (2021-04-05) [x86_64-darwin19]
[2021-05-29 09:34:28] DEBUG WEBrick::HTTPServlet::FileHandler is mounted on /.
[2021-05-29 09:34:28] DEBUG unmount .
[2021-05-29 09:34:28] DEBUG Jekyll::Commands::Serve::Servlet is mounted on .
    Server address: http://127.0.0.1:4000
[2021-05-29 09:34:28] INFO  WEBrick::HTTPServer#start: pid=9375 port=4000
  Server running... press ctrl-c to stop.

[damiannmm]

Seems like changing two lines solves the problem

-# gem "jekyll", "~> 4.2.0"
+gem "jekyll", "~> 4.2.0"
...
-gem "github-pages", group: :jekyll_plugins
+# gem "github-pages", group: :jekyll_plugins

Been struggling with this for a few hours. Sorry to bother, hopefully might helps someone stuck with the same reason.

[avillafiorita]

Hi @damiannmm, thanks for the bug report and for finding the solution and sorry for the time it took you. I'll check and fix the examples.

[avillafiorita]

Hi, I have checked and on my computer the example runs with no need for a Gemfile.

There is, in fact, no specific gem required for the example, so with no Gemfile it should run on the latest version of jekyll and its dependencies.

Can you confirm it is the same with you? (I will update either the documentation or the example dir.)

[ryanwoldatwork]

@damiannmm - the site is generated in the directory site, which is sometimes a hidden directory. Look in there to see how the files are named.

In your example, I'm guessing the spaces in localhost:4000/Adolfo Villaforita broke the url.

[avillafiorita]

Hi - I run the example today and trying to catch up with the discussion.

Quick answer: link to "my" page in the example is:

 http://localhost:4000/people/adolfo-villafiorita/

(notice the =people= subdir).

If you run =jekyll serve= and open =localhost:4000= you should see something like:

and, if you click on "Adolfo Villafiorita" you indeed get to =http://localhost:4000/people/adolfo-villafiorita/=.

Let me know if it solves the issue!