jekyll-import 0.1.0.beta4 → 0.1.0.rc1

data/site/docs/contributing.md

@@ -0,0 +1,8 @@
+---
+layout: docs
+title: Contributing
+prev_section: third-party
+next_section: history
+permalink: /docs/contributing/
+---
+

data/site/docs/csv.md

@@ -0,0 +1,25 @@
+---
+layout: docs
+title: CSV
+prev_section: quickstart
+link_source: csv
+next_section: drupal6
+permalink: /docs/csv/
+---
+
+To import your posts from a CSV file, run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::CSV.run({
+      "file" => "my_posts.csv"
+    })'
+{% endhighlight %}
+
+Your file CSV file will be read in with the following columns:
+
+1. title
+2. permalink
+3. body
+4. published_at
+5. filter (e.g. markdown, textile)

data/site/docs/drupal6.md

@@ -0,0 +1,24 @@
+---
+layout: docs
+title: Drupal 6
+prev_section: csv
+link_source: drupal6
+next_section: drupal7
+permalink: /docs/drupal6/
+---
+
+To import your posts from a [Drupal 6](http://drupal.org) installation, run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::Drupal6.run({
+      "dbname"   => "name",
+      "user"     => "myuser",
+      "password" => "mypassword",
+      "host"     => "myhost",
+      "prefix"   => "mytableprefix"
+    })'
+{% endhighlight %}
+
+The only required fields are `dbname` and `user`. `password` defaults to `""`,
+`host` defaults to `"localhost"`, and `prefix` defaults to `""`.

data/site/docs/drupal7.md

@@ -0,0 +1,24 @@
+---
+layout: docs
+title: Drupal 7
+prev_section: drupal6
+link_source: drupal7
+next_section: enki
+permalink: /docs/drupal7/
+---
+
+To import your posts from a [Drupal 7](http://drupal.org) installation, run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::Drupal7.run({
+      "dbname"   => "name",
+      "user"     => "myuser",
+      "password" => "mypassword",
+      "host"     => "myhost",
+      "prefix"   => "mytableprefix"
+    })'
+{% endhighlight %}
+
+The only required fields are `dbname` and `user`. `password` defaults to `""`,
+`host` defaults to `"localhost"`, and `prefix` defaults to `""`.

data/site/docs/enki.md

@@ -0,0 +1,23 @@
+---
+layout: docs
+title: Enki
+prev_section: drupal7
+link_source:  enki
+next_section: google_reader
+permalink: /docs/enki/
+---
+
+To import your posts from a [Enki](http://enkiblog.com) installation, run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::Enki.run({
+      "dbname"   => "name",
+      "user"     => "myuser",
+      "password" => "mypassword",
+      "host"     => "myhost"
+    })'
+{% endhighlight %}
+
+The only required fields are `dbname` and `user`. `password` defaults to `""`
+and `host` defaults to `"localhost"`.

data/site/docs/google_reader.md

@@ -0,0 +1,19 @@
+---
+layout: docs
+title: Google Reader
+prev_section: enki
+link_source:  google_reader
+next_section: joomla
+permalink: /docs/google_reader/
+---
+
+To import your posts from a [Google Reader](http://reader.google.com) XML dump file, run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::GoogleReader.run({
+      "source" => "my_file.xml"
+    })'
+{% endhighlight %}
+
+The `source` field is required.

data/site/docs/history.md

@@ -0,0 +1,7 @@
+---
+layout: docs
+title: History
+permalink: /docs/history/
+prev_section: contributing
+---
+

data/site/docs/index.md

