Quick patch for migration docs.
This commit is contained in:
parent
8537c6770e
commit
7b22502c94
|
@ -7,6 +7,7 @@
|
||||||
* Rename Jekyll::Logger to Jekyll::Stevenson to fix inheritance issue (#1106)
|
* Rename Jekyll::Logger to Jekyll::Stevenson to fix inheritance issue (#1106)
|
||||||
|
|
||||||
### Site Enhancements
|
### Site Enhancements
|
||||||
|
* Quick patch for importers documentation
|
||||||
* Fix prefix for WordpressDotCom importer in docs (#1107)
|
* Fix prefix for WordpressDotCom importer in docs (#1107)
|
||||||
* Add jekyll-contentblocks plugin to docs (#1068)
|
* Add jekyll-contentblocks plugin to docs (#1068)
|
||||||
* Make code bits in notes look more natural, more readable (#1089)
|
* Make code bits in notes look more natural, more readable (#1089)
|
||||||
|
|
|
@ -15,12 +15,13 @@ the foreign system.
|
||||||
## Preparing for migrations
|
## Preparing for migrations
|
||||||
|
|
||||||
Because the importers have many of their own dependencies, they are made
|
Because the importers have many of their own dependencies, they are made
|
||||||
available via a separate gem called `jekyll-import`. To use them, all you need
|
available via a separate gem called
|
||||||
to do is install the gem, and they will become available as part of Jekyll's
|
[`jekyll-import`](https://github.com/jekyll/jekyll-import). To use them, all
|
||||||
standard command line interface.
|
you need to do is install the gem, and they will become available as part of
|
||||||
|
Jekyll's standard command line interface.
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ gem install jekyll-import
|
$ gem install jekyll-import [--pre]
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
You should now be all set to run the importers below. If you ever get stuck, you
|
You should now be all set to run the importers below. If you ever get stuck, you
|
||||||
|
@ -61,7 +62,7 @@ $ ruby -rubygems -e 'require "jekyll/jekyll-import/wordpressdotcom";
|
||||||
|
|
||||||
<div class="note">
|
<div class="note">
|
||||||
<h5>ProTip™: Wordpress.com Export Tool</h5>
|
<h5>ProTip™: Wordpress.com Export Tool</h5>
|
||||||
<p>If you are migrating from a Wordpress.com account, you can access the export tool at the following URL: `https://YOUR-USER-NAME.wordpress.com/wp-admin/export.php`.</p>
|
<p markdown="1">If you are migrating from a Wordpress.com account, you can access the export tool at the following URL: `https://YOUR-USER-NAME.wordpress.com/wp-admin/export.php`.</p>
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
### Using Wordpress MySQL server connection
|
### Using Wordpress MySQL server connection
|
||||||
|
@ -70,7 +71,7 @@ If you want to import using a direct connection to the Wordpress MySQL server, h
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/wordpress";
|
$ ruby -rubygems -e 'require "jekyll/migrators/wordpress";
|
||||||
Jekyll::WordPress.process("database", "user", "pass")'
|
JekyllImport::WordPress.process("database", "user", "pass")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
If you are using Webfaction and have to set up an [SSH
|
If you are using Webfaction and have to set up an [SSH
|
||||||
|
@ -81,7 +82,7 @@ authentication system:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/wordpress";
|
$ ruby -rubygems -e 'require "jekyll/migrators/wordpress";
|
||||||
Jekyll::WordPress.process("database", "user", "pass", "127.0.0.1")'
|
JekyllImport::WordPress.process("database", "user", "pass", "127.0.0.1")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
### Further Wordpress migration alternatives
|
### Further Wordpress migration alternatives
|
||||||
|
@ -110,7 +111,7 @@ for you too:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/drupal";
|
$ ruby -rubygems -e 'require "jekyll/migrators/drupal";
|
||||||
Jekyll::Drupal.process("database", "user", "pass")'
|
JekyllImport::Drupal.process("database", "user", "pass")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
<div class="note warning">
|
<div class="note warning">
|
||||||
|
@ -126,7 +127,7 @@ To import posts from Movable Type:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/mt";
|
$ ruby -rubygems -e 'require "jekyll/migrators/mt";
|
||||||
Jekyll::MT.process("database", "user", "pass")'
|
JekyllImport::MT.process("database", "user", "pass")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
## Typo
|
## Typo
|
||||||
|
@ -135,7 +136,7 @@ To import posts from Typo:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/typo";
|
$ ruby -rubygems -e 'require "jekyll/migrators/typo";
|
||||||
Jekyll::Typo.process("database", "user", "pass")'
|
JekyllImport::Typo.process("database", "user", "pass")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
This code has only been tested with Typo version 4+.
|
This code has only been tested with Typo version 4+.
|
||||||
|
@ -146,7 +147,7 @@ To import posts from TextPattern:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/textpattern";
|
$ ruby -rubygems -e 'require "jekyll/migrators/textpattern";
|
||||||
Jekyll::TextPattern.process("database_name", "username", "password", "hostname")'
|
JekyllImport::TextPattern.process("database_name", "username", "password", "hostname")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
You will need to run the above from the parent directory of your `_import`
|
You will need to run the above from the parent directory of your `_import`
|
||||||
|
@ -162,14 +163,14 @@ To import posts from Mephisto:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/mephisto";
|
$ ruby -rubygems -e 'require "jekyll/migrators/mephisto";
|
||||||
Jekyll::Mephisto.process("database", "user", "password")'
|
JekyllImport::Mephisto.process("database", "user", "password")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
If your data is in Postgres, you should do this instead:
|
If your data is in Postgres, you should do this instead:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/mephisto";
|
$ ruby -rubygems -e 'require "jekyll/migrators/mephisto";
|
||||||
Jekyll::Mephisto.postgres({:database => "database", :username=>"username", :password =>"password"})'
|
JekyllImport::Mephisto.postgres({:database => "database", :username=>"username", :password =>"password"})'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
## Blogger (Blogspot)
|
## Blogger (Blogspot)
|
||||||
|
@ -197,7 +198,7 @@ To import posts from your primary Posterous blog:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/posterous";
|
$ ruby -rubygems -e 'require "jekyll/migrators/posterous";
|
||||||
Jekyll::Posterous.process("my_email", "my_pass")'
|
JekyllImport::Posterous.process("my_email", "my_pass")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
For any other Posterous blog on your account, you will need to specify the
|
For any other Posterous blog on your account, you will need to specify the
|
||||||
|
@ -205,7 +206,7 @@ For any other Posterous blog on your account, you will need to specify the
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/posterous";
|
$ ruby -rubygems -e 'require "jekyll/migrators/posterous";
|
||||||
Jekyll::Posterous.process("my_email", "my_pass", "blog_id")'
|
JekyllImport::Posterous.process("my_email", "my_pass", "blog_id")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
There is also an [alternative Posterous
|
There is also an [alternative Posterous
|
||||||
|
@ -218,7 +219,7 @@ To import posts from Tumblr:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/tumblr";
|
$ ruby -rubygems -e 'require "jekyll/migrators/tumblr";
|
||||||
Jekyll::Tumblr.process("http://www.your_blog_url.com", true)'
|
JekyllImport::Tumblr.process("http://www.your_blog_url.com", true)'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
There is also [a modified Tumblr
|
There is also [a modified Tumblr
|
||||||
|
@ -237,7 +238,7 @@ Once installed, simply use the format argument:
|
||||||
|
|
||||||
{% highlight bash %}
|
{% highlight bash %}
|
||||||
$ ruby -rubygems -e 'require "jekyll/migrators/tumblr";
|
$ ruby -rubygems -e 'require "jekyll/migrators/tumblr";
|
||||||
Jekyll::Tumblr.process("http://www.your_blog_url.com", format="md")'
|
JekyllImport::Tumblr.process("http://www.your_blog_url.com", format="md")'
|
||||||
{% endhighlight %}
|
{% endhighlight %}
|
||||||
|
|
||||||
## Other Systems
|
## Other Systems
|
||||||
|
|
Loading…
Reference in New Issue