jekyll / jekyll-import

:inbox_tray: The "jekyll import" command for importing from various blogs to Jekyll format.
https://import.jekyllrb.com
MIT License
513 stars 314 forks source link

Documentation on importers is not helpful #464

Open ashmaroli opened 2 years ago

ashmaroli commented 2 years ago

The importer-specific page directs the visitor to run a Ruby script instead of using the CLI provided by the plugin. For example, the documentation for importing a wordpress.com site directs the visitor to run:

$ ruby -r rubygems -e 'require "jekyll-import";
    JekyllImport::Importers::WordpressDotCom.run({
      "source" => "wordpress.xml",
      "no_fetch_images" => false,
      "assets_folder" => "assets"
    })'

instead of

jekyll import wordpressdotcom
parkr commented 2 years ago

There is a lot of cruft in this project that has accumulated over time. I think the reason we went this route originally was because the "jekyll import" subcommand was unreliable (jekyll needs to require jekyll-import for the subcommand to exist). So we went this less optimal route.

jekyllbot commented 2 years ago

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 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.