@@ -0,0 +1,17 @@
+---
+layout: docs
+title: Getting started
+next_section: installation
+permalink: /docs/home/
+---
+
+If you’re switching to Jekyll from another blogging system, Jekyll’s importers
+can help you with the move. Most methods listed on this page require read access
+to the database from your old system to generate posts for Jekyll. Each method
+generates `.markdown` posts in the `_posts` directory based on the entries in
+the foreign system.
+
+## Other Systems
+
+If you have a system for which there is currently no migrator, consider writing
+one and sending us [a pull request](https://github.com/jekyll/jekyll-import).

data/site/docs/installation.md

@@ -0,0 +1,26 @@
+---
+layout: docs
+title: Installation
+prev_section: home
+next_section: usage
+permalink: /docs/installation/
+---
+
+Because the importers have many of their own dependencies, they are made
+available via a separate gem called
+[`jekyll-import`](https://github.com/jekyll/jekyll-import). To use them, all
+you need to do is install the gem, and they will become available as part of
+Jekyll's standard command line interface.
+
+{% highlight bash %}
+$ gem install jekyll-import --pre
+{% endhighlight %}
+
+<div class="note warning">
+  <h5>Jekyll-import requires you to manually install some dependencies.</h5>
+  <p markdown="1">If you are importing your blog from Drupal 6,7, Joomla,
+  Mephisto, Movable Type, Textpattern, or Typo (with mysql db), you need to install
+  `mysql` and `sequel` gems. If you are importing from a WordPress database, you
+  need to install `mysql2` and `sequel` gems, and if you are importing from Enki
+  or Typo (with postgresql db) you need to install `pg` and `sequel` gems.</p>
+</div>

data/site/docs/joomla.md

@@ -0,0 +1,26 @@
+---
+layout: docs
+title: Joomla
+prev_section: google_reader
+link_source:  joomla
+next_section: jrnl
+permalink: /docs/joomla/
+---
+
+To import your posts from a [Joomla](http://joomla.org) installation, run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::Joomla.run({
+      "dbname"   => "name",
+      "user"     => "myuser",
+      "password" => "mypassword",
+      "host"     => "myhost",
+      "section"  => "thesection",
+      "prefix"   => "mytableprefix"
+    })'
+{% endhighlight %}
+
+The only required fields are `dbname` and `user`. `password` defaults to `""`,
+`host` defaults to `"localhost"`, and `section` defaults to `"1"` and `prefix`
+defaults to `"jos_"`.

data/site/docs/jrnl.md

@@ -0,0 +1,23 @@
+---
+layout: docs
+title: Jrnl
+prev_section: joomla
+link_source: jrnl
+next_section: marley
+permalink: /docs/jrnl/
+---
+
+To import your posts from [Jrnl](http://maebert.github.io/jrnl/), run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::Jrnl.run({
+      "file"        => "~/journal.txt",
+      "time_format" => "%Y-%m-%d %H:%M",
+      "extension"   => "md",
+      "layout"      => "post"
+    })'
+{% endhighlight %}
+
+None of the fields are mandatory. The default to the values in the example
+block above.

data/site/docs/marley.md

@@ -0,0 +1,20 @@
+---
+layout: docs
+title: Marley
+prev_section: jrnl
+link_source: marley
+next_section: mephisto
+permalink: /docs/marley/
+---
+
+To import your posts from [Marley](https://github.com/karmi/marley), run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::Marley.run({
+      "marley_data_dir" => "my_marley_data_dir"
+    })'
+{% endhighlight %}
+
+The `marley_data_dir` field is required and points to the directory in which
+your Marley data resides.

data/site/docs/mephisto.md

@@ -0,0 +1,23 @@
+---
+layout: docs
+title: Mephisto
+prev_section: marley
+link_source: mephisto
+next_section: mt
+permalink: /docs/mephisto/
+---
+
+To import your posts from [Mephisto](http://www.mephistoblog.com), run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::Mephisto.run({
+      "dbname"   => "name",
+      "user"     => "myuser",
+      "password" => "mypassword",
+      "host"     => "myhost"
+    })'
+{% endhighlight %}
+
+The only required fields are `dbname` and `user`. `password` defaults to `""`
+and `host` defaults to `"localhost"`.

data/site/docs/mt.md

@@ -0,0 +1,23 @@
+---
+layout: docs
+title: Movable Type
+prev_section: mephisto
+link_source: mt
+next_section: posterous
+permalink: /docs/mt/
+---
+
+To import your posts from [Movable Type](http://movabletype.org), run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::MT.run({
+      "dbname"   => "name",
+      "user"     => "myuser",
+      "password" => "mypassword",
+      "host"     => "myhost"
+    })'
+{% endhighlight %}
+
+The only required fields are `dbname` and `user`. `password` defaults to `""`
+and `host` defaults to `"localhost"`.

