Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Please add dependencies to Importer docs #467

Closed
SimonDarksideJ opened this issue Mar 5, 2022 · 2 comments · Fixed by #468
Closed

Please add dependencies to Importer docs #467

SimonDarksideJ opened this issue Mar 5, 2022 · 2 comments · Fixed by #468

Comments

@SimonDarksideJ
Copy link

I'm new to Ruby and Jekyll, so I'm not as familiar with how importers and such work.

So if there are "Requirements" for an importer to work, PLEASE document them on the docs page and NOT just the run command.

Just spent a few hours trying to get the Ghost importer to run only to find:

  1. I needed to also run "gem install jekyll-import"
  2. Then it turns out I needed another gem and had to run "gem install sequel"
  3. Then I needed sqlite3 -> "gem install sqlite3"

NEVER assume the reader / user has complete knowledge or expect them to know things, please just be clear with install instructions and usage to avoid confusion

After all that, the Ghost importer still didn't work as it appears "out of date" with Ghost 3 / 4 db schema. Too much time wasted

@parkr
Copy link
Member

parkr commented Mar 6, 2022

@SimonDarksideJ Hello! I'm very sorry you lost time. Unfortunately these importers don't get a ton of love. Thank you for sharing your experience with us so that we can improve this for future users. @ashmaroli has a pull request in the works to add required libraries to the docs.

I'm not sure when our Ghost importer was written but I believe it was years ago. If you are willing to share your Ghost database so we can make improvements to support later versions of ghost, that would be appreciated!

@SimonDarksideJ
Copy link
Author

ghost.zip
Here you go, nothing sensitive in there. But hope that helps improve the importer.

The link to the ghost.json importer is a good reference to ensure tags and other content such as feature images are supported too.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

Successfully merging a pull request may close this issue.

3 participants