Quick patch for migration docs.

This commit is contained in:
Parker Moore 2013-05-15 13:57:30 +02:00
parent 8537c6770e
commit 7b22502c94
2 changed files with 19 additions and 17 deletions

View File

@ -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)

View File

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