Skip to content

Commit

Permalink
updating the documentation for imports
Browse files Browse the repository at this point in the history
  • Loading branch information
mansona committed Apr 27, 2021
1 parent 1765f0f commit 1292797
Showing 1 changed file with 17 additions and 14 deletions.
31 changes: 17 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ npm init ember-app super-blog
cd super-blog

# you can replace the template with the one you want to use
npx ember-cli install empress-blog empress-blog-casper-template
npx ember install empress-blog empress-blog-casper-template
```

It will ask you if you want to update the `index.html` file and you should say yes 👍
Expand All @@ -62,7 +62,7 @@ This addon comes with helpful blueprints to generate posts and authors for you i
expects. The first thing you should do is generate an author as follows:

```sh
ember g author your-name
npx ember g author your-name
```

Then you should be able to edit the file `author/your-name.md` to update the details.
Expand All @@ -71,7 +71,7 @@ Next you will want to generate some posts. If you only have one author generated
blog) you can generate a post as simply as running:

```sh
ember g post "this is a post I want to write"
npx ember g post "this is a post I want to write"
```

### Configuring
Expand Down Expand Up @@ -153,22 +153,25 @@ include your template in a list of existing templates.
Importing content
------------------------------------------------------------------------------

If you hosted your blog somewhere else, you might be interested in importing the content
to your new *empress-blog*.
If you would like to import your blog content from another platform into
empress-blog we have a beta import function that we would love for people to try
out and give feedback. It requires that you create an export file from your
respective blog platform and then run the following command from the command
line:

Command line for import is:
```sh
ember empress-blog:import [dump_file] --type=[import_type]
npx ember empress-blog:import --type=[import_type] [dump_file]
```

The current available `import_type`s are:
- ghost
- wordpress
- tumblr
Currently available `import_type`s are:
- [Ghost](https://ghost.org/faq/the-importer/)
- [WordPress](https://en.support.wordpress.com/export/)
- [Tumblr](https://tumblr.zendesk.com/hc/en-us/articles/360005118894-Export-your-blog)

### Tumblr

When exporting your Tumblr posts you get a zip file that contains another zip file called `posts.zip`. You need to unpack the first file and use the `posts.zip` file as your `dump_file`.
**Note:** When exporting a Tumblr blog you will be downloading a zip file which
you need to unpack. Once you unpack your export zip file you will find a
`posts.zip` file which also needs to be unpacked. Your `dump_file` will be the
resulting `posts.xml` file.

Upgrade notes
------------------------------------------------------------------------------
Expand Down

0 comments on commit 1292797

Please sign in to comment.