Error while setting up docs locally

Meshery
1

cc: @vishalvivekm @Sudhanshu_Dasgupta

image
image784×162 5.37 KB

2

Hi @Ripul.Handoo , I’ll assume you’re getting this on running make docs.
Please pull the latest from the upstream and then try. working fine on my machine.

3

I tried both git pull upstream master and git remote update. Still getting the same error.

4

@Ripul.Handoo
Try following commands

  • gem update --system
  • gem install escape_utils
  • gem update escape_utils
5

I have had the same issue for over ~7 days (consistently):

  • re-cloned the repo a few times thinking it was a cloning issue (something not downloaded properly)
  • cd docs
  • make docs
    j2
    j21447×281 24.1 KB

    j
    j1300×258 22.8 KB
  • adding the missing gems one after the other as the error messages came, but they kept coming.

Specs:

  • WSL2 Ubuntu 22.04.3 LTS
  • Windows 11
6

Day 8: What worked for me

  • clone the fork of your meshery repo (again if you have to)
  • cd meshery
  • cd docs (there was an automatic output to the terminal stating that ruby 3.2.2 was not installed)
  • installed ruby 3.2.2
  • ran bundle exec jekyll serve

Screenshot

tk
tk1460×335 28.9 KB

These are a lot of commands to run individually so I used ChatGPT (for efficiency) to create sudo gem install [command] -v 'v.v.v' for each gem, and ran it all at once

  • depending on your bandwidth speed this can take some time to complete
  • after all gems were installed, I ran bundle exec jekyll serve again, and the docs were successfully deployed on local server.

Screenshot

kt
kt1464×686 81.4 KB

7

@Ripul.Handoo have you successfully built docs right now?