Preview procedure on README needs to be updated.

[apinnick]

Describe the bug

Podman command for preview build no longer works because of a new Git security feature. The podman container fails with a "fatal: unsafe repository" error and the workaround in the error message does not appear to work.

Solution

Provide instructions for installing Asciidoctor, running "$ asciidoctor master.adoc" in the document directory, and then opening the master.html file in a browser. Delete the master.html file so that it is not included in a PR.

It would also be a good idea to add "master.html" to the gitignore file.

[rokkbert]

I experienced this problem, with the SELinux-command. Full error, repeated a few times, is:

fatal: unsafe repository ('/srv/jekyll' is owned by someone else)
    To add an exception for this directory, call:

      git config --global --add safe.directory /srv/jekyll

At the end, and after some asciidoctor-warnings/errors, there is also this, possibly related, error:

jekyll 3.9.2 | Error:  Permission denied @ dir_s_mkdir - /srv/jekyll/_site
/usr/local/lib/ruby/3.1.0/fileutils.rb:243:in `mkdir': Permission denied @ dir_s_mkdir - /srv/jekyll/_site (Errno::EACCES)
	from /usr/local/lib/ruby/3.1.0/fileutils.rb:243:in `fu_mkdir'
	from /usr/local/lib/ruby/3.1.0/fileutils.rb:221:in `block (2 levels) in mkdir_p'
	from /usr/local/lib/ruby/3.1.0/fileutils.rb:219:in `reverse_each'
	from /usr/local/lib/ruby/3.1.0/fileutils.rb:219:in `block in mkdir_p'
	from /usr/local/lib/ruby/3.1.0/fileutils.rb:211:in `each'
	from /usr/local/lib/ruby/3.1.0/fileutils.rb:211:in `mkdir_p'
	from /usr/gem/gems/jekyll-3.9.2/lib/jekyll/convertible.rb:226:in `write'
...

Afterwards there is html-documentation in the new _site directory, but after all the error messages that wasn't even expected.

[jsakil14]

@rokkbert Is this still an issue and where you able to find a workaround ? I am facing similar error :