data/site/docs/posterous.md

@@ -0,0 +1,25 @@
+---
+layout: docs
+title: Posterous
+prev_section: mt
+link_source: posterous
+next_section: rss
+permalink: /docs/posterous/
+---
+
+To import your posts from [Posterous](http://movabletype.org), run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::Posterous.run({
+      "email"     => "myemail",
+      "password"  => "mypassword",
+      "api_token" => "mytoken"
+    })'
+{% endhighlight %}
+
+All three fields are required.
+
+There is also an [alternative Posterous
+migrator](https://github.com/pepijndevos/jekyll/blob/patch-1/lib/jekyll/migrators/posterous.rb)
+that maintains permalinks and attempts to import images too.

data/site/docs/rss.md

@@ -0,0 +1,19 @@
+---
+layout: docs
+title: RSS
+prev_section: posterous
+link_source:  rss
+next_section: s9y
+permalink: /docs/rss/
+---
+
+To import your posts from an RSS feed (local or remote), run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::RSS.run({
+      "source" => "my_file.xml"
+    })'
+{% endhighlight %}
+
+The `source` field is required and can be either a local file or a remote one.

data/site/docs/s9y.md

@@ -0,0 +1,19 @@
+---
+layout: docs
+title: S9Y
+prev_section: rss
+link_source:  s9y
+next_section: textpattern
+permalink: /docs/s9y/
+---
+
+To import your posts from an [S9Y](http://www.s9y.org) feed, run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::S9Y.run({
+      "source" => "http://blog.example.com/rss.php?version=2.0&all=1"
+    })'
+{% endhighlight %}
+
+The `source` field is required.

data/site/docs/textpattern.md

@@ -0,0 +1,30 @@
+---
+layout: docs
+title: Textpattern
+prev_section: s9y
+link_source: textpattern
+next_section: tumblr
+permalink: /docs/textpattern/
+---
+
+To import your posts from [Textpattern](http://textpattern.com), run:
+
+{% highlight bash %}
+$ ruby -rubygems -e 'require "jekyll-import";
+    JekyllImport::Importers::TextPattern.run({
+      "dbname"   => "name",
+      "user"     => "myuser",
+      "password" => "mypassword",
+      "host"     => "myhost"
+    })'
+{% endhighlight %}
+
+The only required fields are `dbname` and `user`. `password` defaults to `""`
+and `host` defaults to `"localhost"`.
+
+You will need to run the above from the parent directory of your `_import`
+folder. For example, if `_import` is located in `/path/source/_import`, you will
+need to run this code from `/path/source`. The hostname defaults to `localhost`,
+all other variables are required. You may need to adjust the code used to filter
+entries. Left alone, it will attempt to pull all entries that are live or
+sticky.

data/site/docs/third-party.md

@@ -0,0 +1,30 @@
+---
+layout: docs
+title: Third-party
+prev_section: wordpressdotcom
+next_section: contributing
+permalink: /docs/third-party/
+---
+
+Various third-party importers for Jekyll have been created separate from this
+gem. They are as below:
+
+### Blogger (Blogspot)
+
+To import posts from Blogger, see [this post about migrating from Blogger to
+Jekyll](http://blog.coolaj86.com/articles/migrate-from-blogger-to-jekyll.html). If
+that doesn’t work for you, you might want to try some of the following
+alternatives:
+
+- [@kennym](https://github.com/kennym) created a [little migration
+  script](https://gist.github.com/1115810), because the solutions in the
+  previous article didn't work out for him.
+- [@ngauthier](https://github.com/ngauthier) created [another
+  importer](https://gist.github.com/1506614) that imports comments, and does so
+  via blogger’s archive instead of the RSS feed.
+- [@juniorz](https://github.com/juniorz) created [yet another
+  importer](https://gist.github.com/1564581) that works for
+  [Octopress](http://octopress.org). It is like [@ngauthier’s
+  version](https://gist.github.com/1506614) but separates drafts from posts, as
+  well as importing tags and permalinks.
+