`Your lockfile doesn't include a valid resolution.
You can fix this by regenerating your lockfile or trying to manually editing the bad locked gems to a version that satisfies all dependencies.
The unmet dependencies are:
* jekyll-theme-cayman (= 0.2.0), depended upon github-pages-231, unsatisfied by jekyll-theme-cayman-0.1.1
Bundle complete! 8 Gemfile dependencies, 109 gems now installed.
Use `bundle info [gemname]` to see where a bundled gem is installed.
ruby 3.1.1p18 (2022-02-18 revision 53f5fc4236) [x86_64-linux-musl]
fatal: detected dubious ownership in repository at '/srv/jekyll'
To add an exception for this directory, call:

	git config --global --add safe.directory /srv/jekyll
fatal: detected dubious ownership in repository at '/srv/jekyll'
To add an exception for this directory, call:

	git config --global --add safe.directory /srv/jekyll
Configuration file: /srv/jekyll/_config.yml
            Source: /srv/jekyll
       Destination: /srv/jekyll/_site
 Incremental build: disabled. Enable with --incremental
      Generating...
       Jekyll Feed: Generating feed for posts
fatal: detected dubious ownership in repository at '/srv/jekyll'
To add an exception for this directory, call:

	git config --global --add safe.directory /srv/jekyll
asciidoctor: WARNING: modules/installing-mtv-operator.adoc: line 13: id assigned to section already in use: installing-mtv-operator_forklift
asciidoctor: WARNING: modules/adding-source-provider.adoc: line 21: id assigned to section already in use: adding-source-provider_forklift
asciidoctor: WARNING: modules/adding-source-provider.adoc: line 36: id assigned to section already in use: adding-source-provider_forklift
asciidoctor: WARNING: modules/adding-source-provider.adoc: line 30: id assigned to section already in use: adding-source-provider_forklift
asciidoctor: WARNING: modules/adding-source-provider.adoc: line 47: id assigned to section already in use: adding-source-provider_forklift
asciidoctor: WARNING: modules/adding-source-provider.adoc: line 62: id assigned to section already in use: adding-source-provider_forklift
asciidoctor: WARNING: modules/new-migrating-virtual-machines-cli.adoc: line 15: id assigned to section already in use: new-migrating-virtual-machines-cli_forklift
asciidoctor: WARNING: modules/new-migrating-virtual-machines-cli.adoc: line 33: id assigned to section already in use: new-migrating-virtual-machines-cli_forklift
asciidoctor: WARNING: modules/new-migrating-virtual-machines-cli.adoc: line 27: id assigned to section already in use: new-migrating-virtual-machines-cli_forklift
asciidoctor: WARNING: modules/new-migrating-virtual-machines-cli.adoc: line 38: id assigned to section already in use: new-migrating-virtual-machines-cli_forklift
asciidoctor: ERROR: obtaining-console-url.adoc: line 21: include file not found: /srv/jekyll/snippet_getting_web_console_url_web.adoc
asciidoctor: ERROR: obtaining-console-url.adoc: line 25: include file not found: /srv/jekyll/snippet_getting_web_console_url_cli.adoc
asciidoctor: ERROR: obtaining-console-url.adoc: line 21: include file not found: /srv/jekyll/snippet_getting_web_console_url_web.adoc
asciidoctor: ERROR: obtaining-console-url.adoc: line 25: include file not found: /srv/jekyll/snippet_getting_web_console_url_cli.adoc
asciidoctor: ERROR: obtaining-console-url.adoc: line 21: include file not found: /srv/jekyll/snippet_getting_web_console_url_web.adoc
asciidoctor: ERROR: obtaining-console-url.adoc: line 25: include file not found: /srv/jekyll/snippet_getting_web_console_url_cli.adoc
asciidoctor: ERROR: obtaining-console-url.adoc: line 21: include file not found: /srv/jekyll/snippet_getting_web_console_url_web.adoc
asciidoctor: ERROR: obtaining-console-url.adoc: line 25: include file not found: /srv/jekyll/snippet_getting_web_console_url_cli.adoc
asciidoctor: ERROR: rhv-prerequisites.adoc: line 30: include file not found: /srv/jekyll/snip-migrating-luns.adoc
asciidoctor: ERROR: rhv-prerequisites.adoc: line 30: include file not found: /srv/jekyll/snip-migrating-luns.adoc
asciidoctor: ERROR: rhv-prerequisites.adoc: line 30: include file not found: /srv/jekyll/snip-migrating-luns.adoc
asciidoctor: ERROR: rhv-prerequisites.adoc: line 30: include file not found: /srv/jekyll/snip-migrating-luns.adoc
asciidoctor: ERROR: rn-2.5.adoc: line 58: include file not found: /srv/jekyll/snippet_ova_tech_preview.adoc
asciidoctor: ERROR: rn-2.5.adoc: line 58: include file not found: /srv/jekyll/snippet_ova_tech_preview.adoc
asciidoctor: ERROR: rn-2.5.adoc: line 58: include file not found: /srv/jekyll/snippet_ova_tech_preview.adoc
asciidoctor: ERROR: rn-2.5.adoc: line 58: include file not found: /srv/jekyll/snippet_ova_tech_preview.adoc
                    done in 2.939 seconds.
 Auto-regeneration: enabled for '/srv/jekyll'
/usr/gem/gems/jekyll-3.9.5/lib/jekyll/commands/serve/servlet.rb:3:in `require': cannot load such file -- webrick (LoadError)
	from /usr/gem/gems/jekyll-3.9.5/lib/jekyll/commands/serve/servlet.rb:3:in `<top (required)>'
	from /usr/gem/gems/jekyll-3.9.5/lib/jekyll/commands/serve.rb:184:in `require_relative'
	from /usr/gem/gems/jekyll-3.9.5/lib/jekyll/commands/serve.rb:184:in `setup'
	from /usr/gem/gems/jekyll-3.9.5/lib/jekyll/commands/serve.rb:102:in `process'
	from /usr/gem/gems/jekyll-3.9.5/lib/jekyll/commands/serve.rb:93:in `block in start'
	from /usr/gem/gems/jekyll-3.9.5/lib/jekyll/commands/serve.rb:93:in `each'
	from /usr/gem/gems/jekyll-3.9.5/lib/jekyll/commands/serve.rb:93:in `start'
	from /usr/gem/gems/jekyll-3.9.5/lib/jekyll/commands/serve.rb:75:in `block (2 levels) in init_with_program'
	from /usr/gem/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in `block in execute'
	from /usr/gem/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in `each'
	from /usr/gem/gems/mercenary-0.3.6/lib/mercenary/command.rb:220:in `execute'
	from /usr/gem/gems/mercenary-0.3.6/lib/mercenary/program.rb:42:in `go'
	from /usr/gem/gems/mercenary-0.3.6/lib/mercenary.rb:19:in `program'
	from /usr/gem/gems/jekyll-3.9.5/exe/jekyll:15:in `<top (required)>'
	from /usr/local/bundle/bin/jekyll:27:in `load'
	from /usr/local/bundle/bin/jekyll:27:in `<main>'`